> 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/es/rnkoth/configuration/config.md).

# config.yml

Todas las opciones de config.yml, agrupadas como en el archivo.

`plugins/rnKoth/config.yml` guarda los ajustes que comparten todos los KOTHs. Cada opción también está explicada dentro del archivo. Muchas se pueden cambiar en el juego con [`/koth editor`](/rnsetups/es/rnkoth/configuration/editor.md) → **Ajustes generales**.

Los ajustes de cada KOTH (zona, modo, horario, premios...) están en su propio archivo. Ver [Archivos de KOTH](/rnsetups/es/rnkoth/configuration/koth-file.md).

## General

| Opción                | Por defecto | Qué hace                                                                                                                                                                                                                                                                                                       |
| --------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `config-version`      | `1`         | Versión del archivo, la usan las actualizaciones. No la cambies.                                                                                                                                                                                                                                               |
| `language`            | `en`        | Idioma del plugin: `languages/<idioma>.yml`. Incluye `en` y `es`. Ver [Idiomas](/rnsetups/es/rnkoth/configuration/languages.md).                                                                                                                                                                               |
| `per-player-language` | `false`     | `true`: cada jugador ve los mensajes, los menús y las boss bars en el idioma de su Minecraft, si existe ese archivo de idioma. `false`: todo usa `language`.                                                                                                                                                   |
| `timezone`            | `''`        | Zona horaria de los horarios, como `Europe/Madrid`, `America/Mexico_City`, `America/Bogota`, `America/New_York` o `UTC`. Vacío = la zona horaria de la máquina del servidor. Ver [Horarios](/rnsetups/es/rnkoth/guides/schedules.md#zona-horaria).                                                             |
| `auto-reload`         | `true`      | Revisa `config.yml`, `languages/` y `koths/` cada pocos segundos y aplica los cambios que guardas a mano. Los eventos en curso siguen.                                                                                                                                                                         |
| `update-checker`      | `true`      | Busca versiones nuevas de rnKoth al arrancar y cada 6 horas. Cuando hay una, lo dice la consola y se avisa a los jugadores con `rnkoth.update` al entrar. Ver [Avisos de actualización](https://realisticnode.gitbook.io/rnsetups/es/rnkoth/configuration/pages/NTHFhsfnIs1AnGg2ifJ2#avisos-de-actualización). |

## Equipos

```yaml
teams:
  mode: solo
  placeholder: '%simpleclans_clan_tag%'
  no-team-values: ['', 'none', 'wilderness', 'no clan', 'null']
```

| Opción                 | Por defecto                                     | Qué hace                                                                                                                                                                  |
| ---------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `teams.mode`           | `solo`                                          | `solo`: cada jugador por su cuenta. `scoreboard`: equipos vanilla de `/team`. `placeholder`: cualquier plugin de clanes, facciones o ciudades a través de PlaceholderAPI. |
| `teams.placeholder`    | `%simpleclans_clan_tag%`                        | Con `mode: placeholder`: el texto que da este placeholder es el equipo del jugador.                                                                                       |
| `teams.no-team-values` | `['', 'none', 'wilderness', 'no clan', 'null']` | Textos que significan "sin equipo". Los jugadores con uno de ellos juegan solos.                                                                                          |

Cada KOTH también puede forzar el juego en solo con `teams: solo` en su archivo. Ver [Equipos y clanes](/rnsetups/es/rnkoth/guides/teams.md).

## Eventos

```yaml
events:
  resume-after-restart: true
  max-at-once: 0
  death-cooldown: 5
  winner-fireworks: true
```

| Opción                        | Por defecto | Qué hace                                                                                                                                                                                                                                                                                     |
| ----------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `events.resume-after-restart` | `true`      | Los eventos en curso siguen donde estaban después de un reinicio, con el mismo progreso y tiempo. El chat dice `{koth_name} continúa donde se quedó`. `false`: los eventos que estaban en curso cuando se apagó el servidor se pierden. (`/koth reload` nunca detiene los eventos en curso.) |
| `events.max-at-once`          | `0`         | Cuántos KOTHs pueden estar en curso (o en cuenta atrás) a la vez. `0` = sin límite.                                                                                                                                                                                                          |
| `events.death-cooldown`       | `5`         | Segundos que debe esperar un jugador que murió dentro de un KOTH antes de volver a contar. `0` = desactivado.                                                                                                                                                                                |
| `events.winner-fireworks`     | `true`      | Un espectáculo de fuegos artificiales sobre el KOTH cuando alguien gana. Nunca hace daño a nadie.                                                                                                                                                                                            |

{% hint style="info" %}
A los jugadores con `rnkoth.bypass.rules` no les afectan las reglas de un KOTH (vuelo, élitros, perlas, comandos, bloques). Los jugadores en creativo o espectador nunca cuentan, a menos que un KOTH lo permita en `rules.counted-gamemodes`. Ver [Reglas](/rnsetups/es/rnkoth/guides/rules.md).
{% endhint %}

## Visualización

| Opción                        | Por defecto   | Qué hace                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `display.action-bar`          | `true`        | Action bar mientras estás en un KOTH: tu progreso, o por qué no cuentas (AFK, invisible...).                                                                                                                                                                                                                                                                                                       |
| `display.locator`             | `true`        | Action bar para los jugadores fuera de un KOTH en curso: su nombre, la distancia y una flecha que apunta hacia él. Cada jugador puede desactivarla con `/koth hud`.                                                                                                                                                                                                                                |
| `display.locator-radius`      | `0`           | Solo para archivos de KOTH sin `display.audience.locator` (archivos antiguos): solo los jugadores así de cerca del KOTH ven el localizador. `0` = todos en el mismo mundo.                                                                                                                                                                                                                         |
| `display.sidebar`             | `true`        | Barra lateral (scoreboard) durante los eventos. `false` = ningún KOTH muestra la barra lateral de rnKoth. Quién la ve se pone en cada KOTH (`display.audience.sidebar`); quien sale de ella recupera su propio marcador al instante. Con otro plugin de scoreboard (TAB, AnimatedScoreboard...) oculta el tuyo mientras `%rnkoth_near%` vale `yes`, o pon esto en `false`. No se muestra en Folia. |
| `display.sidebar-radius`      | `120`         | Solo para archivos de KOTH sin `display.audience.sidebar` (archivos antiguos): los jugadores hasta esta cantidad de bloques del KOTH ven la barra lateral. `0` = todos en el mundo.                                                                                                                                                                                                                |
| `display.progress-style`      | `both`        | Cómo se ve el progreso: `bar` (■■■■□□), `percent` (45% o 120/300 puntos) o `both`.                                                                                                                                                                                                                                                                                                                 |
| `display.progress-bar.length` | `10`          | Número de símbolos de la barra (de 1 a 40).                                                                                                                                                                                                                                                                                                                                                        |
| `display.progress-bar.symbol` | `■`           | El símbolo de la barra.                                                                                                                                                                                                                                                                                                                                                                            |
| `display.progress-bar.filled` | `<green>`     | Color de la parte llena.                                                                                                                                                                                                                                                                                                                                                                           |
| `display.progress-bar.empty`  | `<dark_gray>` | Color de la parte vacía.                                                                                                                                                                                                                                                                                                                                                                           |
| `display.titles`              | `true`        | Títulos en pantalla cuando empieza un KOTH y cuando alguien gana.                                                                                                                                                                                                                                                                                                                                  |

### Sonidos

Cualquier clave de sonido de Minecraft, como `block.bell.use`. `''` = sin sonido.

| Opción                         | Por defecto                   | Cuándo                                     |
| ------------------------------ | ----------------------------- | ------------------------------------------ |
| `display.sounds.start`         | `block.bell.use`              | Se abre un KOTH                            |
| `display.sounds.countdown`     | `block.note_block.hat`        | Cada anuncio de la cuenta atrás            |
| `display.sounds.capture-start` | `block.beacon.activate`       | Un bando empieza a capturar o toma el KOTH |
| `display.sounds.capture-lost`  | `block.beacon.deactivate`     | Quien domina sale y el KOTH queda libre    |
| `display.sounds.contested`     | `block.note_block.bass`       | El KOTH queda en disputa                   |
| `display.sounds.win`           | `ui.toast.challenge_complete` | Alguien gana                               |
| `display.sounds.moved`         | `entity.enderman.teleport`    | Un KOTH itinerante se mueve                |

Ver [Lo que ven los jugadores](/rnsetups/es/rnkoth/guides/display.md) para cómo se ve cada parte.

## Premios

| Opción                  | Por defecto | Qué hace                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `rewards.claim-command` | `true`      | Los jugadores pueden abrir su buzón de premios (objetos que no cabían) con `/koth claim`. `false` = `/koth claim` solo dice que está desactivado, los mensajes del buzón no tienen botón para hacer clic y el menú no tiene botón del buzón; abre el buzón con `/koth open claim <jugador>` (un NPC, un plugin de menús...). Ver [El buzón de premios](https://realisticnode.gitbook.io/rnsetups/es/rnkoth/configuration/pages/F7nHg5GaPRrKIwxXbAb6#el-buzón-de-premios). |

Los premios en sí se ponen en cada KOTH. Ver [Premios](/rnsetups/es/rnkoth/guides/rewards.md).

## Discord

```yaml
discord:
  enabled: false
  webhook-url: ''
  username: 'rnKoth'
  avatar-url: ''
  on-start: true
  on-win: true
  mention: ''
```

| Opción                | Por defecto | Qué hace                                                                                                                     |
| --------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `discord.enabled`     | `false`     | Publica en un canal de Discord a través de un webhook. No hace falta ningún otro plugin.                                     |
| `discord.webhook-url` | `''`        | El enlace del webhook. En Discord: Ajustes del servidor → Integraciones → Webhooks → Nuevo webhook → Copiar URL del webhook. |
| `discord.username`    | `rnKoth`    | Nombre del bot que publica.                                                                                                  |
| `discord.avatar-url`  | `''`        | Enlace a una imagen para el bot. Vacío = la imagen propia del webhook.                                                       |
| `discord.on-start`    | `true`      | Publica cuando se abre un KOTH, con dónde, el modo y la duración.                                                            |
| `discord.on-win`      | `true`      | Publica cuando termina un KOTH: el ganador, el tiempo, los jugadores y la puntuación, o "terminó sin ganador".               |
| `discord.mention`     | `''`        | Texto antes de la publicación, por ejemplo la mención de un rol `<@&123456789>`. Vacío = ninguna.                            |

Los textos de las publicaciones están en el archivo de idioma, en `discord`. Si el webhook falla, la consola te dice por qué.

{% hint style="info" %}
Para mencionar un rol, activa el Modo desarrollador en Discord (Ajustes de usuario → Avanzado), haz clic derecho en el rol → Copiar ID del rol, y escribe `<@&ID_DEL_ROL>`.
{% endhint %}

## Almacenamiento

```yaml
storage:
  type: sqlite
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: ''
    table-prefix: 'rnkoth_'
    pool-size: 4
    parameters: 'useSSL=false&allowPublicKeyRetrieval=true&characterEncoding=utf8'
```

`sqlite` guarda las estadísticas en un archivo, sin nada que configurar. `mysql` (MySQL o MariaDB) las comparte entre servidores. Los cambios necesitan un reinicio. Ver [Base de datos](/rnsetups/es/rnkoth/reference/database.md).

## Editor

| Opción          | Por defecto                | Qué hace                                                            |
| --------------- | -------------------------- | ------------------------------------------------------------------- |
| `editor.wand`   | `BLAZE_ROD`                | Objeto de la varita de selección (`/koth wand`).                    |
| `editor.filler` | `BLACK_STAINED_GLASS_PANE` | Objeto en los espacios vacíos de los menús. `''` = dejarlos vacíos. |

## Nombres de los mundos

```yaml
world-names:
  void: Spawn
  world_pvp: '/warp pvp'
```

Nombres que se muestran en lugar de los nombres reales de los mundos en los mensajes (`{world}`). Por defecto: `{}` (ninguno). Cada KOTH también puede tener el suyo con `display.world-name` en su archivo.
