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"]
FlavourHow it is definedControl block modeReal examples
Wave encounterdifficulties (fixed waves) or endlessPool (procedural waves); optional tiny mode with only arenaAnchorinstancedalbase duat-gate, scarab-swarm, funeral-procession, duat-retribution
Rotating bossmode with spawnMode: "proximity" and bosses[]ambientalbase ossuary
Tiered summon bossmode with spawnMode: "summon", bosses[].tierSet, summonRitualConfigambientalbase 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).


PathPurpose
config/encounters/*.jsonEncounter definitions
config/encounters/fxstyles/*.jsonAltar particle / sound styles (below)
config/encounterbosspools/*.jsonReusable boss pools for waves (below)
config/challenges/*.jsonChallenge definitions (below)
config/modifiers/*.jsonRotating modifier pools, see Modifiers
config/progression/pity.json, progressive.jsonCase pity and progressive-difficulty definitions
config/gui/hud-themes.jsonNamed HUD themes
config/chatnotify*.jsonChat 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": { }
}
FieldDefaultDescription
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, ...)
activationRange8Range in blocks around the block for player detection (wave encounters)
zoneRadius40Encounter zone radius; leaving it starts the failure grace
allowInteractionInAnyLandfalseAllow using the control block inside someone else's land claim
spawnRadius / spawnMinDistance0 / 3When spawnRadius > 0 all mobs and bosses spawn within that horizontal distance of the anchor, no closer than spawnMinDistance
runeCooldownReduction00-1 shorter rune ability cooldowns for players in the arena (a difficulty can override)
maxConcurrentPlayers4Participant limit
cooldownMinutes10Cooldown after an encounter ends, success or failure
abandonTimeoutMinutes30Real minutes an active run may stay with all participants offline before it fails; 0 disables
preparationSeconds0Preparation phase before the first wave
maxMobsPerWave0Cap on mobs per wave (0 = none); scaling is applied first, then capped proportionally
spawnBatchSize1Mobs per spawn callback (larger = fewer events, same total time)
mobSpawnSound—Sound when a mob spawns
mobKillRewardItem / mobKillRewardAmount— / 0Item 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)
achievementEventTypetrialkillEvent 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).

FieldDefaultDescription
difficultyId, nameKey, descKey, symbol—Identity and the card shown in the GUI
waveCount—Number shown in the GUI (the waves list is authoritative)
timeLimitMinutes0Time limit; 0 = none
tier1Difficulty tier (1-3), passed to spawned bosses to unlock tiered mechanics
healthMult / damageMult1Stat multipliers for all mobs
bossHealthMult / bossDamageMult1For boss and mini-boss spawns
miniBossHealthMult / miniBossDamageMult1For mini-bosses only
damageTierBonus0Raises the damage tier of mob and boss attacks
abilityDamageMult, abilityCooldownMult, summonLimitMult, enrageDamageMult, enrageSpeedMult-1Boss 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-1Overrides the encounter value
ambientMusicKey, fogColor, maxFogDensity—Per-difficulty music and storm fog overrides
mobKillRewardMult1Scales 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 }
}
FieldDefaultDescription
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— / falseA 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
isMinibossfalseTreat the boss as a mini-boss
clearConditionallKilledWhen the wave counts as cleared; killCount clears after killCount non-ignored mobs died
delayBetweenSpawnsMs / delayBeforeWaveMs500 / 2000Timing
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).

FieldDefaultDescription
mobs[]—entityCode, weight (1), minWave (1), spawnPattern, minDistance, maxDistance, spawnPreset, ignoreForWaveClear, despawnOnWaveClear (at least one required)
miniBosses[] / bosses[]—entityCode, everyNWave (5), alternate
scalingrequiredhealthMultPerWave (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, miniBossDamageMult1 (boss values -1 = defaults 1.0 / 0.5 / 0.8)Base multipliers
abilityDamageMult, abilityCooldownMult, summonLimitMult, enrageDamageMult, enrageSpeedMult-1Boss 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

FieldDefaultsDescription
respawnmode: "anchor", respawnAtBlock: true, respawnRadius: 5, clearBindingOnEnd: true, preserveDietOnDeath: trueWhere and how participants respawn
failureConditionsallPlayersDead: true, allPlayersDiedOnce: false, timeLimit: true, zoneLeaveGraceSeconds: 30, noDeathTimeoutSeconds: 0, allPlayersDeadOfflineGraceSeconds: 60When 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)
playerScalingcountBonusPerPlayer 0.3, maxCountMult 2, normalHealthBonusPerPlayer 0.2 / ...ThresholdPlayers 1 / normalMaxHealthMult 1.8, minibossHealthBonusPerPlayer 0.5 / 1 / 3, bossHealthBonusPerPlayer 1 / 1 / 4, additiveHealthScaling falseMob count and health scaling by participant count; additive mode adds the bonus to the difficulty multiplier instead of multiplying
groupScalingcountBonusPerPlayer 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.05Scaling used by boss (ambient) encounters, with optional damage and gear-level scaling
leashenabled: 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
zoneshape: "circle" (or box), radius: 40, height: 0, blockNonParticipants: false, pushForce: 1, nonParticipantDamagePerSec, leaveDamagePerSec, leaveGraceSeconds: 5, enterMessageKey, leaveMessageKey, boundaryWarningKeyEnforced dynamic zone around the anchor
stormSee StormProgressive storm
environmentfogDensity, 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

FieldDefaultDescription
spawnModeproximityproximity: 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)
activeBossCount1How many bosses are active in the rotation
rotationDays7In-game days between rotations of the active boss
rerollOnRotationtrueSummon mode: re-roll an altar's assigned boss when the rotation advances (a living summoned boss keeps its assignment)
respawnInGameHours24Respawn delay after a boss dies (a boss entry can override)
activationRange160Player detection range in blocks
softResetIdleHours / softResetAntiSpamHours1 / 0.25Hours idle without combat before the fight soft-resets (despawn); minimum gap between resets
relocateIntervalHours0Relocate the boss to another anchor every N hours (0 = never)
noRelocateAfterDamageMinutes / rotationPostponeAfterDamageHours10 / 0.25Postpone relocation / rotation after the boss was hit
anchorCooldownDays / anchorCooldownDaysPerTier1 / —Cooldown per anchor between summons
modifierIntervalDays0Real rotation of the encounter modifier in in-game days (0 = rolled once at start)
watchedAttributePrefixalegacyvsquest:ambientPrefix of the attributes written on spawned entities
localizationPrefix""Prefix for notification / UI keys
resetCooldownOnServerRestartfalseClear saved respawn cooldowns on server restart
showFailureReasonstrueShow per-challenge failure reasons in the HUD
soloDamageSharePercent100Minimum 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
arenaAnchordisabledArena respawn settings, below
arenaEnabled, keepInventoryfalse, trueUse the respawn registry for arena binding; keep inventory on death
rolledChallengeCount / rolledChallengeCountPerTier3 / —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), deathEffectSoundfalseThemed burst and corpse despawn after a boss dies
summonCompleteSound, summonCompleteSoundTier2Plus, summonCompleteSoundRangetranslocate / lightning / 48Sounds when a summon finishes
bossRegenGraceMs0Out-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
}
FieldDefaultDescription
bossKey—Identity used by rotation, trackers, quests, achievements and rune currency routing
entityCodederived from bossKeyEntity 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, regenGraceMs0Overrides of the shared values (0 = shared)
leashRange / outOfCombatLeashRange0Combat / out-of-combat leash (0 = none)
yOffset0Spawn 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: baseScore 1000, maxTimeBonus 500, targetTimeSeconds 300, perChallengeBonus 200, soloBonus 300, deathlessBonus 250.
  • 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 with affixId, category, nameKey, weight, minTier, damageMult, healthMult, speedMult, grantedAbilities, visualEffect, rollSound.
  • bossPhases, bossEnrage, bossAdds (boss encounters): phases with hpThresholdEnd, timeLimitSeconds, multipliers, morphEntityCode, ability lock / unlock lists; enrage by hpThreshold / timeLimitSeconds with enrageDamageMult (2) and enrageSpeedMult (1.5); minion groups per phase with leash and despawn rules. None of the shipped packs uses them.
  • Rune currency: bosses[].runeCurrency pays credited players on kill. Separately, each core can route boss kills to itself with bossCurrency (see Runes).
  • Achievements: boss kills fire trialkill / bosskill (see achievementEventType) and encounter on completion, with tags such as the completed challenge IDs and deathless.

Control blocks

Placeable blocks bind the world to an encounter; their JSON attributes are described in Arena Blocks & Altars. In short:

Block attributes.modeUsed forKey attributes
instancedWave altarsencounterId, 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)
ambientBoss encountersencounterId, fxStyle, tier (summon altars), yOffset, hologramRange, disableDefaultMobSpawns, zoneRadius, regionGravity, ambient sound keys (ambientSound, ambientSoundIntervalAlive 1.9, ambientSoundIntervalDormant 5, summonSoundInterval 2), enableAmbientParticles, enableServerAmbientParticles
regionRegion effects onlysee 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) and killactiveencounter (credit for the active boss of a tier).
  • Actions: trackencounter (alias trackboss), resetencountertracker (alias resetbosstrackergeneric), encounterchallengebonuses.
  • Quest giver attributes: ambientactiveonly hides quests whose ambientActiveBoss is not active; trialactiveonly hides tiered encounter quests while their encounter is not active or the player lacks the reputation for the tier; infoEncounterId (or encounterId) 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).

FieldDescription
preparationChatKey / preparationDiscordKeyPreparation starts
completionChatKey / completionDiscordKeyCompletion (also used for boss rotation messages)
failChatKey / failDiscordKeyFailure
hologramRotationKey / hologramRespawnKeyHologram lines ({0} days / hours left)
modifierChatKey / modifierDiscordKeyA new modifier was rolled ({0} its name)
discordBroadcastKindDiscord 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.

CommandDescription
/avq encounter listList 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 validatepackRe-run quest-pack validation

Tips

  • bossKey is 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 leashRange is too small feels like a bug.
  • softResetIdleHours prevents griefing — a fight someone walked away from resets instead of locking the boss.
  • Use arenaRestore for destructible arenas and arenaGroup when several encounters share one crater.
  • Keep the three "flavours" apart — a wave encounter has difficulties/endlessPool; a boss encounter has mode.bosses; do not combine both in one file.

Press ESC to close