Hylograms

⚠️ Nota: Debido a las limitaciones actuales del juego Hytale, el texto holográfico con formato y color no está disponible. Esta función se añadirá cuando Hytale exponga las APIs necesarias.

Un potente plugin de hologramas para servidores de Hytale que permite texto en múltiples líneas, exhibiciones de objetos, animaciones y una API fácil de usar.

Todos los comandos utilizan el comando padre /holo.

Comandos Básicos

Comando	Descripción
/holo create <nombre>	Crea un nuevo holograma en tu posición
/holo delete <nombre>	Elimina un holograma
/holo list	Lista todos los hologramas
/holo save	Guarda todos los hologramas en el disco
/holo reload	Recarga la configuración y vuelve a generar los hologramas

⭐ Editor Visual

Comando	Descripción
/holo ui <nombre>	Abre la interfaz gráfica del editor de hologramas

El comando /holo ui abre una interfaz amigable donde puedes:

• Ver y editar todas las líneas del holograma
• Añadir nuevas líneas de texto u objeto
• Modificar el contenido de las líneas con campos de texto
• Vista previa en tiempo real de los cambios

Gestión de Líneas

Comando	Descripción
/holo addline <nombre> --text="texto"	Añade una nueva línea
/holo setline <nombre> <número de línea> --text="texto"	Edita una línea específica
/holo removeline <nombre> <número de línea>	Elimina una línea
/holo alignline <nombre> <número de línea> <x> <y> <z>	Desplaza la posición de una línea

Sintaxis de Exhibición de Objetos:

item:ItemId                          - Objeto básico
item:ItemId:scale                    - Con escala (p. ej., 1.5)
item:ItemId:scale:pitch:yaw:roll     - Con rotación

Movimiento y Posición

Comando	Descripción
/holo move <nombre>	Mueve el holograma a tu posición
/holo teleport <nombre>	Te teletransporta al holograma

Comandos de Animación

Comando	Descripción
/holo anim create <nombreAnimación> [--loop=true]	Crea una nueva animación
/holo anim keyframe <nombreAnimación> <tiempo> [opciones]	Añade un fotograma clave
/holo anim list	Lista todas las animaciones
/holo anim load <nombreHolo> <número de línea> <nombreAnimación>	Carga la animación en una línea
/holo anim play <nombreHolo> <número de línea>	Empieza a reproducir la animación
/holo anim stop <nombreHolo> <número de línea>	Detiene la animación
/holo anim export <nombreHolo> <número de línea> <nombreAnimación>	Exporta la animación de la línea

Opciones de Fotograma Clave:

• --x, --y, --z – Desplazamiento de posición
• --pitch, --yaw, --roll – Rotación (grados)
• --scale – Multiplicador de escala
• --easing – LINEAL, EASE_IN, EASE_OUT, EASE_IN_OUT, BOUNCE, ELASTIC

Comandos de Utilidad

Comando	Descripción
/holo respawnHolograms --confirm	Vuelve a generar todos los hologramas forzosamente
/holo debugitem <itemId>	Depura las rutas de modelos de objetos

Nodos de Permiso

hylograms.create      - Crear hologramas
hylograms.delete      - Eliminar hologramas
hylograms.list        - Listar hologramas
hylograms.save        - Guardar en disco
hylograms.reload      - Recargar configuración
hylograms.addline     - Añadir líneas
hylograms.setline     - Editar líneas
hylograms.removeline  - Eliminar líneas
hylograms.move        - Mover hologramas
hylograms.teleport    - Teletransportarse a hologramas
hylograms.alignline   - Alinear desplazamientos de línea
hylograms.respawn     - Fuerza la regeneración
hylograms.debug       - Comandos de depuración
hylograms.ui          - Usar editor visual

hylograms.anim.create   - Crear animaciones
hylograms.anim.keyframe - Añadir fotogramas clave
hylograms.anim.load     - Cargar animaciones
hylograms.anim.play     - Reproducir animaciones
hylograms.anim.stop     - Detener animaciones
hylograms.anim.export   - Exportar animaciones
hylograms.anim.list     - Listar animaciones

Ubicado en mods/Hylograms/config.yml:

# Espaciado entre líneas de holograma (en bloques)
lineSpacing: 0.3

# Color por defecto para nuevos hologramas (formato hex)
defaultColor: "#FFFFFF"

Los datos de hologramas se almacenan en mods/Hylograms/holograms.yml:

holograms:
  - name: welcome
    worldName: overworld
    position:
      x: 100.50
      y: 64.00
      z: -200.50
    color: "#00FF00"
    text:
      - '¡Bienvenido a nuestro servidor!'
      - 'item:ItemDiamond:1.5'
      - '¡Diviértete!'
    lineOffsets:
      1:
        x: 0.5
        y: 0.0
        z: 0.0
    lineAnimations:
      1: spin
    createdAt: 1705264800000

Edición Manual: Edita este archivo y ejecuta /holo reload para aplicar los cambios.

Las animaciones reutilizables se almacenan en mods/Hylograms/animations.yml:

animations:
  spin:
    loop: true
    keyframes:
      - time: 0.0
        x: 0.0
        y: 0.0
        z: 0.0
        yaw: 0.0
        scale: 1.0
        easing: LINEAR
      - time: 2.0
        yaw: 360.0
        scale: 1.0
        easing: LINEAR

  bounce:
    loop: true
    keyframes:
      - time: 0.0
        y: 0.0
        easing: EASE_OUT
      - time: 0.5
        y: 0.3
        easing: EASE_IN
      - time: 1.0
        y: 0.0
        easing: EASE_OUT

Hylograms proporciona una API fluida y fácil de usar para desarrolladores.

Creando Hologramas

import dev.ehko.hylograms.api.HologramsAPI;

// Crear con constructor fluido
HologramsAPI.create("shop", store)
    .at(100, 65, 200)
    .inWorld("overworld")
    .color("#00FF00")
    .addLine("¡Bienvenido a la Tienda!")
    .addItem("ItemDiamond", 2.0f)
    .addLine("Haz clic para explorar")
    .spawn();

Modificando Hologramas

HologramsAPI.get("shop")
    .setLine(1, "¡La tienda está ABIERTA!")
    .alignLine(1, 0.5, 0, 0)
    .addLine("¡Nuevos artículos disponibles!")
    .respawn(store)
    .save(store);

Animaciones

HologramsAPI.get("shop")
    .loadAnimation(1, "spin")
    .playAnimation(store, 1);

// Detener animación
HologramsAPI.get("shop").stopAnimation(1);

Utilidades

// Comprobar existencia
if (HologramsAPI.exists("shop")) { ... }

// Listar todos los hologramas
List<String> names = HologramsAPI.list();

// Eliminar
HologramsAPI.delete("shop", store);

// Generar todos al iniciar el servidor
HologramsAPI.spawnAll(store);

¿Hologramas no visibles o duplicados?

• Ejecuta /holo respawnHolograms --confirm para forzar la limpieza y regeneración

¿Objetos mostrando un modelo incorrecto?

• Usa /holo debugitem <itemId> para comprobar las rutas de los modelos
• Algunos objetos pueden no tener modelos 3D en Hytale

¿Ediciones en YAML no aplicadas?

• Ejecuta /holo reload después de editar archivos
• Revisa la consola del servidor en busca de errores de análisis de YAML

¿Animaciones no reproduciéndose?

• Asegúrate de que la animación esté cargada con /holo anim load
• Ejecuta /holo anim play después de cargar
• Verifica que el holograma esté generado

¿Entidades fantasma después de un fallo?

• Usa /holo respawnHolograms --confirm para limpiar entidades huérfanas

Instalación

• Descarga el JAR de Hylograms
• Colócalo en la carpeta mods/ de tu servidor
• Reinicia el servidor
• Concede los nodos de permiso según sea necesario
• Crea hologramas con /holo create o /holo ui