> ## 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.

# Commands

> Every HotPotato command for players and admins.

The base command is `/hotpotato`, with the alias `/hp`. Running it with no arguments shows the help page.

<Frame caption="The /hotpotato help page, including the admin commands shown to operators.">
  <img src="https://mintcdn.com/zarrowtan/w7VKwbzoPhrocToj/images/help-command.png?fit=max&auto=format&n=w7VKwbzoPhrocToj&q=85&s=f56659331bce898b5df8ee66403a25e2" alt="HotPotato in-game help page listing player and admin commands" width="1001" height="389" data-path="images/help-command.png" />
</Frame>

<Tabs>
  <Tab title="Player" icon="user">
    These need `hotpotato.play`, which everyone has by default.

    | Command                   | What it does                                                  |
    | ------------------------- | ------------------------------------------------------------- |
    | `/hotpotato join <arena>` | Join the named arena.                                         |
    | `/hotpotato leave`        | Leave your current game.                                      |
    | `/hotpotato list`         | List arenas, their player counts, and whether they are ready. |
    | `/hotpotato help`         | Show the help page.                                           |
  </Tab>

  <Tab title="Admin" icon="user-shield">
    These need `hotpotato.admin`, which operators have by default.

    | Command                 | What it does                                                  |
    | ----------------------- | ------------------------------------------------------------- |
    | `/hotpotato reload`     | Reload config, language, and powerups. Applies to live games. |
    | `/hotpotato arena list` | Same as `/hotpotato list`.                                    |
  </Tab>
</Tabs>

## Arena setup

All arena setup runs as `/hotpotato arena <action> <arena> [value]`. For the location actions, stand where you want the point before running the command.

| Action          | Usage                            | What it does                                            |
| --------------- | -------------------------------- | ------------------------------------------------------- |
| `create`        | `create <arena>`                 | Create a new arena.                                     |
| `delete`        | `delete <arena>`                 | Delete an arena.                                        |
| `setlobby`      | `setlobby <arena>`               | Set the lobby spawn to your position.                   |
| `addspawn`      | `addspawn <arena>`               | Add a play spawn at your position.                      |
| `removespawn`   | `removespawn <arena> <index>`    | Remove the play spawn at that index.                    |
| `setspectator`  | `setspectator <arena>`           | Set the spectator spawn to your position.               |
| `setreturn`     | `setreturn <arena>`              | Set where players go after a game.                      |
| `setcorner1`    | `setcorner1 <arena>`             | Set the first [bounds](/features/arena-bounds) corner.  |
| `setcorner2`    | `setcorner2 <arena>`             | Set the second bounds corner.                           |
| `setmin`        | `setmin <arena> <number>`        | Minimum players to start.                               |
| `setmax`        | `setmax <arena> <number>`        | Maximum players.                                        |
| `setpotatoes`   | `setpotatoes <arena> <number>`   | How many potatoes per round.                            |
| `setroundtime`  | `setroundtime <arena> <seconds>` | Round length in seconds.                                |
| `addpowerup`    | `addpowerup <arena> <type>`      | Place a [powerup](/features/powerups) at your position. |
| `removepowerup` | `removepowerup <arena> <index>`  | Remove the powerup at that index.                       |
| `listpowerups`  | `listpowerups <arena>`           | List an arena's placed powerups.                        |
| `save`          | `save <arena>`                   | Save the arena and check it is playable.                |

<Tip>
  Run `save` after setup. If anything is missing or only one bounds corner is set, the message lists exactly what to fix.
</Tip>