Boss Systems
Encounters
The Encounter Engine runs every scripted fight in the framework from data: wave-based arena fights (Duat gates), rotating world bosses (Ossuary, tutorial) and tiered summon bosses (Hollow Trials, the lunar bosses of Zenith). One definition file per encounter, in config/encounters/*.json of any mod or quest pack, is enough; the shared code provides spawning, rotation, scaling, challenges, rewards, HUD, trackers and persistence. The old boss-hunt system no longer exists — its bosses are now plain encounters.
graph TD
Def["config/encounters/x.json"] --> Engine[Encounter engine]
Block["Control block (activationBlock)"] -->|mode| Engine
Engine -->|difficulties / endlessPool| Waves["Wave encounter
(instanced altar, runner)"]
Engine -->|mode.spawnMode: proximity| Prox["Rotating world boss"]
Engine -->|mode.spawnMode: summon| Summon["Tiered summon boss
(ritual at an altar)"]
Engine --> Quests["Quests, trackers, shops, rewards"]| Flavour | How it is defined | Control block mode | Real examples |
|---|---|---|---|
| Wave encounter | difficulties (fixed waves) or endlessPool (procedural waves); optional tiny mode with only arenaAnchor | instanced | albase duat-gate, scarab-swarm, funeral-procession, duat-retribution |
| Rotating boss | mode with spawnMode: "proximity" and bosses[] | ambient | albase ossuary |
| Tiered summon boss | mode with spawnMode: "summon", bosses[].tierSet, summonRitualConfig | ambient | albase hollowtrials, alzenith selenarch, moon-spinner, moon-craterguard |
An encounter is valid only if it has encounterId, activationBlock and either a valid mode (at least one boss or an enabled arenaAnchor), endlessPool, or at least one valid difficulty (with waves with unique IDs).
Related files
| Path | Purpose |
|---|---|
config/encounters/*.json | Encounter definitions |
config/encounters/fxstyles/*.json | Altar particle / sound styles (below) |
config/encounterbosspools/*.json | Reusable boss pools for waves (below) |
config/challenges/*.json | Challenge definitions (below) |
config/modifiers/*.json | Rotating modifier pools, see Modifiers |
config/progression/pity.json, progressive.json | Case pity and progressive-difficulty definitions |
config/gui/hud-themes.json | Named HUD themes |
config/chatnotify*.json | Chat announcement categories (Chat Announcement Filter) |
Top-level fields
{
"encounterId": "albase:encounter:ossuary",
"nameKey": "albase:encounter-ossuary-name",
"descKey": "albase:encounter-ossuary-desc",
"activationBlock": "albase:ossuary-control",
"mode": { },
"spawnAnimation": { },
"dropAnimation": { },
"messages": { },
"hologram": { },
"tracker": { },
"hud": { },
"infoTab": { },
"lootTable": { },
"backfill": { }
}| Field | Default | Description |
|---|---|---|
encounterId | — | Stable ID used by commands, quests, blocks and persistence |
nameKey / descKey | — | Localization keys of the name and description |
tierNameKeys | — | { "1": key, ... } per-tier names (hologram uses the tier name when present) |
activationBlock | — | Code of the control block for this encounter (required) |
localizationPrefix | "" | Prefix for hologram / HUD keys (the mode value wins) |
modeSymbol | — | Symbol id on the mode selector card in the altar GUI (gate, scarab, procession, ...) |
activationRange | 8 | Range in blocks around the block for player detection (wave encounters) |
zoneRadius | 40 | Encounter zone radius; leaving it starts the failure grace |
allowInteractionInAnyLand | false | Allow using the control block inside someone else's land claim |
spawnRadius / spawnMinDistance | 0 / 3 | When spawnRadius > 0 all mobs and bosses spawn within that horizontal distance of the anchor, no closer than spawnMinDistance |
runeCooldownReduction | 0 | 0-1 shorter rune ability cooldowns for players in the arena (a difficulty can override) |
maxConcurrentPlayers | 4 | Participant limit |
cooldownMinutes | 10 | Cooldown after an encounter ends, success or failure |
abandonTimeoutMinutes | 30 | Real minutes an active run may stay with all participants offline before it fails; 0 disables |
preparationSeconds | 0 | Preparation phase before the first wave |
maxMobsPerWave | 0 | Cap on mobs per wave (0 = none); scaling is applied first, then capped proportionally |
spawnBatchSize | 1 | Mobs per spawn callback (larger = fewer events, same total time) |
mobSpawnSound | — | Sound when a mob spawns |
mobKillRewardItem / mobKillRewardAmount | — / 0 | Item given to the killer of each non-boss mob; a difficulty's mobKillRewardMult scales it |
ambientMusicKey | — | Music key played by the altar while the encounter is selected and idle (a difficulty can override) |
arenaGroup | — | Encounters with the same ID share one arena; only one runs at a time |
arenaRestore | — | { "radius": 45, "below": 8, "above": 30 } — terrain and plain blocks around the anchor are snapshotted at start and restored at the end (block entities are not) |
achievementEventType | trialkill | Event fired for achievements on boss kills; use bosskill or any custom name |
difficulties / endlessPool | — | Wave content (below) |
mode | — | Boss rotation / summon config (below) |
respawn, failureConditions, questHooks, playerScaling, groupScaling, leash, zone, storm, environment, startEffects | — | Run rules and atmosphere (below) |
waveEffectTemplates, spawnPresets | — | Named reusable wave effects and mob spawn patterns |
hud, hologram, infoTab, messages, tracker, spawnAnimation, dropAnimation, summonRitualConfig | — | Presentation and helpers (below) |
lootTable, backfill, scoring, checkpoints, spectator, affixPool, bossPhases, bossEnrage, bossAdds | — | Rewards and extra systems (below) |
Wave encounters
A wave encounter is started from an altar block: the player picks one of the encounter's difficulties (or the endless mode), an optional preparation countdown runs, the waves play one after another, and the run ends in success, failure (rules below) and then a cooldown. Admins can also run one with /avq encounter start.
difficulties
difficulties is a map difficultyId -> definition. Real example: albase/config/encounters/duat-gate.json (sand, flame, curse).
| Field | Default | Description |
|---|---|---|
difficultyId, nameKey, descKey, symbol | — | Identity and the card shown in the GUI |
waveCount | — | Number shown in the GUI (the waves list is authoritative) |
timeLimitMinutes | 0 | Time limit; 0 = none |
tier | 1 | Difficulty tier (1-3), passed to spawned bosses to unlock tiered mechanics |
healthMult / damageMult | 1 | Stat multipliers for all mobs |
bossHealthMult / bossDamageMult | 1 | For boss and mini-boss spawns |
miniBossHealthMult / miniBossDamageMult | 1 | For mini-bosses only |
damageTierBonus | 0 | Raises the damage tier of mob and boss attacks |
abilityDamageMult, abilityCooldownMult, summonLimitMult, enrageDamageMult, enrageSpeedMult | -1 | Boss ability tuning (-1 = engine default) |
modifiers | — | Modifier IDs active during this difficulty (for example nofood, nopotions) |
waves | — | Ordered waves (at least one, unique waveId) |
rewards | — | { itemRewards: [{ itemCode, amount }], randomItemRewards: { selectAmount, items[] }, actionRewards: [{ id, args }] } given on success |
runeCooldownReduction | -1 | Overrides the encounter value |
ambientMusicKey, fogColor, maxFogDensity | — | Per-difficulty music and storm fog overrides |
mobKillRewardMult | 1 | Scales mobKillRewardAmount |
waves
{
"waveId": "sand-6-boss",
"delayBeforeWaveMs": 3000,
"delayBetweenSpawnsMs": 300,
"mobs": [ { "entityCode": "albase:sand-scarab", "count": 1, "spawnPattern": "surround", "minDistance": 3, "maxDistance": 12 } ],
"bossPoolRef": "albase:duat-gate-boss",
"waveEffects": { "sound": "albase:sounds/duat/boss-wave-start", "particleType": "explosion", "particleIntensity": 2 }
}| Field | Default | Description |
|---|---|---|
waveId | — | Unique within the difficulty |
mobs[] | — | Entries: entityCode, count (1), spawnPattern (surround, cluster, swarm, line, random; default surround), minDistance (5), maxDistance (20), spawnPreset, ignoreForWaveClear, despawnOnWaveClear |
boss | — | Boss entry: entityCode (or entityTag to pick one at random from all entities with that tag), bossKey, healthMult, damageMult, damageTierBonus, tier (0 = difficulty tier), enrageTimerSeconds, paired + pairedCount (twin bosses with a shared health pool), phases[] (healthPercent + action = spawnAdds / enrage / heal, adds) |
secondaryBoss, linkedHealth | — / false | A second boss; linkedHealth makes damage to either reduce both |
bossPool, bossPoolRef (and secondaryBossPool / secondaryBossPoolRef) | — | One entry is picked at random at spawn time; bossPoolRef points to a boss pool |
isMiniboss | false | Treat the boss as a mini-boss |
clearCondition | allKilled | When the wave counts as cleared; killCount clears after killCount non-ignored mobs died |
delayBetweenSpawnsMs / delayBeforeWaveMs | 500 / 2000 | Timing |
waveEffects, waveEffectTemplate | — | Effects played when the wave starts (start effects); the template name refers to waveEffectTemplates |
spawnPresets is a map name -> { spawnPattern, minDistance, maxDistance }; a mob (or endless entry) with spawnPreset takes those values for the fields it left at the default.
endlessPool
Procedural waves instead of fixed ones (funeral-procession.json).
| Field | Default | Description |
|---|---|---|
mobs[] | — | entityCode, weight (1), minWave (1), spawnPattern, minDistance, maxDistance, spawnPreset, ignoreForWaveClear, despawnOnWaveClear (at least one required) |
miniBosses[] / bosses[] | — | entityCode, everyNWave (5), alternate |
scaling | required | healthMultPerWave (0.08), damageMultPerWave (0.05), countBonusPerWave (0.5), maxMobsPerWave (30), boss / mini-boss per-wave variants (-1 = same as mobs), tierBonusAfterWave + tierBonusAmount (1) |
healthMult, damageMult, bossHealthMult, bossDamageMult, miniBossHealthMult, miniBossDamageMult | 1 (boss values -1 = defaults 1.0 / 0.5 / 0.8) | Base multipliers |
abilityDamageMult, abilityCooldownMult, summonLimitMult, enrageDamageMult, enrageSpeedMult | -1 | Boss tuning |
difficulties | — | Map of variants (for example hardcore) with healthMultScale, damageMultScale, countBonusScale, maxMobsBonus, damageTierBonus, direct boss multipliers, rewards, runeCooldownReduction, mobKillRewardMult |
baseDifficultyNameKey, baseDifficultyDescKey, baseDifficultySymbol | — | Card of the base endless run |
waveEffects, waveEffectTemplate | — | Effects at the start of each wave |
rewards | — | Rewards of the base endless run |
Boss pools
config/encounterbosspools/*.json: { "pools": [ { "code": "albase:duat-gate-boss", "entries": [WaveBossEntry...], "subPools": ["other:pool"] } ] } (single-pool files also work). subPools are flattened into the pool; circular references are detected. A wave's bossPoolRef must resolve to a non-empty pool.
Run rules
| Field | Defaults | Description |
|---|---|---|
respawn | mode: "anchor", respawnAtBlock: true, respawnRadius: 5, clearBindingOnEnd: true, preserveDietOnDeath: true | Where and how participants respawn |
failureConditions | allPlayersDead: true, allPlayersDiedOnce: false, timeLimit: true, zoneLeaveGraceSeconds: 30, noDeathTimeoutSeconds: 0, allPlayersDeadOfflineGraceSeconds: 60 | When the run is aborted |
questHooks | — | Action strings (or raw quest IDs, force-completed) run on onStart, onWaveStart, onComplete, onFail, plus onWaveReached: [{ "wave": 3, "actions": [...] }] (1-based) |
playerScaling | countBonusPerPlayer 0.3, maxCountMult 2, normalHealthBonusPerPlayer 0.2 / ...ThresholdPlayers 1 / normalMaxHealthMult 1.8, minibossHealthBonusPerPlayer 0.5 / 1 / 3, bossHealthBonusPerPlayer 1 / 1 / 4, additiveHealthScaling false | Mob count and health scaling by participant count; additive mode adds the bonus to the difficulty multiplier instead of multiplying |
groupScaling | countBonusPerPlayer 0.3, maxCountMult 2, healthBonusPerPlayer 0.2, healthThresholdPlayers 1, maxHealthMult 1.8, damageBonusPerPlayer 0.1, damageThresholdPlayers 2, maxDamageMult 1.5, boss health values, useGearLevelScaling, gearLevelThreshold, gearLevelHealthBonus 0.05 | Scaling used by boss (ambient) encounters, with optional damage and gear-level scaling |
leash | enabled: true, leashRange: 30, outOfCombatLeashRange: 0, damageGraceSeconds: 8, noKillRecallSeconds: 0, recallMoveSpeed: 0.06, recallStopDistance: 5, recallStuckTeleportSeconds: 5, recallTarget: "anchor" | Pulls wandering mobs back to the anchor |
zone | shape: "circle" (or box), radius: 40, height: 0, blockNonParticipants: false, pushForce: 1, nonParticipantDamagePerSec, leaveDamagePerSec, leaveGraceSeconds: 5, enterMessageKey, leaveMessageKey, boundaryWarningKey | Enforced dynamic zone around the anchor |
storm | See Storm | Progressive storm |
environment | fogDensity, fogColor (grey), darkness, rainIntensity, overrideWeather + weatherPatternCode + restoreWeatherOnEnd (true), ambientSound + ambientSoundVolume (0.5) + ambientSoundRange (48), particleType, particleColor, particleCount (5), particleRadius (30), particleHeight (20), particleIntensity/particleIntervalMs (500) | Fog, darkness, rain, sounds and particles during the run |
Storm
storm builds a storm that intensifies as waves advance (boss waves boost it): baseParticleCount 5, maxParticleCount 30, stormRadius 30, stormHeight 20, ambientSound, maxSoundVolume 0.6, soundRange 48, maxFogDensity 0.8, baseStormIntensity 0.2, endlessRampWaves 10, maxDarkness 0.5, fogColor (sandy RGB 0-1), maxScreenShake 2, screenShakeDurationSeconds 1, overrideWeather true, weatherPatternCode, windPatternCode, restoreWeatherOnEnd true.
Start effects
startEffects (and waveEffects / templates) play when the encounter or a wave starts. All optional: sound, soundVolume (32), soundPitch (1), particleType (shockwave, auraRing, spiral, explosion, embers), particleColor (packed ARGB int; 0 = default), particleRadius (3), particleHeight (4), particleIntensity (1), delayMs, screenShake (0-1), screenShakeDurationSeconds (1), chatMessageKey. A wave effect that sets only some fields inherits the rest from its waveEffectTemplate.
Boss encounters (mode)
The mode object turns an encounter into a boss encounter: bosses rotate (proximity) or are summoned by a ritual (summon). The control block must use mode: "ambient"; a wave encounter that only needs arena respawns uses mode: { "watchedAttributePrefix": ..., "arenaAnchor": { "enabled": true, ... } }.
mode fields
| Field | Default | Description |
|---|---|---|
spawnMode | proximity | proximity: the active boss of the rotation spawns at an anchor (the control block) when players come near. summon: players start a ritual at the block and the boss is summoned |
bosses[] | — | The boss entries (at least one unless an arena anchor is enabled) |
activeBossCount | 1 | How many bosses are active in the rotation |
rotationDays | 7 | In-game days between rotations of the active boss |
rerollOnRotation | true | Summon mode: re-roll an altar's assigned boss when the rotation advances (a living summoned boss keeps its assignment) |
respawnInGameHours | 24 | Respawn delay after a boss dies (a boss entry can override) |
activationRange | 160 | Player detection range in blocks |
softResetIdleHours / softResetAntiSpamHours | 1 / 0.25 | Hours idle without combat before the fight soft-resets (despawn); minimum gap between resets |
relocateIntervalHours | 0 | Relocate the boss to another anchor every N hours (0 = never) |
noRelocateAfterDamageMinutes / rotationPostponeAfterDamageHours | 10 / 0.25 | Postpone relocation / rotation after the boss was hit |
anchorCooldownDays / anchorCooldownDaysPerTier | 1 / — | Cooldown per anchor between summons |
modifierIntervalDays | 0 | Real rotation of the encounter modifier in in-game days (0 = rolled once at start) |
watchedAttributePrefix | alegacyvsquest:ambient | Prefix of the attributes written on spawned entities |
localizationPrefix | "" | Prefix for notification / UI keys |
resetCooldownOnServerRestart | false | Clear saved respawn cooldowns on server restart |
showFailureReasons | true | Show per-challenge failure reasons in the HUD |
soloDamageSharePercent | 100 | Minimum share of the boss damage a player must deal for solo credit; soloViolationLangKey is the warning text |
legacyReputationKey | "" | One-time migration from an older reputation key |
arenaAnchor | disabled | Arena respawn settings, below |
arenaEnabled, keepInventory | false, true | Use the respawn registry for arena binding; keep inventory on death |
rolledChallengeCount / rolledChallengeCountPerTier | 3 / — | Number of challenges rolled when a quest is accepted |
baseRewards, challengeRewards, reputationRewards | — | Maps tier -> amount: currency for the kill, for each completed challenge, and reputation for the kill (tier 1 is the fallback; defaults 20 / 12) |
ranks | — | [{ nameKey, requiredReputation }] rank ladder; the tier-th rank's threshold opens tier N |
tierRequiredReputation | — | Map tier -> reputation that overrides the ranks for opening tiers 2 and 3 |
progression | — | Economy block, below |
deathEffectEnabled, deathEffectType (themed, void, shadow, or a custom type such as lunar), deathEffectRadius (3), deathDespawnDelayMs (2000), deathEffectSound | false | Themed burst and corpse despawn after a boss dies |
summonCompleteSound, summonCompleteSoundTier2Plus, summonCompleteSoundRange | translocate / lightning / 48 | Sounds when a summon finishes |
bossRegenGraceMs | 0 | Out-of-combat regeneration grace in ms |
arenaAnchor
enabled (false), keepInventory (false), yOffset (1), respawnRadius (5), arenaRadius (-1 = use respawnRadius), spawnDelayMs (500), pvpDisabled (false), preserveDiet (true). Players who die near the anchor respawn at the rift.
progression
Economy of tiered encounters: currencyKey, reputationKey, npcReputationKey (the reputation id), pityDefinitionPrefix, progressiveDefinitionId, progressiveMaxSteps (10), progressiveStepPercent (0.05), progressiveShardBonusPerStep (5), pityRadiantOpens (8), pityAbyssalOpens (25), the pity display name keys, tier1Chances ... tier4Chances (case quality chances; defaults [50,30,15,5], [42,35,18,5], [33,40,20,7], [20,35,30,15]), potionItemCodePatterns, potionAttributeSuffixes and nopotionsFailOnPreexisting (true). config/progression/pity.json (definitions[] with definitionId and rules[] of qualityTierIndex, opensUntilGuarantee, displayNameKey) and progressive.json (definitionId, stepSize, maxSteps, formula = linear/exponential/logarithmic, bonusesPerStep) register pity and progressive-difficulty rules.
bosses[]
{
"bossKey": "alzenith:moon:selenarch",
"entityCode": "alzenith:selenarch",
"nameKey": "alzenith:selenarch-title",
"respawnInGameHours": 999999,
"activationRange": 120,
"leashRange": 48,
"tierSet": { "tiers": { "1": {
"questId": "alzenith:selenarch",
"maxHealth": 24000, "damageMult": 1.0, "damageTierBonus": 1, "enrageTimerSeconds": 1920,
"challenges": [ { "type": "speedkill", "thresholdMinutes": 25 }, { "type": "deathless" } ],
"dropItems": [ { "code": "alzenith:moondust", "quantity": { "avg": 120, "var": 20, "dist": "uniform" } } ]
} } },
"introAnimation": "emerge", "introSeconds": 4
}| Field | Default | Description |
|---|---|---|
bossKey | — | Identity used by rotation, trackers, quests, achievements and rune currency routing |
entityCode | derived from bossKey | Entity to spawn |
questId | — | Quest of this boss (when there are no tiers; with tierSet the quest is per tier) |
nameKey / descKey | — | Names for hologram and info GUI |
respawnInGameHours, activationRange, relocateIntervalHours, softResetIdleHours, regenGraceMs | 0 | Overrides of the shared values (0 = shared) |
leashRange / outOfCombatLeashRange | 0 | Combat / out-of-combat leash (0 = none) |
yOffset | 0 | Spawn height offset |
tierSet.tiers | — | Map tier -> data, below |
runeCurrency | — | { runeId, amount } currency to credited players on kill |
reputation | — | { scope (npc), id, amount } reputation to credited players on kill, independent of quests |
introAnimation, introSeconds, introSound, introSoundRange (48) | — | Arrival animation after a summon: the boss is frozen and invulnerable while it plays |
Tier data: questId, maxHealth (300), damageMult (1), damageTierBonus, speedMult (1), enrageTimerSeconds (240), enrageDamageMult / enrageSpeedMult / abilityDamageMult / abilityCooldownMult (0 = scaled by tier), potionSuppressionPercent and silenceDurationMult (-1 = scaled by tier), challenges[], dropItems[]. A drop is { code, quantity: { avg, var, dist } } with dist = uniform (default), gaussian or invexp.
Summon ritual
summonRitualConfig: channelSeconds (15; 0 disables the channel), activationRange (4), cancelOnDamage (true), cancelOnMove (true), cancelRange (6), requiredItems[] ({ itemCode, count } consumed on start), particleStages[] (progressThreshold, effectType, particleColor, radius, height, intensity), startSound, loopSound, completeSound, cancelSound, soundRange (32), startPitch (0.5).
Challenges
Challenges are per-fight objectives rolled from the tier's challenges[] (rolledChallengeCount). Completing them pays challengeRewards and counts for achievements (the requireTags filter). Built-in types: speedkill (thresholdMinutes), deathless, nofood, nopotions, lowgear (maxArmorTier), perfectdodge (abilityCode), minimalhits, lowmaxhp, underhp, noshield, enragebeat. The entry fields are type, thresholdMinutes, maxArmorTier, abilityCode and a free parameters map (for example maxHits, maxHpThreshold, hpThreshold).
config/challenges/*.json ({ "definitions": [...] }) tunes them: challengeKey, displayNameKey, descriptionKey, maxArmorTier, timeLimitMinutes, abilityCode, potionPatterns, potionAttributeSuffixes, failOnPreexistingPotions, soloDamageSharePercent, maxHpThreshold (16), hpThreshold (10), maxHits (12), reputationMultiplier, bonusShards.
Presentation and helpers
hud
hud: { "enabled": true, "theme": "bone-ossuary", "showPlayerBoard": true, "elements": [...] } defines the on-screen panel of the fight (themes from config/gui/hud-themes.json, element types such as title, boss-name, wave-counter, timer, challenge-list). Without a hud block, or with enabled: false, nothing is shown. All elements, options and themes are described in Encounter HUD.
hologram
Text floating above the control block: range, yOffset (2.5), separator, colors (idle, preparing, active, cooldown, completed, failed for wave altars; alive, dead for boss encounters; RGBA 0-1), statusKeys, waveFormatKey ({0} current, {1} total), cooldownDayKey / cooldownHourKey / cooldownMinuteKey / cooldownSecondKey.
infoTab
Explanation tab on the quest giver: linkedEncounters[], howItWorksKeys[], howItWorksColors[].
tracker
How the tracker item / rune ability leading to a boss behaves: hpCost (3), cooldownMinutes (2), trailDurationSeconds (30), trailRefreshIntervalSeconds (5), trailVisibilityRange (20), particleColor ("200,160,80,230"), particleColorSecondary, activationSound, trailSound, requireActiveQuest (true), requireSameDimension (true).
spawnAnimation / dropAnimation
spawnAnimation plays before a boss appears when players approach: durationSeconds (12), triggerRange (8), sound, soundVolume (32), soundPitch (0.8), particleType (spiral, auraRing, falling, embers, aurasphere), particleColor, particleRadius (3), particleHeight (5), particleIntensity, screenShake (0.6), chatMessageKey. dropAnimation is the reward burst at the altar after a boss dies: sound, soundVolume, soundPitch, soundRange (48), particleType (boneshatter, aurasphere, shockwave, spiral, pillar, embers, falling, stonecrumble, ...), particleColor, particleRadius, particleHeight, particleIntensity (2), screenShake (0.4), shakeDurationSeconds (2), delaySeconds (1.5).
FX styles
config/encounters/fxstyles/*.json, referenced by the block attribute fxStyle: styleId, yOffset, enableAmbientParticles, enableServerAmbientParticles and one object per state (ready, dormant, active, summon, summonComplete, collapse) with tick intervals, colours, particle counts / sizes / life / velocity, orbit, vortex, explosion and collapse parameters and a looping sound. Examples: fxstyles/void.json, ossuary.json, alzenith/.../lunar.json.
Rewards and extra systems
lootTable:{ "entries": [ { itemCode, chance (1), minQty, maxQty, dropMode ("shared" or "perPlayer"), condition ("solo", "challengeComplete", "tier3", "deathless", ...), minTier, rarity } ] }, rolled on boss death.backfill: one-time retroactive rewards for saved kills (/avq encounter backfill):enabled,runeCurrencyMult,lootMult,boneItemCode,playerBackfilledAttributeKey,notifyKey.scoring: leaderboard score:baseScore1000,maxTimeBonus500,targetTimeSeconds300,perChallengeBonus200,soloBonus300,deathlessBonus250.checkpoints: retry from the last stage:persistAcrossRestart(true),maxRetries(3),expirySeconds(600) and the checkpoint list (checkpointId,stageIndex,reachedMessageKey).spectator:allowSpectators,spectatorRange(64),receiveNotifications,excludedFromSoloCheck,spectatingMessageKey,stoppedSpectatingMessageKey.affixPool: random boss affixes per fight:rollCount(1),maxPerCategory(1),rollCountPerTier, and affixes withaffixId,category,nameKey,weight,minTier,damageMult,healthMult,speedMult,grantedAbilities,visualEffect,rollSound.bossPhases,bossEnrage,bossAdds(boss encounters): phases withhpThresholdEnd,timeLimitSeconds, multipliers,morphEntityCode, ability lock / unlock lists; enrage byhpThreshold/timeLimitSecondswithenrageDamageMult(2) andenrageSpeedMult(1.5); minion groups per phase with leash and despawn rules. None of the shipped packs uses them.- Rune currency:
bosses[].runeCurrencypays credited players on kill. Separately, each core can route boss kills to itself withbossCurrency(see Runes). - Achievements: boss kills fire
trialkill/bosskill(seeachievementEventType) andencounteron completion, with tags such as the completed challenge IDs anddeathless.
Control blocks
Placeable blocks bind the world to an encounter; their JSON attributes are described in Arena Blocks & Altars. In short:
Block attributes.mode | Used for | Key attributes |
|---|---|---|
instanced | Wave altars | encounterId, encounterIds[] (the altar offers all listed encounters), nameKey, cooldownMinutes (10), activationRange (8), zoneRadius (40), maxConcurrentPlayers (4), arenaEnabled, arenaRadius, disableDefaultMobSpawns, regionPvpDisabled, regionNoDamage, disableTemporalStabilityDrain, regionWarmth, regionGravity, useLandClaimRegion, hologram options, idleAnimation, idleAnimationSpeed (0.1), activeAnimationSpeed (1), idleSound, activeSound, soundRange (5), ambientMusicKey, ambientMusicUrl, ambientMusicRange, the mob-pull set (mobPullEnabled, mobPullRadius 5, mobPullAliveThreshold 0.2, mobPullCooldownSeconds 60, sounds and text keys) |
ambient | Boss encounters | encounterId, fxStyle, tier (summon altars), yOffset, hologramRange, disableDefaultMobSpawns, zoneRadius, regionGravity, ambient sound keys (ambientSound, ambientSoundIntervalAlive 1.9, ambientSoundIntervalDormant 5, summonSoundInterval 2), enableAmbientParticles, enableServerAmbientParticles |
region | Region effects only | see Arena Blocks & Altars |
Start conditions of an instanced altar are also block attributes: minPlayers, maxPlayers, soloEnforce, lockoutHours, entryCost: { item, count }, prerequisiteQuest, weatherLock, leaderboard, plus timeWindow, summonRitual and escalation objects.
Quests and quest givers
Encounter quests are ordinary quests with a few additions:
{
"id": "alzenith:selenarch",
"ambientActiveBoss": "alzenith:moon:selenarch",
"actionObjectives": [ { "id": "killactiontarget", "objectiveId": "kill", "args": ["alzenith:selenarch", "kill", "alzenith:moon:selenarch", "1"] } ]
}ambientActiveBoss— the quest can only be offered while that boss key is part of the active rotation.- Objectives:
killactiontarget(credit when the boss with this key dies) andkillactiveencounter(credit for the active boss of a tier). - Actions:
trackencounter(aliastrackboss),resetencountertracker(aliasresetbosstrackergeneric),encounterchallengebonuses. - Quest giver attributes:
ambientactiveonlyhides quests whoseambientActiveBossis not active;trialactiveonlyhides tiered encounter quests while their encounter is not active or the player lacks the reputation for the tier;infoEncounterId(orencounterId) names the encounter shown in the info tab. See NPCs.
Chat announcements
An encounter announces its lifecycle in chat and Discord through messages; all keys are optional and resolve through the language files ({0} player names, {1} encounter, {2} difficulty where noted).
| Field | Description |
|---|---|
preparationChatKey / preparationDiscordKey | Preparation starts |
completionChatKey / completionDiscordKey | Completion (also used for boss rotation messages) |
failChatKey / failDiscordKey | Failure |
hologramRotationKey / hologramRespawnKey | Hologram lines ({0} days / hours left) |
modifierChatKey / modifierDiscordKey | A new modifier was rolled ({0} its name) |
discordBroadcastKind | Discord message type: AmbientEncounter (default), TrialRotation, EncounterPreparation, EncounterCompleted, EncounterFailed, BossDefeated, Generic, ... (unknown values fall back to the default) |
Which announcements a player receives is chosen in the profile (bell icon). The rows of that window are data (config/chatnotify*.json) and an announcement is matched by its event code, source entity tags, boss target IDs or encounter IDs; see Chat Announcement Filter. Encounters use the events encounter-preparation, encounter-completion, encounter-fail, encounter-awaken, encounter-rotation, encounter-modifier, bosskill and playerkilledbyboss.
Commands
All need the give privilege.
| Command | Description |
|---|---|
/avq encounter list | List loaded definitions |
/avq encounter start <encounterId> [difficultyId] | Start a wave encounter at your position |
/avq encounter stop <encounterId> | Abort a running encounter |
/avq encounter status <encounterId> | State, wave and participants |
/avq encounter resetcooldown [encounterId] | Reset the cooldown of the targeted altar or an encounter |
| `/avq encounter backfill <encounterId> [player\ | all]` |
/avq ambient status <encounterId> | Active boss, state, rotation timer, anchor count |
/avq ambient skip <encounterId> | Force-rotate to the next boss |
/avq ambient reload <encounterId> [radiusBlocks] | Re-scan control blocks in loaded chunks around players (default 512) and re-register the anchors; it does not reload JSON |
/avq validatepack | Re-run quest-pack validation |
Tips
bossKeyis the identity — quests, trackers, rune currency, achievements and commands reference it; never reuse one across encounters.- Leash before damage tuning — a boss that resets because
leashRangeis too small feels like a bug. softResetIdleHoursprevents griefing — a fight someone walked away from resets instead of locking the boss.- Use
arenaRestorefor destructible arenas andarenaGroupwhen several encounters share one crater. - Keep the three "flavours" apart — a wave encounter has
difficulties/endlessPool; a boss encounter hasmode.bosses; do not combine both in one file.