Server documentation

BuffLedger

Active

Hytale • Version 0.1.0

Instalação, comandos, comportamento do HUD, compatibilidade opcional e limitações conhecidas.

O BuffLedger mostra buffs e debuffs com tempo restante num HUD com nomes e contagem regressiva.

Visão geral

O BuffLedger lê o EffectControllerComponent no servidor e renderiza um HUD customizado com nomes de efeitos e timers de contagem regressiva. O rastreio começa automaticamente ao entrar no mundo. O overlay só aparece enquanto houver pelo menos um efeito com duração.

Instalação

Baixe BuffLedger-0.1.0.jar na aba Files do CurseForge
Coloque o JAR em mods/ (UserData/Mods global ou mods/ do save)
Entre no mundo — rastreio ligado por padrão
Coma ou beba uma poção para ver o HUD
Use /buffs status para verificar rastreio e quantidade de efeitos

Início rápido

Entre no mundo (sem precisar de /buffs on).
Ganhe um buff ou debuff com duração.
O HUD aparece no canto inferior esquerdo com linhas como +HP Regen T3 4:32 ou -Poison 12s.
Quando todos os efeitos temporários acabarem, o HUD some.
/buffs off desativa até /buffs on ou apagar opted_out.txt nos dados do mod.

Comandos

Comando	Descrição
`/buffs on`	Reativa o rastreio após opt-out
`/buffs off`	Para o rastreio; opt-out persiste
`/buffs status`	Rastreio ligado/desligado, HUD visível, contagem de efeitos
`/buffs list`	Lista efeitos ativos no chat (debug sem HUD)

Comportamento do HUD

Comportamento	Detalhe
Auto-rastreio	Ligado em `PlayerReady` salvo opt-out
Visibilidade	HUD só enquanto `EffectController` tiver efeitos com tempo
Atualização	Cerca de 1x por segundo na thread do mundo
Posição	Inferior esquerdo acima da hotbar (`Durkz_BuffLedger_Hud.ui`)
Linhas	Até 7 linhas de efeito mais cabeçalho

Compatibilidade opcional

Sem dependências obrigatórias. O BuffLedger usa o mesmo pipeline vanilla de efeitos que estes mods.

MultipleHUD (Buuz135)

Tópico	Detalhe
Propósito	Slot extra de HUD custom quando há vários mods HUD
Obrigatório?	Não
Limitação	Usa `addCustomHud` nativo quando MultipleHUD está ausente

Not Enough Potions (NEP)

Tópico	Detalhe
Detecção	Automática via `ApplyEffect` + JSON `EntityEffect`
Labels	Nomes legíveis para poções NEP e `Potion_Morph_*`
Limitação	Poções morph rodam `CleanseMorph` primeiro (limpa todos os efeitos). Timers do HUD podem travar ou congelar no intervalo antes do novo morph registrar. Alguns morphs de dragão podem falhar — independente do BuffLedger

BuffStacks (BeyondSmash)

Tópico	Detalhe
Detecção	Mesmo `EffectController`; contagem de stacks quando vários slots compartilham um effect ID
Limitação	BuffStacks não rastreia efeitos morph. Ícones duplicados vêm do BuffStacks, não do BuffLedger

MoreFood / SNIP3 FoodPack

Tópico	Detalhe
Detecção	Automática — asset packs que usam `ApplyEffect` vanilla
Labels	Tiers (`Stamina T4`, `Fire Resist (Medium)`, etc.)

Problemas conhecidos (0.1.0)

Transições de poção morph (NEP CleanseMorph) podem pausar a contagem regressiva do HUD
/buffs list lista efeitos ativos no chat quando o layout do HUD estiver errado

Arquivos de dados

Caminho	Propósito
`mods/durkz_BuffLedger/opted_out.txt`	UUIDs de jogadores que usaram `/buffs off`

Licença

MIT License