Systems

Runes

The rune system gives players collectible cores and shards (called *aspects* in the UI). A player equips one core and, depending on the core's level, up to five aspects. The core brings passive stats, procs, auras and active abilities; aspects modify, unlock or add to the core's abilities. Cores collect their own rune currency (earned from bosses, quests, achievements) that is spent on "cases" which unlock aspects. Definitions live in config/runes/*.json; server tuning lives in runes-config.json; the ability implementations behind defId live in config/abilities/*.json.


Definition files

Every mod and quest pack contributes config/runes/*.json (the legacy single file config/runes.json still loads). Each file is a wrapper with a runes array; cores and shards can be mixed in a file. Real examples: albase/config/runes/bone-crown.json, sand-swarm.json, void-echo.json, ashen-warden.json, alzenith/config/runes/lunar-tide.json. A rune ID defined twice replaces the earlier definition (a validation warning is logged for duplicates).

{
  "runes": [
    {
      "id": "bone-crown",
      "nameLangKey": "albase:rune-bone-crown-name",
      "descriptionLangKey": "albase:rune-bone-crown-desc",
      "type": "core",
      "attunement": "bone",
      "rarity": "legendary",
      "maxLevel": 5,
      "fixedAbilitySlots": 3,
      "iconType": "crown",
      "iconAsset": "albase:textures/gui/runes/bone.webp",
      "particleColor": "255,255,255,255",
      "effects": [ { "stat": "maxhealthflat", "baseValue": 1.2, "valuePerLevel": 1.2 } ],
      "activeAbilities": [ ],
      "case": { "cost": 270, "openDurationSeconds": 7.5, "rewardRuneIds": [ "bone-titan", "chain" ] },
      "bossCurrency": { "albase:bosshunt:*": { "amount": 100, "fallback": false } }
    }
  ]
}

Common fields

FieldDefaultDescription
id—Rune ID (required; entries without it are skipped)
nameLangKey / descriptionLangKey—Localization keys
typeshardcore (equippable core) or shard (aspect)
attunementneutralFamily label. Decides the default particle colour: void, moon, bone, neutral, sand, fire/ember, ice/frost, storm, nature/verdant; any other value gets a neutral brown
raritycommoncommon, rare, legendary (the packs also use epic) — display only
maxLevel5Level cap (aspects in the packs use 1)
effects[][]Passive stats while equipped (see below)
particleColorby attunement"r,g,b,a" (0-255) default colour for the rune's abilities
castStylesphereDefault cast animation: sphere, vortex, ring, pillar, aura
iconAsset—Image asset for the icon (overrides the built-in vector icon)

Core-only fields

FieldDefaultDescription
activeAbilities[][]Castable abilities (below)
procs[][]Triggered effects (below)
auras[][]Persistent auras (below)
fixedAbilitySlotsby levelNumber of ability slots (max 5). Without it: (level + 1) / 2, max 5
fixedAspectSlotsby levelNumber of aspect slots (max 5). Without it: level / 2 + 1, max 5
abilitiesFromAspectsfalseAbilities marked locked become available only when an equipped aspect unlocks them (level is ignored). Used by the Ashen Warden tracker core
iconTypegeneric hexagonBuilt-in vector icon: voidrift, crown, sandstorm, sandswarm, wardenshield, fendisc... used when iconAsset is not set
noEquipCooldownfalseEquipping / unequipping this core skips the equip cooldown and the combat check
casenoneCase configuration (below)
bossCurrencynoneBoss-kill currency routing (below)

Aspect-only fields

FieldDefaultDescription
compatibleCoreany coreID of the core this aspect can be slotted into
coreLevelBonus0Adds this much effective core level while equipped (stacks, capped at the core's maxLevel)
modifiers[][]Changes to the core's abilities (below)

effects[] — passive stats

{ "stat": "attackpower", "baseValue": 0.02, "valuePerLevel": 0.02 }

Value = baseValue + valuePerLevel × (level − 1). stat is an item/action attribute key (attackpower, maxhealthflat, walkspeed, protection, critchance, healingeffectiveness, ...); an unsupported stat name logs a warning on load. Effects of the core (at its effective level) and of every equipped aspect add up. Equipping aspects that cover the core's abilities adds an extra bonus of +6.7 % per equipped aspect when together they target all active abilities.

activeAbilities[] — castable abilities (core)

FieldDefaultDescription
id, nameLangKey, descriptionLangKey—Identity; the ID is what aspects target
abilityType—Handler name (hook, grab, dash, sandwave, shardswarm, sandanchor, voidzone, voidbarrage, randomteleport, lifedrainnova, moonleap, smallmoon, fallingstar, trackers trackboss/tracktrial/trackencounter/trackduatgate/trackmoon, ...). Ignored when defId is set
defId—ID of a reusable ability from config/abilities/*.json; the rune becomes a data-driven ability
effects[]Inline ability effects, used only without defId
lockedfalseNeeds an aspect with an unlock modifier (or, in normal cores, the core level)
unlockLevel1Core level that unlocks a locked ability
cooldownSeconds / cooldownPerLevel30 / 0Cooldown at level 1 and the reduction per core level above 1 (minimum 1 s)
castTimeSec / castTimePerLevel0 / 0Channel time and its reduction per level
cost0Resource cost
params / paramsPerLevel{}Ability-specific numbers and per-level additions
particleColor, castStyle, castSound, sounds, iconAsset—Presentation (fall back to the core, then to the attunement)
encounterId / encounterIds—For tracker abilities: the encounters to track

A charges entry in params (extra charges) gives the ability charges + 1 uses. Parameters can never fall below built-in floors (radius, range, durations, speeds); the floors can be tuned with ParamCaps in runes-config.json.

procs[] — triggered effects

{ "trigger": "onHit", "baseChance": 0.1, "chancePerLevel": 0.02, "cooldownSeconds": 5, "effectType": "lifeDrain", "params": { "amount": 2 } }
FieldDefaultDescription
trigger—onHit (the player deals damage), onDamaged (receives damage), onKill, onHealthBelow (health at or below 35 %)
baseChance / chancePerLevel0.1 / 0.02Chance 0-1, scaled by the core level
cooldownSeconds5Cooldown per effect type
effectType—Ability effect to run: repulse, shield, lifeDrain, woundedMark, dash, voidZone, voidBarrage, teleport, knockback, shardSwarm, sandWave (other names are passed through to the ability effect registry)
params{}Effect arguments

None of the shipped packs currently defines core procs; one aspect uses addProc.

auras[] — persistent auras

auraType (repulsion, oxygenDrain, despair, voidGrasp, decay), radius (default 5) + radiusPerLevel (0.5), tickIntervalMs (1000), params / paramsPerLevel.

modifiers[] — aspect effects on the core

typeFieldsEffect
unlocktargetAbilityMakes a locked ability available
locktargetAbilityRemoves the ability from the build
modify / enhancetargetAbility, paramMods, paramModsPerLevelAdds the numbers to the ability's params. The keys cooldownSeconds and castTimeSec change the cooldown / cast time instead. paramModsPerLevel is multiplied by aspect level − 1
reduceCooldowntargetAbility, paramMods.seconds (+paramModsPerLevel.seconds)Shortens the cooldown
addProcprocDefAdds a proc to the build
addAuraauraDefAdds an aura to the build
{ "type": "modify", "targetAbility": "bone-hook", "paramMods": { "cooldownSeconds": 12, "maxRange": 8, "pullMs": 700 } }

case — rune cases

FieldDefaultDescription
cost1Cost in the core's own currency
openDurationSeconds5Length of the opening animation
titleLangKey<rune name key>-caseTitle of the case window
rewardRuneIdsthe rune itselfPool of runes a case can give. The core itself and already owned / maxed runes are excluded; a case only unlocks runes (it never adds levels)

A case needs the core to be owned, enough currency and at least one reward left.

bossCurrency — currency from bosses

Per core, which boss kills pay currency to this core. Keys are boss target IDs or sources, exact or with a trailing * prefix (exact matches win):

"bossCurrency": {
  "albase:trial:*": { "amount": 12, "tierAmounts": { "1": 12, "2": 25, "3": 40 }, "fallback": false },
  "alzenith:moon:selenarch": { "amount": 60, "fallback": false }
}
FieldDefaultDescription
amount—Currency per kill; 0 disables the reward
tierAmounts{}Amount per tier / variant number, falls back to amount
runeIdthe core that declares itTarget core
fallbacktruetrue: if the player does not own the core, pay the equipped core (or all owned cores). false: bank the currency on the core anyway (it appears once the core is obtained)

Without a matching entry, a boss kill pays BossKillCurrency from runes-config.json to the equipped core, or to every owned core when none is equipped.


Server config (runes-config.json)

ModConfig/alegacyvsquest/runes-config.json is created with defaults on first start.

KeyDefaultDescription
EquipCooldownSeconds30Cooldown between equip / unequip operations (0 = none)
RequireOutOfCombattrueRunes can only be changed out of combat
CombatCooldownSeconds10Seconds after the last combat action before runes can be changed
BossKillCurrency5Fallback currency for a boss kill without a bossCurrency match
EnablePlaytimeUnlockfalseGate slots by playtime
CoreUnlockHours0Hours to unlock the core slot
Shard1UnlockHours ... Shard5UnlockHours2, 5, 10, 15, 20Hours to unlock aspect slots 1-5
AbilityNamePrefix""Localization prefix (for example albase:rune-) used as a tooltip fallback for ability names
FailSound""Sound on a failed cast
ParamCaps{}Lower floors for ability parameters, paramKey -> minimum; overrides the built-in floors

Boss currency is not configured here; use bossCurrency on the core. Old BossCurrencyOverrides / BossCurrencyTargets keys have been removed from the shipped file (and are ignored if present).


ActionPurpose
openruneawakeningOpen the rune window for the player
addcorelevel <coreId>Raise a core's level by one (cores only)
addaspectlevel <runeId>Raise any rune's level by one, unlocking it at level 1 if needed
unlockaspect <runeId>Unlock a rune at level 1 (no effect if owned)
addrunecurrency <coreId> <amount>Give currency to one core (banked even if the core is not owned yet)

Achievement rewards of type RuneCurrency use the same currency (value: core ID, equipped or all), and the rune / runelevel achievement events fire on unlocks and level-ups.

Commands

All need the give privilege.

CommandDescription
/avq rune listList registered runes
/avq rune unlock <runeId> [player]Unlock a rune
/avq rune unlockall [player]Unlock every rune
/avq rune level <runeId> <level> [player]Set a rune's level
/avq rune levelall <level> [player]Set all owned runes to a level
/avq rune levelequipped <level> [player]Set the equipped core and aspects to a level
/avq rune reset [player]Wipe the player's runes
/avq rune nocdToggle ability cooldowns off / on (debug)
`/avq rune currency <runeId\all\

Press ESC to close