# xHeadTurns v1.0.6 - The Interactive Update ✨ This update brings massive improvements to animations, hitboxes, and player interactions based on community feedback! ### 🚀 New Features * **Hover Animation (Bobbing):** Heads can now smoothly float up and down on the Y-axis. You can fully configure the speed and height of the hover effect. * **Multi-Axis 3D Rotation:** Replaced the simple rotation with full X, Y, and Z-axis rotation support. Combine `speed-x`, `speed-y`, and `speed-z` to make heads spin in any direction! * **Advanced Click Actions:** You can now bind different commands and messages to specific mouse clicks: * `RIGHT` (Right Click) * `LEFT` (Left Click / Punch) * `SHIFT_RIGHT` (Crouch + Right Click) * `SHIFT_LEFT` (Crouch + Left Click) * **New Default Presets:** Added 3 brand-new examples to `presets.yml` (Advanced NPC, Mystic Cube, Simple Head) so you can easily test the new features right out of the box. ### 🐛 Bug Fixes & Improvements * **Hitbox Fix (`clickable: HEAD`):** Fixed an issue where the click hitbox was generating from the bottom of the block, causing players to accidentally click the hologram instead of the head. The hitbox now perfectly wraps the visual head. --- **Note:** We recommend deleting your old `presets.yml` to let the plugin generate the new version with the updated examples!

# Changelog - xHeadTurns All news, fixes, and improvements for the project. ## [v1.0.5] - 2026-02-25 ### 🚀 New Features - **MiniMessage Support:** Holograms now support the modern Adventure format. - Gradients: `<gradient:#a7c7e7:#77dd77>Text</gradient>` - Rainbow: `<rainbow>Text</rainbow>` - Hex Colors: `<#FF0000>Text` - **Advanced Color System:** The background edit command (`/xhte ... background`) now accepts: - Names: `RED`, `BLUE`, `TRANSPARENT`. - RGB: `255,0,0` `10,0,30`. - Hexadecimal: `#FF0055`. - **Automatic Centering:** When creating or moving a head, it now automatically snaps to the **exact center** of the block (`x.5`, `z.5`) facing the player. ### 🐛 Bug Fixes - **CRITICAL: "Zombie" Fix:** Fixed an issue where heads and holograms would duplicate or become immortal upon reload/crash. - All entities now have `Persistent=false`. If the server crashes, Minecraft removes them automatically. - **Hologram Overlap Fix:** Inverted the hologram construction logic. - *Before:* Grew downwards, clipping into the head. - *Now:* Grows upwards from the base, always respecting the head's space. - **Rotation Fix:** Fixed a bug where heads lost their direction (Yaw/Pitch) upon server restart. Now saved correctly in `data.yml`. - **Command Fix:** Resolved `IndexOutOfBounds` error when using short aliases like `/xhtc` or `/xhte`. - **Detection Fix (Case Sensitivity):** The plugin now internally forces names to lowercase. It no longer matters if you type "Head" or "head"; the plugin will find it. ### ⚡ Technical Changes - **Data Migration:** Active heads are no longer saved in `config.yml`. - Implemented `data.yml` to handle active entity storage, separating logic configuration from save data. - **Animation Optimization:** Animation tasks now run on the main thread (`runTaskTimer`) safely to prevent desynchronization with the Bukkit API. ### 🗑️ Removed - Removed strict legacy color support in favor of the hybrid system (Legacy + MiniMessage). - Removed hardcoded messages in Java code; everything now responds to `messages/en.yml` and `es.yml`. --- > **xPlugins**

# 🛠️ Changelog v1.0.4 > This update completely rewrites the plugin core to provide total control over your floating heads. No more manual config editing—everything is now dynamic! ### 🌟 Main Features * **Advanced In-Game Editor:** Full control over every head property via commands. * `/xhte <name> head <scale|speed|rotate|pitch|texture>` * `/xhte <name> hologram <add|set|remove|clear|visible|background|offset>` * **Dynamic Holograms:** Full **PlaceholderAPI** support. Holograms now update based on the nearest player! * **Modern Color Support:** Native **HEX** and gradient support for holograms using Adventure API. * **Performance:** Optimized async tasks for rotations and animations to ensure 0 lag. ### 🚀 Technical Improvements * **Smart Interactions:** Clickable hitboxes now auto-scale with the head size. * **Language Support:** Completely updated English and Spanish message files. * **Maven Optimized:** Clean project structure for developers. --- **Developed by xPlugins x WillfryDev** *Join our Discord for support:* https://discord.gg/AH5k9YE78b

 ## We've added customizable particles. You can also change the head size and add server-specific holograms!