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

# Horarios

Todas las formas de escribir cuándo empieza un KOTH, zonas horarias, avisos, cuentas atrás y mínimo de jugadores.

Un KOTH empieza solo a las horas de su lista `schedule`. Una línea por hora. Un KOTH con la lista vacía solo empieza con `/koth start`.

```yaml
schedule:
  - 'daily 20:00'
  - 'weekends 16:00'
  - 'every 6h'
```

La forma más fácil de editarla es `/koth editor <nombre>` → **Horario**. Ver [Editor en el juego](/rnsetups/es/rnkoth/configuration/editor.md#horario).

<figure><img src="https://1485480385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQaixEy8lxLssO2tL4Sxc%2Fuploads%2F0iY4EkpuYyLt53FZsqIL%2Frnkoth-es-editor-schedule.png?alt=media" alt="La página Horario: cada horario listo dice cuándo sería su primer inicio"><figcaption><p>La página Horario: cada horario listo dice cuándo sería su primer inicio</p></figcaption></figure>

## Formatos

| Línea               | Cuándo empieza                                           |
| ------------------- | -------------------------------------------------------- |
| `daily 20:00`       | Todos los días a las 20:00. `20:00` solo también sirve.  |
| `mon,wed,fri 18:30` | Esos días a las 18:30.                                   |
| `weekdays 19:00`    | De lunes a viernes a las 19:00.                          |
| `weekends 16:00`    | Sábado y domingo a las 16:00.                            |
| `every 2h`          | Cada 2 horas: 00:00, 02:00, 04:00...                     |
| `every 45m`         | Cada 45 minutos, contando desde la medianoche.           |
| `every 1h30m`       | Cada hora y media, contando desde la medianoche.         |
| `every 90`          | Un número solo son minutos: cada 90 minutos.             |
| `every 2d`          | Cada 2 días a las 00:00 (un día sí y otro no).           |
| `2026-12-24 21:00`  | Solo ese día, a esa hora. Las fechas pasadas se ignoran. |

Detalles:

* Las **horas** usan el formato de 24 horas: `20:00`, `08:30` o `8:30`.
* **Días**: cuentan las tres primeras letras, así que `mon`, `monday` y `Monday` son lo mismo. Separa los días con comas y sin espacios: `tue,thu`.
* `daily`, `everyday` y `all` significan todos los días. `weekend` funciona igual que `weekends`.
* **`every`** de un día o menos cuenta desde la medianoche y vuelve a empezar cada medianoche. Con `every 2h` los inicios siempre son a horas pares, reinicies el servidor cuando lo reinicies. Si el día no es múltiplo del intervalo (`every 7h`: 00:00, 07:00, 14:00, 21:00), la cuenta vuelve a empezar a las 00:00.
* **`every`** de más de un día (`every 2d`, `every 36h`, `every 1d12h`) cuenta desde un día fijo, el 1 de enero de 1970 a las 00:00 en la `timezone` de `config.yml`, así mantiene su ritmo entre días y reinicios: `every 2d` es un día sí y otro no a las 00:00, `every 36h` es a las 00:00 un día y a las 12:00 el siguiente. Los días se cuentan en hora local, así que un cambio de horario de verano no mueve los inicios.

### Palabras en español

También puedes escribir las líneas en español:

| En español                                     | Igual que           |
| ---------------------------------------------- | ------------------- |
| `diario 20:00`, `todos los días 20:00`         | `daily 20:00`       |
| `cada 2h`                                      | `every 2h`          |
| `entre semana 19:00`                           | `weekdays 19:00`    |
| `fines de semana 16:00`, `fin de semana 16:00` | `weekends 16:00`    |
| `lun,mié,vie 18:30`                            | `mon,wed,fri 18:30` |

Días en español: `lun`, `mar`, `mie` / `mié`, `jue`, `vie`, `sab` / `sáb`, `dom`.

Los menús muestran cada línea en el idioma del jugador que la lee, sin importar en qué idioma se escribió.

## Zona horaria

Todos los horarios usan la `timezone` de `config.yml`:

```yaml
timezone: 'Europe/Madrid'
```

Vacío (`''`) significa la zona horaria de la máquina del servidor, que en los hostings suele ser UTC. Usa los nombres de la [base de datos tz](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), por ejemplo `America/Mexico_City`, `America/Bogota`, `America/Argentina/Buenos_Aires`, `America/New_York` o `UTC`. Un nombre que no existe usa la zona horaria del servidor.

Puedes cambiarla en `/koth editor <nombre>` → Horario → **Zona horaria** (clic izquierdo / derecho para pasar por las zonas más comunes, Shift + clic o Q para escribir una), o en la página de ajustes generales.

## Avisos antes del inicio

```yaml
announce-before: [300, 60, 10]
```

Segundos antes de un inicio **programado** en los que se avisa a los jugadores en el chat (`{koth_name} empieza en 5m. ¡Prepárate!`). `[]` = sin avisos.

En el editor (Horario → **Avisos antes del inicio**) los escribes así: `15m,5m,1m,10s`, o `none`.

Los avisos que no son más largos que `start-countdown` no se envían, porque la cuenta atrás ya cubre esos segundos.

## Cuenta atrás

```yaml
start-countdown: 10
```

Segundos de cuenta atrás antes de que el KOTH se abra, para los inicios programados **y** para `/koth start` (`0` = se abre enseguida). El chat muestra `¡{koth_name} abre en 10s!` con la ubicación (en un KOTH con varias zonas, la zona donde se abrirá), y suena el sonido `countdown`. La cuenta atrás se anuncia al empezar, a los 10 segundos, cada 30 segundos y en los últimos 5 segundos.

`/koth start <nombre> <segundos>` usa otra cuenta atrás solo para ese inicio.

## Mínimo de jugadores

```yaml
min-players: 2
```

Jugadores que deben estar **conectados al servidor** para un inicio programado (`0` = siempre empieza). No cuentan los jugadores en vanish (Essentials, SuperVanish, PremiumVanish y otros plugins que marcan a los jugadores como `vanished`) ni los que están en modo espectador. Un archivo de KOTH sin esta línea usa `2`. Cuando hay menos, el chat dice `{koth_name} no empezó: necesita 2 jugadores conectados (1).` y el KOTH espera a su próxima hora.

`/koth start` siempre lo inicia, sin importar el número de jugadores.

## Cuando no se hace un inicio

Un inicio programado no se hace cuando:

* el KOTH tiene `enabled: false` (aun así se puede iniciar con `/koth start`),
* todavía no tiene zona,
* ya está en curso o en cuenta atrás,
* hay menos jugadores conectados que `min-players`,
* ya hay `events.max-at-once` KOTHs en curso (`0` = sin límite),
* el mundo de una de sus zonas no está cargado,
* otro plugin cancela el inicio (ver [API para desarrolladores](/rnsetups/es/rnkoth/reference/api.md)).

Cuando el inicio falla por otra razón que no sea el número de jugadores, la consola lo muestra, por ejemplo `Hill spawn could not start by its schedule: ...`. Cuando otro plugin cancela un inicio al final de su cuenta atrás, la consola muestra `The start of KOTH spawn was cancelled by another plugin (KothStartEvent).`

{% hint style="info" %}
Si el servidor está apagado a una hora programada, ese inicio no se hace después. El KOTH espera a su próxima hora.
{% endhint %}

## Ver el próximo inicio

* `/koth next`: el KOTH que empieza antes, en cuánto tiempo y a qué hora.
* `/koth list` y `/koth info <nombre>`: el próximo inicio de cada KOTH.
* El holograma de un KOTH en espera: `Próximo evento: 2h 5m`.
* El editor: el objeto **Próximos inicios** muestra los próximos cinco inicios.
* Placeholders: `%rnkoth_next_name%`, `%rnkoth_next_time%`, `%rnkoth_<name>_next%`. Ver [Placeholders](/rnsetups/es/rnkoth/reference/placeholders.md).