> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/mythic-trials/commands-and-permissions.md).

# Commands & permissions

## Admin commands

Require `tcpmt.admin` (default: op).

| Command                                            | Description                                                                          |
| -------------------------------------------------- | ------------------------------------------------------------------------------------ |
| `/tcpmt help`                                      | Command reference                                                                    |
| `/tcpmt menu`                                      | Open the admin menu (player only; alias: `gui`)                                      |
| `/tcpmt reload`                                    | Reload every config file + `messages.yml`                                            |
| `/tcpmt tier <player> [chamber]`                   | Show a player's tier (omit chamber = the one the player is standing in)              |
| `/tcpmt tier set <player> [chamber\|all] <tier>`   | Set a player's tier (e.g. `T8`, `M2`); `all` = every registered chamber at once      |
| `/tcpmt season`                                    | Show the active season                                                               |
| `/tcpmt season set <id>`                           | Force a season active (override)                                                     |
| `/tcpmt season clear`                              | Clear the override, revert to the calendar                                           |
| `/tcpmt leaderboard [chamber]`                     | Top players (alias: `lb`; omit chamber = the one you're standing in)                 |
| `/tcpmt mob list`                                  | List authored mob templates (see [Mob Editor](/plugins/mythic-trials/mob-editor.md)) |
| `/tcpmt mob spawn <id>`                            | Spawn a template at your feet, re-dressed (debug; bypasses assignments)              |
| `/tcpmt boss list`                                 | List authored bosses                                                                 |
| `/tcpmt boss spawn [chamber]`                      | Run the boss spawn a chamber-clear would (debug; omit chamber = the one you're in)   |
| `/tcpmt update [check\|download\|restore\|status]` | Check for and install plugin updates (esmp.fun licences only)                        |

## Player commands

Require `tcpmt.use` (default: everyone).

| Command                          | Description                                                    |
| -------------------------------- | -------------------------------------------------------------- |
| `/tcpmt hud [auto\|on\|off]`     | Show or set your in-chamber HUD mode                           |
| `/tcpmt status`                  | Print the chamber you're in + current wave state               |
| `/tcpmt leaderboard [chamber]`   | Top players for a chamber (GUI in-game, chat from console)     |
| `/tcpmt leaderboard season [id]` | Season clear-count leaderboard (defaults to the active season) |

`auto` (default) shows the HUD only while inside a registered chamber at tier 2 or higher. `on` is reserved for a future always-show mode (behaves the same as `auto` today). `off` hides it everywhere.

Command aliases: `/mythictrials`, `/mt`.

### Notes

* **`/tcpmt update`** *(1.1.0+)* — checks esmp.fun for a newer build, authenticated with your licence key. Subcommands: `check` (default), `status`, `download` (verify + stage for the next restart), `restore` (roll back to the previous jar), and `ignore <version>` / `unignore <version>`. Behaviour is gated by `update.mode` in `config.yml` — in the default `notify` mode nothing downloads. Staged updates install on the next server restart. **Available for esmp.fun licences only**; copies from other stores get a pointer to their marketplace instead. See [config.yml → Updates](/plugins/mythic-trials/config-yml.md#updates).
* **`tier` / `tier set` / `leaderboard`** take the chamber name as an *optional* argument (0.1.2+). Omitted, it resolves by location: the **target player's** current chamber for `tier`/`tier set` (the player must be online for that), or **your own** for `leaderboard`. On servers with 100+ chambers this beats hunting down auto-generated names.
* **`tier set <player> all <tier>`** (0.1.3+) applies the tier to **every** registered chamber in one command — useful for seeding a starting rank or compensating a player.
* **`tier set`** accepts both online and offline players (offline resolved from the server's cached profiles — though resolving the chamber by location requires them online). Tier labels are `T1`–`T20` or `M1`–`M5`.
* **`leaderboard`** opens the GUI leaderboard for a player, or prints the top 10 to chat when run from console. `/tcpmt lb <chamber>` works too.
* **`reload`** re-reads `config.yml`, `tiers.yml`, `chambers.yml`, `seasons.yml`, `rewards.yml`, `custom-mobs.yml`, `tactics.yml`, `rooms.yml`, `my-mob-settings.yml`, and `messages.yml` without a restart.

## Permissions

| Permission    | Default  | Purpose                                                                                       |
| ------------- | -------- | --------------------------------------------------------------------------------------------- |
| `tcpmt.admin` | OP       | Every `/tcpmt` subcommand + the admin GUI                                                     |
| `tcpmt.use`   | everyone | Receive scaling + rewards in registered chambers; view leaderboards, own tier/status, and HUD |

`tcpmt.use` is mostly passive: it controls whether a player is scaled and rewarded inside chambers and whether PlaceholderAPI returns their per-player tier placeholders. It also gates the read-only player commands (`hud`, `status`, `leaderboard`). Negate it for a player or group to exclude them from the progression system entirely.

***

Next: [**The admin GUI →**](/plugins/mythic-trials/admin-gui.md)