命令与权限

命令

根命令：/emakiattribute（别名 /eattribute、/ea）

子命令	用法	权限	说明
help	/ea help	emakiattribute.use	显示帮助信息
reload	/ea reload	emakiattribute.reload	异步重载所有配置文件，完成后输出加载统计
resync	/ea resync [玩家|all]	emakiattribute.resync	重新同步属性快照。不带参数同步自己，all 同步所有在线玩家
preview	/ea preview [玩家] [槽位]	emakiattribute.debug	查看指定玩家指定槽位物品的属性快照
dump	/ea dump [玩家]	emakiattribute.debug	导出玩家的完整战斗属性快照和资源状态
debug	/ea debug [玩家] [toggle|on|off]	emakiattribute.debug	切换战斗调试模式，开启后控制台会输出详细的伤害计算日志
lint	/ea lint	emakiattribute.reload	检查所有配置文件的合法性，报告潜在问题

reload 是异步的

reload 不会阻塞主线程，重载过程中会逐步输出进度。完成后会告诉你加载了多少属性、多少伤害类型、多少档案。如果某个文件有问题，也会在这里报错。

权限节点

权限	默认	说明
emakiattribute.use	true	基础命令（help），所有玩家默认拥有
emakiattribute.reload	op	重载配置和 lint 检查
emakiattribute.resync	op	重新同步属性
emakiattribute.debug	op	preview、dump、debug 命令
emakiattribute.admin	op	超级权限，包含以上所有

权限继承

emakiattribute.admin 包含所有其他权限，给了这个就不需要再单独授予 reload、resync 等权限了。

Preview 槽位名称

preview 命令用来查看某个装备槽位上物品的属性快照，排查"为什么这件装备的属性没生效"之类的问题时很有用。

槽位	别名	说明
main_hand	mainhand、hand	主手
off_hand	offhand	副手
helmet	—	头盔
chestplate	chest	胸甲
leggings	legs	护腿
boots	—	靴子

用法示例：

/ea preview                    # 预览自己主手物品（默认槽位）
/ea preview main_hand          # 同上
/ea preview Steve helmet       # 预览 Steve 的头盔
/ea preview chestplate         # 预览自己的胸甲

Debug 调试模式

调试模式开启后，每次伤害计算都会在控制台输出完整的计算日志，包括攻击者/目标的属性快照、各阶段的计算值、暴击判定结果等。排查伤害数值不对的问题时非常有用。

操作	别名	说明
toggle	—	切换调试状态（默认操作）
on	enable、true	开启调试
off	disable、false	关闭调试

用法示例：

/ea debug                      # 切换自己的调试状态
/ea debug on                   # 开启自己的调试
/ea debug Steve off            # 关闭 Steve 的调试
/ea debug Steve                # 切换 Steve 的调试状态

注意性能影响

调试模式会在每次伤害计算时输出大量日志。如果服务器上有高频战斗（比如刷怪塔），控制台可能会被日志刷屏。建议只在排查问题时临时开启，用完记得关掉。

Lint 检查项

lint 命令会扫描所有配置文件，检查常见的配置错误。建议在修改配置后跑一次，比 reload 后发现问题再排查要高效得多。

检查区域	检查内容
主配置	default_damage_type 是否指向有效的伤害类型；allowed_damage_causes 中的伤害类型引用是否存在
属性定义	属性文件的格式和字段合法性
伤害类型	伤害类型文件的格式和阶段定义合法性
默认属性配置	档案文件的格式合法性
Lore 格式	Lore 格式文件的格式合法性
属性预设	预设文件的格式合法性
属性读取条件	条件文件的格式和引用合法性