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

# rnKoth

King of the Hill events for Spigot, Paper, Purpur and Folia, fully editable in game.

rnKoth runs **King of the Hill** events on your server. A KOTH is an area in your world. When the event opens, players fight to stand inside it. The player or team that holds it long enough (or gets the most points) wins the rewards.

You can build everything in game: draw the area with a wand, set the schedule and the rewards in a menu, and watch the event live with boss bars, holograms and particles. No file editing needed, but every option is also in clear YAML files.

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2FEzp3J2rzyOtnJj4qRsry%2Frnkoth-en-hero.png?alt=media" alt="A KOTH running: hologram, border particles, boss bar, sidebar and locator"><figcaption><p>A KOTH running: hologram, border particles, boss bar, sidebar and locator</p></figcaption></figure>

{% hint style="info" %}
**Need help?** Join our [Discord](https://discord.gg/GzxW2FANPB) and open a ticket. See [Support](/rnsetups/support.md).
{% endhint %}

## Features

**Game modes**

* **Capture**: hold the KOTH alone until the capture bar is full.
* **Score**: earn 1 point per second while you hold it. First to the target wins, or the best when time runs out.
* **What happens when you leave**: progress resets, pauses (tug of war) or drains slowly.
* **Contested areas**: nobody gains (freeze), the bigger team keeps gaining (majority), the king defends it (holder) or everyone races at once (everyone). Works with teams and with players on their own.
* **Overtime**: extra time while the KOTH is still contested or someone is still capturing.
* **Roaming KOTHs**: give a KOTH several areas and it moves between them during the event, or uses the next area each event.

**Areas**

* Box areas from two corners with the **selection wand**, or round and square areas around you with one command.
* Minimum height of 3 blocks, so jumping players stay inside.
* See the areas with particles, teleport to them, change their height from the editor.

**Schedules**

* Write times the way you say them: `daily 20:00`, `mon,wed,fri 18:30`, `weekends 16:00`, `every 2h`, `2026-12-24 21:00`. Spanish words work too.
* Your own time zone, warnings before the start, a countdown, and a minimum of online players.

**Rewards**

* For the winner, 2nd and 3rd place, every participant, players holding the KOTH and whoever kills a holder.
* Commands, items, messages, titles, sounds, potion effects, fireworks and a **loot chest** filled in game.
* Chances, permission-only rewards and weighted "pick one" groups.
* **Nothing is lost**: offline players get their rewards when they join, and items that do not fit go to a reward box (`/koth claim`).

**What players see**

* Boss bar, action bar with your progress (or why you do not count), and a **locator** with distance and an arrow to the KOTH.
* Sidebar, floating hologram, border particles in colors for each player, glowing holders, titles and sounds.
* Discord webhook posts when a KOTH starts and when someone wins.

**Teams and rules**

* Solo, vanilla scoreboard teams, or **any clan, faction or town plugin** through PlaceholderAPI.
* Rules inside the area: no flight, no elytra, no ender pearls, blocked commands, block protection, AFK and invisible checks.

**For admins**

* **In-game editor** (`/koth editor`) for every option of every KOTH and of `config.yml`.
* **Events continue after a restart** or `/koth reload`, with the same progress and time.
* Stats (wins, captures, events, time holding, kills, holder kills), top menus and the last events.
* **Files that never break**: updates add new options without touching yours, changes are backed up, and a file with a mistake tells you the exact line.
* **Changes apply on their own** a few seconds after you save a file.
* SQLite or MySQL / MariaDB, PlaceholderAPI placeholders, English and Spanish (add your own language), and a developer API.

## Compatibility

|          |                                                        |
| -------- | ------------------------------------------------------ |
| Server   | Spigot, Paper, Purpur and Folia, 1.21.1 to 26.3        |
| Java     | 21 or newer                                            |
| Optional | PlaceholderAPI (placeholders and clan / faction teams) |

{% hint style="info" %}
One jar for every server. On Folia everything works except the sidebar and vanilla scoreboard teams. Use the [placeholders](/rnsetups/rnkoth/reference/placeholders.md) in your own scoreboard and `teams.mode: placeholder` for teams.
{% endhint %}

## Quick start

1. Put `rnKoth.jar` in `plugins/` and restart the server.
2. Run `/koth create spawn` and click two opposite floor corners with the wand you get.
3. Run `/koth setzone spawn` to save the area.
4. Run `/koth start spawn` to test it, and stand inside.
5. Open `/koth editor spawn` to set the schedule, the rewards and everything else.

Continue with [Installation](/rnsetups/rnkoth/getting-started/installation.md) or jump to [Your first KOTH](/rnsetups/rnkoth/guides/first-koth.md).