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

# Files overview

What each file and folder of plugins/rnKoth is for.

```
plugins/rnKoth/
├── config.yml          main settings: language, time zone, teams, display, sounds, Discord, database
├── koths/
│   └── <name>.yml      one file per KOTH: area, mode, schedule, rules, display and rewards
├── languages/
│   ├── en.yml          every message, title, boss bar, hologram and menu text in English
│   └── es.yml          the same in Spanish
├── data/
│   ├── running.yml     events that are running (so they continue after a restart) and the next area of KOTHs with several areas
│   └── players.yml     players who turned the locator and sidebar off (/koth hud)
├── data.db             stats, history and reward box (SQLite). Not used with MySQL
└── backups/            copies made before the plugin changes one of your files, and deleted KOTHs
```

| File               | Page                                                               |
| ------------------ | ------------------------------------------------------------------ |
| `config.yml`       | [config.yml](/rnsetups/rnkoth/configuration/config.md)             |
| `koths/<name>.yml` | [KOTH files](/rnsetups/rnkoth/configuration/koth-file.md)          |
| `languages/`       | [Languages and texts](/rnsetups/rnkoth/configuration/languages.md) |
| `data.db`          | [Database](/rnsetups/rnkoth/reference/database.md)                 |

{% hint style="info" %}
KOTH names can only use lower case letters `a-z`, numbers, `-` and `_` (up to 32 characters). A file in `koths/` with another name is skipped and the console tells you.
{% endhint %}

## Applying changes

With `auto-reload: true` (default), the plugin checks `config.yml`, `languages/` and `koths/` every few seconds. Saved changes are applied by themselves and the console tells you:

```
[rnKoth] Applied the changes saved in koths/spawn.yml
```

Running events are not stopped. They continue with the new settings.

You can also use `/koth reload`. It reads every file again; running events continue too.

{% hint style="warning" %}
The database settings (`storage`) are only read when the server starts. Restart the server after changing them.
{% endhint %}

## Text format

Every text accepts:

* **MiniMessage**: `<green>`, `<#ff8800>`, `<gradient:#ffb000:#ffe066>`, `<bold>`, `<click:...>`, `<hover:...>`
* **Legacy codes**: `&a`, `&l`, `&r` and hex colors `&#ff8800`

Both can be mixed in the same line. Start a chat line with `<center>` to center it.

{% hint style="warning" %}
YAML files need spaces, never tabs. When a text has a `'`, write it twice: `'You can''t fly here'`.
{% endhint %}

## About data.db-wal and data.db-shm

SQLite keeps recent changes in `data.db-wal` (and an index in `data.db-shm`) and moves them into `data.db` from time to time. They are normal. Do not delete them while the server is running. To back up the stats, stop the server and copy `data.db`, or copy the three files together.