命令与权限

EmakiAttribute 的主命令是 /emakiattribute，别名为 /eattribute、/ea。玩家通常不需要直接使用这些命令；管理员主要用它们重载配置、同步属性和排查战斗计算。

命令列表

命令	说明	权限
/ea help	输出命令帮助；不带任何参数时等效。	无（受 emakiattribute.use 约束）
/ea reload	重载配置、属性、条件、伤害类型等。	emakiattribute.reload 或 emakiattribute.admin
`/ea resync [player	all]`	同步自己、指定玩家或全部在线玩家的属性状态。
/ea preview [player] [slot]	预览指定玩家指定装备槽的属性贡献。	emakiattribute.debug 或 emakiattribute.admin
/ea dump [player] [sources [attribute]|json]	输出玩家属性快照与资源状态；可追加来源追踪或 JSON。	emakiattribute.debug 或 emakiattribute.admin
/ea debug [player] [toggle/on/off]	切换或设置战斗调试输出，也可转发 status/on/off/player/module。	emakiattribute.debug 或 emakiattribute.admin
/ea source <player> <attribute>	查看指定属性的逐条来源贡献与条件是否通过。	emakiattribute.debug 或 emakiattribute.admin
/ea trace last|list|export|clear <player>	查看、导出或清除玩家的伤害结算追踪记录。	emakiattribute.debug 或 emakiattribute.admin
/ea points view/open/add/reset ...	查看、打开 GUI、分配或重置自己的父级属性点。	emakiattribute.points 或 emakiattribute.admin
/ea points set/grant/setreset player amount	管理员设置可用属性点、发放属性点或设置重置点数。	emakiattribute.points.admin 或 emakiattribute.admin
/ea lint	检查配置引用、属性 ID、格式和条件配置。	emakiattribute.reload 或 emakiattribute.admin

权限节点

权限	默认	说明
emakiattribute.use	true	允许使用基础命令。
emakiattribute.reload	op	允许重载和配置检查。
emakiattribute.resync	op	允许同步属性。
emakiattribute.debug	op	允许查看调试信息。
emakiattribute.points	true	允许查看属性点、打开属性点 GUI、给自己分配或消耗重置点数重置。
emakiattribute.points.admin	op	允许查看/打开他人属性点、设置可用点数、发放点数、设置重置点数和免费重置。
emakiattribute.admin	op	管理员总权限。

先用哪个命令

场景	先执行	目的
修改了属性、伤害或条件配置	/ea lint，再 /ea reload	先发现配置问题，再重载。
玩家属性没有变化	/ea resync <player>	重新读取装备、PDC 和资源状态。
不确定装备贡献了什么属性	/ea preview <player> <slot>	查看单件装备的属性贡献。
某个属性数值来路不明	/ea source <player> <attribute>	逐条列出该属性的来源与条件结果。
战斗伤害不符合预期	/ea debug <player> on	查看阶段、暴击、防御、穿透和恢复。
需要复盘某一次伤害	/ea trace last <player>	查看最近一次伤害的分阶段结算记录。
玩家状态异常	/ea dump <player>	输出完整属性与资源状态。
玩家要加点或洗点	/ea points open / /ea points reset	打开父级属性点 GUI，或按重置点数规则重置。

常用操作示例

重载配置

/ea reload

修改 attributes/、conditions/、damage_types/、lore_formats/ 或语言文件后使用。改动涉及在线玩家当前装备时，重载后继续执行 resync。

同步全部在线玩家

/ea resync all

适合批量更新属性状态，例如调整了属性定义、默认值、装备解析规则之后。

预览手持装备属性

/ea preview Steve main_hand

常用槽位：

• main_hand
• off_hand
• helmet
• chestplate
• leggings
• boots

追踪属性来源

/ea source Steve physical_attack
/ea dump Steve sources physical_attack

逐条列出该属性的贡献值、来源类型和来源标签；条件未通过的贡献会额外标注。/ea dump <player> sources 省略属性 ID 时列出全部属性来源，/ea dump <player> json 额外输出 JSON 形式的来源追踪。

复盘一次伤害结算

/ea trace last Steve
/ea trace list Steve
/ea trace export Steve
/ea trace clear Steve

last 输出最近一次伤害的摘要与各阶段输入/输出，list 列出已记录的追踪摘要，export 以 JSON 输出最近一条记录，clear 清除该玩家的记录。

打开属性点 GUI 与分配点数

/ea points open
/ea points view
/ea points add strength 1

points add 只允许给自己已定义为 parent_attribute: true 的父级属性分配点数；可用点数不足、属性 ID 不存在或目标不是父级属性时会失败。控制台执行属性点命令时必须指定玩家。

管理员发放与重置属性点

/ea points grant Steve 5
/ea points set Steve 10
/ea points setreset Steve 1
/ea points reset Steve free

grant 增加可用属性点，set 直接设置可用属性点，setreset 设置玩家可消耗的重置点数；管理员对他人执行 reset 或附加 free 时不会消耗玩家重置点数。

打开战斗调试

/ea debug Steve on

用于排查伤害计算阶段、暴击、防御、穿透、资源变化等问题。生产服不建议长期开启大量玩家调试。