Zap's Enhanced HUD Utilities

ZEHU — Zap's Enhanced HUD Utilities

Высокопроизводительный модульный мод на HUD-утилиты для Minecraft 1.21.11, 26.1.x и 26.2 на Fabric.

Обзор

ZEHU — Zap's Enhanced HUD Utilities — это HUD-мод, созданный для Minecraft 1.21.11, 26.1.x и 26.2. ZEHU стремится предоставить необходимые HUD-утилиты в простом моде, не встроенном в проприетарные лаунчеры, с относительным масштабированием, независимым от разрешения, и процедурами отрисовки без мусорных аллокаций. Основные PvP HUD-утилиты, а также прочие разноплановые и выживальческие утилиты включены в этот мод вместе с различными темами для каждой из этих конкретных утилит.

Предупреждение

[!Warning] Этот мод находится в разработке и будет в ней оставаться. Если вы найдёте баги или что-то, что недостаточно отполировано, — это связано с тем, что мод всё ещё в разработке. Если вы найдёте баги или что-то, что требует доработки, пожалуйста, откройте issue в исходном репозитории на Github. Я соло-разработчик, и у меня нет времени проверять каждый уголок этого мода, поэтому я буду очень признателен, если вы сообщите мне о них, чтобы я мог взглянуть.

Ключевые особенности и предлагаемые модули

1. HUD брони и снаряжения

• Отслеживание прочности в реальном времени: отображает надетый шлем, нагрудник, штаны, ботинки с полосами прочности в реальном времени, сырыми числами или процентами.
• Предупреждения о низкой прочности: визуальные предупреждения срабатывают, когда прочность снаряжения падает ниже настраиваемых порогов (процент или сырые значения прочности).
• Гибкие макеты: поддерживает вертикальное или горизонтальное расположение, обратный порядок отрисовки и настраиваемое позиционирование текста.

2. HUD нажатий клавиш и ввода

• Отображение ввода в реальном времени: отображает WASD, левую/правую кнопки мыши, левый Shift, Control и пробел.
• Встроенные индикаторы CPS: отображает клики в секунду прямо внутри клавиш кнопок мыши.

3. Боевые утилиты (комбо, дистанция, пинг, CPS)

• Счётчик комбо
• Отображение дистанции
• Монитор пинга
• Счётчик CPS
• Счётчик FPS

4. Навигация (координаты, спидометр и компас)

• HUD координат: отображает позицию X, Y, Z, сторону света (север, юг, восток, запад), текущий биом и автоматический расчёт координат Nether.
• Спидометр: отслеживает горизонтальную скорость передвижения в метрах в секунду ($m/s$).
• Лента компаса: плавная линейная полоса компаса с иконками головы игрока (PlayerFaceExtractor) и отметками сторон света.

5. HUD отслеживания предметов

• Свой счётчик предметов: отслеживайте конкретные предметы в инвентаре (эндер-жемчуг, золотые яблоки, стрелы, тотемы и т. д.) с наложением счётчика в реальном времени.
• Экран поиска и выбора предметов: встроенный экран поиска по реестру для быстрого выбора предметов для отслеживания.
• Наложения зелий и стаков: индикаторы длительности активных эффектов зелий и количества предметов в стаках в реальном времени.

7. Свой прицел

[!WARNING]
В настоящее время дорабатывается и улучшается, не в рабочем состоянии

• Векторные стили: выберите из DOT, CROSS, CIRCLE, ARROW или VANILLA.
• Параметры точности: полностью настраиваемые зазор, толщина линий, внешний размер и цвета RGB/Hex.

8. Полоса босса

[!WARNING]
В настоящее время дорабатывается и улучшается, не в рабочем состоянии

• Одиночное и множественное стекирование полос: настраиваемые направления стека (UP или DOWN) для нескольких активных полос боссов.
• Единый выбор ограничивающей рамки: рамки редактора охватывают все активные полосы боссов вместе как единый интерактивный элемент.

---

Интерактивный редактор перетаскивания (HudLayoutScreen)

Нажмите Right Shift (настраивается) в игре, чтобы запустить редактор макета HUD.

• Привязка к пиксельной сетке: выравнивайте виджеты по наложенной сетке для аккуратного позиционирования.
• Динамические направляющие выравнивания: голубые и фиолетовые линии привязки появляются динамически во время перемещения, чтобы выровнять элементы по центру экрана или соседним виджетам.
• Восьмиточечные маркеры масштабирования: захватите углы или середины сторон, чтобы масштабировать размеры X и Y независимо ($25% \text{--} 200%$).
• Относительное масштабирование экрана: сохраняет координаты как проценты относительно экрана (relativeX, relativeY), гарантируя, что ваш макет HUD останется центрированным на разных мониторах (1080p, 1440p, 4K) или масштабах GUI.
• Контекстное меню в редакторе: нажмите на иконку шестерёнки любого виджета, чтобы открыть стекломорфную всплывающую панель для настройки цветов, масштаба и переключателей конкретного модуля.

---

Техническая архитектура и эффективность производительности

ZEHU разработан специально для устранения микрозадержек и скачков кадров, характерных для тяжёлых HUD-модов.

1. Нулевые мусорные аллокации в цикле отрисовки

Стандартные HUD-моды создают новые объекты String, Component или Vector каждый кадр, вызывая частые паузы сборщика мусора Java (GC).

• Кэшированные форматированные последовательности: ZEHU кэширует строковые представления и примитивные целочисленные цвета.
• Примитивные буферы: вычисления для CPS, комбо и спидометра используют массивы примитивов фиксированного размера (long[] / float[]), чтобы предотвратить аллокации в куче во время отрисовки.

2. Сэмплирование временных окон на основе событий

Вместо непрерывного опроса списков сущностей или перебора инвентарей каждый тик:

• Клики и попадания: захватываются на нативных событиях ввода и хранятся в кольцевых буферах.
• Отслеживание предметов: количество в инвентаре оценивается только на событиях тика инвентаря, снижая нагрузку на CPU.

3. Точечные перехваты Mixin

ZEHU использует целевые SpongePowered Mixins (GuiMixin, BossHealthOverlayMixin) для перехвата ванильных процедур отрисовки GUI (extractEffects, extractCrosshair, extractRenderState):

• Когда модуль ZEHU включён, соответствующая ванильная процедура отрисовки отменяется на @At("HEAD").
• Это избегает накладных расходов на двойную отрисовку и предотвращает конфликты текстурных буферов.

4. Извлечение состояния GPU (GuiGraphicsExtractor)

Разработанный для Fabric 1.21.11, 26.1.x и 26.2, ZEHU использует современный конвейер Mojang GuiGraphicsExtractor (extractRenderState). Проходы отрисовки пакетируются напрямую в конвейеры GPU, избегая ненужных операций push матричного стека и разбиения вызовов отрисовки.

Конфигурация и установка

Требования

• Minecraft: 1.21.11, 26.1.x или 26.2.x
• Fabric Loader: >=0.19.0
• Fabric API

Файл конфигурации

Данные конфигурации автоматически сохраняются в:

.minecraft/config/zehu.json

Планы и будущие разработки

• [ ] Импорт / экспорт профилей HUD
• [ ] Графики времени кадра и CPS
• [ ] Точки маршрута и отслеживание маяков
• [ ] Пользовательские фоны-шейдеры
• [ ] Переключение спринта / приседания
• [ ] Переключение Fullbright
• [ ] Настраиваемый мод отображения F3
• [ ] Изменение частиц
• [ ] Часы
• [ ] HUD инвентаря
• [ ] Пользовательские шрифты и больше контроля над шрифтами HUD
• [ ] Ползунки прозрачности фона
• [ ] Циклы хромa-цветов
• И ещё куча модулей

Лицензия

Распространяется под лицензией LGPLv3. Создано Zapaxe.