> ## Documentation Index
> Fetch the complete documentation index at: https://pumpkings.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LiricTNT Admin Commands and Arena Management

> Full reference for all /tnt and /extras commands — permissions, tab-completion for template and instance names, and arena lifecycle management.

LiricTNT registers all of its commands through the Paper Brigadier API, which means every argument offers live tab-completion as you type. Template names, active instance names, and game type suggestions all auto-populate in the command bar — you never have to remember exact names from memory.

## /tnt Commands

All `/tnt` sub-commands require the `tnt.admin` permission node by default. Individual sub-commands carry their own child permissions (`tnt.admin.setup`, `tnt.admin.arena`, `tnt.admin.start`, `tnt.admin.stop`) so you can grant granular access if needed.

| Command                           | Permission        | Description                                                                                            |
| --------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------ |
| `/tnt help`                       | `tnt.admin`       | Display the visual help menu listing all available commands                                            |
| `/tnt setup lobby`                | `tnt.admin.setup` | Save your current position as the main lobby that players are sent to after a match                    |
| `/tnt setup waiting`              | `tnt.admin.setup` | Save your current position as the waiting spawn shown between events                                   |
| `/tnt arena create <name> <type>` | `tnt.admin.arena` | Register a new arena template from an existing `.slime` world file (`type`: `tag`, `run`, or `spleef`) |
| `/tnt arena addspawn <template>`  | `tnt.admin.arena` | Add your current location as a player spawn point to the named template                                |
| `/tnt iniciar <template>`         | `tnt.admin.start` | Clone the template's Slime world, join all unassigned online players, and start the match              |
| `/tnt detener <instance>`         | `tnt.admin`       | Force-stop a running instance, return all players to the waiting spawn, and destroy the cloned world   |
| `/tnt espectar <instance>`        | `tnt.admin`       | Enter an active arena as a spectator without joining the game                                          |
| `/tnt revivir <player>`           | `tnt.admin`       | Revive an eliminated player and return them to alive status inside the current game                    |
| `/tnt descalificar <player>`      | `tnt.admin`       | Permanently disqualify a player from the event — they cannot rejoin even if revived                    |
| `/tnt reload`                     | `tnt.admin`       | Reload `config.yml`, `arena.yml`, and the scoreboard manager without restarting the server             |

<Note>
  The `<instance>` arguments in `/tnt detener` and `/tnt espectar` tab-complete with the names of **currently running** arena instances, not templates. An instance name looks like `Endercon_1715000000` — a timestamped clone of the original template.
</Note>

### Arena Lifecycle Example

```bash theme={null}
# 1. Register the Slime world as a tag template
/tnt arena create Endercon tag

# 2. Walk to each spawn and add it
/tnt arena addspawn Endercon

# 3. Start the event — clones the world and starts the game
/tnt iniciar Endercon

# 4. Force-stop if needed (tab-completes instance names)
/tnt detener Endercon_1715000000
```

## /gm Command

The `/gm` command is a Folia-safe gamemode switcher designed for use during events. It works across threaded regions without scheduling issues.

**Permission:** `tnt.gamemode`

```bash theme={null}
/gm <mode> [player]
```

The `<mode>` argument accepts both numeric shortcuts and full names:

| Value                    | Gamemode  |
| ------------------------ | --------- |
| `0` / `survival` / `s`   | Survival  |
| `1` / `creative` / `c`   | Creative  |
| `2` / `adventure` / `a`  | Adventure |
| `3` / `spectator` / `sp` | Spectator |

If you omit `[player]`, the command applies to yourself. Provide a player name to change someone else's gamemode. The command also registers the `/gamemode` alias.

## /extras Commands

The `/extras` command group gives operators real-time control over match dynamics. All sub-commands require the `tnt.admin.extras` permission.

### Applying Potion Effects

Apply a potion effect to every currently alive player in the active arena:

```bash theme={null}
/extras efecto <effect> <level>
```

| Effect       | Description                                                     |
| ------------ | --------------------------------------------------------------- |
| `Speed`      | Speed potion — lower level values are safer for competitive use |
| `Slowness`   | Slowness potion — use to balance a match or create a challenge  |
| `Jump`       | Jump Boost potion                                               |
| `Blindness`  | Blindness potion — dramatic effect for short bursts             |
| `Levitation` | Levitation potion — launches players upward                     |

`<level>` accepts values from `1` to `10`. Higher levels produce extreme effects — use with caution.

### Triggering Events

Trigger a special event in the active arena:

```bash theme={null}
/extras evento <type>
```

| Event      | Duration         | Description                                                                               |
| ---------- | ---------------- | ----------------------------------------------------------------------------------------- |
| `Lava`     | 15 s             | Converts the blocks beneath moving players to lava                                        |
| `Tornado`  | 15 s             | A moving vortex roams the arena, launching players and destroying blocks                  |
| `Tormenta` | 20 s             | Lightning storm; flame circles appear on the ground to telegraph where strikes will land  |
| `Yunques`  | 15 s             | Anvils rain from the sky with smoke shadow warnings on the ground below each impact point |
| `Geoffrey` | Until match ends | Spawns a custom boss entity inside the arena                                              |

See the [Special Events](/tnt/admin/events) page for a full breakdown of each event's behavior.

<Tip>
  You can chain `/extras efecto` and `/extras evento` during the same match. For example, trigger the `Tornado` event and then immediately apply `Levitation 3` to keep airborne players in danger longer.
</Tip>