> 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/koth-file.md). # Archivos de KOTH Todas las opciones de un archivo de KOTH (plugins/rnKoth/koths/\.yml). Cada KOTH tiene su propio archivo: `plugins/rnKoth/koths/.yml`. Lo crea `/koth create ` (o el editor) a partir de una plantilla con todas las opciones y su explicación. Todo lo de aquí también se puede cambiar con `/koth editor `. El nombre del archivo es el nombre del KOTH, el que se usa en los comandos y los placeholders. Solo puede usar `a-z`, `0-9`, `-` y `_`, hasta 32 caracteres. Las palabras que usan los [placeholders](/rnsetups/es/rnkoth/reference/placeholders.md#nombres-que-no-puedes-usar) no pueden ser nombres de KOTH: `running`, `current`, `next`, `top`, `hud`, los nombres de las estadísticas (`wins`, `captures`, `events`, `time`, `time_formatted`, `kills`, `king`, `king_kills`) y los nombres que empiezan por `top_`, `next_` o `current_`. {% hint style="info" %} Puedes copiar un archivo de KOTH para crear uno nuevo: copia `spawn.yml` como `arena.yml` y guarda. El KOTH nuevo aparece a los pocos segundos (con `auto-reload` activado) o después de `/koth reload`. {% endhint %} ## Lo básico | Opción | Por defecto | Qué hace | | -------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `display-name` | `Nombre` | Nombre que ven los jugadores. Los colores funcionan: ``, `<#ff8800>`, `&6`... | | `enabled` | `true` | `false` = nunca empieza por su horario. Aun así se puede iniciar con `/koth start`. | | `icon` | `BEACON` | Objeto que representa a este KOTH en los menús. En el editor: sostén un objeto y haz clic en **Icono**. | | `mode` | `capture` | `capture`: gana el primer bando que lo domina solo durante `capture.time` segundos. `score`: 1 punto por segundo mientras lo dominas, gana el primero que llega a `score.target` (o el que tiene más puntos cuando se acaba el tiempo). | ## Zonas ```yaml zones: - 'box world 100 64 100 110 66 110' - 'circle world -80 65 30 6 4' ``` Una línea por zona. Ponlas en el juego con la varita y `/koth setzone`, o con `/koth setzone circle `. Ver [Tu primer KOTH](/rnsetups/es/rnkoth/guides/first-koth.md). | Línea | Significado | | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | `box ` | Una caja entre dos bloques de esquina, los dos incluidos. `y1` es el suelo donde se paran los jugadores. | | `circle ` | Un círculo alrededor del bloque `x y z`, desde `y` hacia arriba, de `height` bloques de alto. | * Las zonas tienen **al menos 3 bloques de alto**. Una zona más baja se hace de 3 bloques de alto y la consola te avisa. * Una línea `circle` sin altura tiene 5 bloques de alto. * Con dos o más líneas, el KOTH se mueve entre ellas (ver `roaming`). ## Movimiento entre zonas Solo se usa cuando hay varias zonas. | Opción | Por defecto | Qué hace | | -------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `roaming.move-every` | `120` | Segundos entre movimientos durante un evento. `0` = no se mueve durante el evento; cada evento nuevo usa la siguiente zona (se recuerda entre reinicios). | | `roaming.order` | `next` | `next` = en el orden de la lista. `random` = cualquier otra zona. | ## Captura | Opción | Por defecto | Qué hace | | ---------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `capture.time` | `120` | Segundos para dominar el KOTH (modo captura). | | `capture.on-leave` | `reset` | Qué pasa con tu progreso cuando sales o mueres. `reset`: vuelve a 0. `pause`: se mantiene, y cualquier otro primero tiene que bajarlo a 0 (tira y afloja). `drain`: baja poco a poco mientras no hay nadie dentro. | | `capture.drain-speed` | `1.0` | Qué tan rápido baja el progreso con `drain`. `1.0` = 1 segundo por segundo. | | `capture.best-wins-when-time-ends` | `true` | Cuando se acaba el tiempo, gana el bando con más progreso. `false` = nadie gana. | ## Puntos | Opción | Por defecto | Qué hace | | -------------- | ----------- | ---------------------------------------------------------- | | `score.target` | `300` | Puntos para ganar (1 punto por segundo dominando el KOTH). | ## El evento | Opción | Por defecto | Qué hace | | ------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `duration` | `900` | Segundos que dura el evento (al menos 10). `0` = sin límite de tiempo: sigue abierto hasta que alguien lo conquiste (captura) o llegue al objetivo (puntos), o un admin lo pare con `/koth stop`. Con `0`, `overtime` y `capture.best-wins-when-time-ends` no se aplican, y el tiempo restante muestra `Sin límite`. | | `overtime` | `60` | Segundos extra cuando se acaba el tiempo mientras el KOTH está en disputa o alguien está capturando. `0` = desactivado. El evento termina en cuanto acaba la pelea. | | `contested` | `holder` | Cuando hay jugadores de bandos distintos (equipos, o jugadores por su cuenta) dentro. `freeze`: nadie avanza hasta que quede un solo bando. `majority`: el bando con más jugadores dentro sigue avanzando, empate = nadie (no sirve con equipos en solo). `holder`: el bando que ya estaba avanzando sigue avanzando, los demás tienen que matarlo o sacarlo. `everyone`: todos los bandos de dentro avanzan a la vez, gana el primero en terminar. Los KOTHs nuevos traen `holder`; un archivo sin esta línea usa `freeze`. | | `min-players` | `2` | Jugadores conectados al servidor necesarios para un inicio programado. No cuentan los jugadores en vanish ni los espectadores. `0` = siempre empieza. | | `teams` | `default` | `default`: equipos según `config.yml` (`teams.mode`). `solo`: en este KOTH cada jugador juega por su cuenta. | Ver [Modos de juego](/rnsetups/es/rnkoth/guides/modes.md) para cómo funcionan juntas. ## Horario | Opción | Por defecto | Qué hace | | ----------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `schedule` | `[]` | Cuándo empieza solo. Una línea por hora: `'daily 20:00'`, `'mon,wed,fri 18:30'`, `'weekdays 19:00'`, `'weekends 16:00'`, `'every 2h'`, `'every 45m'`, `'2026-12-24 21:00'`. | | `announce-before` | `[300, 60, 10]` | Avisa a los jugadores esta cantidad de segundos antes de un inicio programado. | | `start-countdown` | `10` | Cuenta atrás en segundos antes de que se abra el KOTH, también para `/koth start`. `0` = se abre enseguida. | Ver [Horarios](/rnsetups/es/rnkoth/guides/schedules.md) para todos los formatos. ## Visualización | Opción | Por defecto | Qué hace | | ----------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `display.audience.announcements` | `server` | Quién recibe la cuenta atrás, los avisos de "empieza en", abierto, se movió, prórroga, detenido y los resultados. | | `display.audience.capture-messages` | `world` | Quién recibe "X está capturando", "X lo tomó", "X perdió el control" y "en disputa". | | `display.audience.titles` | `world` | Quién ve el título de inicio y el de "X ganó" (los ganadores siempre ven el suyo). | | `display.audience.sounds` | `world` | Quién oye los sonidos del evento. | | `display.audience.boss-bar` | `150` | Quién ve la boss bar con quien domina, el progreso y el tiempo restante. | | `display.audience.sidebar` | `60` | Quién ve la barra lateral de rnKoth. `%rnkoth_near%` vale `yes` para ellos. | | `display.audience.locator` | `world` | Quién recibe la flecha y la distancia en la action bar estando fuera de la zona. | | `display.audience.action-bar` | `on` | Progreso en la action bar mientras estás en la zona: `on` u `off`. | | `display.audience.discord` | `on` | Publicar este KOTH en Discord (si Discord está configurado en `config.yml`): `on` u `off`. | | `display.boss-bar-color` | `YELLOW` | `PINK`, `BLUE`, `RED`, `GREEN`, `YELLOW`, `PURPLE` o `WHITE`. Se pone roja mientras está en disputa. | | `display.hologram` | `true` | Texto flotante sobre el KOTH con su estado. No hace falta ningún otro plugin. | | `display.hologram-height` | `3.5` | Bloques sobre el suelo de la zona. | | `display.border-particles` | `true` | Partículas en el borde de la zona mientras está en curso: blanco = libre, verde = tu bando, naranja = otro bando, rojo = en disputa. | | `display.glow-holder` | `true` | Los jugadores que dominan el KOTH brillan para que todos los vean. | | `display.world-name` | `''` | Nombre que se muestra en lugar del nombre del mundo en los mensajes, como `Spawn` o `/warp pvp`. `''` = el nombre del mundo, o `world-names` de `config.yml`. | Cada parte de `display.audience` acepta `server` (todos los jugadores), `world` (el mundo del KOTH), un número de bloques como `150`, `worlds:pvp,arena`, `region:` u `off`. Ver [Quién ve qué](https://realisticnode.gitbook.io/rnsetups/es/rnkoth/configuration/pages/dB0L8q0dtvCgpZK0Y9Uj#quién-ve-qué). Los archivos antiguos pueden tener todavía `display.radius`, `display.boss-bar` y `display.locator`: solo se usan para las partes de `display.audience` que el archivo no tiene (ver [Archivos de KOTH antiguos](/rnsetups/es/rnkoth/guides/display.md#archivos-de-koth-antiguos)). Ver [Lo que ven los jugadores](/rnsetups/es/rnkoth/guides/display.md). ## Reglas | Opción | Por defecto | Qué hace | | ------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `rules.deny-flight` | `true` | Los jugadores dentro no pueden volar (`/fly`) mientras el KOTH está en curso. | | `rules.deny-elytra` | `true` | Los jugadores dentro no pueden planear con élitros. | | `rules.deny-ender-pearls` | `false` | No se pueden lanzar perlas de ender hacia la zona. | | `rules.invisible-players-count` | `false` | Los jugadores invisibles cuentan para la captura. | | `rules.afk-seconds` | `60` | Los jugadores que no se mueven durante estos segundos dejan de contar. `0` = desactivado. | | `rules.counted-gamemodes` | `[SURVIVAL, ADVENTURE]` | Modos de juego que cuentan. | | `rules.blocked-commands` | `[]` | Comandos que los jugadores no pueden usar dentro de la zona mientras el KOTH está en curso, como `['home', 'spawn', 'tpa']`. | | `rules.protect-blocks` | `false` | Nadie puede romper ni colocar bloques dentro de la zona (ni en su suelo) mientras está en curso. `rnkoth.bypass.rules` sí puede. | Ver [Reglas dentro de la zona](/rnsetups/es/rnkoth/guides/rules.md). ## Premios | Opción | Por defecto | Qué hace | | ------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `rewards.winner` | botín, 3 diamantes, un fuego artificial | Todos los del bando ganador que estuvieron en el KOTH. El título `¡VICTORIA!` es integrado (`display.titles` en `config.yml`), así que no es una línea de premio. | | `rewards.second` | `[]` | El 2.º mejor bando. | | `rewards.third` | `[]` | El 3.er mejor bando. | | `rewards.participation` | 2 lingotes de hierro | Todos los que estuvieron en el KOTH al menos `participation-seconds`. | | `rewards.participation-seconds` | `30` | Segundos dentro (contando) necesarios para `participation`. | | `rewards.while-holding` | `[]` | Se da cada pocos segundos a los jugadores que dominan el KOTH. | | `rewards.while-holding-every` | `30` | Segundos entre los premios de `while-holding`. | | `rewards.holder-killed` | un mensaje | Se da a quien mata a un jugador que domina el KOTH. | Cada línea es una acción como `'[console] eco give {player} 500'`. Ver [Premios](/rnsetups/es/rnkoth/guides/rewards.md) para todas las acciones, probabilidades y grupos. ## Comandos | Opción | Por defecto | Qué hace | | ------------------- | ----------- | ------------------------------------------------------------------------------------ | | `commands.on-start` | `[]` | Comandos de consola que se ejecutan cuando se abre el KOTH. | | `commands.on-end` | `[]` | Comandos de consola que se ejecutan cuando termina. `{winner}` es el ganador, o `-`. | Placeholders: `{koth}`, `{koth_name}`, `{winner}` y los demás de [Premios](/rnsetups/es/rnkoth/guides/rewards.md#comandos-al-iniciar-y-al-terminar). También funcionan las palabras `{@ruta}` (en el idioma del servidor) y los placeholders de PlaceholderAPI (sin jugador). ## Botín | Opción | Por defecto | Qué hace | | ------------- | ----------- | -------------------------------------------------------------------------------------------- | | `loot.mode` | `all` | `all` = todos los objetos del cofre de botín. `random` = `amount` objetos al azar. | | `loot.amount` | `1` | Cuántos objetos se dan con `mode: random`. | | `loot.items` | `[]` | Los objetos que da `[loot]`. Llénalos en el juego: `/koth editor ` → Cofre de botín. | ## Opciones que faltan Un archivo de KOTH no necesita todas las opciones. Una opción que falta usa su valor integrado, que es el mismo que el valor por defecto de las tablas de arriba (y de la plantilla). La excepción es `display.audience`: una parte que falta funciona como antes de la 1.0.1 (`display.radius`, y `sidebar-radius` / `locator-radius` de `config.yml`), así que los archivos antiguos siguen funcionando igual. Algunos números tienen un valor mínimo: `capture.time` y `score.target` al menos `1`, `duration` al menos `10` (o `0` = sin límite de tiempo), `drain-speed` al menos `0.05`, `while-holding-every` al menos `1` y `loot.amount` al menos `1`. Una palabra mal escrita (como `mode: capure`) usa el valor por defecto. {% hint style="warning" %} Si un archivo de KOTH tiene un error de YAML, la consola muestra la línea y el KOTH **mantiene la última versión que se leyó sin errores**: un evento en curso sigue, y `/koth reload` dice que algunos archivos tienen errores. Arregla la línea y guarda; se aplica a los pocos segundos. (Un archivo que ya está roto cuando arranca el servidor todavía no tiene una versión buena: usa los valores integrados, sin zona, hasta que lo arregles.) {% endhint %}