HeadHunting - Head Hunting system v1.13.0

What's New ​

In-game Mob Loot Editor

• Added a full in-game loot editor for mob loot profiles.
• You can now create, edit, save, and reset mob loot without manually editing the config files.
• Supports custom loot overrides for editable mob types directly from the GUI.

Native Mob Stacking Rewrite

• Reworked native mob stack kill handling so SINGLE mode now removes exactly one mob per lethal hit.
• Reworked WHOLE mode so killing a full native stack now correctly rewards the full stack amount.
• Heads, mob loot, currency, contracts, and progression now use proper per-system stack accounting instead of all sharing the same old logic.
• Whole-stack damage causes from stacker.yml still work correctly, such as VOID.

Whole-stack Loot + Head Support

• Native WHOLE mode now drops the correct amount of mob heads for the full stack.
• Custom loot-editor drops now reroll correctly across the whole stack.
• Vanilla mob loot is also scaled correctly for native whole-stack kills.
• Native whole-stack kills now also scale vanilla mob XP correctly.

Version Update

• Updated the plugin version to v1.13.0.

How To Use ​

Mob loot editor

1. Open the admin GUI with /hh admin.
2. Open the Mob Loot Editor.
3. Select the mob you want to edit.
4. Add or change the loot items, amount range, and chance.
5. Save the loot profile to apply the custom override.
6. Use reset if you want to go back to the default loot behavior.

Native stack kill modes

1. Use /hh stacker mode single if you want one kill to remove only one mob from a stack.
2. Use /hh stacker mode whole if you want one kill to remove the full native stack.
3. Use /hh stacker info while looking at a stacked mob or tracked spawner to check current stack data.
4. Use /hh stacker set <amount> while looking at a stacked mob if you want to quickly test a specific stack size.

Important Notes ​

• These changes target the plugin's native mob stacking system.
• In SINGLE mode, one lethal hit should now leave the remaining stack alive.
• In WHOLE mode, the full native stack should now pay out proper heads, loot, and XP for the entire stack.
• External stacker plugins keep using their own hook integrations.

Update Steps ​

1. Replace your old HeadHunting2.jar with the new v1.13.0 build.
2. Restart the server or fully reload the plugin.
3. Test /hh stacker mode single on a large native stack.
4. Test /hh stacker mode whole on a large native stack.
5. Open the loot editor once and confirm you can save and reset a mob loot profile correctly.

New Features​

• Added a fully native Mob Stacker system
• Added a fully native Spawner Stacker system
• Added configurable Mob AI for stacked mobs
• Added Silk Touch requirement for mining tracked spawners
• Added crouch-break support to break an entire stacked spawner at once
• Added spawner stack holograms
• Added configurable hologram radiusfor:
  • spawner holograms
  • stacked mob holograms
• Added configurable spawner spawn-condition overrides
  • disable grass requirement
  • disable light requirement
  • keep player-range / air / solid-ground checks configurable
• Added public API methods for spawner counts
• Added tracked spawner update events for external integrations
• Added PlaceholderAPI placeholders for spawner totals
• Added SaberFactions support for faction-based spawner counting

Improvements​

• Native stacking now works without requiring any stacker plugin
• External stacker plugins remain soft-supported
• Spawner stack size now persists properly in the database
• Spawner items preserve their tracked data more reliably
• Improved placement handling for custom tracked spawners
• Improved hologram lifecycle handling on reload, restart, and chunk load/unload
• Improved support for leaderboard-style integrations for factions / skyblock plugins

🛠 Fixes​

• Fixed custom spawners placing as plain vanilla spawners
• Fixed native spawner handling when external stacker plugins are not installed
• Fixed stacked spawner mining and item-return behavior
• Fixed stacked mob display behavior with the new hologram system
• Fixed stacked mobs with AI disabled so they can still be pushed and knocked back
• Fixed spawner level config fallback so global level multipliers apply correctly

New Placeholders​

• %headhunt2_spawners_owned%
• %headhunt2_spawner_stacks_owned%
• %headhunt2_chunk_spawners%
• %headhunt2_chunk_spawner_stacks%
• %headhunt2_total_spawners%
• %headhunt2_total_spawner_stacks%
• %headhunt2_faction_name%
• %headhunt2_faction_spawners%
• %headhunt2_faction_spawner_stacks%

Notes​

• This update focuses heavily on native spawner systems, stacking, holograms, and leaderboard integration support
• More direct hooks for additional factions / skyblock plugins can now be added much more easily on top of the new API layer

Important Update Note​

To make sure the new settings load properly, delete these old generated config files before starting the new version:

• plugins/HeadHunting2/config.yml
• plugins/HeadHunting2/spawners.yml
• plugins/HeadHunting2/stacker.yml

What's New
Player head balance cap

• Added a new config option: settings.player-head-balance-cap.
• Default cap is set to 10,000,000.
• Player head value now uses the victim's balance up to that cap before applying player-head-balance-percent.

Current behavior

• Example: if a player has 50,000,000, their head value will still only calculate from 10,000,000.
• The existing minimum fallback still works through player-head-min-value.
• Setting player-head-balance-cap: 0 disables the cap completely.

Important note

• This change applies to newly dropped player heads.
• Existing player heads keep the sell value that was stored on them when they were created.

Update Steps
1. Replace your old HeadHunting2.jar with the new build.
2. Make sure your config.yml contains player-head-balance-cap: 10000000.0 under settings.
3. Restart the server fully.

What's Fixed
** Spawner Config Reload**

• Fixed removed spawner types and levels in spawners.yml being re-added after /hh reload.
• You can now safely remove any spawner entry or level entry and it will stay removed on reload.

Update Steps
1. Replace the old HeadHunting2.jar with the new build.
2. Keep your existing config files — your edits will be preserved.
3. Restart the server fully.

What's Fixed
Config Overwrite on Reload

• Fixed plugin overwriting manual config edits when running /hh reload.
• Entries you remove from required-heads in levels.yml now stay removed after reload.
• This applies to all config files — any manual edits you make are now fully preserved.
• New config keys from future plugin updates will still be added automatically.

Fall Damage Heads

• Fixed settings.fall-damage-heads not working correctly.
• Heads now properly drop for player-caused fall kills when the setting is enabled.

Spawner Shop

• Fixed removed spawners being added back to the shop after restart or reload.
• Spawners with enabled: false are now properly hidden from the shop.

Update Steps
1. Replace the old HeadHunting2.jar with the new build.
2. Keep your existing config files — your edits will be preserved.
3. Restart the server fully.

What's Fixed
Fall Damage Heads

• Fixed settings.fall-damage-heads not working correctly.
• Heads now properly drop for player-caused fall kills when the setting is enabled.
• Heads can also drop from pure fall deaths when fall-damage-heads: true.
• If fall-damage-heads is disabled, those kills are blocked as expected.

Spawner Shop

• Fixed removed spawners being added back to the shop after restart or reload.
• Deleted entries in spawners.yml now stay removed instead of being restored by config merging.
• Spawners with enabled: false are now skipped by the shop, giving you a clean way to hide entries without deleting them.

Notes

• Your custom spawners.yml edits are now preserved properly.
• No manual migration is required beyond replacing the jar and restarting the server.

Update Steps
1. Replace the old HeadHunting2.jar with the new build.
2. Keep your existing config files.
3. Restart the server fully.

What's New
Environment Kills Support

• Want grinder setups to drop heads? Now they can!
• Server owners can configure drops.allow-environment-kills and drops.require-player-killer in config.yml.
• Works flawlessly with fall-damage-heads!

Dynamic Spawner Shop Lore

• "Head Value" and "Head XP" are no longer hardcoded in the Spawner Shop!
• Spawner lore is now completely customizable through guis/spawner-shop.yml.
• Added new show-head-value and show-head-xp config toggles to quickly hide those lines globally!
• Blank lines from empty placeholders are hidden smoothly.

Season Points Persistence

• Season points are now properly saved to the database across server restarts!
• Claimed premium and free tiers are correctly retained in the hh_season_progress and hh_players tables.
• Critical SQL Fix: Resolved a "no such column: tier" SQLiteException that occurred when servers tried to load or save a player's season progress.

Quality of Life & Bug Fixes

• Critical Crash Fix: Resolved a NullPointerException on newer Paper 1.21.4 servers where disabled messages would crash the player's connection during the system_chat packet encoding.
• Chat Spam Reduction: Fixed issue where the plugin would send blank/empty messages.
• Silenced Command Output: The default Spigot Usage: message no longer spams chat on successful commands.
• Config Auto-Merging: Missing configuration lines (like the season: block in messages_en.yml) are now automatically appended to your existing files, preventing errors.
• Fixed Head Textures: Corrected default base64 head textures for Sheep, Rabbit, and Piglin Brute.
• GUI Color Parsing: Fixed Spawner Shop GUI incorrectly parsing hex formatting codes like <#55ff55> for Required Level statuses.
• Tab Completer Update: The new /hh addseasonpoints administrative command now properly supports Tab Completion for player names!

Updating from previous versions:
1. Backup your HeadHunting2 folder (highly recommended).
2. Replace the old HeadHunting2.jar with the new version.
3. Your configurations will update automatically! Missing keys will be seamlessly merged into your configuration without wiping any of your custom settings.
4. Restart your server!

What's New
Head Drops Toggle

• Added a new /hh toggle command!
• Players can now easily enable or disable head drops from the mobs they kill.
• Great for players who don't want their inventories filled up with heads while grinding.
• Toggle state is securely saved per-player natively without any database requirements!

Shift + Right-Click Quick Sell

• Selling just got easier!
• Players holding heads can now simply look in the air and Shift + Right-Click to instantly sell all heads in their inventory.
• Looking at a block while sneaking will still maintain the vanilla behavior of placing the head.

Updating from previous versions:
1. Backup your HeadHunting2 folder.
2. Replace the old HeadHunting2.jar with the new version.
3. Add the following two lines to your messages/messages_en.yml under the heads: section:

Code:

yaml
     toggle-enabled: "&#2ECC71Head drops have been &#FFEB3Benabled&7!"
     toggle-disabled: "&#E74C3CHead drops have been &#FFEB3Bdisabled&7!"

4. Restart your server.
No database changes required — fully backward compatible!