Prop Hunt – Neo/Forge 1.21.1/1.20.1

The classic Prop Hunt gamemode for Minecraft!
Hide as blocks, hunt your friends, and enjoy chaotic, fast-paced matches on your server.

🧱 What is Prop Hunt?

Prop Hunt is a hide-and-seek minigame where players are split into two teams:

Props – Transform into blocks and hide in the map. Use your freeze ability to blend perfectly into the environment.
Hunters – Track down and eliminate all props before time runs out!

The mod is fully configurable and designed for servers, with support for custom blocks, custom weapons, and multiple maps.

⭐ Features

Block Transformation

Props can transform into any block, including custom player heads with NBT data.

Freeze System

Props can freeze in place to look like real blocks.

Fully configurable freeze duration, cooldown, and regen rate.

Custom Maps

Create unlimited maps.

Separate spawn points for Hunters and Props.

Hunter Loadout

Configure custom weapons and ammo for hunters.

Ammo is rewarded on each prop kill.

HUD Display

Real-time game information.

Freeze bar, team list, and game status.

Sound System

Props periodically whistle to help Hunters locate them.

Victory and defeat sounds at the end of the round.

Special Items

Prop Locator (Hunters) – Every minute, hunters receive an item that plays a sound on a random prop.
Decoy (Props) – Every minute, props receive an item that plays a decoy sound on a random prop (can be on themselves or another prop).

Fully Configurable

Game time, hide duration, minimum players, hunter ratio, freeze settings, sound intervals and more, all in a simple config file.

🚀 Quick Start Guide

1️⃣ Create a Map

Stand at the center of your arena.
Run: /prophunt create <mapname>

2️⃣ Set Spawn Points

Go to the Hunter spawn location and run: /prophunt sethunterspawn <mapname>
Go to the Prop spawn location and run: /prophunt setpropsspawn <mapname>

3️⃣ Add Prop Blocks

Props randomly transform into blocks from the map’s block list.

Hold a block in your hand (works with custom player heads too).
Run: /prophunt addblock <mapname> hand
Repeat for every block you want props to be able to use.

4️⃣ Configure Hunter Loadout

Hold the weapon you want hunters to receive, then run: /prophunt hunteraddweapon hand
Hold an ammo item (given to the player each time they kill a prop), then run: /prophunt addammo hand

5️⃣ Start a Game!

Start the game: /prophunt start <mapname>
Players have 60 seconds to join with: /prophunt join
The game starts automatically when the lobby timer ends (minimum 2 players).

📋 Commands Reference

🎮 Game Commands

/prophunt start <map> – OP – Start a game on the specified map
/prophunt stop – OP – Stop the current game
/prophunt join – All – Join the current game lobby
/prophunt leave – All – Leave the current game
/prophunt status – All – Show current game status
/prophunt testmode – OP – Start solo test mode as a Prop

🌍 Map Commands

/prophunt create <name> – OP – Create a new map at your location
/prophunt maps – All – List all available maps
/prophunt mapinfo <name> – All – Show detailed information about a map
/prophunt sethunterspawn <map> – OP – Set hunter spawn at your position
/prophunt setpropsspawn <map> – OP – Set props spawn at your position
/prophunt addblock <map> hand – All – Add held block to the map’s prop list
/prophunt showblock <map> – All – Show all prop blocks configured for a map
/prophunt clearblock <map> – OP – Remove all blocks from a map

🔫 Hunter Loadout Commands

/prophunt hunteraddweapon hand – OP – Add held item as a hunter weapon
/prophunt addammo hand – OP – Add held item as ammo (given on kills)
/prophunt hunterloadout – All – Show current hunter loadout
/prophunt clearloadout – OP – Clear all hunter loadout items

🧱 Prop Commands (In-Game)

/prophunt transform – Transform into a nearby block
/prophunt transform hand – Transform into the held block (debug)
/prophunt transform <block> – Transform into a specific block
/prophunt revert – Revert transformation

⚙️ Configuration

All main settings are in: config/prophunt-common.toml

[freeze]
# Maximum freeze time in seconds (5-120)
maxFreezeTime = 30

# Cooldown after freeze is exhausted (5-120)
freezeCooldown = 30

# Freeze regeneration speed (0 = no regen, 2 = 2x faster)
freezeRegenRate = 2

[sound]
# Interval between prop whistles in seconds (10-120)
propSoundInterval = 30

[game]
# Hide phase duration in seconds (10-120)
hidePhaseTime = 30

# Total game time in seconds (60-1800)
gameTime = 300

# Minimum players to start (1-10)
minPlayers = 2

# Ratio of hunters (0.1-0.9, e.g., 0.33 = 1/3 hunters)
hunterRatio = 0.33

Everything from the freeze bar to the length of each phase is tweakable to match your server’s style.

⏱️ Game Phases

LOBBY – 60 seconds – Players join the game with /prophunt join.
HIDING – 30 seconds – Props hide and transform while hunters are blinded and frozen.
PLAYING – 5 minutes – Hunters search for props across the map.
ENDING – Winner is announced with a victory sound.

🏆 Win Conditions

Props Win – At least one prop survives until time runs out.

Hunters Win – All props are eliminated before the timer ends.

🧙 Prop Abilities

Freeze (Sneak)

Hold Shift to freeze in place.
While frozen, you look exactly like a regular block.
A freeze bar depletes while sneaking.
When it reaches 0, you enter cooldown before you can freeze again.
Freeze regenerates while you’re not sneaking.

Speed Boost

Props have permanent Speed II during the game.
Use it to escape when hunters get too close!

Decoy Item

Every minute, props receive a Decoy item.
Put it in your offhand to activate it.
Plays a fart sound on a random prop (including yourself).
Perfect for confusing hunters and baiting them away from your real position.

🎯 Hunter Abilities

Custom Loadout

Hunters receive the configured weapons at the start of the game.
They receive bonus ammo every time they kill a prop.

Prop Locator Item

Every minute, hunters receive a Prop Locator (compass).
Put it in your offhand to activate it.
Plays a loud sound at the location of a random prop.
Listen carefully to track hidden props!

💡 Tips

For Props

Choose blocks that naturally blend with the map.
Don’t move when hunters are nearby – freeze instead.
Use decoys to mislead hunters and start chases elsewhere.
When the whistle sound is about to trigger, be ready to move!

For Hunters

Listen closely for the periodic prop whistles.
Use the Prop Locator wisely – don’t waste the ping.
Check blocks that look slightly out of place.
Work together and communicate to cover more ground.

📦 Requirements

Minecraft: 1.21.1
NeoForge: 21.1.x
Side: Server-side (clients need the mod installed for HUD & visuals)

🛠️ Support

Found a bug? Want to suggest a new feature?
Please report issues and suggestions on the GitHub repository or on the CurseForge issue tracker.

[TACZ] Prop Hunt