> For the complete documentation index, see [llms.txt](https://realisticnode.gitbook.io/rnsetups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://realisticnode.gitbook.io/rnsetups/rnkoth/reference/commands.md). # Commands and permissions Every /koth command and every permission, with who has it by default. Main command: `/koth`, alias `/rnkoth`. `<...>` is required, `[...]` is optional, and `` is the name of a KOTH (its file name). ## Players | Command | Permission | What it does | | ---------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/koth` | `rnkoth.use` | Menu with every KOTH (state, location, next start), and buttons for the top, your stats and the reward box | | `/koth help` | — | List of commands (admins also see the admin ones) | | `/koth list` | `rnkoth.use` | Every KOTH and its state: running, starting, waiting, disabled or without area | | `/koth info [name]` | `rnkoth.use` | Where it is, who holds it and the time left. Without a name: the first running KOTH | | `/koth next` | `rnkoth.use` | The KOTH that starts the soonest, in how long and at what time | | `/koth top [stat]` | `rnkoth.top` | Top 10 menu. Stats: `wins`, `captures`, `events`, `time`, `kills`, `king_kills`. From the console, or with one more word (`/koth top wins chat`), the top is printed in the chat instead | | `/koth stats [player]` | `rnkoth.stats` (`rnkoth.stats.others` for other players) | Stats menu: wins, captures, events played, time holding, kills, holder kills | | `/koth claim` | `rnkoth.claim` | The reward box: items that did not fit in the inventory. With `rewards.claim-command: false` it only answers that it is turned off (`/koth open claim ` still opens the box) | | `/koth hud` | `rnkoth.hud` | Turns the locator and the sidebar on or off for yourself (remembered after restarts) | All of them are given by `rnkoth.player` (default: everyone). In the `/koth` menu, players with `rnkoth.teleport` can click a running KOTH to teleport to it.
The /koth menu: each KOTH shows its mode, location and next event

The /koth menu: each KOTH shows its mode, location and next event

/koth top: the podium and a button for each stat

/koth top: the podium and a button for each stat

/koth stats: wins, captures, events, time holding and kills

/koth stats: wins, captures, events, time holding and kills

## Admins | Command | Permission | What it does | | -------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `/koth editor [name]` | `rnkoth.editor` | [In-game editor](/rnsetups/rnkoth/configuration/editor.md). Aliases: `edit`, `gui` | | `/koth create [display name]` | `rnkoth.editor` | New KOTH from the template. Gives you the wand, or offers to use your selection if you already have one. Names used by the placeholders (`top`, `next`, `current`, `running`, `hud`, the stat names...) are refused, see [Placeholders](/rnsetups/rnkoth/reference/placeholders.md#names-you-cant-use) | | `/koth wand` | `rnkoth.editor` | Gives the selection wand. Using it needs `rnkoth.editor` too (or `rnkoth.admin`) | | `/koth setzone [add]` | `rnkoth.editor` | Uses your wand selection as the area. `add` keeps the other areas. Alias: `zone` | | `/koth setzone circle [height] [add]` | `rnkoth.editor` | A round area around you (radius 1 to 200, height 3 to 384, default 5) | | `/koth setzone square [height] [add]` | `rnkoth.editor` | A square area around you, `radius` blocks from the middle to each side | | `/koth show ` | `rnkoth.editor` | Shows the areas with particles for 10 seconds, only to you | | `/koth tp ` | `rnkoth.teleport` | Teleports you to the middle of the area (the current one when it runs). Alias: `teleport` | | `/koth start [countdown]` | `rnkoth.start` | Starts it now, with its countdown or with the seconds you give (`0` = at once). Ignores `min-players` | | `/koth stop ` | `rnkoth.stop` | Stops a running KOTH (or its countdown) without a winner | | `/koth delete confirm` | `rnkoth.editor` | Deletes a KOTH. Its file is moved to `backups/`. Without `confirm` it asks first. Alias: `remove` | | `/koth reload` | `rnkoth.reload` | Reads every file again. Running events continue | | `/koth status [name]` | `rnkoth.admin` | Technical view of a running KOTH: state, holder, time, area, every side's score and each player inside with their status (`counting`, `afk`, `gamemode`...) | | `/koth history [name]` | `rnkoth.admin` | The last 10 events: date, KOTH, winner, length and players | | `/koth resetstats ` | `rnkoth.admin` | Deletes the stats of a player. `all` needs `/koth resetstats all confirm` | | `/koth open ` | `rnkoth.open` | Opens a menu for a player. For NPCs (Citizens), menu plugins and signs that run commands as the console | | `/koth version` | `rnkoth.update` | The installed version and the latest one on SpigotMC, with download links when there is a newer one. It says `(up to date)`, `(update available)` or, for a build newer than the published one, `(newer than the published version)`. Alias: `ver` | All of them are given by `rnkoth.admin` (default: operators). Commands that need a player in the game (`claim`, `hud`, `editor`, `wand`, `setzone`, `tp`, `show`) answer `Only players can use this` from the console. Tab completion only offers the commands the sender has permission for. `/koth cancel` and `/koth answer ` are used by the clickable buttons of the editor questions in chat. You do not need to type them. ## Opening menus from NPCs and other plugins `/koth open` lets other plugins open rnKoth menus, for example a Citizens NPC at spawn: ``` /npc command add koth open hills

``` Or a menu plugin item that runs `koth open top %player_name%` as the console. Menus: `hills` (the `/koth` menu), `top`, `stats` (the player's own stats), `claim` and `editor`. `claim` works even with `rewards.claim-command: false`, so an NPC can be the only way to open the reward box. {% hint style="warning" %} `/koth open editor ` only opens the editor for players with `rnkoth.editor` (or `rnkoth.admin`). For anyone else the sender gets ` doesn't have permission to use the editor`, and nothing opens. Every editor page also checks the permission when it opens and on every click, so a player who loses it can't keep using an open editor. {% endhint %} ## Every permission | Permission | Default | | | --------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `rnkoth.admin` | op | Every rnKoth permission (except `rnkoth.bypass.rules`) | | `rnkoth.player` | everyone | Every player permission | | `rnkoth.use` | everyone | `/koth`, `/koth list`, `/koth info`, `/koth next` | | `rnkoth.top` | everyone | `/koth top` | | `rnkoth.stats` | everyone | Your own stats (`/koth stats`) | | `rnkoth.stats.others` | everyone | Stats of other players (`/koth stats `) | | `rnkoth.claim` | everyone | The reward box (`/koth claim`) | | `rnkoth.hud` | everyone | Turn the locator and sidebar on or off (`/koth hud`) | | `rnkoth.teleport` | op | `/koth tp ` and teleporting from the `/koth` menu | | `rnkoth.editor` | op | `/koth editor`, `create`, `delete`, `wand`, `setzone`, `show` | | `rnkoth.start` | op | `/koth start` (also from the editor) | | `rnkoth.stop` | op | `/koth stop` (also from the editor) | | `rnkoth.reload` | op | `/koth reload` | | `rnkoth.open` | op | `/koth open

` | | `rnkoth.update` | op | Told when a new version of rnKoth is out (when joining), and `/koth version`. See [Update notifications](/rnsetups/rnkoth/getting-started/updating.md#update-notifications) | | `rnkoth.bypass.rules` | nobody | Not affected by the rules of running KOTHs (flight, elytra, pearls, commands, blocks) | `/koth status`, `/koth history` and `/koth resetstats` need `rnkoth.admin` itself.