EmakiAttribute

[2.1.0] - 2026-04-08

Added

PDC Attribute Writing and Conditional Reading Interface

• Added PdcAttributeApi and registered it via Bukkit Services. External plugins can now write, read, and clear structured attribute payloads on items, grouped by source_id.
• Added PdcAttributeService, PdcAttributePayload, and PdcReadRule. This supports writing attribute values and meta data to an item's Persistent Data Container (PDC) and managing them grouped by source.
• Added a conditions/ directory and PdcReadRuleLoader. Rules can determine whether a group of PDC attributes takes effect based on conditions like player placeholders, source meta, and source attributes.
• Included two disabled example configurations by default: default_bind.yml and default_equipment_level.yml, making it easy to enable binding checks and equipment level requirements according to server rules.

Integration of MMOItems Combat Bridge into the Attribute Damage Chain

• MmoItemsBridge now listens for MMOItems main-hand/off-hand melee hits, projectile hits, and the SpecialWeaponAttackEvent.
• MMOItems hit events are uniformly rewritten into EmakiAttribute's damage calculation process, preventing conflicts where external weapon damage and the attribute system calculate separately.
• Projectiles record their source and a snapshot before entering Attribute's projectile damage resolution chain. Synthetic knockback can be optionally added post-calculation based on configuration.

Improvements & Optimizations

Item Snapshot Now Merges Lore and PDC Attributes

• AttributeSnapshotCollector now collects both Lore attributes and PDC attributes, generating a unified signature cache for the merged result.
• Equipped state snapshots support filtering PDC attributes based on the player's context. This allows rules like "equipment binding," "level requirements," and "source conditions" to directly affect the final combat attributes.
• Since read rules participate in signature generation, changes to equipment conditions will also trigger snapshot refreshes, reducing lingering attributes after a player logs in.

Placeholder and Lifecycle Cleanup

• Placeholder expansions have been standardized for attribute and resource queries. power now automatically maps to attribute_power.
• Resource placeholders now only retain explicit fields: current, max, default, bonus, percent.
• Added a PDC rule loading phase to the plugin's lifecycle. The conditions/ directory is refreshed during reloads.
• Command aliases have been adjusted from eattr / attr to eattribute / ea to reduce conflicts with other plugin commands.

Consolidation of Default Attribute Sets

• Removed default attribute definitions for skill_damage_bonus, skill_crit_rate, skill_crit_damage, and skill_cdr.
• Removed damage_types/skill.yml and the example debug attribute test_attribute.
• Corresponding default entries have been removed from attribute_balance.yml and profiles/global.yml to prevent new servers from inheriting the old skill attribute groupings.

Upgrade Notes

• If your equipment, loot, strengthening, or other modules still reference skill_damage_bonus, skill_crit_rate, skill_crit_damage, or skill_crit_damage, please migrate to your new attribute design before upgrading.
• External plugins that wish to write structured attributes to items should first obtain the PdcAttributeApi, register their own source_id, and then proceed with writing.
• Update old scripts calling /emakiattribute attr or /emakiattribute eattr to use eattribute or ea instead.
• After enabling MMOItems on your server, it is recommended to thoroughly retest melee, projectile, and special weapon attacks to ensure there is no double damage calculation or duplicate processing by old listeners.

Known Issues

• None