What is HeadHunter?

HeadHunter turns mob hunting into a full progression system. Kill mobs, collect heads, sell them for money & XP, level up, unlock powerful wearable Masks with unique enchantments. A complete gameplay loop your players will keep coming back to.


Why Choose HeadHunter?

• Deep Progression — A full leveling system tied to mob hunting, head selling, and money accumulation. Not just a head drop plugin.
• 45+ Custom Enchantments — Combat, defense, utility, mobility, immunities, and summons. Each with multiple configurable levels.
• Mask Crafting & Upgrades — Multi-tier wearable masks per mob type, forged from collected heads, granting real gameplay power.
• Economy Integration — Vault-powered selling, level-up costs, and spawner shop signs. Heads have real value on your server.
• 80+ Mob Head Textures — Every mob in the game has a custom skull texture included out of the box.
• Head Storage Blocks — Dedicated blocks where players bank their heads for progression and mask crafting.
• Sell Signs & Spawner Shops — In-world signs for selling heads and purchasing mob spawners.
• PlaceholderAPI Support — 10+ placeholders for scoreboards, holograms, tab lists, and more.
• Fully Configurable — Every feature, value, message, and behavior is driven by config files.
• Admin Panel — In-game GUI for managing players, masks, levels, enchantments, signs, rewards, and plugin game rules.

• Mob Head Drops — Every mob drops its head on death. Configurable drop rates per mob.
• Tiered Leveling System — Each level is tied to a mob type. Players collect and sell heads to earn XP, then pay money to level up. Configurable XP-per-head, sell values, level-up costs, and level-up messages.
• Mask System — Multi-tier wearable masks forged from collected heads. Each tier grants custom enchantment effects. Upgrades require stored heads and previous-tier masks.
• 45+ Custom Enchantments. All multi-level with configurable effects and cooldowns.
• Head Storage Blocks — Placeable blocks that store collected heads. Stored heads count toward masks and progression.
• Sell Heads — Sell by hand, via GUI, or through placeable Sell Signs. Earns money (Vault) and XP.
• Spawner Shop Signs — In-world signs for purchasing mob spawners at configured prices.
• Level-Up & Mask Rewards — Configurable rewards (messages + console commands) on level-up and mask creation/upgrade.
• PlaceholderAPI Integration — 10+ placeholders: level, next level, current mob, remaining heads, level-up cost, remaining money, and more.
• Admin Panel — In-game GUI for managing all plugin data: players, masks, levels, enchantments, signs, rewards, and plugin game rules.

Drop in the jar, have Vault + an economy plugin installed, and you're done. Heads drop, selling works, leveling is active immediately. Everything is covered in the wiki and all config files are fully commented.


Permissions

headhunter.sell-heads - Access /hh sellheads
headhunter.sell-heads.hand - Sell heads by hand (default: true)
headhunter.sell-heads.sign - Create/break sell heads signs
headhunter.sell-heads.sign.use - Use sell heads signs (default: true)
headhunter.spawner-sign - Create/break spawner shop signs
headhunter.head-storage-block - Manage head storage blocks
headhunter.head-storage-block.use - Use head storage blocks (default: true)
headhunter.masks - Access /hh masks
headhunter.masks.get - Get masks
headhunter.masks.give - Give masks to players
headhunter.heads - Access /hh heads
headhunter.heads.get - Get head data
headhunter.heads.set - Set head data
headhunter.heads.delete - Delete head data
headhunter.heads.give - Give heads to players
headhunter.stored - Access /hh stored
headhunter.stored.get - Get stored head data
headhunter.stored.set - Set stored head data
headhunter.stats - Access /hh stats
headhunter.level - Access /hh level
headhunter.level.get - Get level data
headhunter.level.set - Set player levels
headhunter.admin - Marks user as admin, Access to admin panel
headhunter.admin.masks - Admin mask management
headhunter.admin.rewards - Admin rewards management
headhunter.admin.rules - Admin rules management
headhunter.admin.player - Admin player management
headhunter.admin.custom-enchantments - Admin enchantment management
headhunter.admin.levels - Admin level management
headhunter.admin.signs - Admin signs management


Commands

/hh - Main command (alias: /headhunter)
/hh help - Show all available commands
/hh stats - Open your stats menu
/hh level - View your current level
/hh levelup - Level up when eligible
/hh sellheads - Sell heads from your hand
/hh masks - Open the masks menu
/hh headstorageblock - Manage head storage blocks
/hh heads - Admin head management
/hh stored - Admin stored heads management
/hh admin - Open the admin panel