HeadHunting - Head Hunting system v1.13.0

HeadHunting 2.0 - Tracking & Bounty Update

---

What's New

Enhanced Mob Kill Tracking

• Universal Tracking: The %headhunt2_mobs_killed% placeholder now tracks ALL mob kills!
  • Naturally spawned mobs
  • Spawner mobs (from ANY player's spawner, not just yours)
  • Spawned-in mobs (eggs, commands, etc.)
  • Even locked mob types are tracked (rewards still require unlock)
• Perfect for leaderboards, quests, and player stats!

---

Bounty System Improvements

• Smart Currency Display: Bounty messages now show the correct currency format
  • "500 Souls" instead of "$500" for custom currencies
  • Proper formatting for all supported currencies (Vault, PlayerPoints, TokenManager, custom)
• Bounty Head Lore: When you kill a player with a bounty, their head shows all active bounties!
  
  Code:

  Active Bounties:
    • 500.00 Money
    • 100 Souls

• Broadcast Control: Toggle bounty placement/claim announcements in config.yml

---

Fixes

• Fixed mob kill tracking to work for ALL spawner kills (any player can trigger)
• Improved bounty currency formatting throughout the plugin
• Better multi-currency bounty support

---

Updating from previous versions:

1. Backup your HeadHunting2 folder
2. Replace the HeadHunting2.jar with the new version
3. Optional: Update 4 lines in messages/messages_en.yml for bounty currency formatting (see walkthrough)
4. Restart your server

No database changes required — fully backward compatible!

We've given HeadHunting 2.0 a massive facelift and added some highly requested features! This update brings a fresh new look, expanded contract options, and better tracking capabilities.

---

New Visual Style
The entire plugin has been re-styled with a modern, high-contrast theme:

• Vibrant Palette: Featuring Hot Pink (#FB5490), Gold (#FFD700), and Emerald Green (#2ECC71).
• Clean GUIs: All menus have been updated with consistent formatting, better readability, and a sleek dark mode aesthetic.
• Polished Messages: Chat messages now use the new color scheme for a premium feel.

---

Expanded Contracts System

• Custom Icons: Contracts can now have custom display icons defined in contracts.yml (e.g., NETHER_STAR for boss missions).
• New Missions: Added new Daily and Weekly contracts, including:
  • Witch Hunt: Kill witches.
  • Guardian Slayer: Hunt guardians.
  • Raid Captain: Defeat raid mobs.

---

New Tracking & Placeholders

• Mob Kill Tracking: The plugin now tracks your total mob kills and kills per mob type.
• New Placeholders: Show off your stats with PlaceholderAPI!
  • %headhunt2_mobs_killed%: Total mobs killed.
  • %headhunt2_mobs_killed_<mob>%: Kills for a specific mob (e.g., %headhunt2_mobs_killed_zombie%).

---

Fixes & Improvements

• Mission Progress: Fixed an issue where "kill any mob" or "sell any head" objectives weren't tracking correctly.
• Database Schema: Optimized database tables for better performance and new stat tracking.
• Stability: General code cleanup and stability improvements.

---

Updating from previous versions
IMPORTANT: This update includes major changes to GUIs and messages.

1. Backup your existing HeadHunting2 folder.
2. Delete the guis/ folder and messages/ folder to generate the new visual style.
3. Delete contracts.yml if you want the new default missions.
4. Replace the HeadHunting2.jar with the new version.
5. Start your server.

Changelog:

• Fixed PlaceholderAPI Support: Resolved an issue where placeholders using the %headhunting_%
  prefix (like %headhunting_heads_sold%
  ) were not parsing correctly.
• Expanded Identifier Support: You can now use both %headhunting_%
  AND %headhunt2_%
  identifiers for all placeholders.
• Backward Compatibility: Full support for the legacy headhunt2
  identifier has been retained, so you don't need to change your existing configurations!

Click to expand...

Updated Placeholders:

• %headhunting_level%
  / %headhunt2_level%
• %headhunting_xp%
  / %headhunt2_xp%
• %headhunting_next_xp%
  / %headhunt2_next_xp%
• %headhunting_heads_sold%
  / %headhunt2_heads_sold%
• %headhunting_title%
  / %headhunt2_title%
• %headhunting_currency_<id>%
  / %headhunt2_currency_<id>%

New Features Unified Currency System The currency engine has been completely overhauled!

• Universal Support: Mob drops, contracts, bounties, and the season pass now all utilize the same robust currency system.
• Custom Currencies: Seamlessly integrate Vault, PlayerPoints, TokenManager, or custom placeholders across the entire plugin.

Optimization & Cleanup

• Legacy Code Removal: We've cleaned up the codebase by removing the old currency manager, resulting in better performance and stability.
• Improved API: Developers can now access player balances and formatting more reliably.

Configuration Changes

File	Change
currencies.yml	Now serves as the master configuration for ALL currencies in the plugin.

Notes

• Build Fixed: Addressed compilation issues to ensure a smooth update process.
• This update finalizes the migration to the new currency architecture.

New Features
Season Pass / Battle Pass System

Brand new battle-pass style progression with free and premium reward tracks
Earn Season Points from selling heads, completing missions, and claiming bounties
5 customizable tiers with XP, money, and command rewards
Premium pass holders get 1.5x Season Points and exclusive rewards
Fully configurable via
season.yml
- add unlimited tiers with custom rewards
Permission-based premium access (headhunt2.season.premium)
Direct GUI Commands

/hh balance - Open balance GUI directly
/hh levels - View hunter levels
/hh shop - Access spawner shop
/hh bounties - Browse active bounties
/hh season - Open Season Pass GUI
/hh missions - Quick access to contracts
Admin Commands

/hh addseasonpoints <player> <amount> - Grant season points to players
Improvements
Unknown subcommands now display the help menu instead of an error
Added feature toggles in
config.yml
to enable/disable: Season Pass, Contracts, Perks, Spawner Shop, Levels
Improved tab completion for all new commands
Configuration
New
season.yml
for Season Pass configuration
New
guis/seasonpass.yml
for GUI customization
Added features section in
config.yml
for feature toggles

What’s New

• New Bounty System is now available
  Commands: /bounty, /bounties

Changes

• Seasonal feature has been removed