> ## Documentation Index > Fetch the complete documentation index at: https://hotpotato.arrowtan.cc/llms.txt > Use this file to discover all available pages before exploring further. # Powerups > Floating pickups that give players an edge during a round. 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. A floating HotPotato powerup with a custom textured head and a name hologram above it ## Placing a powerup Stand where you want it to float, then run: ``` /hotpotato arena addpowerup ``` Remove one by its list index: ``` /hotpotato arena listpowerups /hotpotato arena removepowerup ``` ## Built-in powerups Speed for a few seconds. common High jump for a few seconds. common Vanish for a few seconds. rare A rod that blinds the player you hit. Breaks after 3 hits. rare A stick that knocks players away on hit. Breaks after 1 hit. unique A blinded potato holder after being struck by the Blindness Wand 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`. * **icon** material, or a custom **head-texture**. * **name** and **lore** for the floating hologram. * **respawn delay** after a pickup. * **pickup sound** and **particle**. * **potion effects** applied on pickup. * **items** to give the player. * **commands** to run on pickup. After editing, run `/hotpotato reload` to apply changes to live games without a restart.