Hologramas

Visibilidad y anclaje

Quién ve un holograma: distancia de visión, permiso, copias por jugador y listas de jugadores elegidos. Hologramas que van encima de un jugador o de un mob.

Varias cosas deciden si un jugador ve un holograma, y todas tienen que cumplirse:

está enabled y su mundo está cargado;
el jugador está dentro de view-distance (por defecto 48 bloques);
el jugador tiene su permission, si tiene uno;
el jugador pasa su lista de visibility;
si está anclado a una entidad, esa entidad está en el mundo.

Además, cada línea puede tener su propio <range>, <perm> o <if>.

Un cambio de permiso o de lista lo lee la siguiente comprobación de visibilidad: no se redibuja nada y nadie ve un parpadeo.

Distancia, permiso y por jugador

Ajuste	Comando
Distancia de visión	`/holo <nombre> viewdistance <bloques>`	Mayor que 0.
Permiso	`/holo <nombre> permission [nodo]`	Solo lo ven los jugadores con él. Sin nodo, se quita.
Por jugador	`/holo <nombre> perplayer <true\|false>`	Cada espectador recibe su propia copia. Cuesta un juego de paquetes por espectador.
Refresco	`/holo <nombre> refresh <ticks>`	Ticks entre refrescos de placeholders, 1+ (por defecto 20).
Autoactualizar	`/holo <nombre> autoupdate <true\|false>`	Si las líneas se refrescan solas (por defecto `true`).

Rara vez necesitas per-player: un holograma con un placeholder en cualquier línea ya se dibuja por espectador. Actívalo solo para líneas sin placeholder que aun así tengan que variar.

La ventana VISIBILIDAD del editor reúne todo esto más el intervalo de página y las listas de jugadores.

Jugadores elegidos

visibility.mode decide cómo se lee la lista de jugadores:

Modo	Quién lo ve	Lista que usa
`all` (por defecto)	Todos menos los jugadores de la lista.	`hidden-from`
`manual`	Solo los jugadores de la lista.	`shown-to`

/holo nametag visibility manual
/holo nametag show Notch
/holo nametag show @a
/holo nametag hide Notch
/holo nametag viewers
/holo nametag viewers clear

show y hide funcionan en los dos modos: en all sacan a un jugador de hidden-from o lo meten; en manual lo meten en shown-to o lo sacan. @a significa todos los jugadores conectados. Un jugador se nombra por nombre o UUID y tiene que haber entrado antes al servidor. viewers muestra la lista que lee el modo; viewers clear la vacía, así que en all vuelven a verlo todos y en manual no lo ve nadie.

Solo se escriben las excepciones, como UUIDs, así que un jugador que cambia de nombre conserva su sitio y un holograma que ven todos cuesta dos listas vacías:

visibility:
  mode: manual
  shown-to: ['069a79f4-44e9-4726-a5be-fca90e38aaf5']
  hidden-from: []

Un clic derecho en VISIBILIDAD del editor alterna entre los dos modos.

Anclar a un jugador o a un mob

Un holograma puede ir encima de una entidad en lugar de quedarse en su ubicación.

/holo nametag attach Notch           # un jugador, por nombre o UUID
/holo nametag attach <uuid>          # cualquier entidad por UUID
/holo nametag attach nearest         # la entidad más cercana a ti, a menos de 16 bloques
/holo nametag attachoffset 0.8       # bloques por encima de la entidad, de -16 a 16 (por defecto 0.5)
/holo nametag detach

Qué lleva	Se guarda	Comportamiento
Un jugador	Sí, `attach.entity`	Va encima de él siempre que esté conectado, también al entrar, reaparecer y cambiar de mundo. Oculto mientras no está.
Un mob que se guarda con su chunk	Sí	Va encima siempre que su chunk esté cargado. Oculto mientras no.
Un mob que no se guarda (no persistente)	No	Lo lleva hasta que desaparece o el servidor se reinicia, sin escribirlo. El comando lo indica.

A un jugador desconectado se le puede nombrar al anclar, siempre que haya entrado antes. El alcance se mide desde la entidad, y un espectador que entra en rango más tarde lo ve ya montado.

attach:
  entity: '069a79f4-44e9-4726-a5be-fca90e38aaf5'
  offset: 0.5

Un entity ilegible (una errata en el archivo) cuenta como sin anclaje. location se conserva mientras está anclado y se vuelve a usar después de detach.

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