HeadHunter Enchant

⚔️ HeadHunter – Player Heads from Kills!

HeadHunter adds a custom enchantment to your Paper server that gives a chance to drop a player's head when you kill them.
🎯 The enchantment works on swords and axes and can be obtained through the enchanting table – no complex recipes!

🌟 Features

• ✅ Custom Headhunter enchantment (levels I–III)
• ✅ Works in offline mode – heads always drop with correct name and cached skin
• ✅ Obtainable via enchanting table – random chance during normal enchanting
• ✅ Configurable drop chance (base + per level)
• ✅ Flexible configuration (max level, table chance, XP cost dependency)
• ✅ Admin commands (give enchanted item, reload config)
• ✅ Lightweight – no dependencies, only Paper API 1.21.1

📥 Installation

1. Download the .jar file.
2. Place it into your server's plugins folder (Paper 1.21.1).
3. Restart the server (or load the plugin with PlugMan).
4. Edit config.yml if needed.
5. Done! 🎉

🎮 How to Play

For players:
Enchant a sword or axe in an enchanting table. There is a chance (default 15%) that the item will receive Headhunter. The more XP levels you spend, the higher the max enchantment level (I–III).

When you kill another player with a Headhunter weapon, their head may drop – chance depends on enchantment level (default 5% + 5% per level).

For admins:

• /headhunter give <player> [level] – gives a diamond sword with Headhunter of the specified level.
• /headhunter reload – reloads the config without restart.

Permissions:

• headhunter.give – access to give command.
• headhunter.reload – access to reload command.

(Default: operators only.)

⚙️ Configuration (config.yml)

# Drop chance when killing (in percent)
chance:
  base: 5.0       # for level 1
  per-level: 5.0  # extra per additional level

# Maximum enchantment level (1-3)
max-level: 3

# Enchanting table settings
enchant-table:
  base-chance: 15.0      # chance to get Headhunter when enchanting
  exp-for-max-level: 30  # XP levels required to get level III

# Debug mode (logs drop chances to console)
debug: false
Tweak numbers to balance your server.

🛠 Requirements
Server: Paper 1.21.1 (or any 1.21.1 Paper fork)

Java: 21 or higher

Online/Offline mode: both work fine

❓ FAQ ❓ Do players see the enchantment in the enchanting table preview? No, only vanilla enchants are shown. After enchanting, the item will have a lore line "Headhunter I/II/III".

❓ Can I combine Headhunter books in an anvil? In the current version, combining works by transferring the enchantment from an item. Full anvil support can be added upon request.

❓ Does it conflict with other enchantments? No, Headhunter does not conflict with any vanilla enchantment.

❓ Why does a head sometimes drop without a skin? On offline-mode servers, the skin is loaded from cache if the player joined at least once with online-mode enabled. If no skin exists, the head will show a blank face but the owner name will be correct.

🔪 Good luck!