Referencia

Configuración

Todos los archivos que escribe el plugin y qué vive en cada uno.

Los archivos viven en plugins/ExyliaCapture/. Todos se escriben en el primer arranque con sus valores por defecto y con comentarios en cada clave.

config.yml

Todo lo global. Los ajustes por evento no están aquí — viven en la base de datos y se editan desde el panel.

scheduler

scheduler:
  timezone: ""

timezonezona horariapor defecto vacío

Contra qué reloj se leen los horarios. Vacío usa el ajuste timezone de ExyliaLib, que es donde una red debería fijarlo una sola vez. Acepta un identificador IANA como America/New_York; uno que no existe se registra como error y se usa en su lugar la zona de ExyliaLib.

particles

particles:
  enabled: true
  interval-ticks: 40
  particle: WAX_ON
  view-distance: 48.0

El contorno alrededor de las zonas de un evento activo. Explicado en Zonas.

event-visuals

Un bloque por tipo de evento, con el identificador del tipo como clave — koth, koth_points_exclusive, koth_points_multi, koth_capture_points, conquest, payload, dtc y bounty —, cada uno con un boss-bar y un hologram. Un tipo que llega con una actualización escribe su propia entrada en el siguiente arranque. Explicados en Elementos en pantalla.

leaderboard

leaderboard:
  top-limit: 50
  use-player-heads: true
  rank-materials:
    first: GOLD_BLOCK
    second: IRON_BLOCK
    third: COPPER_BLOCK
    default-player: PLAYER_HEAD
    default-clan: SHIELD
  filter-materials:
    active: LIME_CONCRETE
    inactive: RED_CONCRETE

Explicado en Estadísticas.

Los tiempos de las pantallas de admin se escriben

Cada duración de las pantallas de evento, de zona y de Destroy The Core se pide como una cantidad de tiempo — 30s, 2m30s, 1h — en vez de subirla a clics, y lo que el plugin escribe de vuelta se lee igual.

scoreboards.yml

Tres secciones, las dos primeras con el identificador del tipo como clave: un sidebar por tipo para cuando corre un solo evento, las líneas compactas que aporta cada evento cuando corren varios, y el sidebar compartido multi-evento. Ver Elementos en pantalla.

messages.yml

Todos los mensajes, agrupados por sistema:

Sección	Contiene
`prefix`	Lo que rellena `%prefix%` en el resto.
`events`	Inicio, fin, ganador y tiempo agotado, comunes a todos los tipos.
`koth-capture-points`	Mensajes propios de ese tipo.
`conquest`	Mensajes de Conquest, incluidos los formatos de línea de zona.
`payload`	Mensajes de Payload.
`dtc`	Mensajes de Destroy The Core.
`bounty`	El objetivo elegido, revelado, abatido, perdido o superviviente.
`admin`	Respuestas del panel y de los comandos.
`leaderboard`	Las pantallas de leaderboard.
`tabs`	La tira de pestañas dentro de los menús.
`event-list`	La lista de `/capture`.
`reward-preview`	Cómo se describen las recompensas a los jugadores.
`placeholders`	Las palabras de reserva: ninguno, desconocido, no aplica, raya.
`holograms`	Lo que muestra un holograma antes de que el evento tenga un valor: empieza en, inactivo, zona vacía, carro parado.
`event-types`	El nombre de cada tipo, sus tres líneas de descripción y su etiqueta de categoría, por identificador de tipo.
`rewards`	`claimed`, enviado al conectarse cuando se entregan recompensas que estaban esperando, con `%amount%`.

database.yml

Motor y credenciales. Ver Instalación · Elegir motor.

menus/

El diseño de los menús en YAML, editable sin tocar código.

menus/
├── admin/    panel, lista y setup de eventos, selector de tipo, lista y editor de
│             zonas de Conquest, horarios, comandos y recompensas, y una pantalla
│             de ajustes por tipo: koth_settings, koth_points_settings,
│             koth_capture_points_settings, conquest_settings, payload_settings,
│             dtc_settings, bounty_settings
└── user/     lista de eventos, leaderboards de jugador y clan, filtro por evento

Se pueden cambiar iconos, posiciones, títulos, lore y sonidos. Las claves de acción de cada botón son las que lo enlazan con lo que hace: consérvalas.

Migraciones

config.yml está en la versión 3 y scoreboards.yml en la versión 2. Un archivo anterior se migra en el primer arranque tras actualizar, y cada valor que hubieras puesto se conserva en vez de regenerarse:

De la versión 2 a la 3 — los bloques por tipo pasan a event-visuals, con el identificador del tipo como clave. koth-capture-points pasa a ser koth_capture_points, y koth-points se divide en koth_points_exclusive y koth_points_multi, los dos partiendo de lo que decía.
scoreboards.yml — scoreboards y compact-lines cambian de clave de la misma forma.
Versión 1 — se elimina la sección interna y color y style de las boss bars pasan a llamarse colour y overlay.

Las claves desconocidas se eliminan

Una clave que ningún archivo declara se borra al cargar y se reporta una vez como UNKNOWN_KEY. Es lo que mantiene los archivos limpios entre actualizaciones, y por eso añadirles claves propias no funciona.

¿Falta algo en esta página? Dínoslo en Discord