> 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/configuration/editor.md). # In-game editor Every page and button of /koth editor, and the clicks you can use. `/koth editor` (permission `rnkoth.editor`) opens a menu to change every KOTH and the general settings without opening files. `/koth editor ` opens one KOTH directly. Every page checks `rnkoth.editor` (or `rnkoth.admin`) when it opens and on every click, also when it was opened with `/koth open editor `: a player without it gets `You don't have permission.` and the menu closes. Every change is saved right away in the file (only that line changes, your comments stay) and applied at once, even during a running event. The chat confirms each change, for example `Capture time (s) → 180`. ## Clicks | Kind of option | Clicks | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | **On / off** | Click to switch. The item glows when it is on. | | **Number** | Left click `+`, right click `−`. With Shift the step is bigger. Press **Q** (drop key) on it to type the exact number in chat. | | **List of values** | Left click for the next value, right click for the previous one. | | **Text** | Click, then type the new value in chat. | Each option shows what it does, its current value and the clicks you can use.
Every option explains itself when you hover it

Every option explains itself when you hover it

### Typing in chat Some buttons close the menu and ask you to type in chat (a name, a reward line, a time...): * What you type is **hidden** from other players. * Some questions have **clickable answers** in the chat, like `[3] [5] [8] [12]` for a radius or `[every 1h] [daily 20:00]` for a schedule. * Click **\[✖ Cancel]** or type `cancel` to stop. The question also ends by itself after 2 minutes. * For reward lines and blocked commands you can type a command with `/` (like `/home`): it is taken as the answer, not run. The menu opens again after you answer. ## Main page | Button | What it does | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **A KOTH** | Left click: edit it. Right click: start it (with its countdown), or stop it when it is running. The lore shows its state, mode, number of areas and next start. Running KOTHs glow. | | **General settings** (comparator) | Opens the [General](#general-settings) page. | | **Create KOTH** (emerald) | Type the name in chat. The KOTH is created, you get the wand, and its page opens. Names used by the placeholders (`top`, `next`, `current`, `running`, `hud`, the stat names...) are refused with a message. | | **Reload** (book) | Reads every file again (`/koth reload`). Running events continue. | | **Close** (barrier) | Closes the menu. | With many KOTHs, arrows at the bottom go to the next and previous page.
The main page: each KOTH shows its state, mode, areas and next start

The main page: each KOTH shows its state, mode, areas and next start

## KOTH page The top item shows the file (`koths/.yml`), the mode and every area. **Settings** | Button | Option | | ------------------- | ------------------------------------------------------------------------------------------------------------------------- | | **Enabled** | `enabled`: off = it never starts by its schedule. | | **Mode** | `mode`: `capture` or `score`. | | **Display name** | `display-name`: type it in chat. Colors work. | | **Icon** | Hold an item in your hand and click: it becomes the icon in the menus. | | **Teams** | `teams`: `default` (as `config.yml`) or `solo`, shown as `default (as in config.yml)` and `solo (everyone on their own)`. | | **Minimum players** | `min-players` (0 to 200). | | **Countdown** | `start-countdown` (0 to 600 seconds). | **Area tools** | Button | What it does | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Set area from the wand** | Uses your wand selection as the only area. Without a selection you get the wand. | | **Add another area** | Adds your wand selection as one more area (the KOTH will move between them). | | **Round area here** | A circle around you. Type the radius (1 to 200) or click one of the answers. It replaces the areas. It keeps the height of the first area, or is 5 blocks high when the KOTH has no area yet (like `/koth setzone`). | | **Square area here** | A square around you. Type how many blocks from the middle to each side (`3` = 7 × 7) or click `[5x5] [7x7] [11x11] [15x15]`. It replaces the areas. Same height as **Round area here**. | | **Area height** | Left click +1, right click −1, Shift ±5 (3 to 384, like `/koth setzone`). Changes the height of every area, from its floor up. | | **Show the areas** | Particles for 10 seconds, only for you. The first area is yellow, the others blue. | | **Teleport there** | Takes you to the middle of the area (needs `rnkoth.teleport`). | | **Remove every area** | Shift + click. | | **Move every (s)** | `roaming.move-every` (0 to 3600). | **The fight** | Button | Option | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Capture time (s)** | `capture.time` (5 to 3600). | | **When you leave** | `capture.on-leave`: `reset`, `pause` or `drain`. | | **Points to win** | `score.target` (10 to 100000). | | **Duration** | `duration` (30 to 86400, or `0` = no time limit). Right click below 30 goes to `0`, shown as `No limit`. | | **Overtime (s)** | `overtime` (0 to 3600). | | **Contested** | `contested`: `freeze` → `majority` → `holder` → `everyone`. The lore explains each value in one line, and the value is shown with a readable name, e.g. `holder (the king defends it)`. With solo teams use `holder` or `everyone`. | | **Move order** | `roaming.order`: `next` or `random`. | **Other pages and actions** | Button | What it does | | --------------------- | ----------------------------------------------------------------------------------------------------- | | **Who sees it** | Opens the [Who sees it](#who-sees-it) page. | | **Rules** | Opens the [Rules](#rules) page. | | **What players see** | Opens the [Display](#what-players-see) page. | | **Rewards** | Opens the [Rewards](#rewards) page. | | **Loot chest** | Opens the [loot chest](#loot-chest). | | **Schedule** | Opens the [Schedule](#schedule) page. | | **Start now / Stop** | Starts the KOTH with its countdown (`rnkoth.start`), or stops it without a winner (`rnkoth.stop`). | | **State** (lamp) | Shows whether it is running, starting, ready, disabled or has no area, with the holder and time left. | | **Delete KOTH** (TNT) | Shift + click. The file is moved to `backups/`. | ## Rules | Button | Option | | --------------------------- | ------------------------------------------------------------------ | | **No flight inside** | `rules.deny-flight` | | **No elytra inside** | `rules.deny-elytra` | | **No ender pearls into it** | `rules.deny-ender-pearls` | | **Invisible players count** | `rules.invisible-players-count` | | **AFK after (s)** | `rules.afk-seconds` (0 to 3600) | | **Protect blocks** | `rules.protect-blocks` | | **Blocked commands** | Click to add one (typed in chat), Shift + click to clear the list. | `rules.counted-gamemodes` is only in the file. ## What players see | Button | Option | | -------------------- | ----------------------------------------------------------------------------------------------- | | **Who sees it** | Opens the [Who sees it](#who-sees-it) page (its Back button returns here). | | **Boss bar color** | `display.boss-bar-color` | | **Hologram** | `display.hologram` | | **Hologram height** | `display.hologram-height`: ±0.5 with left / right click, ±2 with Shift, Q to type it (0 to 30). | | **Border particles** | `display.border-particles` | | **Holders glow** | `display.glow-holder` | | **World name** | `display.world-name`: type it in chat. | The old **Boss bar**, **Locator** and **Radius** buttons are now part of **Who sees it**. ## Who sees it Who gets each part of the KOTH (`display.audience`, see [Who sees what](/rnsetups/rnkoth/guides/display.md#who-sees-what)). Opened from the KOTH page or from **What players see**. | Button | Option | | --------------------------- | -------------------------------------------------------------------------------------------------------------------- | | **Announcements** (bell) | `display.audience.announcements`: countdown, "starts in" warnings, opened, moved, overtime, stopped and the results. | | **Capture messages** (book) | `display.audience.capture-messages`: is capturing, took it, lost control, contested. | | **Titles** (sign) | `display.audience.titles`: start title and "X won" for everyone else. | | **Sounds** (note block) | `display.audience.sounds` | | **Boss bar** (dragon head) | `display.audience.boss-bar` | | **Sidebar** (item frame) | `display.audience.sidebar`, which `%rnkoth_near%` follows. | | **Locator** (compass) | `display.audience.locator` | | **Action bar inside** | `display.audience.action-bar`: on / off. | | **Who sees it** (book) | Explains the values. | | **Discord** | `display.audience.discord`: on / off. | Each button shows what the part is and who gets it now: "Whole server", "This world", "Within 150 blocks", "Worlds: pvp, arena", "Region: spawn" or "Off". A part turned off for every KOTH in **General settings** says so, and a part that is not in the file yet (older files) says it comes from the old settings. | Click | Does | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Left click | Whole server → This world → a distance → Off → Whole server | | Right click | The other way | | Shift + left / right | Distance +50 / -50 blocks (a value that is not a distance becomes one) | | `Q` (drop key) | Type any value in chat (`server`, `world`, `250`, `worlds:pvp,arena`, `region:spawn`, `off`), or click a ready-made one. An unknown world or region, or `region:` without WorldGuard, is refused with a message. | ## Rewards The page lists every reward list with its number of lines: | Button | List | | ------------------------------------------- | -------------------------------------------- | | **Winner** | `rewards.winner` | | **2nd place** / **3rd place** | `rewards.second` / `rewards.third` | | **Participation** | `rewards.participation` | | **While holding** | `rewards.while-holding` | | **Holder killed** | `rewards.holder-killed` | | **Commands on start** / **Commands on end** | `commands.on-start` / `commands.on-end` | | **Loot chest** | Opens the loot chest. | | **Participation time (s)** | `rewards.participation-seconds` | | **While holding every (s)** | `rewards.while-holding-every` | | **Loot mode** | `loot.mode`: `all` or `random` | | **Random loot items** | `loot.amount` (1 to 54) | | **Reward lines** (book) | A short list of every action, as a reminder. | ### A reward list Click a list to see its lines. Each line is a paper item: | Click | What it does | | ------------------------ | --------------------------------------------------------------------------------------------- | | Left click a line | Type a new version of it in chat. | | Right click a line | Removes it. | | **Add a line** (emerald) | Type a new line in chat, like `[console] give {player} diamond 5` or `[item] golden_apple 2`. | Groups (`chance` and `pick-one`, see [Rewards](/rnsetups/rnkoth/guides/rewards.md#groups)) are shown as a bundle. You can remove them with a right click, but edit them in the file. ## Loot chest A chest of 54 slots. Put in the items the `[loot]` action gives (they keep enchantments, names and custom data), and close it to save. The chat says how many stacks were saved. ## Schedule | Item | What it does | | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Schedule lines** (clocks, top rows) | Each line of `schedule`, shown in your language. Right click to remove it. A line that is not understood shows as a barrier. | | **Ready-made times** (dyes) | `every 1h`, `every 2h`, `every 3h`, `every 6h`, `every 12h`, `every 24h`, `daily 20:00`, `weekends 18:00`. Click to add, click again to remove. The lore tells when the first start would be. | | **Add a time** (emerald) | Type any line, like `mon,fri 18:30`. It is checked before it is saved. | | **Next starts** (spyglass) | The next five starts and the time zone. | | **Time zone** (clock) | `timezone` of `config.yml`, used by every KOTH. Left / right click goes through common zones; Shift + click or Q to type one (`server` = the server time zone). | | **Warnings before the start** (bell) | `announce-before`: type times like `10m,5m,1m,10s`, or `none`. | ## General settings Options of `config.yml`: | Button | Option | | -------------------------------- | -------------------------------------------------------------------------------- | | **Language** | `language`: goes through the language files in `languages/`. | | **Language of each player** | `per-player-language` | | **Teams** | `teams.mode`: `solo`, `scoreboard` or `placeholder` | | **Team placeholder** | `teams.placeholder` | | **Resume after restart** | `events.resume-after-restart` | | **Death cooldown (s)** | `events.death-cooldown` (0 to 120) | | **Max KOTHs at once** | `events.max-at-once` (0 to 50) | | **Victory fireworks** | `events.winner-fireworks` | | **Action bar inside** | `display.action-bar` | | **Locator (all KOTHs)** | `display.locator` | | **Sidebar (all KOTHs)** | `display.sidebar` (off = no rnKoth sidebar in any KOTH) | | **Sidebar distance (old KOTHs)** | `display.sidebar-radius`: only for KOTH files without `display.audience.sidebar` | | **Titles** | `display.titles` | | **Discord** | `discord.enabled` | | **Discord webhook URL** | `discord.webhook-url` | | **Discord mention** | `discord.mention` | | **Time zone** | `timezone` | | **Progress style** | `display.progress-style`: `both`, `bar` or `percent` | | **Update checker** | `update-checker` |
General settings: the Language option

General settings: the Language option

{% hint style="info" %} If you edit a file by hand, the editor shows the new values a few seconds after you save it (with `auto-reload` on). {% endhint %} ## Changing the texts of the editor Every text of the editor is in the language file, under `editor`: | Key | Text | | -------------------------------------------------------------- | -------------------------------------------------------------- | | `editor.opt.