Configuration Directory

EmakiAttribute configuration consists of the main config, attribute definitions, damage types, conditions, lore formats, and attribute balance data. Define a stable attribute naming convention before expanding damage types and equipment sources.

Default directory structure

plugins/EmakiAttribute/
├── config.yml
├── attribute_balance.yml
├── attributes/
├── damage_types/
├── conditions/
├── lore_formats/
├── lang/
└── data/

Path	Purpose
config.yml	Main config: default resources, damage interception, regeneration, scaling curves, and vanilla damage mappings.
attribute_balance.yml	Attribute score and balance parameters.
attributes/	Individual attribute definitions.
damage_types/	Damage pipelines, such as physical, projectile, and spell.
conditions/	Attribute conditions used by items or other modules.
lore_formats/	Attribute display format templates.
lang/	Language files.
data/	Runtime data; usually not edited manually.

Main config fields

Field	Description
version	Config version maintained by default resource sync.
language	Language file id.
hard_lock_damage	Whether unmapped vanilla damage is intercepted.
default_damage_type	Fallback damage type.
regen_interval_ticks	Resource regeneration interval.
sync_delay_ticks	Delay before syncing attributes to Bukkit.
default_profile	Default resources and attributes.
synthetic_hit_feedback	Knockback and hurt sound feedback after vanilla damage interception.
scaling_curves	Rules for diminishing returns after thresholds.
allowed_damage_causes	Bukkit DamageCause to attribute damage mappings.

Suggested edit order

1. Define attribute ids and display formats in attributes/.
2. Add default values to default_profile.
3. Configure damage pipelines in damage_types/.
4. Tune score weights in attribute_balance.yml.
5. Write attributes from equipment, gems, strengthening, forging, or item modules.
6. Use /ea lint to check configuration.
7. Use /ea preview or /ea dump to verify final player attributes.