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> ` – 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`) ```yaml # 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!