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

# Editor en el juego

Todas las páginas y botones de /koth editor, y los clics que puedes usar.

`/koth editor` (permiso `rnkoth.editor`) abre un menú para cambiar todos los KOTHs y los ajustes generales sin abrir archivos. `/koth editor <nombre>` abre un KOTH directamente.

Cada página revisa `rnkoth.editor` (o `rnkoth.admin`) al abrirse y en cada clic, también cuando se abrió con `/koth open editor <jugador>`: un jugador sin el permiso recibe `No tienes permiso.` y el menú se cierra.

Cada cambio se guarda al momento en el archivo (solo cambia esa línea, tus comentarios se quedan) y se aplica enseguida, incluso durante un evento en curso. El chat confirma cada cambio, por ejemplo `Tiempo de captura (s) → 180`.

## Clics

| Tipo de opción           | Clics                                                                                                                                               |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Activar / desactivar** | Clic para cambiar. El objeto brilla cuando está activado.                                                                                           |
| **Número**               | Clic izquierdo `+`, clic derecho `−`. Con Shift el paso es mayor. Pulsa **Q** (tecla de soltar) sobre él para escribir el número exacto en el chat. |
| **Lista de valores**     | Clic izquierdo para el valor siguiente, clic derecho para el anterior.                                                                              |
| **Texto**                | Haz clic y luego escribe el nuevo valor en el chat.                                                                                                 |

Cada opción muestra qué hace, su valor actual y los clics que puedes usar.

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2FaMgWWB3psNS3J7B8XWsA%2Frnkoth-es-editor-koth-tip.png?alt=media" alt="Cada opción se explica al pasar el ratón por encima"><figcaption><p>Cada opción se explica al pasar el ratón por encima</p></figcaption></figure>

### Escribir en el chat

Algunos botones cierran el menú y te piden que escribas en el chat (un nombre, una línea de premio, una hora...):

* Lo que escribes está **oculto** para los demás jugadores.
* Algunas preguntas tienen **respuestas para hacer clic** en el chat, como `[3] [5] [8] [12]` para un radio o `[cada 1h] [diario 20:00]` para un horario.
* Haz clic en **\[✖ Cancelar]** o escribe `cancelar` para parar. La pregunta también termina sola después de 2 minutos.
* En las líneas de premio y los comandos bloqueados puedes escribir un comando con `/` (como `/home`): se toma como respuesta, no se ejecuta.

El menú se vuelve a abrir después de que respondes.

## Página principal

| Botón                              | Qué hace                                                                                                                                                                                                                                 |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Un KOTH**                        | Clic izquierdo: editarlo. Clic derecho: iniciarlo (con su cuenta atrás), o detenerlo cuando está en curso. El lore muestra su estado, el modo, el número de zonas y el próximo inicio. Los KOTHs en curso brillan.                       |
| **Ajustes generales** (comparador) | Abre la página de [ajustes generales](#ajustes-generales).                                                                                                                                                                               |
| **Crear KOTH** (esmeralda)         | Escribe el nombre en el chat. El KOTH se crea, recibes la varita y se abre su página. Los nombres que usan los placeholders (`top`, `next`, `current`, `running`, `hud`, los nombres de las estadísticas...) se rechazan con un mensaje. |
| **Recargar** (libro)               | Vuelve a leer todos los archivos (`/koth reload`). Los eventos en curso siguen.                                                                                                                                                          |
| **Cerrar** (barrera)               | Cierra el menú.                                                                                                                                                                                                                          |

Con muchos KOTHs, las flechas de abajo van a la página siguiente y a la anterior.

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2FLahEDM4ihs1q1yCd5ABQ%2Frnkoth-es-editor-main.png?alt=media" alt="La página principal: cada KOTH muestra su estado, modo, zonas y próximo inicio"><figcaption><p>La página principal: cada KOTH muestra su estado, modo, zonas y próximo inicio</p></figcaption></figure>

## Página de un KOTH

El objeto de arriba muestra el archivo (`koths/<nombre>.yml`), el modo y todas las zonas.

**Ajustes**

| Botón                   | Opción                                                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Activado**            | `enabled`: desactivado = nunca empieza por su horario.                                                                                     |
| **Modo**                | `mode`: `capture` o `score`.                                                                                                               |
| **Nombre visible**      | `display-name`: escríbelo en el chat. Los colores funcionan.                                                                               |
| **Icono**               | Sostén un objeto en la mano y haz clic: pasa a ser el icono en los menús.                                                                  |
| **Equipos**             | `teams`: `default` (como en `config.yml`) o `solo`, que se muestran como `default (como en config.yml)` y `solo (cada uno por su cuenta)`. |
| **Mínimo de jugadores** | `min-players` (de 0 a 200).                                                                                                                |
| **Cuenta atrás**        | `start-countdown` (de 0 a 600 segundos).                                                                                                   |

**Herramientas de zona**

| Botón                          | Qué hace                                                                                                                                                                                                                                         |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Definir zona con la varita** | Usa la selección de tu varita como única zona. Sin selección, recibes la varita.                                                                                                                                                                 |
| **Añadir otra zona**           | Añade la selección de tu varita como una zona más (el KOTH se moverá entre ellas).                                                                                                                                                               |
| **Zona redonda aquí**          | Un círculo a tu alrededor. Escribe el radio (de 1 a 200) o haz clic en una de las respuestas. Reemplaza las zonas. Mantiene la altura de la primera zona, o tiene 5 bloques de alto cuando el KOTH todavía no tiene zona (como `/koth setzone`). |
| **Zona cuadrada aquí**         | Un cuadrado a tu alrededor. Escribe cuántos bloques hay del centro a cada lado (`3` = 7 × 7) o haz clic en `[5x5] [7x7] [11x11] [15x15]`. Reemplaza las zonas. La misma altura que **Zona redonda aquí**.                                        |
| **Altura de la zona**          | Clic izquierdo +1, clic derecho −1, Shift ±5 (de 3 a 384, como `/koth setzone`). Cambia la altura de todas las zonas, desde su suelo hacia arriba.                                                                                               |
| **Mostrar las zonas**          | Partículas durante 10 segundos, solo para ti. La primera zona es amarilla y las demás azules.                                                                                                                                                    |
| **Teletransportarse**          | Te lleva al centro de la zona (necesita `rnkoth.teleport`).                                                                                                                                                                                      |
| **Quitar todas las zonas**     | Shift + clic.                                                                                                                                                                                                                                    |
| **Moverse cada (s)**           | `roaming.move-every` (de 0 a 3600).                                                                                                                                                                                                              |

**La pelea**

| Botón                     | Opción                                                                                                                                                                                                                                             |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tiempo de captura (s)** | `capture.time` (de 5 a 3600).                                                                                                                                                                                                                      |
| **Al salir**              | `capture.on-leave`: `reset`, `pause` o `drain`.                                                                                                                                                                                                    |
| **Puntos para ganar**     | `score.target` (de 10 a 100000).                                                                                                                                                                                                                   |
| **Duración**              | `duration` (de 30 a 86400, o `0` = sin límite de tiempo). Clic derecho por debajo de 30 lo pone en `0`, que se muestra como `Sin límite`.                                                                                                          |
| **Tiempo extra (s)**      | `overtime` (de 0 a 3600).                                                                                                                                                                                                                          |
| **En disputa**            | `contested`: `freeze` → `majority` → `holder` → `everyone`. La descripción explica cada valor en una línea, y el valor se muestra con un nombre que se entiende, p. ej. `holder (defiende el rey)`. Con equipos en solo usa `holder` o `everyone`. |
| **Orden de movimiento**   | `roaming.order`: `next` o `random`.                                                                                                                                                                                                                |

**Otras páginas y acciones**

| Botón                        | Qué hace                                                                                                   |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Quién lo ve**              | Abre la página [Quién lo ve](#quién-lo-ve).                                                                |
| **Reglas**                   | Abre la página de [Reglas](#reglas).                                                                       |
| **Lo que ven los jugadores** | Abre la página de [Lo que ven los jugadores](#lo-que-ven-los-jugadores).                                   |
| **Premios**                  | Abre la página de [Premios](#premios).                                                                     |
| **Cofre de botín**           | Abre el [cofre de botín](#cofre-de-botín).                                                                 |
| **Horario**                  | Abre la página de [Horario](#horario).                                                                     |
| **Iniciar ahora / Detener**  | Inicia el KOTH con su cuenta atrás (`rnkoth.start`), o lo detiene sin ganador (`rnkoth.stop`).             |
| **Estado** (lámpara)         | Muestra si está en curso, iniciando, listo, desactivado o sin zona, con quien domina y el tiempo restante. |
| **Eliminar KOTH** (TNT)      | Shift + clic. El archivo se mueve a `backups/`.                                                            |

## Reglas

| Botón                                 | Opción                                                                        |
| ------------------------------------- | ----------------------------------------------------------------------------- |
| **Sin vuelo dentro**                  | `rules.deny-flight`                                                           |
| **Sin élitros dentro**                | `rules.deny-elytra`                                                           |
| **Sin perlas de ender hacia la zona** | `rules.deny-ender-pearls`                                                     |
| **Los invisibles cuentan**            | `rules.invisible-players-count`                                               |
| **AFK tras (s)**                      | `rules.afk-seconds` (de 0 a 3600)                                             |
| **Proteger bloques**                  | `rules.protect-blocks`                                                        |
| **Comandos bloqueados**               | Clic para añadir uno (escrito en el chat), Shift + clic para vaciar la lista. |

`rules.counted-gamemodes` solo está en el archivo.

## Lo que ven los jugadores

| Botón                         | Opción                                                                                                     |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Quién lo ve**               | Abre la página [Quién lo ve](#quién-lo-ve) (su botón Volver regresa aquí).                                 |
| **Color de la barra de jefe** | `display.boss-bar-color`                                                                                   |
| **Holograma**                 | `display.hologram`                                                                                         |
| **Altura del holograma**      | `display.hologram-height`: ±0.5 con clic izquierdo / derecho, ±2 con Shift, Q para escribirla (de 0 a 30). |
| **Partículas del borde**      | `display.border-particles`                                                                                 |
| **Brillo de quien domina**    | `display.glow-holder`                                                                                      |
| **Nombre del mundo**          | `display.world-name`: escríbelo en el chat.                                                                |

Los antiguos botones **Barra de jefe**, **Localizador** y **Radio** ahora están en **Quién lo ve**.

## Quién lo ve

Quién recibe cada parte del KOTH (`display.audience`, ver [Quién ve qué](https://realisticnode.gitbook.io/rnsetups/es/rnkoth/configuration/pages/dB0L8q0dtvCgpZK0Y9Uj#quién-ve-qué)). Se abre desde la página del KOTH o desde **Lo que ven los jugadores**.

| Botón                                | Opción                                                                                                                          |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Anuncios** (campana)               | `display.audience.announcements`: cuenta atrás, avisos de "empieza en", abierto, se movió, prórroga, detenido y los resultados. |
| **Mensajes de captura** (libro)      | `display.audience.capture-messages`: está capturando, lo tomó, perdió el control, en disputa.                                   |
| **Títulos** (cartel)                 | `display.audience.titles`: título de inicio y "X ganó" para los demás.                                                          |
| **Sonidos** (bloque musical)         | `display.audience.sounds`                                                                                                       |
| **Barra de jefe** (cabeza de dragón) | `display.audience.boss-bar`                                                                                                     |
| **Barra lateral** (marco)            | `display.audience.sidebar`, que sigue `%rnkoth_near%`.                                                                          |
| **Localizador** (brújula)            | `display.audience.locator`                                                                                                      |
| **Barra de acción dentro**           | `display.audience.action-bar`: activado / desactivado.                                                                          |
| **Quién lo ve** (libro)              | Explica los valores.                                                                                                            |
| **Discord**                          | `display.audience.discord`: activado / desactivado.                                                                             |

Cada botón dice qué es esa parte y quién la recibe ahora: "Todo el servidor", "Este mundo", "A 150 bloques", "Mundos: pvp, arena", "Región: spawn" o "Desactivado". Una parte desactivada para todos los KOTHs en **Ajustes generales** lo indica, y una parte que aún no está en el archivo (archivos antiguos) dice que sale de los ajustes antiguos.

| Clic                     | Hace                                                                                                                                                                                                                                         |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Clic izquierdo           | Todo el servidor → Este mundo → una distancia → Desactivado → Todo el servidor                                                                                                                                                               |
| Clic derecho             | Al revés                                                                                                                                                                                                                                     |
| Shift + clic izq. / der. | Distancia +50 / -50 bloques (un valor que no es una distancia pasa a serlo)                                                                                                                                                                  |
| `Q` (tecla de soltar)    | Escribe cualquier valor en el chat (`server`, `world`, `250`, `worlds:pvp,arena`, `region:spawn`, `off`), o haz clic en uno de los propuestos. Un mundo o una región que no existen, o `region:` sin WorldGuard, se rechazan con un mensaje. |

## Premios

La página muestra todas las listas de premios con su número de líneas:

| Botón                                              | Lista                                                     |
| -------------------------------------------------- | --------------------------------------------------------- |
| **Ganador**                                        | `rewards.winner`                                          |
| **2.º puesto** / **3.er puesto**                   | `rewards.second` / `rewards.third`                        |
| **Participación**                                  | `rewards.participation`                                   |
| **Mientras domina**                                | `rewards.while-holding`                                   |
| **Rey eliminado**                                  | `rewards.holder-killed`                                   |
| **Comandos al iniciar** / **Comandos al terminar** | `commands.on-start` / `commands.on-end`                   |
| **Cofre de botín**                                 | Abre el cofre de botín.                                   |
| **Tiempo de participación (s)**                    | `rewards.participation-seconds`                           |
| **Mientras domina, cada (s)**                      | `rewards.while-holding-every`                             |
| **Modo de botín**                                  | `loot.mode`: `all` o `random`                             |
| **Ítems de botín al azar**                         | `loot.amount` (de 1 a 54)                                 |
| **Líneas de premio** (libro)                       | Una lista corta de todas las acciones, como recordatorio. |

### Una lista de premios

Haz clic en una lista para ver sus líneas. Cada línea es un papel:

| Clic                             | Qué hace                                                                                                |
| -------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Clic izquierdo en una línea      | Escribe una versión nueva en el chat.                                                                   |
| Clic derecho en una línea        | La quita.                                                                                               |
| **Añadir una línea** (esmeralda) | Escribe una línea nueva en el chat, como `[console] give {player} diamond 5` o `[item] golden_apple 2`. |

Los grupos (`chance` y `pick-one`, ver [Premios](/rnsetups/es/rnkoth/guides/rewards.md#grupos)) se muestran como un saco. Puedes quitarlos con clic derecho, pero se editan en el archivo.

## Cofre de botín

Un cofre de 54 espacios. Pon los objetos que da la acción `[loot]` (mantienen encantamientos, nombres y datos personalizados) y ciérralo para guardar. El chat dice cuántos stacks se guardaron.

## Horario

| Objeto                                            | Qué hace                                                                                                                                                                                                     |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Líneas del horario** (relojes, filas de arriba) | Cada línea de `schedule`, mostrada en tu idioma. Clic derecho para quitarla. Una línea que no se entiende se muestra como una barrera.                                                                       |
| **Horas ya preparadas** (tintes)                  | `cada 1h`, `cada 2h`, `cada 3h`, `cada 6h`, `cada 12h`, `cada 24h`, `diario 20:00`, `fines de semana 18:00`. Clic para añadirla, clic otra vez para quitarla. El lore te dice cuándo sería el primer inicio. |
| **Añadir una hora** (esmeralda)                   | Escribe cualquier línea, como `mon,fri 18:30`. Se revisa antes de guardarla.                                                                                                                                 |
| **Próximos inicios** (catalejo)                   | Los próximos cinco inicios y la zona horaria.                                                                                                                                                                |
| **Zona horaria** (reloj)                          | `timezone` de `config.yml`, la usan todos los KOTHs. Clic izquierdo / derecho pasa por las zonas más comunes; Shift + clic o Q para escribir una (`server` = la zona horaria del servidor).                  |
| **Avisos antes del inicio** (campana)             | `announce-before`: escribe tiempos como `10m,5m,1m,10s`, o `none`.                                                                                                                                           |

## Ajustes generales

Opciones de `config.yml`:

| Botón                                              | Opción                                                                              |
| -------------------------------------------------- | ----------------------------------------------------------------------------------- |
| **Idioma**                                         | `language`: pasa por los archivos de idioma de `languages/`.                        |
| **Idioma de cada jugador**                         | `per-player-language`                                                               |
| **Equipos**                                        | `teams.mode`: `solo`, `scoreboard` o `placeholder`                                  |
| **Placeholder de equipo**                          | `teams.placeholder`                                                                 |
| **Reanudar tras reinicio**                         | `events.resume-after-restart`                                                       |
| **Espera tras morir (s)**                          | `events.death-cooldown` (de 0 a 120)                                                |
| **Máx. KOTHs a la vez**                            | `events.max-at-once` (de 0 a 50)                                                    |
| **Fuegos artificiales de victoria**                | `events.winner-fireworks`                                                           |
| **Action bar dentro**                              | `display.action-bar`                                                                |
| **Localizador (todos los KOTHs)**                  | `display.locator`                                                                   |
| **Barra lateral (todos los KOTHs)**                | `display.sidebar` (desactivada = ningún KOTH la muestra)                            |
| **Distancia de la barra lateral (KOTHs antiguos)** | `display.sidebar-radius`: solo para archivos de KOTH sin `display.audience.sidebar` |
| **Títulos**                                        | `display.titles`                                                                    |
| **Discord**                                        | `discord.enabled`                                                                   |
| **URL del webhook de Discord**                     | `discord.webhook-url`                                                               |
| **Mención de Discord**                             | `discord.mention`                                                                   |
| **Zona horaria**                                   | `timezone`                                                                          |
| **Estilo de progreso**                             | `display.progress-style`: `both`, `bar` o `percent`                                 |
| **Buscar actualizaciones**                         | `update-checker`                                                                    |

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2F62fjpkxCiKmlKgQ7FeIu%2Frnkoth-es-editor-general.png?alt=media" alt="Ajustes generales: la opción Idioma"><figcaption><p>Ajustes generales: la opción Idioma</p></figcaption></figure>

{% hint style="info" %}
Si editas un archivo a mano, el editor muestra los valores nuevos a los pocos segundos de guardarlo (con `auto-reload` activado).
{% endhint %}

## Cambiar los textos del editor

Todos los textos del editor están en el archivo de idioma, en `editor`:

| Clave                                                          | Texto                                                                  |
| -------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `editor.opt.<opción>`                                          | Nombre (primera línea) y explicación (las demás líneas) de cada opción |
| `editor.help-toggle`, `help-number`, `help-cycle`, `help-text` | La ayuda de clics que se añade debajo de cada opción                   |
| `editor.value-on`, `editor.value-off`                          | "Activado" / "Desactivado"                                             |
| `editor.saved`, `editor.save-failed`                           | Mensajes del chat después de un cambio                                 |
| `editor.type-...`                                              | Las preguntas que se hacen en el chat                                  |
| `editor.main-title`, `hill-title`, `rules-title`...            | Títulos de los menús                                                   |
