> 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/rncombatpvp/configuration/editor.md).

# In-game editor

Change config.yml without leaving the game, lists and item cooldowns included.

`/combat editor` (permission `rncombat.editor`), also from the **Editor** button in `/combat`.

<figure><img src="https://i.imgur.com/RpUPHJw.png" alt="The editor: the parts of config.yml"><figcaption><p>The editor: the parts of config.yml</p></figcaption></figure>

The options of `config.yml` are grouped in parts:

| Part             | What is in it                                                                                                                                |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **General**      | Language, per-player language, update checker, auto reload, storage, money format and decimals, disabled worlds                              |
| **Combat**       | Combat time, what tags, mobs, end when enemies are gone, pearls renew combat, glow, close inventory, what is turned off, harmful effects     |
| **Display**      | Action bar, boss bar and its color, progress bar, titles, countdown sound, red screen, damage numbers, blood, nametag prefix                 |
| **Restrictions** | Command mode and list, pearls, chorus fruit, riptide, elytra, rockets, totems, blocks, containers, teleports, blocked blocks, item cooldowns |
| **Combat log**   | Punishment, NPC time, NPC on old servers, money penalty, commands, kicks that punish, tell on join                                           |
| **Protections**  | PvP switch, newbie protection, respawn protection, anti-clean, duel lock, safe zones                                                         |
| **Kills**        | Money, steal, death penalty, experience, rewards, drops, loot protection, heads, death recap, anti-farm, assists, streaks, rating            |
| **Bounties**     | On/off, smallest bounty, tax, payers can claim, days, announce from, rewards                                                                 |
| **Discord**      | Webhook and what is posted                                                                                                                   |

**Reload** reads every file again (with `rncombat.reload`).

## Changing an option

<figure><img src="https://i.imgur.com/znCf1DI.png" alt="The options of one part, with what each one does and its value"><figcaption><p>The options of one part, with what each one does and its value</p></figcaption></figure>

Every option shows its name in `config.yml`, what it does and its value now:

* **On / off** options switch with a click.
* Options with a few values (language, storage, punishment, drops, boss bar color, command mode...) go to the next value.
* Numbers and texts are typed in the chat. For a text, `-` leaves it empty. Type `cancel` (or click **\[Cancel]**) to stop. The question ends by itself after two minutes.

Changes are written to `config.yml` keeping every comment and are applied at once.

## Lists and item cooldowns

<figure><img src="https://i.imgur.com/T47OrIz.png" alt="A list of config.yml in the editor: click a line to remove it, the dye adds one"><figcaption><p>A list of config.yml in the editor: click a line to remove it, the dye adds one</p></figcaption></figure>

Lists (allowed commands, disabled worlds, mobs, harmful effects, blocked blocks, kill rewards, combat log commands, assist rewards...) open their own page:

* **Click a line** to remove it.
* **Add** asks for a new line in the chat.

The item cooldowns (**Cooldowns in combat** and **Cooldowns always**) work the same way: type the item and the seconds, like `ENDER_PEARL 8`.

The MySQL details, `storage.server-id`, the money separators, the streak milestones and the sounds are changed in the file.
