> 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/getting-started.md).

# Getting started

Install rnKoth, keep it up to date and learn what each file is for.

rnKoth starts with no KOTH. You create each one in game: you draw its area, and the plugin writes its file in `plugins/rnKoth/koths/`. These pages take you from the first start to a server ready for players.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Installation</strong></td><td>Requirements, first start and a test event in two minutes.</td><td><a href="/rnsetups/rnkoth/getting-started/installation.md">Installation</a></td></tr><tr><td><strong>Updating</strong></td><td>Replace the jar: your KOTHs, texts and stats are kept.</td><td><a href="/rnsetups/rnkoth/getting-started/updating.md">Updating</a></td></tr><tr><td><strong>Files overview</strong></td><td>What each file and folder is for, text colors and how changes are applied.</td><td><a href="/rnsetups/rnkoth/getting-started/files.md">Files overview</a></td></tr></tbody></table>

## Setup in 5 minutes

1. **Install** the jar and restart the server ([Installation](/rnsetups/rnkoth/getting-started/installation.md)).
2. **Pick the language** in `config.yml`: `language: en` or `language: es`.
3. **Set your time zone** in `config.yml` (`timezone: Europe/Madrid`, for example), so `daily 20:00` means 20:00 for your players.
4. **Create a KOTH**: `/koth create spawn`, click two floor corners with the wand, then `/koth setzone spawn` ([Your first KOTH](/rnsetups/rnkoth/guides/first-koth.md)).
5. **Set when it starts and what it gives**: `/koth editor spawn` → Schedule and Rewards.
6. **Test it** with `/koth start spawn`.

## Recommended settings by server size

These are only starting points. Change them after watching a few events.

| Players online | `duration`              | `capture.time`  | `min-players` | Tip                                                                                              |
| -------------- | ----------------------- | --------------- | ------------- | ------------------------------------------------------------------------------------------------ |
| 1 – 15         | `600` (10 min)          | `60`            | `2`           | Use `on-leave: pause`, so small fights do not wipe the progress.                                 |
| 15 – 60        | `900` (15 min, default) | `120` (default) | `4`           | Add a `participation` reward to bring more players.                                              |
| 60+            | `1200` (20 min)         | `180`           | `10`          | Try `mode: score` or a roaming KOTH with several areas, and `contested: majority` for big teams. |

{% hint style="info" %}
Players who do not like the extra screen texts can turn the locator and the sidebar off for themselves with `/koth hud`.
{% endhint %}

## Good to know

* **Spigot, Paper, Purpur and Folia**: 1.21.1 to 26.3, with the same jar.
* **No restart needed** for most changes: save the file and it is applied a few seconds later.
* **Running events survive** a restart or `/koth reload` and continue where they were.
* **Your files are safe**: updates add new options and save a backup in `backups/` first.
* **Need help?** Open a ticket on our [Discord](https://discord.gg/GzxW2FANPB).
