Skip to main content
Powerups are floating items you place around an arena. A player walks into one to grab it and gets an effect or a special item. They make rounds less predictable and give runners a way to fight back.

​
How they work

  • You place powerups per arena while standing where each should float.
  • During a round they bob in place. Heads with a custom texture also spin.
  • A player grabs one by getting close to it. After pickup it disappears and respawns on a timer.
  • Pickup can play a sound and spawn particles.

​
Placing a powerup

Stand where you want it to float, then run: 
/hotpotato arena addpowerup <arena> <type>
Remove one by its list index: 
/hotpotato arena listpowerups <arena>
/hotpotato arena removepowerup <arena> <index>

​
Built-in powerups

speed

Speed for a few seconds. common

jump

High jump for a few seconds. common
Effects only ever help with movement or vision. Combat damage is off during a game, so damage-based powerups would do nothing. That is why the rod and stick apply blindness and knockback instead of harm.

​
Random spawns and rarity

By default each spawn point ignores the exact type you placed and rolls a random powerup every time it respawns, weighted by rarity.
  • Rarity tiers are common, rare, and unique.
  • The weight for each tier is set in config.yml under powerups.rarities.
  • Weights are relative, not percentages. A higher weight shows up more often. A weight of 0 never spawns.
  • The weight applies per type, so a tier with more types in it takes a bigger combined share.
To make every spawn point always show the exact type you placed instead, set powerups.random-selection: false.

​
Tuning powerups

The catalog lives in powerups.yml. Pickup distance, bob height, spin speed, and the floating name tags are tuned in config.yml under powerups.
After editing, run /hotpotato reload to apply changes to live games without a restart.