Contenido generado con IA — puede contener errores.

ExyliaLib/Visuales

Sidebars, hologramas, nametags y bordes

Todo lo que se dibuja en la pantalla de un jugador, enviado como paquetes y declarado en configuración.

Página 36 de 547 min de lectura

Módulos con algo en común: ninguno crea estado real en el servidor. Ningún equipo de scoreboard, ningún armor stand, ninguna entidad que se quede colgada, ningún cambio en el borde propio del mundo.

java
Scoreboards.show(this, player, config.ffa());

SidebarConfig se anida en tu propio record de config, así que la sidebar vive en el archivo del dueño:

yaml
scoreboard:
  enabled: true
  title:
    - "{primary}&lFFA"
  lines:
    - " {muted}❙ {letters}Kills: {success}%kills%"
    - " {muted}❙ {letters}KDR: {highlight}%kdr%"
  update:
    interval: 15
    smart: true
ClaveQué hace
enabledMostrarla o no — una sección puede seguir escrita pero apagada.
titleUna lista. Varias entradas animan: cada refresco muestra la siguiente.
linesDe arriba abajo. Como mucho 15; las de más se descartan.
update.intervalTicks entre refrescos (20 por defecto). También lee 1s.
update.smartEnviar solo las líneas que cambiaron en vez del tablero entero.

Scoreboards.show devuelve un Board: refresh(), updateData(map), stop(), stopped(). Scoreboards.hide(player), get(player) y has(player) funcionan desde fuera. Los tableros se apilan por jugador — mostrar uno pausa el anterior, y cerrarlo lo devuelve. Eso permite que la sidebar de un evento tape la del hub sin que ningún plugin sepa del otro.

Una línea que se expande

Un placeholder que devuelve texto con saltos de línea se convierte en varias líneas. Así un solo valor %objectives% puede dibujar tres filas sin que el archivo sepa cuántas habrá.

Otras sidebars en el servidor

Un tablero visible recupera el hueco de la sidebar cada tres segundos, y al momento tras un teleport, un cambio de mundo, un respawn o una entrada, así que otro plugin que lo reclame no deja al jugador sin la nuestra. Si está instalado TAB, se le pide que se aparte: el primer tablero que se muestra a un jugador apaga la sidebar de TAB para ese jugador, y el último que se quita — o que el jugador salga — la vuelve a encender. Solo se toca a un jugador cuya sidebar de TAB estaba visible.

Diseño de tarjeta y ancho estable#

Desde 1.541.0 un tablero sigue las partes de una tarjeta de ítem: un tono, un subtítulo oscuro opcional, secciones y estadísticas, sin líneas de acción. El título no lleva icono; {icon:...} se dibuja en las líneas (por debajo de 1.21.9 lo sustituye su glifo). Un cliente muestra como máximo 15 líneas.

yaml
title: '{primary}&lDUEL'
lines:
  - '{letters_black}Duel · %exyliaduels_mode%'
  - ''
  - '{primary}⚔ Opponent'
  - '  {letters_black}· {highlight}{icon:kills} {letters}Name{letters_black}: {highlight}%exyliaduels_opponent%'
  - ''
  - '{muted}{server-ip}'

Desde 1.580.0 un sidebar ya no salta cuando un valor cambia de largo: nunca es más estrecho que su línea más ancha con todos los placeholders vacíos, un valor más largo lo ensancha al instante y solo se estrecha tras 10 segundos más corto (se mantiene rellenando la primera línea en blanco). Empieza una línea con <center> para centrarla dentro de ese ancho.

Hologramas#

java
Holograms.show(this, "trophy", location, config.trophy());
ClaveQué hace
enabledMostrarlo o no.
typeTEXT, ITEM o BLOCK.
linesEl texto, para TEXT. Una línea puede empezar con etiquetas que le dan estilo solo a ella.
item / blockLo que flota, para los otros dos.
per-playerCada espectador tiene su propia copia, así los placeholders pueden variar por jugador.
view-distanceMás allá de esto no se envía nada.
offset-x/y/zDónde queda respecto a la ubicación dada.
propertiesCómo se dibuja: billboard, escala, fondo y el resto.
config.update-intervalTicks entre redibujados del texto.
click, pages, page-intervalLo que ejecuta un clic, y más páginas que cada espectador va pasando.

Son paquetes de display. No existe nada en el servidor, así que un holograma no lo puede empujar un pistón, matar un mob ni quedarse atrás cuando el plugin falla.

Holograms.get(plugin, id), all(plugin), remove(plugin, id) y removeAll(plugin) los gestionan por id. isSupported() responde con honestidad cuando falta PacketEvents. Las etiquetas por línea, los clics y las páginas están en Hologramas.

Nametags#

java
PluginNametags tags = Nametags.of(this);
 
tags.paint(viewer, target, style);                 // cómo ve un jugador a otro
tags.paintEachOther(team, style);                  // un equipo entero, mutuamente
tags.reset(viewer, target);
tags.resetEverywhere(target);

La clave es por espectador, no por jugador: el mismo jugador puede ser rojo para uno y azul para otro, que es lo que necesita un juego por equipos y lo que un equipo de scoreboard no puede hacer sin pelearse con todos los demás plugins por el mismo nombre de equipo.

NametagStyle.of(color) fija el color del nombre; withGlow() lo resalta a través de las paredes, withCollision() permite empujarlo y showingInvisible() lo dibuja tenue mientras es invisible. Los clientes vanilla están incluidos — no es una función de mods de cliente.

Sin PacketEvents, Nametags.isSupported() es false y cada llamada no hace nada en vez de lanzar una excepción.

Bordes del mundo que solo ven algunos#

Un borde por arena, por partida o por zona, en el mismo mundo, cada uno con su borde y su reloj:

java
VirtualBorder zone = Packets.of(this).worldBorders().create(arena.center(), 200);
match.players().forEach(zone::show);
zone.size(20, Duration.ofMinutes(2));
En un VirtualBorderQué hace
show(viewer) / hide(viewer)Sustituye el borde que ve, o le devuelve el del mundo.
size(size) / size(size, over)Lo redimensiona; un cambio con tiempo es un paquete y cada cliente lo anima.
center(x, z)Lo mueve.
warning(blocks, seconds)Cuándo se pone roja la pantalla. Por defecto los 5 bloques o 15 segundos de vanilla.
damage(perBlock, buffer)Daño fuera de él. Por defecto los 0,2 por bloque pasados 5 de vanilla; cero no hiere a nadie.
contains(location), size(), viewers()Lecturas, también a mitad de un cambio.
remove()Lo oculta a todos.

worldBorders().seenBy(player) devuelve el borde que ve un jugador, o null mientras ve el del mundo.

Los paquetes del borde propio del mundo se descartan de camino a un espectador que ve uno virtual en ese mundo, así que un /worldborder no lo puede sobrescribir, y un respawn o un cambio de mundo vuelve a enviar el correcto. El servidor hiere a los espectadores que estén fuera como hace vanilla, cada diez ticks con el tipo de daño OUTSIDE_BORDER — un cliente modificado, una perla o un vehículo no le preguntan al cliente antes.

Límites

Un borde por jugador, entre todos los plugins. Solo cuadrados. La colisión, la colocación de bloques y los portales del servidor siguen el borde propio del mundo. Sin PacketEvents un borde se puede crear y moldear, pero no lo ve nadie ni hiere a nadie.

Waypoints y cooldowns de cliente#

Para jugadores en Lunar (por Apollo), Feather o SurvivalCore:

java
PluginClients clients = Clients.of(this);
 
clients.waypoints().show(player, Waypoint.at("koth", location).colour("#ff5555"));
clients.waypoints().remove(player, "koth");
clients.clear(player);   // solo lo que dibujó este plugin

Lo que un plugin envía con Clients.of(this) va a nombre de ese plugin, así que el marcador spawn de un lobby y el de un evento no se borran entre sí, clear(player) quita solo los de este plugin, y desactivarlo los retira. En Lunar un nombre de waypoint sigue siendo un solo hueco por jugador, así que dos plugins que muestran spawn ahí comparten un marcador.

Los cooldowns de cliente, los temporizadores del HUD, los marcadores de compañeros, los puntos de reunión, los haces, los bordes de zona y las barras del HUD funcionan igual. Un jugador cuyo cliente no soporta nada de esto simplemente no recibe nada; quien llama nunca distingue qué cliente usa cada uno. Todo lo que ofrece está en Integración de cliente.

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