Hologramas en tu servidor de Minecraft: texto flotante, iconos y clics con DecentHolograms

Qué necesitas

Un servidor Paper (o Spigot, Purpur): los hologramas de esta guía son plugins y no funcionan en Fabric, Forge ni NeoForge. En NapNodes los servidores de Minecraft se entregan con Paper.

Ser operador (op) o tener el permiso dh.admin: todos los comandos de DecentHolograms son de fábrica solo para los op. Para verlos no hace falta nada: los ve todo el mundo.

Los hologramas no son bloques ni entidades del mundo: el plugin se los envía a cada jugador. No se pueden romper, empujar ni robar, y no los toca un reseteo del mundo (se guardan en la carpeta del plugin, no en world).

Instalar DecentHolograms

1. Haz una copia

   En el panel, «Copias de seguridad»: instalar un plugin no toca el mundo, pero así vuelves atrás en un minuto si algo no encaja.

2. Búscalo en el panel

   Dentro de tu servidor, «Mods y plugins» → busca «DecentHolograms» → «Instalar». Solo salen las versiones que valen para tu versión de Minecraft. Si no aparece, bájalo de su página en Modrinth o SpigotMC y súbelo a la carpeta plugins desde «Archivos».

3. Reinicia

   Los plugins se cargan al arrancar. En «Archivos» aparece la carpeta plugins/DecentHolograms, con config.yml (ajustes) y holograms (uno .yml por holograma).

4. Comprueba que está

   Entra al servidor y escribe /dh help. Si dice que el comando no existe, mira en «Consola» si el plugin dio un error al cargar (casi siempre, una versión que no corresponde).

Tu primer holograma

Los hologramas se crean desde el juego, porque aparecen donde estás. Ponte en el sitio exacto (a tus pies queda la parte de abajo del holograma) y escribe los comandos en el chat. El nombre es para ti, sin espacios: bienvenida, normas, tienda.

1. Créalo con su primera línea

   /dh create bienvenida &d&lBienvenido a MiServidor. Lo que va después del nombre es el texto de la primera línea; los códigos con & son los colores de siempre (&d rosa, &l negrita, &7 gris).

2. Añade más líneas

   /dh line add bienvenida 1 &7Escribe &f/spawn &7para volver aquí. El 1 es la página (un holograma puede tener varias, más abajo); cada line add pone la línea debajo de las demás.

3. Corrige una línea

   /dh line set bienvenida 1 2 &7Lee las normas antes de construir cambia la línea 2 de la página 1. Las líneas se cuentan desde 1, de arriba abajo.

4. Mete o quita líneas

   /dh line insert bienvenida 1 2 &8------ mete una línea en la posición 2 y baja las demás; /dh line remove bienvenida 1 2 la quita.

5. Muévelo

   /dh movehere bienvenida lo trae a donde estás; /dh center bienvenida lo centra en el bloque. Para coordenadas exactas: /dh move bienvenida 100 70 -50.

Colores, degradados y animaciones

Además de los 16 colores de & (y &l negrita, &o cursiva, &n subrayado), DecentHolograms entiende colores hexadecimales: &#5b4ae8Texto, o <#5b4ae8>Texto. Un degradado se escribe con el color de inicio delante y el de final detrás: <#ff5555>Bienvenido a MiServidor</#5555ff>. Si quieres el texto ya coloreado letra a letra en formato &#, lo saca nuestra herramienta de texto con degradado.

Animaciones de serie: <#ANIM:colors>Texto</#ANIM> (cambia de color), y también typewriter (se escribe letra a letra), wave, burn y scroll, con la misma forma. Úsalas con medida: un holograma animado en cada esquina del spawn cansa y se lee peor.

En el texto, {player} se cambia por el nombre de quien lo mira: &eHola, {player} saluda a cada uno por su nombre.

Iconos, cabezas y criaturas

Una línea puede ser un objeto que flota y gira en vez de texto: /dh line add tienda 1 #ICON: DIAMOND. El nombre es el del objeto en inglés y mayúsculas, como en el juego (EMERALD, NETHERITE_SWORD, ENCHANTED_GOLDEN_APPLE); con !ENCHANTED detrás brilla como encantado.

Cabezas de jugador: #HEAD: PLAYER_HEAD (Notch) pone la cabeza grande de Notch y #SMALLHEAD: la pequeña. Con #HEAD: PLAYER_HEAD ({player}) cada uno ve su propia cabeza.

Criaturas: #ENTITY: ZOMBIE pone un zombi quieto. Para personajes que hablan, se mueven o te llevan a sitios, mejor un plugin de NPC como Citizens o FancyNpcs.

Los iconos y las cabezas ocupan más alto que una línea de texto: si se montan, separa con una línea en blanco o ajusta la altura con /dh line height tienda 1 2 0.6.

Hologramas que hacen algo al pulsarlos

Cada página puede tener acciones según el clic: LEFT, RIGHT, SHIFT_LEFT o SHIFT_RIGHT. Se añaden con /dh page addaction <holograma> <página> <clic> <acción>.

1. Que ejecute un comando

   /dh page addaction tienda 1 RIGHT COMMAND:/warp tienda. Lo ejecuta el jugador que pulsa, así que necesita el permiso de ese comando (si usas EssentialsX, essentials.warp).

2. Que mande un mensaje

   /dh page addaction normas 1 RIGHT MESSAGE:&aGracias por leerlas, {player}. Solo lo ve quien pulsa.

3. Que cambie de página

   Añade una segunda página con /dh page add normas &eNormas (2/2) y pon /dh page addaction normas 1 LEFT NEXT_PAGE y /dh page addaction normas 2 LEFT PREV_PAGE. Así caben unas normas largas sin un holograma de 20 líneas. En el texto, {page} y {pages} se cambian por la página que se ve y el total.

4. Con cuidado: CONSOLE

   CONSOLE:give {player} diamond 1 ejecuta el comando como la consola, con todos los permisos, y cada vez que alguien pulsa. No lo uses para dar cosas: cualquiera puede pulsar mil veces. Para premios, mejor un kit con tiempo de espera.

Datos en vivo con PlaceholderAPI

Con el plugin PlaceholderAPI instalado, los hologramas pueden enseñar datos que cambian: jugadores conectados, el dinero de quien mira, su rango. DecentHolograms lo detecta solo. Instálalo desde «Mods y plugins» o, si no sale, desde su página (Hangar o SpigotMC) subiéndolo a plugins en «Archivos», y reinicia.

Cada dato viene de una «expansión» que se baja desde la consola: para los jugadores conectados, papi ecloud download Server y después papi reload. Luego: /dh line add bienvenida 1 &7Conectados: &f%server_online%.

El texto se actualiza solo cada segundo (update-interval: 20 ticks en config.yml). Dentro de las animaciones los datos no se cambian salvo que actives allow-placeholders-inside-animations, que el propio plugin desaconseja porque gasta más procesador.

Ver, borrar y editar a mano

/dh list enseña todos los hologramas (desde el juego), /dh near 10 los que tienes a 10 bloques y /dh tp bienvenida te lleva a uno. /dh delete bienvenida lo borra para siempre: no pide confirmación.

Cada holograma es un fichero en plugins/DecentHolograms/holograms (bienvenida.yml). Para cambios largos (unas normas de diez líneas) es más cómodo editarlo en «Archivos», guardar y escribir dh reload en «Consola». Copia el fichero antes: un error de formato en el .yml hace que ese holograma no cargue.

Si cambias el spawn de sitio o reseteas el mundo, los hologramas se quedan en sus coordenadas: muévelos con /dh movehere.

¿Y FancyHolograms?

FancyHolograms es la alternativa moderna: usa las entidades de texto de Minecraft (desde la 1.19.4), así que el texto puede escalarse, girarse, tener fondo de color o verse a través de los bloques, cosas que DecentHolograms no hace. A cambio, solo funciona en Paper (no en Spigot) y pide Paper 1.21.4 o más nuevo, que es lo que entregamos.

Se crea con /hologram create text bienvenida (el tipo puede ser text, item o block) y se edita con /hologram edit bienvenida setLine 1 <texto>, addLine <texto>, removeLine, scale 2 o background. El texto va en formato MiniMessage: <light_purple><bold>Bienvenido</bold>, y el degradado con <gradient:#ff5555:#5555ff>Texto</gradient>.

Elige uno de los dos y no instales ambos para lo mismo. Si ya tienes un servidor con hologramas hechos en otro plugin (HolographicDisplays, por ejemplo), DecentHolograms los convierte con /dh convert.

Preguntas frecuentes