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
| Field | Type | Default | Notes |
|---|---|---|---|
abilityName | string | "Ability" | Used by the system to identify abilities by name in some code paths. |
description | string | "" | Shown in the Spellbook UI and action-bar tooltip. |
variantOnly | bool | false | Hides the ability from the spellbook UI; only reachable as a variant reference. |
shape | AbilityShape | Circle | Circle, Cone, or Rectangle. |
category | AbilityCategory | Damage | Damage, Heal, or Support. |
range | float | 4 | Effective range in metres. |
coneAngle | float | 60 | Total angle of a cone in degrees. |
useFixedRange | bool | false | Locks indicator to full range instead of tracking cursor distance (Cone and Rectangle only). |
rectWidth | float | 1.5 | Width of Rectangle-shaped indicators. |
indicatorSize | float | 1.5 | Visual circle radius for Circle-shaped indicators. |
targetTag | string | "Enemy" | Unity tag string. Use "Player" for friendly abilities. |
icon | Sprite | โ | Shown on the action bar and spellbook. |
Timing and cost
| Field | Type | Default | Notes |
|---|---|---|---|
cooldown | float | 3 | Seconds before the ability can be used again. |
manaCost | float | 0 | Mana consumed on commit. |
instantCast | bool | false | When 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. |
castTime | float | 0.6 | Seconds between aim commit and effect resolution. Moving outside castMoveInterruptDistance cancels the cast without starting cooldown. |
Cast animation
| Field | Type | Default | Notes |
|---|---|---|---|
marauderCastAnimation | AnimationClip | null | Class-compatible clip played on commit. |
animationPlaybackSpeed | float | 1 | Speed multiplier for the cast animation (range 0.1โ3). Movement spells apply this after synchronizing to landing. |
Caster movement
| Field | Type | Default | Notes |
|---|---|---|---|
moveCasterToTarget | bool | false | Caster moves to the spell target on resolve. |
instantMovement | bool | false | Teleport instead of leaping. |
movementTiming | AbilityMovementTiming | ConstantSpeed | ConstantSpeed: longer distance = more time. FixedDuration: every distance takes the same time. |
moveToSpeed | float | 14 | m/s when ConstantSpeed. |
fixedMovementDuration | float | 0.9 | Seconds of air time when FixedDuration. |
movementArcHeight | float | 0 | Peak height above the flat path in metres. Zero = flat movement. |
resolveEffectsOnLanding | bool | false | Applies damage and effects on landing instead of launch. |
animationLandingPoint | float | 0.8 | Normalized clip time at which ground contact occurs; animation speed syncs to match landing. |
Charge
| Field | Type | Default | Notes |
|---|---|---|---|
chargeable | bool | false | Enables charge mechanic. |
maxChargeTime | float | 1.5 | Seconds to reach full charge. |
maxChargeDamage | float | 10 | Damage at full charge. |
maxChargeSizeMultiplier | float | 1.8 | Indicator scale multiplier at full charge. |
Damage
| Field | Type | Default | Notes |
|---|---|---|---|
damage | float | 10 | Base damage before character bonuses. |
damageDelay | float | 0 | Seconds after target lock-in before damage is applied. |
secondaryDamage | float | 0 | Optional second damage hit applied to the same locked targets. Fixed base amount before character bonuses; does not scale with charge. |
secondaryDamageDelay | float | 0 | Seconds 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
| Field | Type | Default | Notes |
|---|---|---|---|
shieldAbsorb | float | 0 | Hit points absorbed by the shield. |
shieldDuration | float | 0 | Seconds before the shield expires. Use 0 to keep it active until the absorb pool is depleted. |
shieldVFX | GameObject | null | Persistent VFX attached to the shielded target. Managed by ShieldVFXLifetime; auto-removed when the shield expires or the absorb pool is depleted. |
Heal
| Field | Type | Default | Notes |
|---|---|---|---|
healAmount | float | 0 | Instant heal applied to the target. |
healingDelay | float | 0 | Seconds after locking in a target before the heal is applied. |
Heal over Time
| Field | Type | Default | Notes |
|---|---|---|---|
hotTickAmount | float | 0 | Heal per tick. |
hotTicks | int | 0 | Number of ticks. |
hotInterval | float | 1 | Seconds between ticks. |
usePulseHealing | bool | false | Delivers HoT as area pulses at the spell location. |
Pulse damage
| Field | Type | Default | Notes |
|---|---|---|---|
usePulseDamage | bool | false | Enables pulse damage. |
pulseDamageIsDoT | bool | false | When 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. |
pulseCount | int | 0 | Number of pulses after landing. Set to 0 to disable custom pulses. |
pulseInterval | float | 0 | Seconds between pulses. 0 = default 1 second. |
pulseRadius | float | 0 | For 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. |
pulseDamage | float | 0 | Damage per pulse. 0 = ability's base damage. |
pulseVFXLifetime | float | 0 | Seconds 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
| Field | Type | Default |
|---|---|---|
statusEffect | StatusEffectType | โ |
statusDuration | float | 0 |
statusValue | float | 0 |
Chain lightning
| Field | Type | Default | Notes |
|---|---|---|---|
chainTargets | int | 0 | Max total enemies struck, including the initial target. 0 disables chaining. |
chainDamageFalloff | float | 5 | Flat damage removed per jump. |
chainRadius | float | 6 | Max distance from previous enemy to the next chain target. |
Crowd control
| Field | Type | Default | Notes |
|---|---|---|---|
crowdControlType | AbilityCrowdControlType | None | None, Pull, or KnockUp. |
pullDestination | AbilityPullDestination | CastPoint | CastPoint or ConeApex. |
pullSpeed | float | 8 | Max pull speed in m/s. |
pullStopDistance | float | 1.25 | Distance at which pulled targets stop. |
pullDuration | float | 0 | Duration of continuous pull effects. |
knockUpHeight | float | 2.5 | Peak vertical height in metres for KnockUp. |
knockUpDuration | float | 0.8 | Total arc duration in seconds for KnockUp. |
VFX prefabs
| Field | Notes |
|---|---|
castVFX | Spawned at the spell destination (or at the caster when castVFXAtCaster is true) on release. |
castingVFX | Looping VFX attached to the caster during aim. Removed on release or cancel. |
healVFX | Played on each ally healed; plays on each HoT tick. |
hitVFX | Spawned at each target hit. Attached to the target's transform when hitVFXFollowsTarget is true. |
shieldVFX | Persistent VFX attached to a shielded target. See Shield section above. |
chainVFX | Connector 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
| Field | Notes |
|---|---|
castSFX | Positional audio played on cast. |
hitSFX | Positional audio played on hit. Requires hitVFX to be assigned (they share the same network broadcast). |
sfxVolume | Volume 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
| Field | Type | Default | Notes |
|---|---|---|---|
launchProjectile | bool | false | When true, direct shape damage (Cone, Rectangle, Circle) is bypassed and a PlayerProjectile is spawned at the cast origin. |
projectilePrefab | GameObject | โ | Networked projectile prefab. Must have NetworkIdentity, a trigger Collider, and PlayerProjectile on its root. Assign via the Spell Forge VFX tab (โ Projectile). |
projectileSpeed | float | 20 | Travel 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.
| Field | Type | Default | Notes |
|---|---|---|---|
combustionPoints | int | 0 | Combustion awarded when the ability's projectile deals health damage. Normal hits award the full value; critical hits award double. |
spendCombustion | bool | false | When 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:
| Value | Integer | Behavior |
|---|---|---|
| None | 0 | No CC. |
| Pull | 1 | Targets are moved toward pullDestination at pullSpeed. |
| KnockUp | 2 | Targets 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.Staggerfor 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:
- Cancels any active aim.
- Snapshots the current cursor aim direction.
- Calls
BeginCommittedCastdirectly โ no targeting or confirmation phase is shown. - 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:
shieldDurationseconds elapse (timed shields).- The target's
HasShieldtransitions 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 index | Ability | Scaling stat | Bonus damage per point |
|---|---|---|---|
| 4 โ Arcanist | Ice Spikes | Intelligence | 0.25 |
| 2 โ Night Hunter | Blade Flurry | Agility | 0.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:
| Ability | Object or path scaled |
|---|---|
| Runic Snare | ShockMineBehaviour.damage |
| Counter Blow (Templar) | KineticReversalHandler release damage |
| Shieldwall Charge (Templar) | DashHandler.BreachSlam slam damage |
| Spirit Wisps | NaniteSwarm.chipDamage |
| Null Field | NullFieldZone.decayDamagePerSecond |
| Turret-spawning abilities | TurretController.damage |
| Cursed status effect | Status effect value at application |
Related: Combat Core and Loop ยท Heroes & Classes ยท Editor Tooling