Hylograms
Create floating text for your servers with easy-to-use commands.
Описание
Гилограммы 
️️ Примечание: Из-за текущего Ограничения игры 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 Голограммы — подтверждениеОчистить осиротевшие объекты
установка
- Скачать Гилограммы JAR
- Место на вашем сервере
модс/папка - Перезагрузить сервер
- Узлы разрешений гранта по мере необходимости
- Создание голограмм с
/holo создатьили/holo ui
Показать оригинальное описание (English)
Hylograms 
⚠️ 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 --confirmto 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 reloadafter editing files - Check server console for YAML parsing errors
Animations not playing?
- Ensure the animation is loaded with
/holo anim load - Run
/holo anim playafter loading - Check that the hologram is spawned
Ghost entities after crash?
- Use
/holo respawnHolograms --confirmto clean up orphaned entities
Installation
- Download the Hylograms JAR
- Place in your server's
mods/folder - Restart the server
- Grant permission nodes as needed
- Create holograms with
/holo createor/holo ui
Последние версии
Информация
Авторы:
Категории:
Версии игры:
Создан: 15.01.2026
