This update addresses two major issues, significantly improving the plugin's user experience and functionality:

1. Attribute Message Customization System Optimization - Fixed combat message display issues and enhanced message configuration flexibility
2. Entity Equipment Attribute System Enhancement - Improved non-player entity equipment attribute support with new Paper 1.21.4 features

️ Main Update Content
1. Attribute Message Customization System Optimization
✅ Fixed Issues
Combat Message Display Anomalies

• Issue Description: When players have multiple attributes (e.g., physical attack + crit chance + vampire chance), normal attack messages would disappear, only showing other attribute messages
• Solution: Redesigned message trigger logic to ensure all message types display correctly

New Features
Fully Customizable Attribute Message System

• Flexible Configuration: All attribute messages can now be freely customized in configuration files
• Dynamic Updates: Configuration changes take effect after plugin reload without server restart
• New Attribute Support: When adding new attributes, simply add corresponding messages in config for automatic recognition

User Experience Improvements

• Clearer Message Logic:
  • Normal attacks display attack messages
  • Critical hits show crit messages (replacing normal attack messages)
  • Other attribute effects (like vampire, dodge) display independently without interference
• Simpler Configuration: Can remove unwanted messages and add new custom messages

2. Entity Equipment Attribute System Enhancement
✅ Fixed Issues
Non-Player Entity Equipment Attributes Not Working

• Issue Description: When equipping HUSK, ZOMBIE and other monsters with attribute LORE items, attributes wouldn't take effect
• Solution: Fixed a critical bug in attribute reading logic, ensuring all entity types can properly receive equipment attributes

New Features
Complete Paper 1.21.4 API Support

• Full Equipment Slot Support:
  • Supports standard 6 equipment slots (helmet, chestplate, leggings, boots, mainhand, offhand)
  • Added BODY slot support (for special entities like horses, wolves)
• Smart Equipment Detection:
  • Automatically validates if entities support specific equipment slots
  • Avoids invalid equipment checks, improving performance
• Optimized Caching System:
  • Improved equipment change detection mechanism
  • Enhanced attribute calculation performance

User Experience Improvements

• Broader Entity Support: Nearly all living entities can now gain attribute bonuses through equipment
• Special Entity Optimization: Body equipment for pets like horses and wolves also provides attributes
• Configuration Control: Can control entity equipment attribute functionality through config files

⚙️ Configuration Guide
Entity Equipment Attribute Control
Add the following configuration in attribute.yml:

attribute:
combat:
entity_equipment_attributes: true # Enable non-player entity equipment attributes

Message Customization Example
Customize any attribute messages in the message section of attribute.yml:

attribute:
message:
attack:
- "&fYou dealt {damage} physical damage to {entityB}!"
- "&fYou received {damage} physical damage from {entityA}!"
crit:
- "&eCritical Hit! You dealt {damage} critical damage to {entityB}!"
- "&eYou were critically hit by {entityA} for {damage} damage!"
dodge:
- "&aYou successfully dodged {entityB}'s attack!"
- "&a{entityA} dodged your attack!"

Server Requirements

• Recommended Version: Paper 1.21.4 or higher
• Minimum Version: Paper 1.20.1 (some new features require 1.21.4)

Usage Recommendations
1. Message Customization

• Can remove unwanted attribute message configurations; corresponding attributes won't show messages
• Supports color codes and PlaceholderAPI variables
• Recommend keeping messages concise to avoid spam

2. Entity Equipment Attributes

• Ensure equipment item LORE format meets plugin requirements
• Can equip any living entity with attribute items
• Particularly suitable for custom BOSS or pet systems

3. Performance Optimization

• When using equipment attributes on many entities, regularly clean up unnecessary entities
• Can disable entity equipment attribute functionality through config to improve performance

Update Highlights

1. More Complete Combat Experience: Message system now correctly displays all combat information
2. More Powerful Entity System: Non-player entities can enjoy the complete attribute system
3. More Flexible Configuration: All messages can be freely customized
4. Better Performance: Optimized attribute calculation and caching mechanisms
5. Broader Compatibility: Supports latest Paper API features