HeadHunter Enchant

⚔️ HeadHunter – Player Heads from Kills!

enchanting table 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 drop chance enchantment (levels I–III) - ✅ Works in drop chance – heads always drop with correct name and cached skin - ✅ Obtainable via drop chance – 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

Headhunter 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`)

```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!