Introducción
Qué es ExyliaDisplays, qué pone en el mundo y cómo está organizada esta documentación.
ExyliaDisplays pone hologramas y NPCs en el mundo de un servidor Paper o Folia, y les da a ambos el mismo sistema de clics. Es gratuito y de código abierto, publicado bajo la GNU General Public License v3.0 en Modrinth.
Todo lo que muestra son paquetes, dibujados por ExyliaLib: nada es una entidad real, nada se guarda en los chunks y nada hace tick en el servidor. Un holograma o un NPC existe para quien está lo bastante cerca para verlo y no cuesta nada cuando no hay nadie.
Cada uno se puede editar de tres formas que siempre coinciden: menús y ventanas de diálogo dentro del
juego, los comandos /holo y /npc, o holograms.yml y npcs.yml a mano, que se aplican en cuanto los
guardas.
Antes se llamaba ExyliaHolograms. Un servidor que venga de él conserva sus hologramas y su permiso; ver Migración.
Qué incluye
Líneas de texto, ítems flotantes, bloques y cabezas de jugador en una misma pila, cada línea con su propio tamaño, movimiento y efectos de color.
Etiquetas de línea<size:2>, <spin>, <shine>, <typewriter>, y líneas que solo ven algunos jugadores:
<range:8>, <perm:vip>, <if:"%player_level% >= 10">.
Un holograma con varias páginas, donde cada jugador lee la suya y la pasa con un clic o con un temporizador.
NPCsNPCs de jugador con skin (o la de cada espectador), pose, tamaño, contorno, equipo, etiqueta y una cabeza que se gira hacia cada espectador.
InteraccionesUn mismo juego de líneas de clic para ambos: comandos, [SERVER], [TELEPORT], [MESSAGE], y
bocadillos de diálogo de los NPCs con [SAY].
DecentHolograms, HolographicDisplays, FancyHolograms, Citizens y FancyNpcs, leídos sin tocar sus archivos.
Requisitos
| Requisito | Detalle |
|---|---|
| Servidor | Paper o Folia 1.21.4 o superior |
| Java | 21 |
| Obligatorio | packetevents, y ExyliaLib 1.299.0 o superior (el jar de la 2.4.0) — se instala solo si falta |
| Opcional | PlaceholderAPI, cuyos placeholders funcionan en cualquier línea y cualquier acción |
| Clientes | Las ventanas de diálogo necesitan un cliente 1.21.6+; los clientes más antiguos y los jugadores de Bedrock reciben los mismos campos por chat o formularios |
Los hologramas, los NPCs, las etiquetas de línea, las líneas de clic, los menús y las ventanas de diálogo vienen de ExyliaLib. ExyliaDisplays es lo que los guarda en archivos, los edita y les da comandos; todos los plugins de Exylia que muestran un holograma lo dibujan igual.
Cómo leer esta documentación
Empezar
La instalación, lo que escribe el primer arranque, y un primer holograma y un primer NPC.
Hologramas
Líneas, etiquetas de línea, páginas, y quién ve un holograma o qué lleva encima.
NPCs
Skin, pose, equipo, hacia dónde mira, su etiqueta y un holograma que lo sigue.
Común
Interacciones de clic, ajuste fino con la rueda del ratón, editar los archivos a mano, los menús y las importaciones desde otros plugins.
Referencia
Comandos, permisos, config.yml y los mensajes, cada clave de holograms.yml y npcs.yml, y las
preguntas frecuentes.
Convenciones
- Los valores marcados como por defecto son los que escribe el plugin cuando falta la clave.
- Los identificadores entre
<y>son variables:/holo <nombre> addline <texto>significa/holo spawn addline Bienvenido. - Un holograma o un NPC se identifica por su nombre: letras minúsculas, dígitos,
_y-, hasta 32 caracteres. Los comandos pasan a minúsculas lo que escribes. - Los colores usan los tokens de paleta de ExyliaLib (
{primary},{highlight},{letters}), códigos&, hex y MiniMessage. - Los números de línea en los comandos empiezan en 1.
¿Falta algo en esta página? Dínoslo en Discord