Server documentation

BuffLedger

Active

Hytale • Version 0.1.0

Установка, команды, поведение HUD, опциональная совместимость и известные ограничения.

BuffLedger показывает баффы и дебаффы с оставшимся временем в HUD с названиями и обратным отсчётом.

Обзор

BuffLedger читает серверный EffectControllerComponent и рисует небольшой кастомный HUD с названиями эффектов и обратным отсчётом. Отслеживание включается автоматически при входе в мир. Оверлей виден только пока активен хотя бы один эффект с длительностью.

Установка

Скачайте BuffLedger-0.1.0.jar на вкладке Files CurseForge
Положите JAR в mods/ (глобально UserData/Mods или mods/ сейва)
Войдите в мир — отслеживание включено по умолчанию
Съешьте еду или выпейте зелье, чтобы увидеть HUD
Выполните /buffs status для проверки отслеживания и числа эффектов

Быстрый старт

Войдите в мир (без /buffs on).
Получите бафф или дебафф с длительностью.
HUD появляется внизу слева со строками вроде +HP Regen T3 4:32 или -Poison 12s.
Когда все временные эффекты закончатся, HUD скрывается.
/buffs off отключает до /buffs on или удаления opted_out.txt в данных мода.

Команды

Команда	Описание
`/buffs on`	Снова включить отслеживание после opt-out
`/buffs off`	Остановить отслеживание; opt-out сохраняется
`/buffs status`	Отслеживание вкл/выкл, видимость HUD, число эффектов
`/buffs list`	Список активных эффектов в чате (отладка без HUD)

Поведение HUD

Поведение	Детали
Автоотслеживание	Включается на `PlayerReady`, если не opt-out
Видимость	HUD только пока в `EffectController` есть эффекты с временем
Обновление	Примерно раз в секунду в потоке мира
Позиция	Внизу слева над хотбаром (`Durkz_BuffLedger_Hud.ui`)
Строки	До 7 строк эффектов плюс заголовок

Опциональная совместимость

Жёстких зависимостей нет. BuffLedger использует тот же ванильный pipeline эффектов, что и эти моды.

MultipleHUD (Buuz135)

Тема	Детали
Назначение	Дополнительный слот custom HUD при нескольких HUD-модах
Обязателен?	Нет
Ограничение	Использует нативный `addCustomHud` без MultipleHUD

Not Enough Potions (NEP)

Тема	Детали
Обнаружение	Автоматически через `ApplyEffect` + JSON `EntityEffect`
Подписи	Читаемые имена для зелий NEP и `Potion_Morph_*`
Ограничение	Зелья morph сначала запускают `CleanseMorph` (сбрасывает все эффекты). Таймеры HUD могут замирать до регистрации нового morph. Некоторые dragon morph могут не примениться — независимо от BuffLedger

BuffStacks (BeyondSmash)

Тема	Детали
Обнаружение	Тот же `EffectController`; счёт стаков при одном effect ID в нескольких слотах
Ограничение	BuffStacks не отслеживает morph-эффекты. Дубли иконок — от BuffStacks, не от BuffLedger

MoreFood / SNIP3 FoodPack

Тема	Детали
Обнаружение	Автоматически — asset packs с ванильным `ApplyEffect`
Подписи	Тиры (`Stamina T4`, `Fire Resist (Medium)` и т.д.)

Известные проблемы (0.1.0)

Переходы morph-зелий (NEP CleanseMorph) могут приостанавливать обратный отсчёт HUD
/buffs list выводит активные эффекты в чат, если layout HUD выглядит неправильно

Файлы данных

Путь	Назначение
`mods/durkz_BuffLedger/opted_out.txt`	UUID игроков, использовавших `/buffs off`

Лицензия

MIT License