Programa eventos
Inicia eventos por hora del día, día de la semana o intervalo, con requisitos de jugadores.
Al terminar esta página un evento arranca solo: a horas fijas, en ciertos días o cada pocas horas, y solo cuando hay suficientes jugadores conectados. Cada evento tiene su propia lista de horarios, así que un KOTH entre semana y un Conquest el sábado no se estorban.
Antes de empezar#
Necesitas un evento ACTIVADO y con su zona fijada (mira Tu primer evento). Un evento desactivado nunca arranca, ni programado ni a mano. Si tu servidor está en otra zona horaria que tus jugadores, lee antes Zona horaria.
Pasos#
Abre los horarios
Ejecuta /captureadmin, haz clic en Configuraciones, clic izquierdo en tu evento y luego en Horarios. El botón muestra cuántos tiene.
Añade uno
Haz clic en el botón de añadir. El formulario ya sabe qué evento inicia, así que no pide un id.
Elige cuándo se ejecuta
En Cuándo se ejecuta elige A horas fijas y escribe las horas en formato de 24 horas, por ejemplo 20:00, 22:30. O elige Repetir cada cierto tiempo y rellena Cada (2h, 90m) con una ventana opcional Desde y Hasta.
Elige los días
Marca los días en que puede ejecutarse. Con todos los días marcados, o ninguno, se ejecuta a diario.
Guarda
Deja Activado marcado y envía el formulario. La entrada aparece en la lista. Una línea sin hora muestra una barrera y "Define una hora antes de que pueda ejecutarse".
Comprueba que funciona#
Añade un horario para dentro de un par de minutos, espera, y el evento debería arrancar y anunciarse. /captureadmin list lo muestra en marcha. Para ver cuándo llega el siguiente, usa %exyliacapture_<id>_time_until_start% (mira Placeholders). Un horario que no se dispara casi siempre es una de las omisiones de Cómo se dispara.
Para ir más allá#
Solo con suficientes jugadores conectados#
En el formulario marca Editar condiciones después. La segunda pantalla, Condiciones del horario, tiene:
- Mínimo de jugadores en línea y Máximo de jugadores en línea (
0es sin límite). - Espera entre ejecuciones, el intervalo más corto entre dos disparos de esta entrada, por ejemplo
1h. - Casillas Solo si ..., una por cada comprobación con nombre que ofrece el plugin (mira abajo).
- Condición personalizada, por ejemplo
%server_tps% >= 18para omitirlo mientras el servidor va con lag.
Varios horarios para un evento#
Un evento puede tener tantas entradas como quieras: tres horas entre semana y una el sábado son dos entradas, una con tres horas y otra con una. Una repetición se ancla a la apertura de su ventana, no al arranque del servidor. Cada dos horas desde las 10:00 dispara a las 10:00, 12:00 y 14:00 sea a la hora que sea que reinicie el servidor.
Cómo se dispara#
Cuando una entrada toca, se ejecutan todas las comprobaciones y el inicio se omite (no se reintenta más tarde) si alguna falla:
- Ese evento ya está en marcha. Esto se comprueba siempre.
- Hay menos del mínimo o más del máximo de jugadores conectados.
- La condición personalizada no se cumple, o no ha pasado la espera entre ejecuciones.
- Una comprobación con nombre que marcaste no se cumple.
Un disparo con más de dos minutos de retraso, por ejemplo tras congelarse el servidor, también se omite. Las omisiones van al registro de depuración de la consola en vez de ser silenciosas.
| Comprobación | Se cumple cuando |
|---|---|
event-inactive | El evento que inicia esta entrada no está en marcha. |
nothing-running | No hay ningún evento de captura en marcha en el servidor. |
nothing-running es la que debes marcar para "inicia este, pero nunca mientras haya otro evento".
Zona horaria#
Todos los horarios se leen con un único reloj:
scheduler:
timezone: ""Vacío, que es el valor por defecto, usa el ajuste timezone de ExyliaLib, donde una red lo fija una vez para todos los plugins. Si no, usa un id de zona como America/New_York o Europe/Madrid, que lo sustituye solo para este plugin. En el juego, /captureadmin, Ajustes y General lo editan.
Un valor que no es un id de zona real, como una abreviatura tipo CET o una errata, se registra como error al cargar y se usa la zona horaria de ExyliaLib. Revisa la consola tras cambiarlo.
Muestra el tiempo hasta el siguiente#
El tiempo hasta el próximo disparo de un evento, entre todas sus entradas, alimenta:
%exyliacapture_<id>_time_until_start%para un evento.%exyliacapture_next_event_time_until_start%para el evento más cercano de todo el servidor.- El estado
SCHEDULEDque muestra un holograma cuando un evento no está en marcha pero tiene un horario próximo.
Un evento sin horarios no informa de nada en vez de cero, y así un holograma distingue "no está en marcha, pero viene" de "no está en marcha".
Iniciar a mano#
Un horario es opcional. /captureadmin start <id> inicia un evento al instante, y también se niega a iniciar uno que ya está en marcha.
Detalles técnicos: campos de un horario
El calendario es el módulo de horarios de ExyliaLib: el mismo editor, los mismos campos y las mismas reglas que cualquier otro plugin de Exylia que arranca cosas con un reloj.
| Campo | Significado |
|---|---|
name | Una etiqueta para la entrada. En blanco se muestran las horas. |
enabled | Si puede dispararse. Activado por defecto. |
days | Nombres de días de la semana, o * para todos. Una lista vacía también significa todos. |
times | Las horas HH:mm en que se dispara, como lista. Una sola time también se lee. |
every | Repetir con esta frecuencia en vez de a horas fijas, como 2h o 90m. |
from / to | La ventana en la que corre una repetición, como HH:mm. |
min-players | Jugadores que deben estar conectados. 0 por defecto. |
max-players | El máximo de jugadores que pueden estar conectados. 0 es sin límite. |
condition | Una comparación de Exylia que debe cumplirse, como %server_tps% >= 18. |
cooldown | El intervalo más corto entre dos disparos de esta entrada. |
requires | Comprobaciones con nombre: event-inactive, nothing-running. Un nombre que el plugin no ofrece nunca se cumple, así que una errata impide que la entrada se dispare. |
¿Falta algo en esta página? Dínoslo en Discord