Skip to main content
1
An arena will not start. Why?The arena needs enough players and a complete setup. Run /hotpotato arena save <arena>, and the message lists anything missing, such as a spawn or a bounds corner. Also check that minimum players is at least the potato count plus the min-players-margin from config.yml.
2
My changes to config.yml did nothing.Run /hotpotato reload. Most settings, including powerup tuning, apply live. A few only take effect for new games. If a setting still seems ignored, check you edited the right key and that the file still parses as valid YAML.
3
Players are wandering off as spectators.Set a bounds box for the arena with setcorner1 and setcorner2. Any spectator who leaves the box is sent back to the spectator spawn. See arena bounds.
4
A powerup is showing a plain Steve head.That powerup has no custom head texture set, so it falls back to its icon material. Add a head-texture for the type in powerups.yml, or leave it on the material icon.
5
My placeholders show as raw text.Install PlaceholderAPI. HotPotato’s placeholders are only registered when it is present. See placeholders.
6
A picked-up powerup item disappeared.Make sure you are on a current build. The potato slot is set by potato-item.slot in config.yml. A picked-up item that would land in the potato slot is moved aside, not destroyed.
7
How do I turn off the usage metrics?Set metrics.bstats: false in config.yml. The plugin sends anonymous stats through bStats only when this is on.
8
Can I run this on Spigot, or do I need Paper?Either works. HotPotato runs on Spigot and Paper, Minecraft 1.18 and newer, on Java 17 or newer.

Still stuck? Head to Support.