Commands and Permissions
Commands
Root command: /emakiattribute (aliases /eattribute, /ea)
| Subcommand | Usage | Permission | Description |
|---|---|---|---|
help | /ea help | emakiattribute.use | Display help information |
reload | /ea reload | emakiattribute.reload | Asynchronously reload all config files, outputs load statistics on completion |
resync | /ea resync [player|all] | emakiattribute.resync | Re-sync attribute snapshots. No argument syncs yourself, all syncs all online players |
preview | /ea preview [player] [slot] | emakiattribute.debug | Preview the attribute snapshot of a specified player's item in a given slot |
dump | /ea dump [player] | emakiattribute.debug | Export a player's full combat attribute snapshot and resource state |
debug | /ea debug [player] [toggle|on|off] | emakiattribute.debug | Toggle combat debug mode; when enabled, outputs detailed damage calculation logs to console |
lint | /ea lint | emakiattribute.reload | Check all config files for validity and report potential issues |
reload Command
reload executes asynchronously and outputs progress messages during the reload process. On completion, it displays the number of loaded attributes, damage types, and profiles.
Permission Nodes
| Permission | Default | Description |
|---|---|---|
emakiattribute.use | true | Use basic commands (help) |
emakiattribute.reload | op | Reload configuration and run lint checks |
emakiattribute.resync | op | Re-sync attributes |
emakiattribute.debug | op | Use preview, dump, debug commands |
emakiattribute.admin | op | Admin permission, includes all above permissions |
Permission Inheritance
emakiattribute.admin is a super permission. Players with this permission can execute all commands without needing individual permission nodes.
Preview Slot Names
The preview command supports the following slot names:
| Slot | Aliases | Description |
|---|---|---|
main_hand | mainhand, hand | Main hand |
off_hand | offhand | Off hand |
helmet | — | Helmet |
chestplate | chest | Chestplate |
leggings | legs | Leggings |
boots | — | Boots |
Usage examples:
/ea preview # Preview your own main hand item
/ea preview main_hand # Preview your own main hand item
/ea preview Steve helmet # Preview Steve's helmet
/ea preview chestplate # Preview your own chestplateDebug Toggle Options
The debug command supports the following operations:
| Operation | Aliases | Description |
|---|---|---|
toggle | — | Toggle debug state (default operation) |
on | enable, true | Enable debug |
off | disable, false | Disable debug |
Usage examples:
/ea debug # Toggle your own debug state
/ea debug on # Enable your own debug
/ea debug Steve off # Disable Steve's debug
/ea debug Steve # Toggle Steve's debug stateDebug Mode Performance
Debug mode outputs a complete log for every damage calculation to the console, including attacker/target snapshots, stage calculation values, crit determination, etc. This may produce a large volume of log output in high-frequency combat scenarios. It is recommended to enable it only when troubleshooting issues.
Lint Check Items
The lint command checks the following configuration areas:
| Check Area | Description |
|---|---|
| Configuration | Whether default_damage_type points to a valid damage type; whether damage type references in allowed_damage_causes are valid |
| Attribute Definitions | Format and field validity of attribute files |
| Damage Types | Format and stage definition validity of damage type files |
| Default Attribute Config | Format validity of profile files |
| Lore Formats | Format validity of Lore format files |
| Attribute Presets | Format validity of preset files |
| Attribute Read Conditions | Format and reference validity of condition files |