Hylograms

Hylograms

Create floating text for your servers with easy-to-use commands.

2.0 тысяч загрузок
Обновлён 8 дней назад

Описание

Гилограммы Discord

️️ Примечание: Из-за текущего Ограничения игры Hytale, цветной/форматированный текст голограммы недоступен. Эта функция будет добавлена, когда Hytale предоставит необходимые API.

Мощный плагин голограммы для серверов Hytale с многострочным текстом, дисплеями элементов, анимацией и простым в использовании API.


командование

Все команды используют /holo Родительское командование.

Основные команды

Командование Описание
/holo create <name> Создайте новую голограмму на своем месте
/holo delete <name> Удалить голограмму
Список /lo Список всех голограмм
/lo Save Сохранит все голограммы на диске
/holo скачать Перезагружает конфигурацию и перезапускает голограммы

← Визуальный редактор

Командование Описание
/holo ui <name> Открывает визуальный голограммный редактор GUI

The /holo ui Команда открывает удобный интерфейс, где вы можете:

  • Просмотр и редактирование всех линий голограммы
  • Добавить новый текст или строки
  • Модифицировать контент строки с помощью текстовых полей
  • Превью изменений в реальном времени

Управление линиями

Командование Описание
/holo addline <name> -text="text" Добавить новую строку
/holo setline <name> <line#> -text="text" Редактирует конкретную строку
/holo removeline <name> <line#> Удалить линию
/holo alignline <name> <line#> <x> <y> <z> Смещение позиции линии

Пункт Display Syntax:

пункт: Пункт Id - Основной пункт
пункт: Пункт Id: масштаб - С масштабом (например, 1.5)
Оригинальное название: Scale: Pitch:yaw:roll - С вращением

Движение и позиция

Командование Описание
/holo move <name> Переместите голограмму в вашу позицию
/holo teleport <name> Телепортирует вас на голограмму

Анимационные команды

Командование Описание
/holo aim create <animName> [--петля = правда] Создает новую анимацию
/holo aim keyframe <animName> <time> [варианты] Добавить Keyframe
/holo aim list Список всех анимаций
/holoim load <holoName> <line#> <animName> Загружает анимацию на линию
/holoim play <holoName> <line#> Начинает играть анимация
/holoim stop <holoName> <line#> Прекратить анимацию
/holoim export <holoName> <line#> <animName> Анимация экспортной линии

Варианты Keyframe:

  • х, -, Z - Смещение позиции
  • - Стучать, - Ага., ролл - Вращение (степени)
  • масштаб - Умножитель масштаба
  • облегчение - LINEAR, EASE_IN, EASE_OUT, EASE_IN_OUT, BOUNCE, ELASTIC

Полезные команды

Командование Описание
/holo respawn Голограммы — подтверждение Сила возрождает все голограммы
/holobugitem <itemId> Пути моделей отладочных элементов

Узлы разрешений

hylograms.create - Создание голограмм
hylograms.delete - Удалить голограммы
hylograms.list - Список голограмм
hylograms.save - Сохранить на диске
hylograms.reload - Перезагрузить конфигурацию
hylograms.addline - Добавить строки
hylograms.setline - Редактировать строки
hylograms.removeline - Удалить линии
hylograms.move - Переместить голограммы
Гилограммы. Телепорт - Телепорт в голограммы
hylograms.alignline - выравнивание линий
hylograms.respawn - Возрождение силы
hylograms.debug - команды Debug
hylograms.ui - Используйте визуальный редактор

hylograms.anim.create - Создание анимации
hylograms.anim.keyframe - Добавить кейфреймы
hylograms.anim.load - Загрузка анимации
hylograms.anim.play - Играть анимацию
hylograms.anim.stop - Остановить анимацию
hylograms.anim.export - Экспортная анимация
hylograms.anim.list - Список анимаций

config.yml

Расположенный в Моды/гилограммы/config.yml:

# Расстояние между голограммными линиями (в блоках)
линейный интервал: 0,3

# Цвет по умолчанию для новых голограмм (хекс-формат)
По умолчанию: #FFFFFF

Голограммы.yml

Данные голограммы хранятся в mods/Hylograms/holograms.yml:

голограммы:
- Добро пожаловать.
Оригинальное название: Overworld
позиция:
x: 100,50
y: 64.00
z: -200,50
Цвет: «#00FF00»
текст:
Добро пожаловать на наш сервер! "
- Тема: Diamond:1.5 "
- Веселитесь! "
LineOffsets:
1:
x - 0,5
y: 0,0
z: 0,0
LineAnimations:
1: спина
Создано: 1705264800000

Ручное редактирование: Отредактируйте этот файл и запустите /holo скачать применять изменения.


Анимация.yml

Многоразовые анимации хранятся в mods/Hylograms/animations.yml:

анимация:
спин:
Альбом: True
Keyframes:
- время: 0,0
x - 0,0
y: 0,0
z: 0,0
yaw: 0,0
шкала: 1.0
Ослабление: Линейный
- время: 2.0
yaw: 360.0
шкала: 1.0
Ослабление: Линейный

Отскок:
Альбом: True
Keyframes:
- время: 0,0
y: 0,0
Обсуждение:EASE_OUT
- время: 0,5
у: 0,3
Обсуждение:EASE_IN
- время: 1.0
y: 0,0
Обсуждение:EASE_OUT

Разработчик API

Гилограммы обеспечивают свободный, простой в использовании API для разработчиков.

Создание голограмм

импортировать dev.ehko.hylograms.api.HologramsAPI;

// Создание с помощью беглого конструктора
HologramsAPI.create (магазин, магазин)
.at (100, 65, 200)
.inworld («мир над миром»)
.color (#00FF00)
.addLine («Добро пожаловать в магазин!»)
.addItem("ItemDiamond", 2.0f)
.addLine («Нажмите, чтобы просмотреть»)
.spawn();

Изменение голограмм

HologramsAPI.get("магазин")
.setLine(1, «Магазин открыт!»)
.alignLine(1, 0,5, 0, 0)
.addLine («Новые предметы доступны!»)
.respawn (магазин)
.save(магазин);

Анимация

HologramsAPI.get("магазин")
.loadAnimation(1, "спин")
.playAnimation(магазин, 1);

Остановить анимацию
HologramsAPI.get("магазин").stopAnimation(1);

коммунальные услуги

Проверить существование
если (HologramsAPI.exists("магазин") {...}

// Перечислите все голограммы
List<String> names = HologramsAPI.list();

// Удалить
HologramsAPI.delete («магазин», магазин);

Spawn all on server start смотреть онлайн
HologramsAPI.spawnAll (магазин);

Общие проблемы и устранение неполадок

Голограммы не видны или не дублируются?

  • Беги. /holo respawn Голограммы — подтверждение Принудить к очистке и возрождению

Предметы, показывающие неправильную модель?

  • Использовать /holobugitem <itemId> Проверить модельные пути
  • Некоторые предметы могут не иметь 3D-моделей.

Редактирование YAML не применяется?

  • Беги. /holo скачать После редактирования файлов
  • Проверьте консоль сервера на наличие ошибок анализа YAML

Анимации не играют?

  • Убедитесь, что анимация загружена /holo aim load
  • Беги. /holo aim play после загрузки
  • Проверьте, что голограмма нерестится

Призрачные сущности после аварии?

  • Использовать /holo respawn Голограммы — подтверждение Очистить осиротевшие объекты

установка

  1. Скачать Гилограммы JAR
  2. Место на вашем сервере модс/ папка
  3. Перезагрузить сервер
  4. Узлы разрешений гранта по мере необходимости
  5. Создание голограмм с /holo создать или /holo ui
Показать оригинальное описание (English)

Hylograms Discord

⚠️ Note: Due to current Hytale game limitations, colored/formatted hologram text is not available. This feature will be added when Hytale exposes the necessary APIs.

A powerful hologram plugin for Hytale servers with multi-line text, item displays, animations, and an easy-to-use API.


Commands

All commands use the /holo parent command.

Core Commands

Command Description
/holo create <name> Creates a new hologram at your position
/holo delete <name> Deletes a hologram
/holo list Lists all holograms
/holo save Saves all holograms to disk
/holo reload Reloads config and respawns holograms

⭐ Visual Editor

Command Description
/holo ui <name> Opens the visual hologram editor GUI

The /holo ui command opens a user-friendly interface where you can:

  • View and edit all hologram lines
  • Add new text or item lines
  • Modify line content with text fields
  • Real-time preview of changes

Line Management

Command Description
/holo addline <name> --text="text" Adds a new line
/holo setline <name> <line#> --text="text" Edits a specific line
/holo removeline <name> <line#> Removes a line
/holo alignline <name> <line#> <x> <y> <z> Offsets a line's position

Item Display Syntax:

item:ItemId                          - Basic item
item:ItemId:scale                    - With scale (e.g., 1.5)
item:ItemId:scale:pitch:yaw:roll     - With rotation

Movement & Position

Command Description
/holo move <name> Moves hologram to your position
/holo teleport <name> Teleports you to the hologram

Animation Commands

Command Description
/holo anim create <animName> [--loop=true] Creates a new animation
/holo anim keyframe <animName> <time> [options] Adds a keyframe
/holo anim list Lists all animations
/holo anim load <holoName> <line#> <animName> Loads animation onto a line
/holo anim play <holoName> <line#> Starts playing animation
/holo anim stop <holoName> <line#> Stops animation
/holo anim export <holoName> <line#> <animName> Exports line's animation

Keyframe Options:

  • --x, --y, --z - Position offset
  • --pitch, --yaw, --roll - Rotation (degrees)
  • --scale - Scale multiplier
  • --easing - LINEAR, EASE_IN, EASE_OUT, EASE_IN_OUT, BOUNCE, ELASTIC

Utility Commands

Command Description
/holo respawnHolograms --confirm Force respawns all holograms
/holo debugitem <itemId> Debug item model paths

Permission Nodes

hylograms.create      - Create holograms
hylograms.delete      - Delete holograms
hylograms.list        - List holograms
hylograms.save        - Save to disk
hylograms.reload      - Reload config
hylograms.addline     - Add lines
hylograms.setline     - Edit lines
hylograms.removeline  - Remove lines
hylograms.move        - Move holograms
hylograms.teleport    - Teleport to holograms
hylograms.alignline   - Align line offsets
hylograms.respawn     - Force respawn
hylograms.debug       - Debug commands
hylograms.ui          - Use visual editor

hylograms.anim.create   - Create animations
hylograms.anim.keyframe - Add keyframes
hylograms.anim.load     - Load animations
hylograms.anim.play     - Play animations
hylograms.anim.stop     - Stop animations
hylograms.anim.export   - Export animations
hylograms.anim.list     - List animations

config.yml

Located at mods/Hylograms/config.yml:

# Line spacing between hologram lines (in blocks)
lineSpacing: 0.3

# Default color for new holograms (hex format)
defaultColor: "#FFFFFF"

holograms.yml

Hologram data is stored at mods/Hylograms/holograms.yml:

holograms:
  - name: welcome
    worldName: overworld
    position:
      x: 100.50
      y: 64.00
      z: -200.50
    color: "#00FF00"
    text:
      - 'Welcome to our server!'
      - 'item:ItemDiamond:1.5'
      - 'Have fun!'
    lineOffsets:
      1:
        x: 0.5
        y: 0.0
        z: 0.0
    lineAnimations:
      1: spin
    createdAt: 1705264800000

Manual Editing: Edit this file and run /holo reload to apply changes.


animations.yml

Reusable animations are stored at 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

Developer API

Hylograms provides a fluent, easy-to-use API for developers.

Creating Holograms

import dev.ehko.hylograms.api.HologramsAPI;

// Create with fluent builder
HologramsAPI.create("shop", store)
    .at(100, 65, 200)
    .inWorld("overworld")
    .color("#00FF00")
    .addLine("Welcome to the Shop!")
    .addItem("ItemDiamond", 2.0f)
    .addLine("Click to browse")
    .spawn();

Modifying Holograms

HologramsAPI.get("shop")
    .setLine(1, "Shop is OPEN!")
    .alignLine(1, 0.5, 0, 0)
    .addLine("New items available!")
    .respawn(store)
    .save(store);

Animations

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

// Stop animation
HologramsAPI.get("shop").stopAnimation(1);

Utilities

// Check existence
if (HologramsAPI.exists("shop")) { ... }

// List all holograms
List<String> names = HologramsAPI.list();

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

// Spawn all on server start
HologramsAPI.spawnAll(store);

Common Issues & Troubleshooting

Holograms not visible or duplicated?

  • Run /holo respawnHolograms --confirm to force cleanup and respawn

Items showing as wrong model?

  • Use /holo debugitem <itemId> to check model paths
  • Some items may not have 3D models in Hytale

YAML edits not applying?

  • Run /holo reload after editing files
  • Check server console for YAML parsing errors

Animations not playing?

  • Ensure the animation is loaded with /holo anim load
  • Run /holo anim play after loading
  • Check that the hologram is spawned

Ghost entities after crash?

  • Use /holo respawnHolograms --confirm to clean up orphaned entities

Installation

  1. Download the Hylograms JAR
  2. Place in your server's mods/ folder
  3. Restart the server
  4. Grant permission nodes as needed
  5. Create holograms with /holo create or /holo ui

Последние версии

hylograms-1.0.7.jar

Early Access 26.01.2026 140.4 КБ
Скачать

Hylograms 1.0.6

Early Access 17.01.2026 131.5 КБ
Скачать

Hylograms 1.0.5

Early Access 17.01.2026 84.8 КБ
Скачать

Hylograms 1.0.4

Early Access 16.01.2026 56.1 КБ
Скачать

Hylograms 1.0.3

Early Access 16.01.2026 47.2 КБ
Скачать