# \u2694\ufe0f HeadHunter \u2013 Player Heads from Kills!<\/p>\n
**HeadHunter** adds a custom enchantment to your Paper server that gives a chance to drop a player’s head when you kill them.
\n\ud83c\udfaf The enchantment works on swords and axes and can be obtained through the **enchanting table** \u2013 no complex recipes!<\/p>\n
—<\/p>\n
## \ud83c\udf1f Features<\/p>\n
– \u2705 Custom **Headhunter** enchantment (levels I\u2013III)
\n– \u2705 Works in **offline mode** \u2013 heads always drop with correct name and cached skin
\n– \u2705 Obtainable via **enchanting table** \u2013 random chance during normal enchanting
\n– \u2705 Configurable **drop chance** (base + per level)
\n– \u2705 Flexible configuration (max level, table chance, XP cost dependency)
\n– \u2705 Admin commands (give enchanted item, reload config)
\n– \u2705 Lightweight \u2013 no dependencies, only Paper API 1.21.1 <\/p>\n
—<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the `.jar` file.
\n2. Place it into your server’s `plugins` folder (Paper 1.21.1).
\n3. Restart the server (or load the plugin with PlugMan).
\n4. Edit `config.yml` if needed.
\n5. Done! \ud83c\udf89<\/p>\n
—<\/p>\n
## \ud83c\udfae How to Play<\/p>\n
**For players:**
\nEnchant 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\u2013III). <\/p>\n
When you kill another player with a Headhunter weapon, their head may drop \u2013 chance depends on enchantment level (default 5% + 5% per level).<\/p>\n
**For admins:** **Permissions:** (Default: operators only.)<\/p>\n —<\/p>\n ## \u2699\ufe0f Configuration (`config.yml`)<\/p>\n “`yaml # Maximum enchantment level (1-3) # Enchanting table settings # Debug mode (logs drop chances to console) \ud83d\udee0 Requirements Java: 21 or higher<\/p>\n Online\/Offline mode: both work fine \u2753 FAQ \u2753 Can I combine Headhunter books in an anvil? \u2753 Does it conflict with other enchantments? \u2753 Why does a head sometimes drop without a skin? \ud83d\udd2a Good luck!<\/p>\n","protected":false},"excerpt":{"rendered":" This project adds new enchantments<\/p>\n","protected":false},"featured_media":79932,"template":"","meta":{"_minecraft_slug":"headhunter-enchant","_minecraft_project_id":"mjdp9TDl","_minecraft_author":"Aenskiy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"headhunter-enchant.zip","_minecraft_size_bytes":10486,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:34:53.742666Z","_minecraft_date_created":"2026-03-31T00:41:51.745209Z","_minecraft_date_modified":"2026-03-31T00:11:00.287835Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/headhunter-enchant","_minecraft_icon_attachment_id":79932,"_minecraft_imported_at":"2026-06-04T14:33:28+00:00","_minecraft_import_hash":"0fd86a156a637f1105ca075a603be8fe","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,127,129,91],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-79931","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_category-storage","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/headhunter give
\n– `\/headhunter reload` \u2013 reloads the config without restart. <\/p>\n
\n– `headhunter.give` \u2013 access to give command.
\n– `headhunter.reload` \u2013 access to reload command. <\/p>\n
\n# Drop chance when killing (in percent)
\nchance:
\n base: 5.0 # for level 1
\n per-level: 5.0 # extra per additional level<\/p>\n
\nmax-level: 3<\/p>\n
\nenchant-table:
\n base-chance: 15.0 # chance to get Headhunter when enchanting
\n exp-for-max-level: 30 # XP levels required to get level III<\/p>\n
\ndebug: false
\nTweak numbers to balance your server.<\/p>\n
\nServer: Paper 1.21.1 (or any 1.21.1 Paper fork)<\/p>\n
\n“`<\/p>\n
\n\u2753 Do players see the enchantment in the enchanting table preview?
\nNo, only vanilla enchants are shown. After enchanting, the item will have a lore line \u201cHeadhunter I\/II\/III\u201d.<\/p>\n
\nIn the current version, combining works by transferring the enchantment from an item. Full anvil support can be added upon request.<\/p>\n
\nNo, Headhunter does not conflict with any vanilla enchantment.<\/p>\n
\nOn 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.<\/p>\n