命令与权限

强化模块的命令与权限: 每条命令做什么, 需要哪个权限, 出问题时先敲哪一条

EmakiStrengthen 的主命令是 /emakistrengthen, 别名 /estrengthen. 你用它打开强化 GUI; 管理员还用它检查主手装备, 刷新展示, 设置星级, 清理状态和发放强化材料

命令列表

命令	说明	权限
/estrengthen help	显示帮助	基础
/estrengthen open	打开强化 GUI	emakistrengthen.use
/estrengthen affix [recipe]	打开词条强化 GUI, 只有玩家能执行; 不填 recipe 时按当前物品匹配	use 或 admin
/estrengthen branch [id]	给主手物品选择分支, 只有玩家能执行; 不填 id 时列出当前可选的分支 ID	use 或 admin
/estrengthen reload	重载配置, GUI, 语言和配方	reload 或 admin
/estrengthen inspect [player]	检查指定玩家或自己的主手物品	use 或 admin
/estrengthen refresh [player]	刷新指定玩家或自己的物品展示	admin
/estrengthen setstar <star> [recipe]	设置执行者主手物品的星级; 这条命令没有 player 参数	admin
/estrengthen convert-legacy [confirm]	把 recipes/*.yml 里已废弃的 match 块转换成 matcher 加顶层字段. 不带参数只做预演; 加 confirm (或 --apply) 才实际改写, 并留一份 .bak 备份. 详见强化配方	admin
/estrengthen clearstate	清除执行者主手的强化层, 只有玩家能执行	admin
/estrengthen clearcrack	清除执行者主手的锻印值, 只有玩家能执行	admin
/estrengthen givecatalyst <material> [amount] [player]	发放强化材料	admin
/estrengthen operation [list|<operationId>]	列出已经注册的强化操作, 或者查看单个 operationId 的详情. 不填参数等同于 list	admin
/estrengthen pity [list|diagnose|set|clear] ...	管理保底 (连续失败到一定次数后必定成功) 计数器. list [group] 用来查看, diagnose 输出存储状态, set <scope> <group> <owner> <counter> (scope 填 player 或 item) 写入计数, clear <group> 清空一个分组. 不填参数等同于 list	admin
/estrengthen debug <status|player|module|all> [...]	查看或切换调试输出	debug 或 admin

权限节点

权限	默认	说明
emakistrengthen.use	true	使用基础强化功能
emakistrengthen.reload	op	重载配置
emakistrengthen.debug	op	调试命令
emakistrengthen.admin	op	管理员功能

先用哪个命令

场景	先执行	目的
玩家要强化装备	/estrengthen open	打开强化 GUI
修改了配方, GUI 或语言	/estrengthen reload	重载运行配置
装备强化状态不对	/estrengthen inspect	查看主手物品的强化层和匹配配方
展示没有刷新	/estrengthen refresh <player>	重建玩家物品展示
测试某个星级效果	/estrengthen setstar <star> [recipe]	直接设置执行者主手物品星级
调试异常状态	/estrengthen debug ...	查看模块, 玩家或全局调试信息

管理建议

• setstar, clearstate, clearcrack 操作的都是执行者手里的主手物品, 执行前先确认手里拿的是测试装备
• refresh 只负责把展示刷出来, 不会替你修正配错的配方
• 改完配方先 reload, 再用测试装备分别验证成功, 失败, 保护材料, 星级写入和属性写入