Team Status HUD

TeamStatus

Следи за состоянием товарищей по команде с одного взгляда — здоровье, голод, броня, эффекты, предметы в руках и живые действия на едином компактном HUD. Работает на любой дистанции и между измерениями.

Features / 功能

Team status HUD / 队伍状态 HUD

• Каждый игрок в сети получает панель: лицо игрока, имя, сердца здоровья, окорочка голода, полоса брони, активные эффекты состояния (с оставшимся временем) и предмет в основной руке.
• Никакой системы групп/команд не требуется — по умолчанию показываются все игроки в сети. HUD работает в одиночной игре, на выделенных серверах и между измерениями.
• Анимация сердец/еды в точности повторяет ванильное поведение: половинки сердец, ряды поглощения над полосой здоровья, типы сердец отравления / иссушения / заморозки, текстуры хардкора, мигание при уроне и лечении, а также тряска при низком здоровье.
• Имена мёртвых игроков становятся красными; текст имени автоматически обрезается, если он слишком длинный.

Live action animations / 实时动作动画

• Mining — настоящий 3D-изометрический блок отрисовывается с ванильным оверлеем трещин разрушения (все 10 стадий проецируются на каждую грань). Инструмент в руке рубит с ванильной скоростью руки, автоматически ускоряясь при Haste и замедляясь при Mining Fatigue. Осколки летят по мере роста трещин, а при разрушении блока происходит взрыв осколков.
• Attacking — одиночный замах удара проигрывается в момент, когда товарищ по команде наносит удар. Жертва отображается как лицо игрока или реальная модель головы моба (с запасным вариантом в виде яйца призыва), покрытая красной вспышкой удара.
• Eating / drinking — под предметом рисуется полоса прогресса использования вместе с покачиванием при жевании, наклоном «поднесения ко рту» и частицами крошек еды / капель напитка.

Your own panel / 自己的面板

• Собственный статус синтезируется локально из сущности клиентского игрока: нулевая сетевая задержка и нулевой трафик, связанный с собой. Он закреплён внизу стопки панелей и также отображается в одиночной игре.

Per-player hide list / 按玩家隐藏

Каждый игрок может выполнить /teamstatus (уровень разрешений 0), чтобы в одностороннем порядке скрыть или показать других людей на своём HUD. Выбор хранится по UUID и сохраняется вместе с миром:

Configuration / 配置

All options are client-side. You can change them in-game via Mods → TeamStatus → Config, or edit config/teamstatus-client.toml. 可在游戏内通过 Mods（模组）→ TeamStatus → Config（配置） 修改，或编辑 config/teamstatus-client.toml。

Performance / 性能

• Ленивая синхронизация по событиям. Сервер помечает игроков как изменённых при уроне, лечении, смерти, возрождении, входе в игру и смене экипировки, а состояние читает один раз в конце тика. Снимок отправляется только тогда, когда то, что видит получатель, действительно меняется, плюс принудительный heartbeat каждые 10 секунд.
• Квантование под разрешение отображения. Голод опрашивается с частотой 4 Гц; насыщение, истощение и длительности эффектов округляются до того, что HUD способен показать, перед сравнением, поэтому субпиксельные изменения не могут зафиксировать частоту отправки. Трафик обратного отсчёта эффектов снижается максимум до 1 Гц на каждый активный эффект.
• Пакеты действий только по событиям. Сигналы добычи, атаки и еды несут по одному пакету на каждое дискретное игровое событие и доставляются только игрокам, которые в данный момент видят действующего — бездействие вообще не генерирует трафик.

• Стабильные кадры на клиенте без аллокаций. Списки дескрипторов для каждой панели кэшируются и перестраиваются не чаще одного раза за тик GUI; покадровая анимация — чистая математика и прямые отрисовки. Панель себя никогда не обращается к сети.

• Мод регистрирует ровно один слой HUD, не использует миксины и не сканирует мир — сервер читает данные игрока напрямую, а не перебирает клиентские сущности.

Требования

• Minecraft: Java Edition 1.21.1
• NeoForge 21.1.150 или новее (для Minecraft 1.21.1)
• Java 21
• Необязательно: AppleSkin 2.5+ для отображения насыщения и полосы истощения; без него HUD работает полностью.

Установка

1. Запустите установщик NeoForge для Minecraft 1.21.1 на клиенте и/или сервере.

2. Поместите JAR мода (`teamstatus-.jar) в папку mods`:

   • Клиент: .minecraft/mods/
   • Выделенный сервер: `/mods/` Создайте папку, если её нет.
3. Для мультиплеера установите мод и на сервер, и на каждый клиент. Для одиночной игры достаточно установки на клиент.
4. (Необязательно) Положите AppleSkin в ту же папку mods, чтобы включить отрисовку насыщения / истощения.
5. Запустите игру.

Сборка из исходников

Требования: JDK 21. Gradle Wrapper автоматически скачивает Gradle, NeoForge и маппинги — отдельная установка Gradle не нужна.

# Сборка JAR (Windows: используйте gradlew.bat)
./gradlew build

# Результат:
# build/libs/teamstatus-<version>.jar

# Конфигурации запуска для разработки
./gradlew runClient      # запустить dev-клиент
./gradlew runServer      # запустить dev-сервер
./gradlew runData        # запустить генераторы данных

Каждый push и pull request также автоматически собирается рабочим процессом GitHub Actions в .github/workflows/build.yml.

Лицензия

TeamStatus распространяется под GNU General Public License v3.0 or later. Полный текст см. в файле LICENSE.