Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Manhunt
A complete Minecraft Manhunt minigame for Paper servers: pick a runner, unleash the hunters, track them with a compass, and enjoy absurdly overpowered fishing loot that you can fully customize from an in-game GUI.
Everything is controlled by operators with simple commands. No setup, no extra dependencies, just drop the jar in your plugins folder.
Features at a glance
- Choose the runner and the hunters yourself, or let the plugin pick them at random
- Red runner, green hunters: colored name tags, tab list and chat names
- Hunter freeze: at the start, hunters are blind and frozen for 60 seconds (configurable) so the runner gets a head start
- Tracking compass for hunters, pointing to the runner's last known position (works in every dimension)
- Automatic win detection: the hunters win when the runner dies, the runner wins by killing the Ender Dragon
- Overpowered fishing: every catch gives powerful loot, from stacks of enchanted golden apples to god-tier netherite gear
- In-game GUI to view, add, edit and remove fishing loot, all saved to a file
- Lightweight, fully configurable, OP-only commands
Requirements
| Server software | Paper 1.21.x or newer |
| Java | 21 |
| Dependencies | None |
Installation
- Download
Manhunt.jarand put it in your server'spluginsfolder. - Restart the server.
- Done! Two files are created in
plugins/Manhunt/:config.ymlandfishing-loot.yml.
Quick start
/manhunt random <- random runner, everybody else becomes a hunter
/manhunt start <- the game begins!
Or choose the roles manually:
/manhunt runner Steve
/manhunt hunter Alex
/manhunt hunter Notch
/manhunt start
Commands
All commands are operator only.
| Command | Description |
|---|---|
/manhunt runner <player> |
Sets the hunted player. Their name turns red. |
/manhunt hunter <player> |
Adds a hunter. Their name turns green. |
/manhunt hunter all |
Adds every online player (except the runner and spectators) as a hunter. |
/manhunt remove <player> |
Removes a player from the game and resets their name color. |
/manhunt random |
Picks one random runner among the online players; everybody else becomes a hunter. Needs at least 2 players. |
/manhunt start |
Starts the game. A runner (online) and at least one hunter are required. |
/manhunt stop |
Stops the game and clears every role, color and compass. |
/manhunt status |
Shows the game state, the runner and the hunters. |
/manhunt fishing |
Opens the fishing loot GUI (players only). |
Roles cannot be changed while a game is running. Use /manhunt stop first.
How a game works
1. Roles and colors
The runner is shown in red and the hunters in green, on their name tags, in the tab list and in chat. Colors are applied as soon as a role is assigned and removed when the game ends or the player is removed. Players who reconnect keep their color.
2. Hunter freeze (head start)
When the game starts, every hunter is blind and frozen for 60 seconds (configurable) while the runner runs away.
During the freeze, hunters:
- cannot see anything (blindness)
- cannot walk or jump (they can still look around, and they fall normally if they were in the air)
- cannot break or place blocks, interact, or attack
- are invulnerable, so the runner cannot kill them while they are helpless
A countdown is shown above the hotbar for everyone involved. When the time is up, the hunters are released with a server-wide announcement. A hunter who disconnects and reconnects during the freeze stays blind until it ends.
Set hunter-freeze-seconds: 0 in the config to disable the freeze.
3. The tracking compass
Every hunter receives a Runner Tracker compass that points to the runner's last known position in the hunter's current dimension. Because it remembers the last known position per dimension, it keeps working after portal travel: if the runner went through a Nether portal, hunters in the Overworld are pointed to the portal location.
- It updates every second (configurable)
- It cannot be dropped
- It never drops on death
- Hunters get a new one when they respawn
4. Winning
| Event | Result |
|---|---|
| The runner dies | Hunters win |
| The runner kills the Ender Dragon | Runner wins (can be disabled in the config) |
When the game ends, a title is shown to every player, the result is broadcast, and everything is reset automatically (roles, colors, compasses).
Overpowered fishing
Every time a player catches something while fishing, the fish is replaced by loot from a customizable pool. It works for every player, at any time, even outside of a Manhunt game. It is designed to be completely over the top.
Default loot
Common drops
Enchanted golden apples, golden apples, totems of undying, ender pearls, diamond blocks, netherite ingots, TNT, end crystals, cooked beef, bottles o' enchanting, wind charges, firework rockets and arrows. All of them in big stacks.
Rare drops (announced to the whole server)
Unbreakable "God" gear with enchantment levels far beyond vanilla limits:
- God Sword: Sharpness 10, Fire Aspect 5, Looting 5, Sweeping Edge 5
- God Axe, God Pickaxe (Efficiency 10, Fortune 5)
- God Bow (Power 10), God Crossbow, God Trident (Impaling 10), God Mace (Density 10)
- Full netherite armor with Protection 10, plus Feather Falling 10, Soul Speed 5, Thorns 5 and more
- God Elytra and God Shield
Fishing loot GUI
Run /manhunt fishing to open a menu listing every item the fishing can give, with its weight and its drop chance in percent.
Adding items
- Click any item in your own inventory while the GUI is open, or drop an item onto the loot area with your cursor.
- The item is copied exactly as it is (enchantments, custom name, lore, amount) and is not consumed.
- New items are added with a weight of 10 on the last page.
Editing items
| Action | Effect |
|---|---|
| Left click | +1 weight (Shift: +10) |
| Right click | -1 weight (Shift: -10) |
F (swap hands) |
Toggle rare (rare drops are announced to the server) |
Q (drop) |
Remove the item from the loot |
Other buttons
- Arrows at the bottom to change page
- A hopper with instructions and totals (entries, total weight, page)
- A TNT button to restore the default loot (Shift+click to confirm)
The higher the weight, the more often an item drops. Everything is saved instantly to plugins/Manhunt/fishing-loot.yml, so your changes survive restarts. If you remove every item, fishing goes back to normal vanilla behavior.
Anything that is an item can be added, so you can build a pool of vanilla fish, custom named items, enchanted books, or anything else you like.
Configuration
plugins/Manhunt/config.yml
# The runner wins if he kills the Ender Dragon
runner-wins-on-dragon-kill: true
# How often (in ticks) hunters' compasses are refreshed. 20 = every second.
tracker-update-ticks: 20
# At the start of the game, hunters are frozen AND blind for this many seconds
# (the runner gets a head start). Set to 0 to disable.
hunter-freeze-seconds: 60
fishing:
# Overpowered loot every time a player catches something while fishing
enabled: true
# Number of items per catch (1 replaces the fish, extra ones go into the inventory)
items-per-catch: 1
# Announce rare drops to the whole server
broadcast-rare: true
Permissions
| Permission | Default | Description |
|---|---|---|
manhunt.admin |
OP | Access to the /manhunt command |
Commands are restricted to operators.
Good to know
- If the runner disconnects, the game keeps running and the compasses keep pointing to the last known position. Use
/manhunt stopto end the game. - Spectators are ignored by
/manhunt randomand/manhunt hunter all. - Hunters can respawn as many times as they want. Only the runner's death ends the game.
- Fishing loot also works with fishing enchantments and rods, since it triggers on every successful catch.
- Want fishing to be even crazier? Raise
fishing.items-per-catchto give several items per catch.


