HeadHunter
A lightweight, highly optimized, and robust custom head-hunting plugin for Minecraft servers. Perfect for server events, Easter egg hunts, or seasonal activities.
✨ Features
Custom Texture Support: Use any Minecraft texture URL directly from the configuration file for the head.
Progress Tracking: Real-time progress bar displayed seamlessly in the player's Action Bar.
Flexible Rewards: Support for custom item rewards (with CustomModelData, names, lore, and enchantments) or console command execution.
Interactive Setup: Quick registration and removal of target heads via simple in-game commands looking directly at the blocks.
Flat-file Storage: Individual player progress is saved efficiently in separate YAML files to prevent data corruption.
Built on KynosLib: Utilizes a custom utility library for streamlined performance and clean message handling.
Commands & Permissions
| Command | Description | Permission |
| :--- | :--- | :--- |
| /headhunter info | Displays plugin and developer information. | headhunter.player.info |
| /headhunter givehead [amount] | Obtains the special event heads to place. | headhunter.admin.givehead |
| /headhunter sethead | Registers the head you are looking at into the system. | headhunter.admin.sethead |
| /headhunter removehead | Unregisters and removes the head you are looking at. | headhunter.admin.removehead |
| /headhunter reloadconfig | Reloads the main config.yml file. | headhunter.admin.reloadconfig |
| /headhunter reloadheads | Reloads the heads.yml storage file. | headhunter.admin.reloadheads |
Installation
1. Drop HeadHunter.jar into your server's plugins folder.
2. Ensure you have KynosLib.jar installed as well (required core dependency).
3. Restart the server to generate the default configuration files.
4. Configure your custom texture URL and rewards in config.yml.
5. Enjoy your hunt!
A lightweight, highly optimized, and robust custom head-hunting plugin for Minecraft servers. Perfect for server events, Easter egg hunts, or seasonal activities.
✨ Features
Custom Texture Support: Use any Minecraft texture URL directly from the configuration file for the head.
Progress Tracking: Real-time progress bar displayed seamlessly in the player's Action Bar.
Flexible Rewards: Support for custom item rewards (with CustomModelData, names, lore, and enchantments) or console command execution.
Interactive Setup: Quick registration and removal of target heads via simple in-game commands looking directly at the blocks.
Flat-file Storage: Individual player progress is saved efficiently in separate YAML files to prevent data corruption.
Built on KynosLib: Utilizes a custom utility library for streamlined performance and clean message handling.
Commands & Permissions
| Command | Description | Permission |
| :--- | :--- | :--- |
| /headhunter info | Displays plugin and developer information. | headhunter.player.info |
| /headhunter givehead [amount] | Obtains the special event heads to place. | headhunter.admin.givehead |
| /headhunter sethead | Registers the head you are looking at into the system. | headhunter.admin.sethead |
| /headhunter removehead | Unregisters and removes the head you are looking at. | headhunter.admin.removehead |
| /headhunter reloadconfig | Reloads the main config.yml file. | headhunter.admin.reloadconfig |
| /headhunter reloadheads | Reloads the heads.yml storage file. | headhunter.admin.reloadheads |
Installation
1. Drop HeadHunter.jar into your server's plugins folder.
2. Ensure you have KynosLib.jar installed as well (required core dependency).
3. Restart the server to generate the default configuration files.
4. Configure your custom texture URL and rewards in config.yml.
5. Enjoy your hunt!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Kynos - HeadHunters is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 14 times (via Spigot). Download it and open it directly in the game.