命令与权限

EmakiGem 的主命令是 /emakigem，别名为 /egem、/eg。玩家用它打开镶嵌、开孔或升级界面；管理员用它检查装备宝石状态、清理异常状态、重载配置和输出调试信息。

命令列表

命令	权限	说明
`/emakigem gui <inlay	open	upgrade>`
/emakigem reload	emakigem.reload 或 emakigem.admin	重载主配置、宝石定义、插槽物品、共鸣、条件、GUI 和语言文件。
/emakigem inspect [player]	emakigem.use 或 emakigem.admin	查看指定玩家或自己的主手装备宝石状态。
/emakigem clearstate	emakigem.admin	清除主手物品的宝石层状态，适合调试或修复异常装备。
/emakigem debug	emakigem.debug 或 emakigem.admin	输出运行时调试信息。

GUI 模式

gui 命令支持三种模式：

模式	作用	常见用途
inlay	镶嵌与提取宝石	玩家日常宝石操作。
open	开孔	使用开孔器解锁装备预留插槽。
upgrade	宝石升级	消耗材料和货币提升宝石等级。

示例：

/emakigem gui inlay
/emakigem gui open
/emakigem gui upgrade

如果希望玩家只通过菜单入口进入某一类操作，可以在其他菜单插件或 NPC 插件中执行对应命令，并把权限控制交给 emakigem.use。

权限节点

权限	默认	说明
emakigem.use	true	允许使用基础宝石功能和打开 GUI。
emakigem.reload	op	允许重载配置。
emakigem.admin	op	允许检查、清理状态等管理操作。
emakigem.debug	op	允许输出调试信息。

先用哪个命令

场景	先执行	目的
玩家要镶嵌或提取宝石	/emakigem gui inlay	打开镶嵌界面。
玩家要给装备开孔	/emakigem gui open	打开开孔界面。
玩家要升级宝石	/emakigem gui upgrade	打开升级界面。
装备宝石状态异常	/emakigem inspect [player]	查看主手装备 gem layer、插槽和共鸣状态。
主手装备需要清理宝石层	/emakigem clearstate	移除主手物品的宝石状态。先备份。
改了宝石、插槽物品、共鸣或 GUI	/emakigem reload	重载运行配置。

常见操作

打开宝石界面

/emakigem gui inlay

命令模式必须明确写 inlay、open 或 upgrade。gui.default_mode 只作为 GUI 服务默认值，不替代命令参数。

检查装备宝石状态

/emakigem inspect Steve

检查内容包括装备是否拥有 gem layer、已开放插槽、已镶嵌宝石、共鸣状态以及可回退的物品操作记录。排查“属性未生效”“宝石显示残留”“提取后效果未撤销”等问题时优先使用该命令。

清理异常状态

/emakigem clearstate

该命令会清除主手物品上的宝石状态。使用前建议备份玩家物品数据，并先通过 inspect 确认目标物品。清理后装备会失去宝石层记录，原有宝石效果不会再按正常流程保留。

排查建议

• GUI 打不开：检查玩家是否拥有 emakigem.use，并确认 GUI 模板目录存在。
• 开孔失败：检查目标装备是否匹配 items/*.yml，并确认存在未开放且类型匹配的预留插槽。
• 镶嵌失败：检查宝石 socket_compatibility、插槽类型、条件配置、费用配置和 inlay_success。
• 升级失败：检查宝石升级配置、目标等级材料、经济插件与全局失败惩罚。
• 属性未刷新：检查 EmakiAttribute 是否安装，装备是否重建，宝石效果是否写入 ea_attribute。