Systems
Boss Status Effect HUD
A column of icons on the player's screen showing boss debuffs on the player (blind, disarm, curse stacks, soul chain, ash floor...) and incoming boss ability warnings (ground slam wind-up, enrage timer, execute...). Boss behaviours register entries on the server; the server broadcasts them every 0.5 s while they are active, and the client draws up to 4 rows. There is no list of effects to enable - a pack configures only how an entry looks and is named.
Behaviours that apply debuffs and their fields (hudIcon, hudColor, debuffNameKey) are described in Boss Defense and Boss Utility.
Icons
By default an entry is a coloured circle with a single character (the behaviour's hudIcon, for example a ◐ for blind) and a ring that drains with the remaining time. Two ways to use a picture instead:
hudIconas a texture path - any value that contains both:and/is treated as an image asset, for example"hudIcon": "albase:textures/gui/bossdebuffs/guardianward.webp".config/bossdebufficons.json- maps an ability code to an image. Loaded on the client from every mod domain, later files override earlier keys.
{
"duat-rune-cooldown": "albase:textures/gui/bossdebuffs/duat-rune-cooldown.webp",
"guardianward": "albase:textures/gui/bossdebuffs/guardianward.webp"
}The key is the entry's ability code (the code the behaviour registered, such as bossdebuff:blind, bosssoulchain, guardianward, secondchance). Image entries have no background circle or ring; the remaining seconds are printed in the top-left corner instead.
Names and descriptions
The HUD name and the tooltip text are looked up by lang keys. For an entry with a key in its display name (the behaviour's debuffNameKey, if that key exists in the lang file):
<debuffNameKey>-namethen<debuffNameKey>for the name.<debuffNameKey>-descfor the description.
Otherwise the ability code is turned into a slug (for example bossgroundslam becomes ground-slam, bossdebuff:blind becomes blind) and the HUD tries, in order:
<prefix>-<slug>-name/<prefix>-<slug>-desc, where the prefix is the pack'sdebuffNamePrefix(below),alegacyvsquest:bossdebuff-<slug>-name/-desc(framework entries),- a readable fallback built from the slug ("Ground Slam", "Ground Slam effect").
If debuffNameKey is empty or its key is missing from the lang file, the behaviour falls back to <prefix>-<slug> for the name key, so packs only have to add albase:bossdebuff-ground-slam-name (and -desc) rather than set a key on every boss. Extra tooltip lines use <prefix>-stacks-template, <prefix>-remaining-template and <prefix>-fading-out.
Pack setting: debuffNamePrefix
Set once per pack in config/gui/combat.json (the file is picked up when the path contains combat). Without it the prefix is alegacyvsquest:boss-debuff.
{ "debuffNamePrefix": "albase:bossdebuff" }The same file carries two sounds for combat screens:
| Field | Description |
|---|---|
debuffNamePrefix | Lang prefix for boss debuff names (see above) |
challengeFailedSound | Sound played when an encounter challenge is failed |
bossDefeatedSound | Sound played when the boss-defeated overlay appears |
deathRecapTierLabel, deathRecapTierLabelFallback | Lang key / fallback for the word before the tier in the death recap title ("Tier II") |
Death recap texts come from config/combat/death-recap.json (Encounter HUD), not from combat.json.
Server side notes
- When a player joins, leftover debuff stat modifiers are cleared if
BossCombat.ClearStuckDebuffsOnJoinis on (defaulttruein the framework config)./avq fixplayerdoes the same on demand (Commands). - An entry that reappears while the old one is still active takes the longest remaining time; entries fade out for one second after expiry.
- Entries are removed on the player's death and when they leave.