> For the complete documentation index, see [llms.txt](https://darkstarworks.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://darkstarworks.gitbook.io/plugins/mc/mt-documentation/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/mc/mt-documentation/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)         |

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

`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

* **`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`, 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 |

`tcpmt.use` is passive — players don't run any command to "use" it. It controls whether they're scaled and rewarded inside chambers, and whether PlaceholderAPI returns their tier. Negate it for a player or group to exclude them from the progression system entirely.

***

Next: [**The admin GUI →**](/plugins/mc/mt-documentation/admin-gui.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://darkstarworks.gitbook.io/plugins/mc/mt-documentation/commands-and-permissions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
