HyUI

HyUI Это мощная, удобная для разработчиков библиотека Java, предназначенная для упрощения создания и управления пользовательскими интерфейсами для серверов Hytale. Соединяя необработанный протокол пользовательского интерфейса Hytale с высокоуровневыми абстракциями, HyUI позволяет создавать сложные, интерактивные и высокопроизводительные пользовательские интерфейсы, используя либо свободно Java Builder API или ЮИМЛДекларативный HTML/CSS-подобный синтаксис.

Независимо от того, создаете ли вы простую панель администратора, постоянный HUD или полномасштабную систему меню RPG, HyUI предоставляет инструменты и «лазейки», необходимые для эффективной работы.

Особенности

• HYUIML (HTML/CSS): Создавайте интерфейсы, используя знакомый, декларативный HTML-подобный синтаксис со стилем CSS, а также шаблонированием и многоразовыми компонентами.
• Свободный строитель API: Постройте вложенные иерархии пользовательского интерфейса (группы, кнопки, ярлыки и т. Д.), Используя чистую, читаемую цепочку методов.
• многофункциональный Система: Сосуществовать с другими модами легко. HyUI автоматически управляет одним HUD-слотом Hytale, позволяя одновременно отображать несколько независимых HUD-элементов.
• Динамическая инъекция элементов: База нагрузки .ui Файлы и впрыскивайте динамические элементы в определенные селекторы во время выполнения.
• Обработка событий Упрощено: Привязывайте логику на стороне сервера непосредственно к событиям пользовательского интерфейса, используя простые выражения лямбда и получайте доступ к состоянию пользовательского интерфейса через МСЖД.
• Периодический UI Обновить: Встроенная поддержка пакетных периодических обновлений HUD с низкой производительностью.
• Специализированные строители: Включает готовых к использованию строителей для:
  • Кнопки: Стандартизированные текстовые кнопки на игровую тему и кнопки обратной связи.
  • Входные поля: Текст, цифры, слайдеры, чекбоксы и цветные пикеры.
  • Бары прогресса: Динамические индикаторы прогресса с настраиваемыми текстурами и эффектами.
  • Иконки элементов: Отображайте иконки предметов с поддерживаемыми активами текстурами.
  • контейнеры: Гибкие групповые строители с различными режимами компоновки и оконными рамами.
• Изображения: Простые изображения, поддерживаемые активами, а также динамические изображения, загружаемые во время выполнения.
• Расширенная логика (Escape Hatches): Доступ к сырому Разработчик Примеры в любой точке для свойств, изначально не охваченных API.

Быстрый старт

1.Установка (Gradle)

Чтобы использовать HyUI в вашем проекте Hytale, вы можете быстро начать работу, используя пример проекта: https://github.com/Elliesaur/Hytale-Example-UI-Project

В противном случае добавьте HyUI в свой проект через Cursemaven:

репозитории {
maven {url}https://www.cursemaven.com"}
?

зависимости {
Идентификатор проекта: 1431415
"curse.maven:hyui-1431415:<file-id>"
?

2. Создание страницы с помощью HYUIML (HTML)

Для большинства случаев использования HYUIML является самым быстрым способом создания макетов:

Струна html = ""
<div class="page-overlay">
<div class="container" data-hyui-title="My Menu">
<div class="container-contents">
<p>Добро пожаловать в меню!</p>
<button id="myBtn"> Нажмите Me</button>
<img class="динамический образ" src=https://example.invalid/render/PlayerName"/"
</div>
</div>
</div>
"";

PageBuilder.pageForPlayer(playerRef)
.fromHtml(html)
.addEventListener("myBtn", CustomUIEventBindingType.Activating, (ctx) -> {
PlayerRef.sendMessage(Message.raw("Clicked!"));
)
.open(магазин);

3. Создание HUD

HUD являются постоянными элементами на экране:

HudBuilder.hudForPlayer (PlayerRef)
.fromHtml("<div style='anchor-top: 10; anchor-left: 10;'><p>Здоровье: 100</p></div>"
.show (магазин);

Компоненты

Документация и примеры

Подробную документацию по установке, созданию страниц, строительству HUD и HYUIML можно найти в разделе WEB документы папка.

Кликни Источник кнопка на этой странице (подробности -> источник на мобильном телефоне, правая боковая панель на рабочем столе) для просмотра полной документации и примеров реализации!

Требования:

• Hytale Server добавляется в зависимости
• Java 25 (совместимая с Hytale версия)
• jsoup (встроен в JAR по лицензии MIT)
• MultipleHUD - факультативное требование - включает источник в JAR (не встроенный) по лицензии MIT.

Лицензии

Все лицензии с открытым исходным кодом можно найти в репо JAR и GitHub.

Помощь и поддержка

Не стесняйтесь присоединиться к раздору: https://discord.gg/NYeK9JqmNB - Рад помочь!