Скачать GameUI | Zero-delay-cursor GUIs and HUD с Black-Minecraft.com | Black-Minecraft.com

Источник: https://builtbybit.com/resources/120765/

Документация: https://hexacoredev.hexacoredev.workers.dev/docs/hexogameui

Описание плагина GameUI:

GameUI позволяет создавать меню и HUD-интерфейсы для ванильных клиентов Minecraft. Каждый экран описывается в YAML-файле или создаётся в веб-редакторе. При подключении к серверу игроки получают графику через ресурспак.

Требования для GameUI

Paper или Folia для Minecraft 1.21.11, 26.1 или 26.2.
Игрокам ничего устанавливать не нужно. Достаточно ресурспака, который GameUI размещает на своём сервере и отправляет игрокам при подключении. В кратком руководстве описана единственная необходимая настройка.

Как экраны отображаются у игроков

Каждый экран — это YAML-файл в папке screen/, а его идентификатор соответствует имени файла. GUI открывается и закрывается как обычное меню. HUD (kind: HUD) остаётся на экране во время игры.

Открыть экран можно с помощью собственной команды или привязки клавиши, клика по другому экрану либо команды /hexo-ui screen open.

Изображения, шрифты и модели предметов размещаются в папке contents/. При запуске плагин добавляет их в ресурспак.

Команда /hexo-ui screen reload перечитывает файлы экранов и папку lang/ без перезапуска сервера. Для применения изменений в ресурспаке и файле config.yml необходим перезапуск.

Плагин не пересобирает ресурспак при перезагрузке, поскольку в противном случае все игроки онлайн получили бы новый ресурспак посреди игровой сессии.

Команды плагина GameUI:

Команда /hexo-ui предназначена для администраторов и требует права hexoui.admin. Для всех игроков доступны только /hexo-ui cursor и /sens.

Команды экранов GameUI

Эти команды также работают из консоли. Имя игрока указывается последним аргументом, поэтому отображать HUD конкретному игроку можно, например, с помощью навыков MythicMobs или командного блока.

Команда	Описание
/hexo-ui screen list	Показывает список загруженных экранов. HUD помечаются как (hud).
/hexo-ui screen open <screen> [player]	Открывает GUI или отображает HUD для себя либо указанного игрока, находящегося онлайн.
/hexo-ui screen close <screen> [player]	Закрывает GUI или скрывает HUD. Скрытый HUD остаётся зарегистрированным, поэтому его можно показать повторно.
/hexo-ui screen close	В игре закрывает все GUI, открытые для вас из файлов экранов.
/hexo-ui screen reload	Перечитывает папки screen/ и lang/, обновляет открытые экраны, команды экранов и привязки клавиш.

Перезагрузка не пересобирает ресурспак и не перечитывает файлы config.yml и variables.yml. Для применения изменений в конфигурации, а также добавления новых изображений, шрифтов и предметов необходим перезапуск сервера.

Команды предметов GameUI

Работают только в игре и предназначены для проверки моделей перед размещением на экранах.

Команда	Описание
/hexo-ui item list	Показывает предметы GameUI: модели из contents/items/ (по имени файла) и определения предметов из contents/pack_overlay/ в формате namespace:path.
/hexo-ui item give <id>	Выдаёт предмет. Можно указать предмет GameUI, идентификатор предмета из другого плагина или название материала.
/hexo-ui item show <id> [seconds]	Отображает предмет в центре экрана на 5 секунд или на указанное время от 1 до 60 секунд.
/hexo-ui item pose <id>	Показывает угол отображения предмета и команду для его настройки.
/hexo-ui item pose <id> <x> <y> <z> [dx dy]	Устанавливает угол отображения в градусах с необязательной корректировкой смещения и показывает предмет. Настройки сохраняются до перезапуска сервера.

Данные, переменные, импорт и шейдеры

Команда	Описание
/hexo-ui data [path]	В игре выводит актуальные значения, доступные экранам: все данные или только данные по указанному пути.
/hexo-ui data export	Сохраняет все пути данных в plugins/GameUI/data-catalog.json для использования в веб-редакторе.
/hexo-ui var <get\\|set\\|add\\|reset> <player> <name> [value]	Позволяет получить или изменить переменную игрока. Игрок может быть офлайн, если ранее заходил на сервер. Подробнее — в разделе «Переменные».
/hexo-ui import betterhud [overwrite] [pixelScale]	Преобразует файлы из plugins/BetterHud/huds/ в экраны и копирует графику в contents/images/betterhud/. При повторном импорте существующие файлы сохраняются, если не указан overwrite. По умолчанию pixelScale равен 4. В конце выводится список элементов, которые не удалось преобразовать.
/hexo-ui compose status	Показывает, какие шейдеры были объединены при последней сборке ресурспака с шейдерами других плагинов, а какие объединить не удалось. Аналогичную информацию выводит команда /hexo-ui compose. Подробнее — в разделе «Конфликты шейдеров».
/hexo-ui compose export	Сохраняет конфликтующие шейдеры и файл hashes.txt в plugins/GameUI/compose-export/, чтобы их можно было отправить автору плагина.

Все перечисленные команды, кроме /hexo-ui data без аргументов или с указанием пути, можно выполнять из консоли.

Импортированные экраны загружаются сразу, но их графика попадёт в ресурспак только после перезапуска сервера.

Скорость курсора GameUI

Команда	Описание
/sens [speed]	Настраивает скорость перемещения курсора по экранам: от 1.0 до 3.0 с шагом 0.1. Значение reset сбрасывает скорость до 1.0. Без аргументов показывает текущую скорость. Алиас — /sensitivity.
/hexo-ui cursor [speed]	Работает так же, как /sens.

Права доступа

Право	По умолчанию	Предоставляет
hexoui.admin	Операторы	Доступ ко всем командам /hexo-ui, кроме cursor.
hexoui.player	Все игроки	Доступ к /sens и /hexo-ui cursor.

Право hexoui.player по умолчанию доступно всем игрокам, поскольку настройка скорости влияет только на курсор самого игрока.