Head Drop

• No more heads from cancelled deaths (revives, totems)
• Fixed head duplication when breaking/exploding placed heads
• give, reload, reset now have their own permissions (delegate without full OP)
• Fixed stats menu paging/sorting, %head_xp%, and false update alerts
• Added FastStats anonymous analytics (alongside bStats)
• Fixed a crash that could stop the plugin from loading at server startup on Folia

Breaking changes

• Now requires Minecraft 26.1+ and Java 25
• Stay on 2.8.2 if you are still running 1.21.x

New Features

• Native Folia 26.1+ support
• Precise PvE death detection : %head_killer% now shows Lava, Fall, Zombie, Creeper, etc. instead of Environment
• New placeholders : %head_death_cause% and %head_player_uuid%
• Added drop.max_per_player to limit head drops per player and the OP-only /head reset <player> command to reset the counter
• Custom name and lore are now preserved when a head is placed, broken or destroyed by an explosion
• New drop.banned_worlds option to disable head drops in specific worlds
• New commands.stats.enabled option to hide /head stats from tab-complete and reject the command
• /head reload is now usable from the console

Security & Bug fixes

• Anvil rename bypass patched : thanks to @baba0bab for reporting and providing the fix
• /head stats <page> now actually navigates to the requested page
• The stats menu now has working Previous / Next page buttons
• Player skins now load correctly in the stats menu
• Many smaller fixes across commands, listeners and the stats system

Core Improvements & Major Optimization

• Cleaner and clearer config.yml
• Lighter on RAM and CPU
• Full internal cleanup for easier maintenance

New Features

• Added new placeholders: %head_xp%, %head_weapon%, %head_id%
• Customizable date format and timezone in config.yml
• Improved particle system (multiple heads now support independent effects)

Core Improvements & Major Optimization

• Cleaner and simplified config.yml
• Improved config change detection for bStats
• Internal rework and global optimization contributed by @SpeastTV

placeholder bug fix

Compatibility & Bug Fixes

• Fixed Spigot compatibility issues for /head give (texture display) and /head stats
• Fixed an issue where the /head command was not displayed for non-OP players
• Improved overall stability and compatibility, including better effects management, some features, and now compiled with Java 21

Gameplay & Features

• Removed the option to control which dimensions allow head drops
• Removed the setting that allowed limiting how many heads players could drop
• Updated and improved the config.yml
• Updated /head help with more details
• The date/time for /head stats and the date placeholder is now displayed in UTC
• Added option to disable head drops when the player is invisible
• Reworked drop mode setting : replaced separate pvp and pve booleans with a single mode option that accepts pvp, pve, or all

Configuration & Structure

• Added an automatic version checker (configurable)
• Improved internal organization for better performance and easier configuration management
• Restricted /head give and /head reload commands to OP players only

• Updated for Minecraft 1.21.10 compatibility
• Improved head lore : added color support and multiline formatting
• Minor text updates and optimizations
• Fixed 3 bugs
• Added new placeholders :
  • %head_player% - Player’s name
  • %head_player_uuid% - Player’s UUID
  • %head_killer% - Killer’s name (or “Environment” if PvE)
  • %head_world% - World name
  • %head_coordinates% - Full coordinates (X, Y, Z)
  • %head_datetime% - Date and time (DD/MM/YYYY HH:MM:SS)

• The /head stats command has been changed to display only players present in the stats.json file, with improved text, global stats item, configurable filters and sorting, and the option of displaying the stats of a single player
• Optimized loading and caching of head textures at startup/reload for smoother display in /head stats
• New /head reset <player> command : resets a player's drop limit (if enabled)
• Correction of the /head listworlds command (to fix an earlier bug)
• New option to enable/disable renaming of heads in anvils
• Improved /head give : now allows you to give the head of any player, simply by using his nickname, even if that player has never been connected to the server. Usage : /head give <headName> <targetPlayer>
• Command permissions reviewed and improved

• Added new particle effects: upward, circle, cycle, pulse, wave, burst and spiral
• Added a configuration option to spawn a lightning bolt when a head is dropped (visual only, no damage)
• Added /head stats command with GUI displaying dropped heads per player
• Replaced welcome message with /head help
• Removed weapon_selector and related attributes
• Heads now drop in all worlds by default : per-world drops can be enabled/disabled via config.yml
• Added /head listworlds command to list all loaded worlds for easier setup
• Vanilla Minecraft colors can now be used for glowing effects (no fixed list required)
• Improved command messages and in-game feedback
• Minor bug fix

• General improvement of the plugin for simplified use
• Minor bug fixes
• Resolved an issue with the infinite parameter that caused the plugin to crash

• Added the /head give command, allowing OP players or players in creative mode to obtain player heads
• Added an error message triggered when a player with a full inventory uses the /head give command
• Improved statistics display in stats.json
• Two new parameters added : drop_pvp and drop_pve to control the head drop in these cases
• Added customization for the dropped heads based on the weapon type that caused the death
• Added a message when the head-drop limit is reached with broadcast_head_drop enabled

• Add custom glowing time for dropped heads
• Addition of an infinite parameter for glowing time and particle time
• Added all existing sounds and particles in minecraft vanilla applicable to dropped heads

• Introduction of new particle effects for heads when on the ground
• Implementation of the /head reload command to reload the config.yml file
• Customizable names and lore for dropped heads

• Introduced configurable options for message drop, despawn time, and drop rate

• Introduced particle effects on dropped heads
• Implemented a glowing effect on dropped heads with customizable colors
• Included three configurable variables to manage head drops in each dimension
• Created a stats.json file to log and track the number of player head drops
• Set a configurable limit on the maximum number of heads that can be dropped