Contenido generado con IA — puede contener errores.

ExyliaCapture/GuíasActualizada en v1.3.0

Programa eventos

Inicia eventos por hora del día, día de la semana o intervalo, con requisitos de jugadores.

Página 7 de 236 min de lectura

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 (0 es 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% >= 18 para 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ónSe cumple cuando
event-inactiveEl evento que inicia esta entrada no está en marcha.
nothing-runningNo 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:

config.yml
yaml
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 id de zona inválido vuelve al de ExyliaLib

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 SCHEDULED que 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.

CampoSignificado
nameUna etiqueta para la entrada. En blanco se muestran las horas.
enabledSi puede dispararse. Activado por defecto.
daysNombres de días de la semana, o * para todos. Una lista vacía también significa todos.
timesLas horas HH:mm en que se dispara, como lista. Una sola time también se lee.
everyRepetir con esta frecuencia en vez de a horas fijas, como 2h o 90m.
from / toLa ventana en la que corre una repetición, como HH:mm.
min-playersJugadores que deben estar conectados. 0 por defecto.
max-playersEl máximo de jugadores que pueden estar conectados. 0 es sin límite.
conditionUna comparación de Exylia que debe cumplirse, como %server_tps% >= 18.
cooldownEl intervalo más corto entre dos disparos de esta entrada.
requiresComprobaciones 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