AxoHologram

AxoHologram es un sistema de hologramas para Paper basado en Display Entities, con páginas, formato avanzado e integración opcional con FancyNPCs.

Plataforma

Paper 1.21.11+ / 26.1.2+

Compatibilidad

Paper

Java Requerido

Java 25+

Autor

AxoStudio

Caracteristicas principales

Hologramas de texto, item y bloque con Display Entities.
MiniMessage, colores HEX, formato legacy con & y §.
Paginas multiples por holograma.
Visibilidad por todos, manual o permiso.
Estilo configurable: billboard, escala, sombras, fondo, brillo y alineacion.
Vinculo opcional con FancyNPCs y seguimiento automatico de posicion.

Integraciones opcionales

Integracion	Uso
PlaceholderAPI	Parsea placeholders por jugador en texto.
FancyNPCs	Vincula hologramas a NPCs y sigue su posicion.
MiniPlaceholders	Declarada como dependencia opcional, sin integracion activa en esta build.

Guia de instalacion

Compila el proyecto con mvn clean package.
Copia el jar generado en la carpeta plugins/ del servidor.
Inicia el servidor para generar la configuracion inicial.
El jar se genera como target/AxoHologram-1.0.6-Alfa.jar.

Archivos generados

plugins/AxoHologram/config.yml
plugins/AxoHologram/messages.yml
plugins/AxoHologram/holograms/

Cada holograma se guarda por separado, por ejemplo spawn.yml, shop.yml o rules.yml.

Comandos equivalentes

Principal	`/holograma`
Alias	`/axohologram`, `/aholo`, `/axoholo`, `/holo`

Gestion basica

Comando	Descripcion
`/holograma create <text\|item\|block> <id>`	Crea un holograma nuevo.
`/holograma create <id>`	Compatibilidad legacy, crea un holograma text.
`/holograma delete <id>`	Elimina un holograma.
`/holograma list`	Lista hologramas cargados.
`/holograma reload`	Recarga configuracion y hologramas.
`/holograma teleport <id>`	Teleporta al jugador al holograma.

Posicion y movimiento

Si un holograma esta vinculado a FancyNPCs, no puede moverse manualmente hasta ejecutar unlink.

Comando	Descripcion
`/holograma movehere <id>`	Mueve el holograma a tu posicion.
`/holograma move <id>`	Alias legacy de movehere.
`/holograma moveto <id> <x> <y> <z> [yaw] [pitch]`	Mueve el holograma a coordenadas.
`/holograma rotate <id> <degrees>`	Cambia la rotacion horizontal.
`/holograma rotatepitch <id> <degrees>`	Cambia la rotacion vertical.
`/holograma offset <id> <x> <y> <z>`	Cambia el offset base.

Paginas y lineas

Comando	Descripcion
`/holograma page add <id>`	Anade una pagina.
`/holograma page delete <id> <page>`	Elimina una pagina.
`/holograma page default <id> <page>`	Define la pagina por defecto.
`/holograma line add <id> <page> <type> <content>`	Anade una linea.
`/holograma line set <id> <page> <line> <content>`	Cambia el contenido de una linea.
`/holograma line delete <id> <page> <line>`	Elimina una linea.
`/holograma line offset <id> <page> <line> <x> <y> <z>`	Cambia el offset de una linea.

Visibilidad, estilo y FancyNPCs

Comando	Descripcion
`/holograma permission <id> [permission]`	Define o limpia el permiso personalizado.
`/holograma viewdistance <id> <distance\|default>`	Cambia la distancia de render.
`/holograma visibility <id> <all\|manual\|permission>`	Cambia el modo de visibilidad.
`/holograma scale <id> <factor>`	Cambia la escala.
`/holograma billboard <id> <center\|fixed\|vertical\|horizontal>`	Cambia el billboard.
`/holograma shadow strength <id> <value>`	Cambia la fuerza de sombra.
`/holograma shadow radius <id> <value>`	Cambia el radio de sombra.
`/holograma background <id> <color\|transparente>`	Cambia el fondo del texto.
`/holograma textshadow <id> <true\|false>`	Activa o desactiva la sombra de texto.
`/holograma brightness <id> <block\|sky> <0-15>`	Cambia el brillo.
`/holograma align <id> <center\|left\|right>`	Cambia la alineacion.
`/holograma npc link <holograma> <npc>`	Vincula un holograma a un NPC.
`/holograma npc unlink <holograma>`	Quita el vinculo.
`/holograma npc info <holograma>`	Muestra el estado del vinculo.

Permiso efectivo por defecto si usas visibilidad por permiso: axohologram.view.<id>.

Permiso	Descripcion
`axohologram.admin`	Acceso administrativo total.
`axohologram.create`	Crear hologramas.
`axohologram.delete`	Eliminar hologramas.
`axohologram.edit`	Permiso legacy de edicion general.
`axohologram.reload`	Recargar el plugin.
`axohologram.list`	Listar hologramas.
`axohologram.teleport`	Teleport a hologramas.
`axohologram.hologram.move`	Mover, rotar y cambiar offset base.
`axohologram.hologram.visibility`	Editar visibilidad y view distance.
`axohologram.hologram.style`	Editar estilo y apariencia.
`axohologram.page.edit`	Editar paginas.
`axohologram.line.edit`	Editar lineas.
`axohologram.permission.edit`	Editar permisos de holograma.
`axohologram.npc.edit`	Vincular y desvincular FancyNPCs.
`axohologram.npc.info`	Ver informacion del vinculo con FancyNPCs.
`axohologram.view.<id>`	Ver un holograma concreto si usa visibilidad por permiso.

Formato de texto

MiniMessage.
Legacy &.
Legacy §.
HEX &#RRGGBB.
HEX estilo Bungee &x&F&F&0&0&F&F.

Ejemplos validos

<red>Hola
&aHola
&#9D00FF&lTexto
&x&9&D&0&0&F&FTexto

Tipos de linea

Tipo	Contenido esperado
`text`	Texto con MiniMessage, legacy o HEX.
`item`	Material de item, por ejemplo `DIAMOND_SWORD`.
`block`	Material de bloque, por ejemplo `GRASS_BLOCK`.

Ejemplos de lineas

/holograma line add bienvenida 1 text <gradient:#9D00FF:#00E5FF>Hola</gradient>
/holograma line add espada 1 item DIAMOND_SWORD
/holograma line add bloque 1 block GRASS_BLOCK

Ejemplos de comandos

Algunos ejemplos reales para el dia a dia:

/holograma create text bienvenida
/holograma line set bienvenida 1 1 <gradient:#9D00FF:#00E5FF>Bienvenido al servidor</gradient>
/holograma page add bienvenida
/holograma line add bienvenida 2 text <yellow>/warp minas
/holograma movehere bienvenida
/holograma visibility bienvenida permission
/holograma permission bienvenida axohologram.view.bienvenida
/holograma create item tienda
/holograma line set tienda 1 1 DIAMOND_SWORD
/holograma create block portal
/holograma line set portal 1 1 END_PORTAL_FRAME
/holograma npc link bienvenida Comerciante
/holograma reload

En corto: create para crearlo, line add o line set para editarlo, movehere para colocarlo donde estas parado y reload cuando cambias archivos a mano y quieres recargar todo sin reiniciar el servidor.

Alias corto addline

Tambien puedes usar el alias corto addline, que en la practica hace lo mismo que line add. Por ejemplo, si quieres meter una linea de texto con animacion inline en la pagina 1:

/holo addline <ID> 1 text <#ANIM:&f:&b&l>Hello World</#ANIM>

Ese comando se interpreta asi:

<ID> es el id del holograma.
1 es la pagina donde se agrega la linea.
text indica que la linea sera de texto.
<#ANIM:&f:&b&l>Hello World</#ANIM> aplica una animacion inline directamente sobre ese texto.

Si prefieres la forma larga, seria equivalente a esto:

/holograma line add <ID> 1 text <#ANIM:&f:&b&l>Hello World</#ANIM>

Estructura de archivos

plugins/AxoHologram/config.yml: Configuracion principal.
plugins/AxoHologram/messages.yml: Mensajes del plugin.
plugins/AxoHologram/holograms/: Carpeta de hologramas individuales.

Hologramas separados

plugins/AxoHologram/holograms/spawn.yml
plugins/AxoHologram/holograms/shop.yml
plugins/AxoHologram/holograms/rules.yml

Opciones de estilo

billboard, scale, shadow, background.
text shadow, brightness y alignment.
Offset base del holograma y offset individual por linea.