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

# Commands & Permissions

`/duel` has the aliases `/duels`, `/pduel` and `/ranked`.

## Players (`pinnaduels.use`, default: everyone)

| Command                             |                                                                   |
| ----------------------------------- | ----------------------------------------------------------------- |
| `/duel`                             | the duels menu                                                    |
| `/duel queue` (`q`)                 | join / leave the ranked queue (1 Duel Token)                      |
| `/duel <player>`                    | friendly duel invite                                              |
| `/duel accept` / `decline` (`deny`) | answer a friendly invite (or a match with `queue.require-accept`) |
| `/duel spectate [player]` (`spec`)  | watch that player's duel (no player = the live duels menu)        |
| `/duel active` (`list`)             | live duels menu                                                   |
| `/duel top`                         | ranked top menu                                                   |
| `/duel leagues` (`league`)          | leagues menu                                                      |
| `/duel stats [player]`              | stats in chat                                                     |
| `/duel leave`                       | leave the queue / stop spectating                                 |
| `/duel help`                        | the command list                                                  |

## Admins (`pinnaduels.admin`, default: op)

| Command                                                          |                                                                                                                       |
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `/duel admin reload`                                             | config.yml, messages.yml and the arenas                                                                               |
| `/duel admin info` / `arenas`                                    | live duels, queue, recordings, season / loaded arenas                                                                 |
| `/duel admin tokens <player> <amount>`                           | add (or with a negative amount remove) Duel Tokens                                                                    |
| `/duel admin nexttoken <player> <blocks>`                        | blocks left for their next token                                                                                      |
| `/duel admin elo <player> <value>`                               | set ELO (also completes placement so the league shows)                                                                |
| `/duel admin place` / `unplace <player>`                         | mark placement duels as done / start them over                                                                        |
| `/duel admin setstat <player> <wins\|losses\|draws\|streak> <n>` | set a stat                                                                                                            |
| `/duel admin reset <player>`                                     | starting ELO and empty stats (tokens kept)                                                                            |
| `/duel admin cooldowns <player>`                                 | clear queue lockout, friendly cooldown and daily rival limits                                                         |
| `/duel admin practice [player] [arena]`                          | solo duel against an empty side, nothing counts                                                                       |
| `/duel admin match <p1> <p2> [ranked\|friendly] [arena]`         | start a duel right away, no tokens or queue                                                                           |
| `/duel admin replays [player]`                                   | newest recordings with clickable \[PLAY] \[WATCH] \[DEL]                                                              |
| `/duel admin replay <id\|player> [player]`                       | race a recording (practice)                                                                                           |
| `/duel admin watchreplay <id\|player>`                           | watch a recording alone                                                                                               |
| `/duel admin deletereplay <id>`                                  | delete a recording                                                                                                    |
| `/duel admin endseason`                                          | end the season now (rewards + soft reset)                                                                             |
| `/duel admin migrate <yaml\|mysql> <yaml\|mysql>`                | copy every player's data and the season to the other storage, see [Storage](/p/pinnaduels/getting-started/storage.md) |
| `/duel admin cancel <player>`                                    | cancel their duel (tokens refunded)                                                                                   |
| `/duel setup <id>` ... `finish`                                  | the arena wizard, see [Arenas](/p/pinnaduels/setting-up/arenas.md)                                                    |

`pinnaduels.admin` includes `pinnaduels.use`. Admins in creative can build in the duels world.

`/duel stats <player>` and the admin player commands also work for offline players (with MySQL they are read from the database in the background).