HUDEngine — plugin for Minecraft 1.21.4+ that enables Paper and Folia server owners to create modern HUD interfaces without requiring players to install client-side mods. Players only need to download the resource pack generated by the plugin and sent by the server.
Plugin Features
- One resource pack for all supported versions. Clients from Minecraft 1.21.4—26.2 automatically use the appropriate assets.
- Easy to use. Minimal folder structure and required configuration. All setup instructions are covered in the documentation, while the open-source code provides additional implementation details.
- Optimized performance. HUDs are rebuilt only for players who have them enabled. Rendering is cached on two levels, and if nothing has changed, no packet is sent at all.
- Configuration errors are explained, not hidden. The plugin identifies the exact file and configuration element causing the issue, and even suggests corrections for typos.
- Vanilla HUD hiding. Optionally hide vanilla interface elements such as health, hunger, armor, level, experience bar, hotbar, and more.
- Built-in placeholder and condition engine. The plugin can display built-in values such as health and hunger without external dependencies, while the condition system allows tracking various player states.
- Open API. Full control over HUD functionality from your own plugins. Particularly useful for the compass system, including personal markers, nearby player indicators, quest objectives, and more.
- Advanced compass. The compass not only displays direction but also supports markers, both static (configured in files) and dynamic (managed through the API).
- Compatible with BetterHud configurations. Migration is as simple as copying the configuration folder (except for popups and animation), while HUDEngine-specific features can be added on top as needed.
- Small resource pack size. The generated ZIP archive is approximately 230 KB by default, minimizing download times for players. Even large HUD setups are unlikely to exceed 1 MB.
- Built-in resource pack hosting. Serve the generated resource pack directly from the game server without requiring a separate web server. The download message and whether players are kicked for declining the pack are fully configurable.
Detailed information about the plugin, including the API-developer, source code and guide, is available on the project's GitHub page via the links on the right.
Compatibility and Dependencies
Paper/Folia 1.21.4–26.2 (Java 21–25). The plugin has no required external dependencies and can run on a clean server installation. PlaceholderAPI is supported for displaying custom placeholders without requiring API integration. Compatibility with BetterHud (by toxicity188) is maintained, making migration from existing BetterHud configurations straightforward.
[RU-version] Информация на русском
HUDEngine — плагин для Minecraft 1.21.4+, позволяющий владельцам серверов Paper и Folia создавать современные HUD-интерфейсы без установки игроками клиентских модификаций. Со стороны игрока необходим лишь ресурспак, генерируемый плагином для отправки на сервер.
Преимущества плагина:
- Один пак на все версии. Клиент 1.21.4—26.2 сам выбирает нужный вариант.
- Простота использования. Минимум папок и обязательных настроек, а вся информация по настройке описана в гайде. Открытый код даст дополнительные разъяснения.
- Оптимизация. HUD пересобирается только для тех игроков, у кого он включён. Вывод кэшируется на двух уровнях: если значения не изменились, пакет не отправляется вообще;
- Ошибки в конфигах объясняются, а не прячутся. Плагин называет файл и конкретный элемент, где проблема, предлагает исправление при опечатке;
- Скрытие ванильного HUD. Возможность опционального скрытия ванильного интерейса: хп, голод, броня, уровень, шкала опыта, хотбар и другое.
- Встроенный движок плейсхолдеров и условий. Плагин самостоятельно отображает хп, голод и другие базовые параметры, а система условий позволяет отслеживать некоторые состояния игрока.
- Открытое API. Полное управление HUD-частью в собственных плагинах, что особенно полезно в контексте компаса: персональные маркеры, отображение игроков поблизости, квестовые точки и прочее;
- Продвинутый компас. Компас не только определяет направление, но и поддерживает метки — постоянные (задаются в конфигах) и динамические (через API).
- Совместим с конфигами BetterHud. Миграция возможна обычным копированием папки (за исключением popups и animation), а дополнительные возможности, поддерживаемые HUDEngine, опционально интегрируются поверх;
- Небольшой размер пака. Базовый размер генерируемого .zip-архивасоставляет ~230 KB), что не заставляет игроков долго ожидать загрузку. Маловероятно, что пак превысит 1 MB даже при большом количестве HUD-элементов;
- Прямая раздача. Настройка раздачи пака прямо с игрового сервера (без веб-сервера) с возможностью изменения текста сообщений и обязательности (кикает ли за отказ от скачивания);
Подробная информация о плагине, включая API для разработчика, открытый код и гайд, доступны на GitHub-странице плагина в списке ссылок справа.
Совместимости и зависимости
Paper/Folia 1.21.4—26.2 (Java 21—25). Плагин не имеет сторонних зависимостей и может работать на чистом сервере. Поддерживается PlaceholderAPI для выведения кастомных плейсхолдеров без необходимости подключения API. Сохраняется совместимость с BetterHud (toxicity188), что упрощает миграцию.
Pinned Versions
- R1.21.4–26.2
Pages
Members
1
Owner