Server documentation

BuffLedger

Active

Hytale • Version 0.1.0

Instalación, comandos, comportamiento del HUD, compatibilidad opcional y limitaciones conocidas.

BuffLedger muestra buffs y debuffs con tiempo restante en un HUD con nombres y cuenta atrás.

Resumen

BuffLedger lee el EffectControllerComponent del servidor y renderiza un HUD personalizado con nombres de efectos y temporizadores de cuenta atrás. El seguimiento empieza automáticamente al entrar al mundo. El overlay solo aparece mientras haya al menos un efecto con duración.

Instalación

Descarga BuffLedger-0.1.0.jar en la pestaña Files de CurseForge
Coloca el JAR en mods/ (UserData/Mods global o mods/ del save)
Entra al mundo — seguimiento activo por defecto
Come o bebe una poción para ver el HUD
Usa /buffs status para verificar seguimiento y cantidad de efectos

Inicio rápido

Entra al mundo (no hace falta /buffs on).
Obtén un buff o debuff con duración.
El HUD aparece abajo a la izquierda con líneas como +HP Regen T3 4:32 o -Poison 12s.
Cuando todos los efectos temporales terminen, el HUD se oculta.
/buffs off desactiva hasta /buffs on o borrar opted_out.txt en los datos del mod.

Comandos

Comando	Descripción
`/buffs on`	Reactiva el seguimiento tras opt-out
`/buffs off`	Detiene el seguimiento; opt-out persistente
`/buffs status`	Seguimiento on/off, HUD visible, cantidad de efectos
`/buffs list`	Lista efectos activos en el chat (debug sin HUD)

Comportamiento del HUD

Comportamiento	Detalle
Auto-seguimiento	Activado en `PlayerReady` salvo opt-out
Visibilidad	HUD solo mientras `EffectController` tenga efectos con tiempo
Actualización	Aprox. 1 vez por segundo en el hilo del mundo
Posición	Abajo a la izquierda sobre la hotbar (`Durkz_BuffLedger_Hud.ui`)
Líneas	Hasta 7 líneas de efecto más cabecera

Compatibilidad opcional

Sin dependencias obligatorias. BuffLedger usa el mismo pipeline vanilla de efectos que estos mods.

MultipleHUD (Buuz135)

Tema	Detalle
Propósito	Slot extra de HUD custom con varios mods HUD
¿Obligatorio?	No
Limitación	Usa `addCustomHud` nativo si MultipleHUD está ausente

Not Enough Potions (NEP)

Tema	Detalle
Detección	Automática vía `ApplyEffect` + JSON `EntityEffect`
Etiquetas	Nombres legibles para pociones NEP y `Potion_Morph_*`
Limitación	Las pociones morph ejecutan `CleanseMorph` primero (limpia todos los efectos). Los timers del HUD pueden detenerse o congelarse antes de que registre el nuevo morph. Algunos morphs de dragón pueden fallar — independiente de BuffLedger

BuffStacks (BeyondSmash)

Tema	Detalle
Detección	Mismo `EffectController`; cuenta stacks cuando varios slots comparten un effect ID
Limitación	BuffStacks no rastrea efectos morph. Iconos duplicados vienen de BuffStacks, no de BuffLedger

MoreFood / SNIP3 FoodPack

Tema	Detalle
Detección	Automática — asset packs que usan `ApplyEffect` vanilla
Etiquetas	Tiers (`Stamina T4`, `Fire Resist (Medium)`, etc.)

Problemas conocidos (0.1.0)

Las transiciones de poción morph (NEP CleanseMorph) pueden pausar la cuenta atrás del HUD
/buffs list lista efectos activos en el chat si el layout del HUD falla

Archivos de datos

Ruta	Propósito
`mods/durkz_BuffLedger/opted_out.txt`	UUIDs de jugadores que usaron `/buffs off`

Licencia

MIT License