BuffLedger

BuffLedger shows timed buffs and debuffs in a HUD with names and countdowns.

---

Overview

BuffLedger reads the server-side EffectControllerComponent and renders a small custom HUD with effect names and countdown timers. Tracking starts automatically when you join a world. The overlay only appears while at least one timed effect is active.

---

Installation

1. Download BuffLedger-0.1.0.jar from the CurseForge Files tab
2. Place the JAR in mods/ (global UserData/Mods or per-save mods/)
3. Join the world — tracking is on by default
4. Eat food or drink a potion to see the HUD
5. Run /buffs status to verify tracking and effect count

---

Quick start

1. Join a world (no /buffs on needed).
2. Gain a timed buff or debuff.
3. HUD appears bottom-left with lines like +HP Regen T3 4:32 or -Poison 12s.
4. When all timed effects end, the HUD hides automatically.
5. /buffs off opts out until /buffs on or delete opted_out.txt in mod data.

---

Commands

Command	Description
/buffs on	Re-enable tracking after opt-out
/buffs off	Stop tracking; persists opt-out
/buffs status	Tracking on/off, HUD visible, active effect count
/buffs list	Print active effects in chat (debug without HUD)

---

HUD behavior

Behavior	Detail
Auto-tracking	Enabled on PlayerReady unless opted out
Visibility	HUD only while EffectController has timed effects
Refresh	About once per second on the world thread
Position	Bottom-left above hotbar (Durkz_BuffLedger_Hud.ui)
Lines	Up to 7 effect lines plus header

---

Optional mod compatibility

No hard dependencies. BuffLedger uses the same vanilla effect pipeline as these mods.

MultipleHUD (Buuz135)

Topic	Detail
Purpose	Extra custom HUD slot when running multiple HUD mods
Required?	No
Limitation	Uses native addCustomHud when MultipleHUD is absent

Not Enough Potions (NEP)

Topic	Detail
Detection	Automatic via ApplyEffect + EntityEffect JSON
Labels	Readable names for NEP potions and Potion_Morph_*
Limitation	Morph potions run CleanseMorph first (clears all effects). HUD timers can stall or freeze during the gap before the new morph registers. Some dragon morphs may fail to apply — independent of BuffLedger

BuffStacks (BeyondSmash)

Topic	Detail
Detection	Same EffectController; stack count when multiple slots share one effect ID
Limitation	BuffStacks does not track morph effects. Duplicate status icons are from BuffStacks, not BuffLedger

MoreFood / SNIP3 FoodPack

Topic	Detail
Detection	Automatic — asset packs using vanilla ApplyEffect
Labels	Tier labels (Stamina T4, Fire Resist (Medium), etc.)

---

Known issues (0.1.0)

• Morph potion transitions (NEP CleanseMorph) can pause HUD countdowns
• /buffs list prints active effects in chat when the HUD layout looks wrong

---

Data files

Path	Purpose
mods/durkz_BuffLedger/opted_out.txt	Player UUIDs who used /buffs off

---

Recommended

• MultipleHUD if you run several HUD mods alongside BuffLedger.
• /buffs list prints active effects in chat when the HUD layout looks wrong.

---

Verifying it works

1. Join a world; /buffs status should show tracking on.
2. Eat food or drink a potion; HUD appears with countdown lines.
3. /buffs off hides tracking until /buffs on or delete opted_out.txt.

---

License

MIT License