Empezar

Instalación

Descargar el plugin, packetevents y ExyliaLib, los archivos que escribe el primer arranque, desactivar módulos y cómo llegan las actualizaciones.

Descargar

ExyliaDisplays es gratuito. Cada versión se publica en Modrinth como ExyliaDisplays-<version>.jar.

Antes de empezar

Plugin	Para qué
`packetevents`	Obligatorio, un `depend` estricto: el plugin no carga sin él.
`ExyliaLib`	Obligatorio. Hologramas, NPCs, etiquetas de línea, líneas de clic, menús y ventanas de diálogo. El jar de la 2.4.0 funciona con la 1.299.0 o superior.
`PlaceholderAPI`	Opcional. Sus placeholders funcionan en líneas, etiquetas y acciones.
`DecentHolograms`, `HolographicDisplays`, `FancyHolograms`, `Citizens`, `FancyNpcs`	Opcionales. Solo los leen las importaciones; figuran como dependencias suaves para que carguen antes mientras migras.

ExyliaLib figura como suave, y se instala sola

plugin.yml pone ExyliaLib en softdepend para que el plugin pueda arrancar sin ella. Si falta, ExyliaDisplays descarga la última versión de ExyliaLib (o, si no puede, aquella con la que se compiló) en plugins/ExyliaLib.jar en un hilo propio, lo dice en la consola y se queda desactivado hasta que reinicies. Si ya hay un jar de ExyliaLib en plugins/ pero no cargó, no descarga nada: la consola te pide que corrijas primero los errores de la librería.

Instalar

Copia los jars

Pon ExyliaDisplays.jar y packetevents en plugins/.

Arranca el servidor

Sin ExyliaLib, el primer arranque la descarga y pide un reinicio. Reinicia una vez.

Revisa la consola

Deberías ver ExyliaDisplays enabled: holograms, npcs, los módulos que arrancaron.

Abre los menús

Con exyliadisplays.admin, ejecuta /holoadmin o /npcadmin. Ver Primeros pasos.

Si vienes de ExyliaHolograms

Quita el jar antiguo de ExyliaHolograms. Los dos dibujarían todos los hologramas. ExyliaDisplays copia plugins/ExyliaHolograms/holograms.yml en su primer arranque y avisa en la consola mientras el plugin antiguo siga instalado. Ver Migración.

Archivos generados

Todos están en plugins/ExyliaDisplays/.

Archivo	Contenido
`config.yml`	Debug, vigilancia de archivos, qué módulos funcionan, y los valores por defecto y presets de cada módulo. Ver Configuración.
`holograms.yml`	Todos los hologramas, por nombre. Ver Referencia de archivos.
`npcs.yml`	Todos los NPCs, por nombre.
`lang/<código>/messages.yml`	El prefijo y los mensajes de `/displays`.
`lang/<código>/messages/holograms.yml`	Todos los mensajes de hologramas, los textos de las ventanas y la ayuda.
`lang/<código>/messages/npcs.yml`	Todos los mensajes de NPCs, el formato del bocadillo y la ayuda.
`lang/<código>/menus/admin/`	Los seis menús: `hologram_list`, `hologram_hub`, `hologram_lines`, `npc_list`, `npc_hub`, `npc_equipment`.

<código> es el idioma en el que funciona ExyliaLib. El plugin trae inglés, español (es) y ruso (ru); no tiene una clave de idioma propia.

menus/admin/ se reescribe

Los seis menús se sustituyen desde el jar en cada arranque. Su cabecera dice "DO NOT EDIT — REGENERATED ON EVERY STARTUP". Lo que edites ahí se pierde.

No hay base de datos: hologramas y NPCs viven en sus archivos YAML, por lo que copiar la carpeta copia todo.

Desactivar un módulo

config.yml lista los módulos:

plugins/ExyliaDisplays/config.yml

modules:
  holograms: true
  npcs: true

Un módulo en false no arranca: ni archivo, ni comandos, ni menús. Un módulo que el archivo no nombra sí funciona. El cambio necesita un reinicio; /displays reload no arranca ni detiene módulos. Con el módulo de hologramas desactivado, los NPCs siguen funcionando, pero /npc <nombre> link se niega porque no hay hologramas que enlazar.

Un módulo que falla al arrancar queda desactivado en esa sesión y se nombra en la consola; el otro sigue.

Actualizar

ExyliaLib mantiene ExyliaDisplays al día. plugin.yml indica el repositorio de GitHub (exylia-updates: Exylia-Plugins/ExyliaDisplays) y la ExyliaLib más antigua con la que funciona (exylia-lib); ExyliaLib busca una versión nueva, la descarga y la aplica en el siguiente reinicio.

Una versión mayor nueva se anuncia y se deja para que la instales tú.
Una versión que necesita una ExyliaLib más nueva espera a que la librería se actualice.
/exylialib updates muestra lo pendiente. plugin-updates en plugins/ExyliaLib/config.yml lo desactiva o lo ajusta.

Para actualizar a mano, cambia el jar y reinicia. config.yml, los mensajes, holograms.yml y npcs.yml conservan tus cambios; menus/admin/ se refresca desde el jar.

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