Hologramas

Un holograma es una pila de display entities enviadas por paquetes. En el servidor no existe nada, así que un pistón no puede empujarlo, un mob no puede matarlo y un crash no puede dejarlo atrás. Cada plugin declara sus hologramas en su propia configuración; ExyliaLib no tiene archivo ni comando de hologramas.

Hologram trophy = Holograms.show(this, "trophy", location, config.trophy());

Los hologramas necesitan PacketEvents. Sin él Holograms.isSupported() es false, se avisa una vez en consola, y cada llamada sigue funcionando pero no dibuja nada. Una sección con enabled: false hace lo mismo.

Mostrar uno

Cada método es seguro desde cualquier hilo. Los placeholders de las líneas se resuelven fuera del hilo principal, así que sus resolvers deben ser seguros en async. Una línea sin placeholders nunca programa un refresco.

La configuración

spawn-hologram:
  enabled: true
  type: TEXT
  lines:
    - '<head:Notch><spin:45>'
    - '<size:2><shine:highlight,speed=15,pause=1,width=4>{primary}&lBIENVENIDO'
    - '<gap:0.1><flow>{secondary}Temporada II · ya abierta'
    - '<if:"%player_level% >= 10">{success}Cumples los requisitos'
    - '<button:join>{letters}Clic para entrar'
  per-player: true
  view-distance: 32
  offset-y: 2
  properties:
    billboard: CENTER
    distance-scale:
      enabled: true
      start: 8
      end: 32
      max: 2.5
  config:
    update-interval: 20
  click:
    commands:
      - '[PAGE] next'
    sound: 'UI_BUTTON_CLICK;0.6;1.4'
    buttons:
      join:
        - 'arena join'
  pages:
    - lines:
        - '{primary}&lNORMAS'
        - '{letters}Nada de griefing.'
      click:
        - '[PAGE] previous'
  page-interval: 10s

persistent, config.spawn-on-chunk-load y config.remove-on-chunk-unload se siguen leyendo, para que los archivos viejos carguen, pero no hacen nada.

properties

Tamaño según la distancia

properties.distance-scale agranda el holograma a medida que el espectador se aleja, para que siga leyéndose desde la otra punta del spawn. Vale min hasta start bloques, crece de forma uniforme y se queda en max desde end, calculado por espectador en pasos de 0.1.

Una línea puede llevar su propia curva con <autoscale> (la del holograma) o <autoscale:start,end,max>.

Etiquetas de línea

Una línea puede empezar con etiquetas que le dan estilo solo a ella. Solo se leen etiquetas conocidas al principio de la línea; la primera desconocida corta la lectura y se queda en el texto, así que <gradient:...> sigue llegando al parser de texto. Un valor que contiene > va entre comillas: <if:"%kills% > 10">. Las duraciones aceptan un número de segundos, s o ms.

Aspecto y disposición

Modelos

Movimiento y texto

El cliente anima el movimiento entre keyframes enviados cada medio segundo, así que los periodos empiezan en dos segundos.

Las líneas con brillo o flujo se redibujan como mucho diez veces por segundo.

Quién la ve

Clics y botones

click hace que se le pueda hacer clic al holograma. Sin comandos no se puede, salvo que el código ponga onClick.

Una línea de comando se ejecuta como el jugador, o desde la consola con console:. Puede empezar con un filtro — left:, right:, shift_left:, shift_right: o shift: — y acepta los tokens de efecto ([MESSAGE], [SOUND], [TITLE], [SERVER], [TELEPORT] world;x;y;z, [ACTION] ns:id, [DELAY] 1s, …).

Una línea <button:join> ejecuta click.buttons.join cuando se le hace clic a esa línea, y tiene su propio fondo que se ilumina al apuntarlo. Lo apuntado crece según hover-scale y se hunde un instante al pulsarlo.

Páginas

Cada espectador ve una página a la vez, guardada por jugador. lines es la página 1 y ejecuta click.commands; cada entrada de pages ejecuta su propio click mientras el espectador está en ella.

page-interval pasa las páginas solo, y su temporizador se reinicia en cada cambio.

El handle Hologram

HologramLine: líneas como datos

Un editor que deja al staff dar estilo a las líneas las lee y escribe con HologramLine en vez de parsear las etiquetas a mano.

HologramLine line = HologramLine.parse("<size:2><spin>&6Campeón");
 
String edited = line.toBuilder()
        .size(1.5)
        .spin(null)          // null quita una etiqueta
        .glow("#8a51c4")
        .build()
        .raw();              // etiquetas en un orden fijo, y luego el texto

of(text) crea una línea simple, builder() una vacía; cada etiqueta es un campo que admite null, y null significa no escrita. item, block y head se borran entre sí. isModel() y hasTags() responden lo que dicen. Los valores por defecto sin valor son constantes: DEFAULT_SPIN, DEFAULT_BOB, DEFAULT_TYPEWRITER y el resto.