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

# Installation

Requirements, first start and how to run a test event.

## Requirements

* A **Spigot** or **Paper** server from **1.21.1 to 26.3**, or a fork of Paper such as Purpur or Folia.
* **Java 21** or newer.
* Internet access on the **first start**: the server downloads the libraries the plugin needs (HikariCP, the SQLite driver and the MySQL driver; on Spigot also Adventure, the text library Paper has built in) from Maven Central once and keeps them in `libraries/`.

Optional:

* [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi) for [placeholders](/rnsetups/rnkoth/reference/placeholders.md) and for [clan, faction and town teams](/rnsetups/rnkoth/guides/teams.md).

## Steps

1. Download `rnKoth.jar` and put it in the `plugins/` folder of your server.
2. Restart the server (do not use `/reload`).
3. The plugin creates `plugins/rnKoth/` with its files (see [Files overview](/rnsetups/rnkoth/getting-started/files.md)).
4. Open `plugins/rnKoth/config.yml` and set:
   * `language`: `en` (English) or `es` (Spanish).
   * `timezone`: the time zone of your players, for example `Europe/Madrid`, `America/Mexico_City` or `UTC`. Empty means the time zone of the server machine.
5. Save the file. Changes are applied a few seconds later, no restart needed.

Check the console. You should see a line like this:

```
[rnKoth] Running on Paper with 0 KOTH(s), stats in SQLite.
```

## First test

1. `/koth create test`: creates the KOTH `test` and gives you the selection wand.
2. With the wand, **left click** one floor block and **right click** the opposite floor block of the area.
3. `/koth setzone test`: saves the area. Particles show it for 10 seconds.
4. `/koth start test`: a 10 second countdown starts, then the KOTH opens.
5. Stand inside the area. The action bar shows `Capturing` and your progress.

To end the test, run `/koth stop test`. To remove it, run `/koth delete test confirm` (a copy stays in `backups/`).

{% hint style="success" %}
A new KOTH has no schedule, so it only starts with `/koth start` until you add times in `/koth editor <name>` → Schedule. See [Schedules](/rnsetups/rnkoth/guides/schedules.md).
{% endhint %}

{% hint style="warning" %}
The wand works for players with `rnkoth.editor` or `rnkoth.admin` (operators have both). See [Commands and permissions](/rnsetups/rnkoth/reference/commands.md).
{% endhint %}