Personaliza boss bars, hologramas y sidebars
Cambia la boss bar, los hologramas, los sidebars, los waypoints y el contorno de zona que ven los jugadores en un evento.
Al terminar esta página habrás cambiado lo que ven los jugadores durante un evento: la boss bar de arriba, el holograma sobre la zona y el sidebar. Los waypoints y el HUD de SurvivalCore no necesitan configuración.
Antes de empezar#
- Un evento que exista. Mira Tu primer evento.
- Acceso a
plugins/ExyliaCapture/lang/<código>/messages.ymlyscoreboards.yml, donde<código>es tu idioma. El texto y los colores usan las etiquetas de ExyliaLib: mira Colores y Mensajes e idiomas.
Pasos#
Activa o desactiva la boss bar o el sidebar de un evento
Ejecuta /captureadmin, pulsa Configuraciones, entra en el evento y pulsa Boss bar o Marcador. Cada clic alterna. Todo lo de abajo solo se aplica a eventos donde están activados.
Edita el texto de la boss bar
Abre lang/<código>/messages.yml, busca boss-bars, luego el id del tipo de evento (koth, conquest, payload...) y cambia text, colour u overlay.
Edita las líneas del holograma
En el mismo archivo busca hologram-lines y el id del tipo. Cada elemento de la lista es una línea.
Edita el sidebar
Abre lang/<código>/scoreboards.yml, busca el id del tipo en scoreboards y cambia sus líneas.
Recarga
Ejecuta /captureadmin reload, o pulsa Recargar en /captureadmin.
Comprueba que funciona#
Lanza el evento con /captureadmin start <id>. Debes ver la boss bar con tu texto y color, el holograma sobre la zona y el sidebar a la derecha. El holograma se ve incluso con el evento parado: su última línea dice entonces inactivo o programado.
Ir más allá#
Cuatro capas independientes, cada una con su configuración y sus propios tokens, más lo que dibuja encima un cliente compatible. Los tokens tienen la forma %event_name%; son propios del plugin, no placeholders de PlaceholderAPI, y solo funcionan en el archivo para el que se listan. Para los valores de PlaceholderAPI mira Placeholders.
Boss bar#
Una por tipo de evento, en messages.yml, dentro de boss-bars y del identificador de ese tipo,
así que sigue el idioma del plugin:
boss-bars:
koth:
text: "{highlight}&l%capture_event_name%&r {muted}| {success}⚑ %capture_koth_capturer% {muted}| {info}%capture_koth_player_time% ⌚"
colour: RED
overlay: NOTCHED_20colour acepta PINK, BLUE, RED, GREEN, YELLOW, PURPLE o WHITE; overlay acepta
PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 o NOTCHED_20.
El relleno de la barra es el progreso del propio evento, escrito cada segundo — no hay cuenta atrás en la barra, porque pelearía con ese progreso.
Colores por defecto: KOTH rojo, los dos tipos de KOTH Points azul, KOTH Capture Points morado,
Conquest verde, Payload amarillo, DTC rojo, Bounty rojo. Todas las barras que vienen de serie usan
NOTCHED_20. La de Bounty nombra al objetivo y su vida, y se vacía a medida que el objetivo se
desgasta.
Un evento concreto puede apagar su barra con el ajuste bossbar-enabled.
Hologramas#
También uno por tipo, y a diferencia de la boss bar se muestra aunque el evento no esté
corriendo: la última línea, %event_status%, dice inactivo, programado o corriendo. Lo que dice
está en messages.yml, dentro de hologram-lines y del identificador del tipo; cómo se dibuja —
enabled, tamaño, desplazamientos, distancia de visión — sigue en config.yml, en
event-visuals.<tipo>.hologram.
hologram-lines:
koth:
- "{warning}⚔ {highlight}&l%event_name%"
- " "
- "{letters}Tiempo: {info}%event_time%"
- "{letters}Capturando: {highlight}%koth_capturer%"
- "{letters}T. captura: {info}%koth_player_time%"
- " "
- "%event_status%"Conquest dibuja un holograma por zona, cada uno con el nombre y el progreso de la suya. El de Payload sigue al carro. Bounty no tiene dónde ponerlo y no dibuja ninguno, aunque su bloque se escribe igual.
Dos eventos con una zona en el mismo sitio apilan sus hologramas en vez de dibujarse uno encima de otro, y un evento desactivado no muestra holograma.
Tokens de holograma#
Son los tokens propios del holograma, que se rellenan al dibujar las líneas. No son placeholders de
PlaceholderAPI y solo funcionan dentro de hologram-lines.
Todos los tokens de holograma
| Token | Familia | Qué dibuja |
|---|---|---|
%event_name% | Cualquier evento | El nombre visible del evento. |
%event_time% | Cualquier evento | Tiempo que le queda al evento en curso, o un guion. |
%event_status% | Cualquier evento | Inactivo, el tiempo que falta para empezar, o corriendo. |
%koth_capturer% | KOTH, KOTH Points, Capture Points | Quién tiene la zona ahora mismo — el tag del clan en modo clan. |
%koth_player_time% | KOTH, KOTH Points, Capture Points | Cuánto le falta a la captura en curso para completarse. |
%koth_leader% | KOTH, KOTH Points, Capture Points | Quién va delante en puntos. |
%koth_top1_name% | KOTH, KOTH Points, Capture Points | Primero en puntos. |
%koth_top1_pts% | KOTH, KOTH Points, Capture Points | Sus puntos. |
%koth_top2_name% | KOTH, KOTH Points, Capture Points | Segundo en puntos. |
%koth_top2_pts% | KOTH, KOTH Points, Capture Points | Sus puntos. |
%koth_top3_name% | KOTH, KOTH Points, Capture Points | Tercero en puntos. |
%koth_top3_pts% | KOTH, KOTH Points, Capture Points | Sus puntos. |
%conquest_zone_name% | Conquest | El nombre de la zona a la que pertenece este holograma. |
%conquest_zone_capturer% | Conquest | El clan que está capturando esa zona. |
%conquest_zone_progress% | Conquest | El progreso de captura de esa zona. |
%conquest_leader% | Conquest | El clan que va delante en todo el evento. |
%conquest_top1_clan% | Conquest | Primer clan en puntos. |
%conquest_top1_pts% | Conquest | Sus puntos. |
%conquest_top2_clan% | Conquest | Segundo clan en puntos. |
%conquest_top2_pts% | Conquest | Sus puntos. |
%payload_progress% | Payload | Cuánto ha avanzado el carro por la vía. |
%payload_distance_remaining% | Payload | Cuánto le queda por recorrer. |
%payload_capturing_clan% | Payload | Quién lo está empujando. |
%payload_state% | Payload | El estado del carro. |
%dtc_leader% | DTC | Quién va delante en puntos. |
%dtc_top1_name% | DTC | Primero en puntos. |
%dtc_top1_pts% | DTC | Sus puntos. |
%dtc_top2_name% | DTC | Segundo en puntos. |
%dtc_top2_pts% | DTC | Sus puntos. |
%dtc_top3_name% | DTC | Tercero en puntos. |
%dtc_top3_pts% | DTC | Sus puntos. |
Sidebars#
scoreboards.yml contiene tres cosas:
| Sección | Se usa cuando |
|---|---|
scoreboards | Corre exactamente un evento. Un sidebar por identificador de tipo. |
compact-lines | Las lines que aporta un evento al sidebar compartido, dos por defecto, por identificador de tipo. |
multi-event | Corren dos o más eventos. |
Las dos secciones por tipo usan el identificador del tipo como clave, y cada tipo tiene su propia
entrada — también koth_points_multi y koth_capture_points, que ya no toman prestado el sidebar de
otro tipo.
Con varios eventos activos, cada uno aporta sus dos líneas compactas a un sidebar compartido, hasta
cuatro eventos. La sección multi-event decide el título, el separador, las dos plantillas de línea
— donde {n} es el índice del evento, de 0 a 3 — y el pie.
multi-event:
title: "{warning}&l⚡ EVENTS"
separator: ""
line1-format: " %e{n}_l1%"
line2-format: " %e{n}_l2%"
footer:
- ""
- " {highlight}ᴇxʏʟɪᴀ.ɴᴇᴛ"
update-interval: 2Los sidebars de un solo evento se refrescan cada 2 ticks por defecto, que es lo que pide un temporizador de captura en vivo.
Cada tipo de evento rellena sus propios tokens de sidebar. Son propios del plugin, no placeholders
de PlaceholderAPI, y solo se resuelven dentro de scoreboards.yml.
Todos los tokens de sidebar
| Token | Tipos de evento | Qué dibuja |
|---|---|---|
%capture_event_name% | Todos | El nombre visible del evento. |
%capture_event_time% | Todos | Tiempo que le queda al evento. |
%capture_zone_x% | KOTH, KOTH Points, Capture Points, DTC | La X del centro de la zona. |
%capture_zone_y% | KOTH, KOTH Points, Capture Points, DTC | La Y del centro de la zona. |
%capture_zone_z% | KOTH, KOTH Points, Capture Points, DTC | La Z del centro de la zona. |
%capture_koth_capturer% | KOTH, Capture Points | Quién tiene la zona ahora mismo. |
%capture_koth_capturer_clan% | KOTH | El clan de ese capturador. |
%capture_koth_player_time% | KOTH, Capture Points | Cuánto le falta a la captura en curso. |
%capture_koth_required% | Capture Points | Cuánto dura una captura completa. |
%capture_koth_leader% | Capture Points | Quién va delante en puntos. |
%capture_koth_target% | KOTH Points, Capture Points | Puntos necesarios para ganar. |
%capture_koth_player_points% | KOTH Points, Capture Points | Los puntos de quien lo lee. |
%capture_koth_top1_name% | KOTH Points, Capture Points | Primero en puntos. |
%capture_koth_top1_pts% | KOTH Points, Capture Points | Sus puntos. |
%capture_koth_top2_name% | KOTH Points, Capture Points | Segundo en puntos. |
%capture_koth_top2_pts% | KOTH Points, Capture Points | Sus puntos. |
%capture_koth_top3_name% | KOTH Points, Capture Points | Tercero en puntos. |
%capture_koth_top3_pts% | KOTH Points, Capture Points | Sus puntos. |
%capture_dtc_target% | DTC | Puntos necesarios para ganar. |
%capture_dtc_player_points% | DTC | Los puntos de quien lo lee. |
%capture_dtc_top1_name% | DTC | Primero en puntos. |
%capture_dtc_top1_pts% | DTC | Sus puntos. |
%capture_dtc_top2_name% | DTC | Segundo en puntos. |
%capture_dtc_top2_pts% | DTC | Sus puntos. |
%capture_dtc_top3_name% | DTC | Tercero en puntos. |
%capture_dtc_top3_pts% | DTC | Sus puntos. |
%conquest_target% | Conquest | Puntos necesarios para ganar. |
%conquest_zone1% | Conquest | La línea de la primera zona — dos zonas por línea a partir de cuatro. |
%conquest_zone2% | Conquest | La línea de la segunda zona. |
%conquest_zone3% | Conquest | La línea de la tercera zona. |
%conquest_zone4% | Conquest | La línea de la cuarta zona. |
%conquest_top1_clan% | Conquest | Primer clan en puntos. |
%conquest_top1_pts% | Conquest | Sus puntos. |
%conquest_top2_clan% | Conquest | Segundo clan en puntos. |
%conquest_top2_pts% | Conquest | Sus puntos. |
%conquest_top3_clan% | Conquest | Tercer clan en puntos. |
%conquest_top3_pts% | Conquest | Sus puntos. |
%payload_progress% | Payload | Cuánto ha avanzado el carro por la vía. |
%payload_distance_remaining% | Payload | Cuánto le queda por recorrer. |
%payload_capturing_clan% | Payload | Quién lo está empujando. |
%payload_state% | Payload | El estado del carro. |
%bounty_target% | Bounty | El nombre del objetivo. |
%bounty_target_health% | Bounty | Su vida en corazones, con un decimal. |
%bounty_target_position% | Bounty | Dónde está, como X, Z. |
%bounty_reward% | Bounty | La recompensa de ganador, tal como la leen los jugadores. |
Conquest, Payload y Bounty conservan capture_ solo en los dos tokens compartidos; sus tokens propios no
llevan prefijo.
Un evento concreto puede apagar su sidebar con el ajuste scoreboard-enabled.
Waypoints de cliente#
Si el cliente del jugador es Lunar con Apollo, o Feather, la zona del evento activo se marca en su
pantalla con el color del evento. El marcador se añade al empezar y se retira al terminar. El de
Payload sigue al carro; el de DTC marca el bloque del núcleo; el de Bounty sigue al objetivo, para
todos menos él, mientras track-target esté activo.
No hay nada que configurar: sin un cliente compatible no se envía waypoint y no cambia nada más.
HUD de SurvivalCore#
Los jugadores con el cliente SurvivalCore reciben más, encima de todo lo anterior — nunca en su lugar:
| Elemento | Qué muestra |
|---|---|
| Temporizador del HUD | El reloj del evento: cuenta atrás hasta el final, o hacia delante desde el inicio cuando el evento dura hasta que alguien gana. |
| Haz | Un haz pulsante en el centro de la zona, con el color del evento. |
| Borde de zona | Las paredes de la zona, con el color del evento. |
| Barra del HUD | La boss bar otra vez, con el mismo texto y progreso. |
| Icono del waypoint | Una corona en las zonas de KOTH, una bandera en las de Conquest y en el carro de Payload, una espada en el núcleo de DTC, una calavera en el objetivo de Bounty. |
Un evento sin zona propia no dibuja haz ni borde. Igual que los waypoints, no hay nada que configurar.
Contorno de la zona#
El contorno de partículas de una zona activa está en Zonas.
¿Falta algo en esta página? Dínoslo en Discord