New here? Start with Installation, then set up your first arena with the commands.
Quick facts
| Platform | Spigot or Paper, Minecraft 1.18 and newer |
| Java | 17 or newer |
| Price | Free |
| Soft dependency | PlaceholderAPI (optional) |
| Storage | YAML, SQLite, or MySQL |
| Languages | English and French out of the box |
How a match works
Players join the lobby
Players run/hotpotato join <arena> and wait in the arena lobby. When enough have joined, a countdown starts.A round begins
Some players are made the potato. Everyone else is a runner. A round timer counts down.Pass the potato
A potato holder hits a runner to pass it on. The runner becomes the potato; the holder becomes a runner.The timer ends
Anyone still holding a potato is eliminated and becomes a spectator. If more than one player is left, a new round starts.Someone wins
When one player remains, they win. Rewards run, stats are saved, and everyone is sent home.What you can configure
Look and feel
The potato item, the holder’s glow helmet, and the lobby leave item.
Timings
Round length, lobby size, countdown and transition timings, per arena.
Powerups
Floating pickups players grab during a round for an edge.
Rewards
Commands that run when a game ends, for winners or losers.
Messages
Every player-facing string, in your own language file.
Storage
Keep stats in YAML, SQLite, or a shared MySQL database.
Where to go next
Installation
Requirements, setup, and your first arena.
Game flow
Rounds, the potato, and spectators in detail.
Commands
Every player and admin command.
Configuration
A tour of the main config file.