
[](https://github.com/Nacvark/HUDEngine/tree/main/hudengine-paper)
[](https://github.com/Nacvark/HUDEngine/wiki)
[](https://github.com/Nacvark/HUDEngine/blob/main/DONATE.md)
[](https://adoptium.net/)
[](https://papermc.io/)
**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] Информация на русском

[](https://github.com/Nacvark/HUDEngine/tree/main/hudengine-paper)
[](https://github.com/Nacvark/HUDEngine/wiki)
[](https://github.com/Nacvark/HUDEngine/blob/main/DONATE.md)
[](https://adoptium.net/)
[](https://papermc.io/)
**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), что упрощает миграцию.HUDEngine is a free Minecraft Java mod. Compatible with Minecraft 1.21.10, 1.21.11, 1.21.4, 1.21.5 and newer. Downloaded 14 times (via Hangar). Download it and open it directly in the game.