Bug Fixes

• Fixed an issue where players could right-click balloon entities causing leads to detach and duplicate
• Added comprehensive protection against lead detachment for all balloon cosmetics
• Fixed error messages related to "Entity not leashed" when interacting with balloons
• Improved the overall stability of balloon entity handling

Technical Improvements

• Added specialized event handling for balloon lead protection
• Enhanced error recovery for balloon cosmetics if leads are broken by external factors
• Optimized cleanup of orphaned lead entities

New Features

• Added: Camera overlay system for hats (camera_overlay component)
• First-person view effects for immersive cosmetic experience
• Custom overlay textures configurable in hats.yml

Technical Improvements

• Updated: Item model system from custom_model_data to Minecraft's new item_model namespaced key approach
• Better integration with newer Minecraft versions
• Support for resource pack developers using the newer format

Bug Fixes

• Fixed: Hat disappearing when inventory is full and equipping a new hat
• Properly handles hat swapping when inventory has no free slots
• Places the previously worn hat in the inventory slot where the new hat was

Configuration

• Updated: hats.yml to include overlay configuration options

Bug Fixes

• Cosmetics (backblings and balloons) disappearing after logging out and back in
• Cosmetics vanishing when teleporting, especially between worlds
• Issue where cosmetics would get stuck in place after teleporting while still rotating with player
• Problems with teleportation causing attachments to break

Improvements

• Enhanced: Player data saving system with improved error handling
• Enhanced: Teleportation handling for cosmetics with automatic detection and repair of broken attachments
• Added: Better logging for plugin debugging
• Improved: Overall stability for cosmetic entities
• Optimized: Entity recreation logic to minimize cosmetic issues

Technical Improvements

• Improved loading sequence that ensures saved cosmetics are loaded before visual entities are created
• Added robust error handling for data saving/loading
• Added logging to help track cosmetic persistence issues
• Completely overhauled teleportation handling to ensure cosmetics always follow players properly
• Added validation checks for entity relationships to auto-fix broken cosmetics
• Added proper cleanup on player disconnect to avoid entity leaking

---
This update focuses on stability and fixing reported issues with cosmetic persistence and teleportation. As always, please report any bugs in our Discord.

Major Changes

• Added new balloons feature
• Implemented a dedicated cosmetic inventory system accessible via /gc cosmetics or /gc inventory
• Players can now wear regular armor while using cosmetics

New Features

• Custom cosmetic inventory with dedicated slots for backblings and balloons
• Visual slot indicators using colored glass panes (blue for backblings, light blue for balloons)
• Persistent storage of cosmetics between server restarts and player logins

Technical Improvements

• UUID parameter naming consistency throughout codebase
• More efficient cosmetic validation system
• Fixed issues with cosmetics disappearing after player logout

Command Changes

• Added /gc cosmetics command to open the cosmetic inventory
• Added /gc inventory as an alias

How To Use

• Right-click with cosmetic items to equip them (unchanged behavior)
• Backblings and balloons now go to the cosmetic inventory instead of armor slots
• Hats still use the helmet slot for compatibility with existing plugins
• Use /gc cosmetics to view and manage your equipped cosmetics

This update makes GuppyCosmetics more compatible with survival gameplay by allowing players to wear their regular armor alongside cosmetic items.