> 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/guides/first-koth.md).

# Your first KOTH

Create a KOTH, draw its area, set it up in the editor, test it and schedule it.

This guide builds a KOTH called `spawn` from start to end. You need the permission `rnkoth.editor` (operators have it; `rnkoth.admin` includes it). Starting and stopping need `rnkoth.start` and `rnkoth.stop`, also included in `rnkoth.admin`.

## 1. Create it

```
/koth create spawn
```

You can also give it a display name with colors: `/koth create spawn <gold>Spawn Hill`. Without one, the display name is the name with a capital letter (`<gold>Spawn`).

The plugin writes `plugins/rnKoth/koths/spawn.yml` and gives you the **selection wand** (a glowing blaze rod). The chat shows the next steps, with clickable commands.

{% hint style="info" %}
Names can only use `a-z`, `0-9`, `-` and `_`, up to 32 characters. You can also create a KOTH from `/koth editor` → **Create KOTH** and type the name in chat.
{% endhint %}

## 2. Draw the area with the wand

Hold the wand and click the **floor blocks** of two opposite corners of the area:

| Click                       | Sets                                                                      |
| --------------------------- | ------------------------------------------------------------------------- |
| Left click a block          | Corner 1                                                                  |
| Shift + right click a block | Corner 1 (handy on Bedrock, where left clicks on blocks are not reliable) |
| Right click a block         | Corner 2                                                                  |

The chat tells you each corner and, when both are set, the size of the area. A yellow box of particles shows the selection for 15 seconds, only to you.

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2FhNRA85g60bITgdHohwdX%2Frnkoth-en-wand.png?alt=media" alt="The wand selection: a yellow box of particles and the size of the area in chat"><figcaption><p>The wand selection: a yellow box of particles and the size of the area in chat</p></figcaption></figure>

The area **starts on top of the blocks you clicked** (where players stand) and is **at least 3 blocks high**, so players who jump stay inside. If you click a higher block for one corner, the area goes up to that block.

Lost the wand? Run `/koth wand`.

## 3. Save the area

```
/koth setzone spawn
```

The chat confirms it, for example `Area of Spawn saved (11x3x11)`, and particles show the area for 10 seconds.

### Round or square areas

Instead of the wand, stand in the middle of the place and type:

```
/koth setzone spawn circle 5
/koth setzone spawn square 5
```

* `circle 5`: a circle with a radius of 5 blocks around you.
* `square 5`: a square that goes 5 blocks from the middle to each side (11 × 11).
* Both start at your feet and are 5 blocks high. Add the height at the end: `/koth setzone spawn circle 5 8`.
* The radius can be 1 to 200 and the height 3 to 384.

### The height

Make the area taller when the place has stairs, slabs or a hill:

* In the editor: **Area height** (left click +1, right click −1, Shift ±5). It changes every area of the KOTH.
* With the wand: click a higher block for one of the corners.
* With a command: the last number of `circle` or `square`.

### Several areas

Add `add` to keep the old areas and add a new one:

```
/koth setzone spawn add
/koth setzone spawn circle 6 add
```

With two or more areas the KOTH **moves** between them. See [Roaming KOTHs](/rnsetups/rnkoth/guides/modes.md#roaming-koths-several-areas).

To check the areas at any time: `/koth show spawn` (particles for 10 seconds). To go there: `/koth tp spawn`.

## 4. Open the editor

```
/koth editor spawn
```

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2FAI6O4lBobmV4uPFCZyYh%2Frnkoth-en-editor-koth.png?alt=media" alt="The page of a KOTH in /koth editor"><figcaption><p>The page of a KOTH in /koth editor</p></figcaption></figure>

Everything about the KOTH is here. The most important options for a first event:

| Option               | What to set                                                                              |
| -------------------- | ---------------------------------------------------------------------------------------- |
| **Mode**             | `capture` (hold it alone until the bar is full) or `score` (points per second).          |
| **Capture time (s)** | How long a player or team must hold it in capture mode (default `120`).                  |
| **When you leave**   | `reset`, `pause` or `drain`. See [Game modes](/rnsetups/rnkoth/guides/modes.md).         |
| **Duration (s)**     | The longest the event can last (default `900`, 15 minutes).                              |
| **Minimum players**  | Online players needed for a scheduled start (default `2`).                               |
| **Rewards**          | What the winner and the others get. See [Rewards](/rnsetups/rnkoth/guides/rewards.md).   |
| **Rules**            | No flight, no elytra, blocked commands... See [Rules](/rnsetups/rnkoth/guides/rules.md). |

Each change is saved in `koths/spawn.yml` right away and applied at once, even during a running event. See [In-game editor](/rnsetups/rnkoth/configuration/editor.md) for every button.

## 5. Start it

```
/koth start spawn
```

A countdown of 10 seconds (`start-countdown`) runs, then the KOTH opens with a title, a chat announcement and a boss bar. Step inside: the action bar shows your progress. Hold it for the capture time to win.

<figure><img src="https://348500357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSlVHklG0EMAOmvfqcizu%2Fuploads%2FTRTNffqgHazXGlWQZbLJ%2Frnkoth-en-start-title.png?alt=media" alt="The KOTH opens: title, countdown and start messages"><figcaption><p>The KOTH opens: title, countdown and start messages</p></figcaption></figure>

* Start without countdown: `/koth start spawn 0`. Another countdown: `/koth start spawn 30`.
* Stop it without a winner: `/koth stop spawn`, or `/koth stop all`.
* See its state: `/koth info spawn`. Admins can see the details with `/koth status spawn`.

## 6. Schedule it

In `/koth editor spawn` → **Schedule**:

* Click a ready-made time (`every 2h`, `daily 20:00`, `weekends 18:00`...) to add it. Click again to remove it.
* Or click **Add a time** and type your own, like `mon,wed,fri 20:00`.
* The spyglass shows the next five starts.

The same in the file:

```yaml
schedule:
  - 'daily 20:00'
  - 'weekends 16:00'
```

Players can see when it starts with `/koth next`, `/koth list` and in the `/koth` menu. See [Schedules](/rnsetups/rnkoth/guides/schedules.md) for every format.

{% hint style="success" %}
Your KOTH is ready. Next steps: [rewards](/rnsetups/rnkoth/guides/rewards.md), [what players see](/rnsetups/rnkoth/guides/display.md) and [teams](/rnsetups/rnkoth/guides/teams.md).
{% endhint %}
