Ability Atlas and Synergies

AbilityDef field reference

AbilityDef is the serialized data container for every spellbook entry. All abilities share this schema; unused fields are left at their defaults.

Identity and targeting

FieldTypeDefaultNotes
abilityNamestring"Ability"Used by the system to identify abilities by name in some code paths.
descriptionstring""Shown in the Spellbook UI and action-bar tooltip.
variantOnlyboolfalseHides the ability from the spellbook UI; only reachable as a variant reference.
shapeAbilityShapeCircleCircle, Cone, or Rectangle.
categoryAbilityCategoryDamageDamage, Heal, or Support.
rangefloat4Effective range in metres.
coneAnglefloat60Total angle of a cone in degrees.
useFixedRangeboolfalseLocks indicator to full range instead of tracking cursor distance (Cone and Rectangle only).
rectWidthfloat1.5Width of Rectangle-shaped indicators.
indicatorSizefloat1.5Visual circle radius for Circle-shaped indicators.
targetTagstring"Enemy"Unity tag string. Use "Player" for friendly abilities.
iconSpriteโ€”Shown on the action bar and spellbook.

Timing and cost

FieldTypeDefaultNotes
cooldownfloat3Seconds before the ability can be used again.
manaCostfloat0Mana consumed on commit.
instantCastboolfalseWhen true, pressing the ability key fires immediately using the current cursor aim without an aim/confirmation phase. Cast time, mana, cooldown, animation, and server validation still apply.
castTimefloat0.6Seconds between aim commit and effect resolution. Moving outside castMoveInterruptDistance cancels the cast without starting cooldown.

Cast animation

FieldTypeDefaultNotes
marauderCastAnimationAnimationClipnullClass-compatible clip played on commit.
animationPlaybackSpeedfloat1Speed multiplier for the cast animation (range 0.1โ€“3). Movement spells apply this after synchronizing to landing.

Caster movement

FieldTypeDefaultNotes
moveCasterToTargetboolfalseCaster moves to the spell target on resolve.
instantMovementboolfalseTeleport instead of leaping.
movementTimingAbilityMovementTimingConstantSpeedConstantSpeed: longer distance = more time. FixedDuration: every distance takes the same time.
moveToSpeedfloat14m/s when ConstantSpeed.
fixedMovementDurationfloat0.9Seconds of air time when FixedDuration.
movementArcHeightfloat0Peak height above the flat path in metres. Zero = flat movement.
resolveEffectsOnLandingboolfalseApplies damage and effects on landing instead of launch.
animationLandingPointfloat0.8Normalized clip time at which ground contact occurs; animation speed syncs to match landing.

Charge

FieldTypeDefaultNotes
chargeableboolfalseEnables charge mechanic.
maxChargeTimefloat1.5Seconds to reach full charge.
maxChargeDamagefloat10Damage at full charge.
maxChargeSizeMultiplierfloat1.8Indicator scale multiplier at full charge.

Damage

FieldTypeDefaultNotes
damagefloat10Base damage before character bonuses.
damageDelayfloat0Seconds after target lock-in before damage is applied.
secondaryDamagefloat0Optional second damage hit applied to the same locked targets. Fixed base amount before character bonuses; does not scale with charge.
secondaryDamageDelayfloat0Seconds after cast resolution to apply the secondary damage hit. Independent of damageDelay.

An ability qualifies as having direct damage when damage > 0 or secondaryDamage > 0 (checked by HasDirectDamage()). Both hits are scaled by the caster's damage multiplier. The action-bar tooltip shows "Secondary Damage" with the amount and, when secondaryDamageDelay > 0, the delay in seconds.

Shield

FieldTypeDefaultNotes
shieldAbsorbfloat0Hit points absorbed by the shield.
shieldDurationfloat0Seconds before the shield expires. Use 0 to keep it active until the absorb pool is depleted.
shieldVFXGameObjectnullPersistent VFX attached to the shielded target. Managed by ShieldVFXLifetime; auto-removed when the shield expires or the absorb pool is depleted.

Heal

FieldTypeDefaultNotes
healAmountfloat0Instant heal applied to the target.
healingDelayfloat0Seconds after locking in a target before the heal is applied.

Heal over Time

FieldTypeDefaultNotes
hotTickAmountfloat0Heal per tick.
hotTicksint0Number of ticks.
hotIntervalfloat1Seconds between ticks.
usePulseHealingboolfalseDelivers HoT as area pulses at the spell location.

Pulse damage

FieldTypeDefaultNotes
usePulseDamageboolfalseEnables pulse damage.
pulseDamageIsDoTboolfalseWhen true, targets are locked to those caught on the initial cast; they continue receiving damage ticks after leaving the original area. When false, each pulse independently rescans the zone for living targets.
pulseCountint0Number of pulses after landing. Set to 0 to disable custom pulses.
pulseIntervalfloat0Seconds between pulses. 0 = default 1 second.
pulseRadiusfloat0For Circle abilities: damage radius per pulse; 0 = half indicator size; chargeable circles use the committed damage-zone radius automatically. For Cone abilities: ignored โ€” pulses repeat across the committed cone range and angle instead.
pulseDamagefloat0Damage per pulse. 0 = ability's base damage.
pulseVFXLifetimefloat0Seconds each pulse VFX stays visible.

Cone abilities with usePulseDamage run PulseConeDamage: each pulse fires ApplyConePulseDamage across the full committed cone (forward direction and range captured at cast time, scaled by charge fraction and indicator scale). Circle abilities use PulseDamage with a radial overlap. When pulseDamageIsDoT is true, the target list is captured once on cast and reused for all subsequent ticks; targets that die between ticks are silently skipped. When false (default), each pulse independently scans the zone for living targets.

Status effects

FieldTypeDefault
statusEffectStatusEffectTypeโ€”
statusDurationfloat0
statusValuefloat0

Chain lightning

FieldTypeDefaultNotes
chainTargetsint0Max total enemies struck, including the initial target. 0 disables chaining.
chainDamageFallofffloat5Flat damage removed per jump.
chainRadiusfloat6Max distance from previous enemy to the next chain target.

Crowd control

FieldTypeDefaultNotes
crowdControlTypeAbilityCrowdControlTypeNoneNone, Pull, or KnockUp.
pullDestinationAbilityPullDestinationCastPointCastPoint or ConeApex.
pullSpeedfloat8Max pull speed in m/s.
pullStopDistancefloat1.25Distance at which pulled targets stop.
pullDurationfloat0Duration of continuous pull effects.
knockUpHeightfloat2.5Peak vertical height in metres for KnockUp.
knockUpDurationfloat0.8Total arc duration in seconds for KnockUp.

VFX prefabs

FieldNotes
castVFXSpawned at the spell destination (or at the caster when castVFXAtCaster is true) on release.
castingVFXLooping VFX attached to the caster during aim. Removed on release or cancel.
healVFXPlayed on each ally healed; plays on each HoT tick.
hitVFXSpawned at each target hit. Attached to the target's transform when hitVFXFollowsTarget is true.
shieldVFXPersistent VFX attached to a shielded target. See Shield section above.
chainVFXConnector VFX spawned between consecutive chain targets. Prefabs with children named "Cast Position" and "Hit Position" have their endpoints placed on the respective targets. When an ability uses pulse damage, the chain VFX is also drawn from the caster to each pulse target and its endpoints track both transforms in real time.

SFX

FieldNotes
castSFXPositional audio played on cast.
hitSFXPositional audio played on hit. Requires hitVFX to be assigned (they share the same network broadcast).
sfxVolumeVolume multiplier for this ability's cast and hit sounds (0โ€“1).

Deployable

deployablePrefab โ€” scene object spawned at the spell location (mine, wall, zone, etc.).

Projectile delivery

FieldTypeDefaultNotes
launchProjectileboolfalseWhen true, direct shape damage (Cone, Rectangle, Circle) is bypassed and a PlayerProjectile is spawned at the cast origin.
projectilePrefabGameObjectโ€”Networked projectile prefab. Must have NetworkIdentity, a trigger Collider, and PlayerProjectile on its root. Assign via the Spell Forge VFX tab (โ†’ Projectile).
projectileSpeedfloat20Travel speed in m/s (minimum 0.1). Overrides the prefab's default speed for this ability.

When launchProjectile is true, the ability skips all shape-hit damage paths on ResolveCastEffects. The projectile is server-spawned (or locally instantiated in offline mode) and fires in the cast indicator's forward direction. Projectile prefabs are created with BCE โ–ถ Spell Forge โ–ถ Projectile Builder. See Combat Core and Loop for runtime projectile behavior.

Charge variants

variants (AbilityVariant[]) โ€” 2โ€“4 zone selectors ordered near-to-far. Each zone references another spellbook entry by index or name. Cursor distance selects the active variant.

AbilityVariant fields mirror AbilityDef for per-zone overrides and add shieldVFX.

Arcanist Combustion

These fields are only read when the owning AbilityCaster is an ArcanistAbilityCaster.

FieldTypeDefaultNotes
combustionPointsint0Combustion awarded when the ability's projectile deals health damage. Normal hits award the full value; critical hits award double.
spendCombustionboolfalseWhen true, all accumulated Combustion is cleared on cast commit. If Combustion was above zero, a Combustion Meteor proc is guaranteed.

Crowd control types

AbilityCrowdControlType enum values:

ValueIntegerBehavior
None0No CC.
Pull1Targets are moved toward pullDestination at pullSpeed.
KnockUp2Targets are launched upward following a parabolic arc.

KnockUp implementation

CrowdControlKnockUpMotor is a server-side component added dynamically to affected targets. It:

  • Suspends the target's NavMeshAgent and Rigidbody for the duration.
  • Applies a StatusEffectType.Stagger for the arc duration.
  • Moves the target along a smooth parabola peaking at knockUpHeight.
  • Returns the target to its ground position on landing and restores movement state.
  • Cancels any active Pull on the same target before beginning.
  • A new knock-up on an already-airborne target restarts the motor.
  • Cancels cleanly on target death or OnDisable.

Instant cast

When instantCast is true, pressing the ability key:

  1. Cancels any active aim.
  2. Snapshots the current cursor aim direction.
  3. Calls BeginCommittedCast directly โ€” no targeting or confirmation phase is shown.
  4. Variant selection uses the current cursor distance (same fraction used during normal aim).

Cast time, mana cost, cooldown, animation, and server validation still apply.

Action-bar tooltips and spell cards show "INSTANT CAST" when this flag is set.


Shield VFX lifetime

ShieldVFXLifetime (client-only, added at runtime by AbilityCaster.SpawnAttachedShieldVFX) binds a VFX GameObject to a Health target and destroys it when:

  • shieldDuration seconds elapse (timed shields).
  • The target's HasShield transitions from true to false (absorb pool depleted).

Only one ShieldVFXLifetime is active per target instance at a time; a new shield on the same target destroys the previous VFX and spawns a fresh one.


Sweet-spot ability handling

The following abilities use a three-zone sweet-spot dispatch: "Healing Cone", "Mending Beam", "Conflagration Cone", "Ember Beam". Cursor distance within the cone selects among three effect zones (burst heal/crit, HoT, or shield zone) defined inside ApplySweetSpotEffects.


Targeted cone support

Cone spells with category == Heal or Support and healAmount > 0 or shieldAbsorb > 0 (that are not sweet-spot abilities or variant spells) use ApplyConeSupportEffects: all colliders within the cone range are resolved, each hit health object receives the heal (with healingDelay) and/or shield.


Arcanist Combustion

ArcanistAbilityCaster tracks a combustion resource (SyncVar, range 0โ€“100) that drives a class-specific damage amplification loop.

Generating spells (combustionPoints > 0, spendCombustion = false): Combustion is awarded when the spell's projectile deals health damage to a target. A normal hit awards combustionPoints; a critical hit awards combustionPoints ร— 2.

Spender spells (spendCombustion = true): All Combustion is set to zero on cast commit. If Combustion was above zero at the moment of commit, a Combustion Meteor proc is guaranteed.

Combustion Meteor proc: When Combustion is at maximum (100), any non-spender cast that is not itself named "Combustion Meteor" has a 25% chance to fire "Combustion Meteor" automatically at the same target position. The meteor spell is resolved from the Arcanist's spellbook by the exact name "Combustion Meteor". The proc fires via TryTriggerCombustionMeteor immediately after the triggering ability resolves.

HUD: A Combustion Bar in the Arcanist's HUD reflects the current Combustion fraction (0โ€“1).

Sync: combustion is a Mirror SyncVar; changes are server-authoritative and broadcast to clients via the CombustionChanged event.

Stat-based ability damage scaling

CombatBalance (Combat/Scripts/CombatBalance.cs) is a static class that loads versioned per-ability scaling rules from Resources/Combat/ability-scaling-v1.json. The server reads the same file at startup; the client loads the bundled copy to display scaling details in tooltips. Both sides expose a version integer; CharacterStats.CombatBalanceVersion (SyncVar) carries the server's loaded version to all clients. Tooltips show scaling data only when the client and server versions match.

CombatScalingStat enum values: Strength, Agility, Intelligence, Vitality.

Current live rules (ability-scaling-v1.json, version 1):

Class indexAbilityScaling statBonus damage per point
4 โ€” ArcanistIce SpikesIntelligence0.25
2 โ€” Night HunterBlade FlurryAgility0.25

Baseline: 5 for Strength, Agility, and Intelligence; 10 for Vitality. Points above the baseline contribute to the scaling bonus: max(0, effectiveStatValue โˆ’ baseline) ร— damagePerPoint.

Variant fallback: when a variant ability has no scaling rule of its own, AbilityCaster uses the parent ability's rule if one exists.

Client feedback:

  • The action-bar ability tooltip appends a yellow scaling line: "+1 {stat} adds {damagePerPoint} damage (current extra: {currentBonus})."
  • Hovering a stat value on the Character Sheet shows character vs. gear contribution, effective total, and the scaling amount for each ability that scales from that stat.

Deployable and delayed ability damage multiplier

Player-owned objects spawned by an ability, and damage that resolves after a delay, inherit the caster's full damage multiplier at the moment of cast. Affected abilities:

AbilityObject or path scaled
Runic SnareShockMineBehaviour.damage
Counter Blow (Templar)KineticReversalHandler release damage
Shieldwall Charge (Templar)DashHandler.BreachSlam slam damage
Spirit WispsNaniteSwarm.chipDamage
Null FieldNullFieldZone.decayDamagePerSecond
Turret-spawning abilitiesTurretController.damage
Cursed status effectStatus effect value at application

Related: Combat Core and Loop ยท Heroes & Classes ยท Editor Tooling