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
| Field | Default | Description |
|---|---|---|
id | — | Rune ID (required; entries without it are skipped) |
nameLangKey / descriptionLangKey | — | Localization keys |
type | shard | core (equippable core) or shard (aspect) |
attunement | neutral | Family 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 |
rarity | common | common, rare, legendary (the packs also use epic) — display only |
maxLevel | 5 | Level cap (aspects in the packs use 1) |
effects[] | [] | Passive stats while equipped (see below) |
particleColor | by attunement | "r,g,b,a" (0-255) default colour for the rune's abilities |
castStyle | sphere | Default cast animation: sphere, vortex, ring, pillar, aura |
iconAsset | — | Image asset for the icon (overrides the built-in vector icon) |
Core-only fields
| Field | Default | Description |
|---|---|---|
activeAbilities[] | [] | Castable abilities (below) |
procs[] | [] | Triggered effects (below) |
auras[] | [] | Persistent auras (below) |
fixedAbilitySlots | by level | Number of ability slots (max 5). Without it: (level + 1) / 2, max 5 |
fixedAspectSlots | by level | Number of aspect slots (max 5). Without it: level / 2 + 1, max 5 |
abilitiesFromAspects | false | Abilities marked locked become available only when an equipped aspect unlocks them (level is ignored). Used by the Ashen Warden tracker core |
iconType | generic hexagon | Built-in vector icon: voidrift, crown, sandstorm, sandswarm, wardenshield, fendisc... used when iconAsset is not set |
noEquipCooldown | false | Equipping / unequipping this core skips the equip cooldown and the combat check |
case | none | Case configuration (below) |
bossCurrency | none | Boss-kill currency routing (below) |
Aspect-only fields
| Field | Default | Description |
|---|---|---|
compatibleCore | any core | ID of the core this aspect can be slotted into |
coreLevelBonus | 0 | Adds 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)
| Field | Default | Description |
|---|---|---|
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 |
locked | false | Needs an aspect with an unlock modifier (or, in normal cores, the core level) |
unlockLevel | 1 | Core level that unlocks a locked ability |
cooldownSeconds / cooldownPerLevel | 30 / 0 | Cooldown at level 1 and the reduction per core level above 1 (minimum 1 s) |
castTimeSec / castTimePerLevel | 0 / 0 | Channel time and its reduction per level |
cost | 0 | Resource 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 } }| Field | Default | Description |
|---|---|---|
trigger | — | onHit (the player deals damage), onDamaged (receives damage), onKill, onHealthBelow (health at or below 35 %) |
baseChance / chancePerLevel | 0.1 / 0.02 | Chance 0-1, scaled by the core level |
cooldownSeconds | 5 | Cooldown 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
type | Fields | Effect |
|---|---|---|
unlock | targetAbility | Makes a locked ability available |
lock | targetAbility | Removes the ability from the build |
modify / enhance | targetAbility, paramMods, paramModsPerLevel | Adds 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 |
reduceCooldown | targetAbility, paramMods.seconds (+paramModsPerLevel.seconds) | Shortens the cooldown |
addProc | procDef | Adds a proc to the build |
addAura | auraDef | Adds an aura to the build |
{ "type": "modify", "targetAbility": "bone-hook", "paramMods": { "cooldownSeconds": 12, "maxRange": 8, "pullMs": 700 } }case — rune cases
| Field | Default | Description |
|---|---|---|
cost | 1 | Cost in the core's own currency |
openDurationSeconds | 5 | Length of the opening animation |
titleLangKey | <rune name key>-case | Title of the case window |
rewardRuneIds | the rune itself | Pool 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 }
}| Field | Default | Description |
|---|---|---|
amount | — | Currency per kill; 0 disables the reward |
tierAmounts | {} | Amount per tier / variant number, falls back to amount |
runeId | the core that declares it | Target core |
fallback | true | true: 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.
| Key | Default | Description |
|---|---|---|
EquipCooldownSeconds | 30 | Cooldown between equip / unequip operations (0 = none) |
RequireOutOfCombat | true | Runes can only be changed out of combat |
CombatCooldownSeconds | 10 | Seconds after the last combat action before runes can be changed |
BossKillCurrency | 5 | Fallback currency for a boss kill without a bossCurrency match |
EnablePlaytimeUnlock | false | Gate slots by playtime |
CoreUnlockHours | 0 | Hours to unlock the core slot |
Shard1UnlockHours ... Shard5UnlockHours | 2, 5, 10, 15, 20 | Hours 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).
Related actions
| Action | Purpose |
|---|---|
openruneawakening | Open 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.
| Command | Description |
|---|---|
/avq rune list | List 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 nocd | Toggle ability cooldowns off / on (debug) |
| `/avq rune currency <runeId\ | all\ |