权限

基础与管理权限#

权限	默认	说明
kafurnace.use	所有玩家	使用 /kafurnace、/kf 和个人虚拟熔炉
kafurnace.admin	OP	全部管理功能；包含下面三个细分权限
kafurnace.admin.furnace.view	OP	使用管理员 get 查看升级状态
kafurnace.admin.furnace.modify	OP	使用管理员 set/reset 修改升级状态
kafurnace.admin.furnace.open	OP	打开并操作其他玩家的虚拟熔炉

kafurnace.admin 在代码层绕过下面全部玩家数量、升级、解锁和炉型限制。管理员 set/reset 也不读取目标玩家的限制权限。

熔炉数量上限#

kafurnace.limit.furnaces.<1-10>

插件选择玩家拥有的最高数值节点。所有数值节点默认关闭；没有任何数值节点时保留系统上限 10，因此未配置权限插件时行为不变。要限制为 1 座，也需要明确授予 .1。

降低上限不会删除、隐藏或锁定已有熔炉；当玩家已有数量达到新上限时，只会阻止继续购买。

属性等级上限#

kafurnace.limit.upgrade.<属性>.<1-6>

可用属性：

input_slot
fuel_slot
output_slot
fuel_efficiency
smelting_speed

每项属性分别选择玩家拥有的最高数值节点。所有数值节点默认关闭；没有任何对应节点时保留系统上限 6。等级达到权限上限后不会继续扣费或升级。降低权限不会回退已有等级，管理员仍可用管理命令在 1..6 范围内设置。

永久能力权限#

权限	默认	说明
kafurnace.unlock.offline_smelting	所有玩家	允许购买离线熔炼
kafurnace.unlock.auto_output_delivery	所有玩家	允许购买自动产物配送
kafurnace.unlock.completion_notification	所有玩家	允许购买完成通知

拒绝权限只会阻止尚未完成的购买，不会撤销已经保存的永久能力。

炉型切换权限#

权限	默认	说明
kafurnace.type.furnace	所有玩家	允许切换为普通熔炉
kafurnace.type.blast_furnace	所有玩家	允许切换为高炉
kafurnace.type.smoker	所有玩家	允许切换为烟熏炉

拒绝目标类型权限不会改变现有熔炉类型，只会阻止之后切换到该类型。点击当前类型仍按“无需切换”处理。

LuckPerms 示例#

给管理员组管理权限：

/lp group admin permission set kafurnace.admin true

禁止某个组使用虚拟熔炉：

/lp group restricted permission set kafurnace.use false

把 member 组限制为最多 3 座熔炉：

/lp group member permission set kafurnace.limit.furnaces.3 true

把 member 组的熔炼速度限制为最高 3 级：

/lp group member permission set kafurnace.limit.upgrade.smelting_speed.3 true

禁止 member 组购买离线熔炼和切换为高炉：

/lp group member permission set kafurnace.unlock.offline_smelting false
/lp group member permission set kafurnace.type.blast_furnace false

默认情况下，上述两种上限只需授予目标节点，无需否定系统上限。若组或通配符已经授予更高数值节点，插件仍会选择最高有效节点，此时应否定那些更高节点。权限在每次打开/刷新菜单和发起事务时读取，LuckPerms 修改后不需要重载 KaFurnace。

菜单提供 {furnace_purchase_allowed}、{<属性>_permission_max_level}、{<属性>_allowed}、{<能力>_allowed} 和 {type_<炉型>_allowed} 变量。显示值按语言文件本地化；条件判断请使用对应的 _raw 变量。