EmakiAttribute Changelog

[1.8.0] - 2026-03-31

New Features

Attribute Damage Action System

• Added the AttributeActions registry for managing the registration and unregistration of attribute-related actions.
• Added the AttributeDamageAction action, supporting the infliction of custom damage based on attributes within the action system.
• Action Parameters:
  • amount (required): Base damage value.
  • type (optional): Damage type ID, defaults to the type configured in settings.
  • cause (optional): Damage cause, defaults to CUSTOM.
• Automatically integrated into the EmakiCoreLib action registration system, supporting templated configuration and conditional execution.

Combat Feedback Enhancement

• Added a synthetic impact feedback system to enhance visual and auditory feedback after EA (EmakiAttribute) damage settlement.
• Mob entities will automatically have their aggression target set (applyAggroTarget) after taking EA damage.
  • Automatically activates the Mob's aware and aggressive states.
  • Sets the attacker as the target, improving combat AI response.
• Improved impact animation handling (playSyntheticImpact).
  • Unified the logic for playing impact animations.
  • Supports playing custom hurt sounds.
  • Ensures visual feedback is closer to vanilla Minecraft's performance.

Configuration Changes

Configuration Version Upgrade

• Configuration version upgraded from 1.1 to 1.2.

New Configuration Options

• synthetic_hit_feedback.knockback: Whether to enable synthetic knockback effect (default: true).
• synthetic_hit_feedback.knockback_strength: Knockback strength (default: 0.4).
• synthetic_hit_feedback.hurt_sound: Whether to play hurt sound (default: true).

Code Improvements

EmakiAttributePlugin

• Added the registerCoreLibActions() method to register attribute actions when the plugin loads.
• Added the unregisterCoreLibActions() method to unregister attribute actions when the plugin unloads.
• Improved lifecycle management to ensure proper initialization and cleanup of the action system.

DamageCalculationService

• Added the applyAggroTarget() method to handle Mob aggression target setting.
• Refactored the applyDirectDamage() method, extracting impact animation logic.
• Added the playSyntheticImpact() method to uniformly handle impact animations and sounds.
• Improved the damage application process, enhancing combat feedback.

AttributeConfig

• Added the syntheticHitKnockback field.
• Added the syntheticHitKnockbackStrength field.
• Added the syntheticHitHurtSound field.
• Updated configuration parsing logic to support the new impact feedback settings.

Usage Notes

Action System Integration

• Ensure EmakiCoreLib version ≥ 1.11.0.
• Attribute actions are automatically registered when the plugin loads; no manual configuration is needed.
• The action ID is attributedamage and can be used in action templates.

Combat Feedback Configuration

• New configuration items use default values; old configuration files do not require modification.
• If you need to customize impact feedback, add the synthetic_hit_feedback section in config.yml.
• Recommended range for knockback strength: 0.1 - 1.0.

Compatibility

• Deeply integrated with EmakiCoreLib 1.11.0.
• Maintains backward compatibility with older configuration file versions.
• New features are optional and do not affect the existing combat system.

Known Issues

• None