Skill kinds (what a skill object does, per behavior / skill set)

Decoded from the executable’s skill-object code (our reading of the machine code; addresses only in the branch report) and written by skilldata.py as skills.json kind (see the end of this section). Units: tick = 1/30 s, u = game unit = 0.1 m, record fields s16. “v / 10.8” is a speed in u per tick (= raw / 3.6 m/s), as in “Straight behavior”.

Dispatch

When the cast releases (see “Cast animation profiles”), the game creates one skill object and picks its code from two tables of {init, update} handlers:

id kind (kind.name) usable records (this build) type
0 straight 95 (set 0) attack, erase, special, status
13 melee 29 attack, special, erase
4 auto 20 erase, special, status
12 blade 19 attack, status, erase, special
1 parabola 13 attack, erase
8 mine 13 status, attack, erase, special
6 multishot (curving shots) 11 attack
5 crawl (floor-hugging homing shot) 10 attack, status
20 rain 9 attack
16 hole_all 7 attack, erase
2 fall 6 attack
17 ricochet 5 attack
9 burst (mine_burst) 5 attack, status
15 hole 3 attack, status
7 fast_rain 3 attack
10 moving 3 attack
14 pursuit 2 attack
11 kinesis 2 attack
set 2 defense 47 defense
set 4 status 34 status, special, erase
set 5 environment 30 environment
set 1 erase 9 erase
set 3 special 9 special, status
set 6 (no handler) 2 attack

Rules shared by all kinds

Melee (13), blade (12) and pursuit (3, 14)

(melee run 11-11; built in godot/scripts/combat/melee_attack.gd, melee_lunge.gd. Confidence H unless marked.)

The lunge (cast state 12). Every skill of set 0 with behaviour 3, 12, 13 or 14 starts the cast in the lunge state (the local cast set-up 0x14025a77d..0x14025a854; the remote-cast copy at 0x140190430). It is set up once, at the cast start, from the ground cast profile and the record:

Per tick (0x14025be40): while the wait runs, the caster turns toward its target (without one: the cast yaw) by the character’s own turn step (charaset, 20°/tick for the playable cast); the wait counts down when the animation’s frame step passes (once per tick at our speed, M). Then for the n lunge ticks: with a target, it turns toward it by at most the turn rate and, while the horizontal distance d to it is over 11 u (.rdata 0x1402f7f90), moves along its facing (0x14024f9c0; skipped while 0x14024d4d0(C + 0x40, 4) is set) by the speed, or by speed − (d − 11) once the speed would pass the stop point (as read, 0x14025c063..0x14025c084: not the clamp to d − 11 one would expect; re-read and confirmed (doc-answers), H in code: the lunge ends at 11 − speed..11 u and the body push then holds 10 u, “Open questions settled” 4). Without a target it only turns toward the cast yaw. A lunge kind gets a target only within the lock’s near range (8 m, “Lock-on”).

The attack point. The cast’s effect instance (spawned at the cast start from the profile’s 0x04 effect, or record 0x20 without a profile; handle at C + 0x13b20, effect number at C + 0x13b24) follows the caster’s root matrix. 0x14018a310 gives the attack matrices: for each model of the effect’s current slot, the skeleton joints whose name tag (joint record + 0x2C) masked with 0xFFFFFF00 is 0xB3D8C500 (a fixed prefix plus a two-digit number NN) give attack point NN − 1 = effect root × the joint’s translation, rotation and scale. With none, it falls back to the caster’s joint tagged 0xADB07630 (0x14018aa50), the right hand (joint 38 of the playable models, PdCharacter.HAND_BONE). Skeleton joint records are 0x40 bytes: nine floats (position, rotation, scale), u16 flags at 0x24, parent s16 at 0x2A, name tag u32 at 0x2C. None of the effects the melee, blade and pursuit records use has attack joints (only 13 effect files in the data do), so for these cards the point is always the right hand.

Melee (13) (init 0x14026a020, tick 0x14026a0d0): lifetime L = the ground profile’s 0x58 − 0x56 (active end − release); the object ends at once without a profile or while the caster’s status +0x10 is set. Radius 0x7C × 0.1 u; the caster’s own hit bit is cleared. Every tick: the attack point (above); every character is tested (0x14026c340); the stage props once (flag 0x400) at chest + facing × 20 u (0x1401633b0); then the counter: nonzero → decrement, zero → end. So the object hits on L + 1 ticks.

Pursuit (3, 14) (init 0x140265d60, tick 0x140265e00): a sphere of 0x7C × 0.1 u on the caster’s chest, no lifetime; one tick: if the caster has a locked target, that target alone is tested (0x14026c340), then the object ends. The “chase” is the lunge above.

The hit test (0x14026c340, melee and pursuit). The target’s hit bit must be set and the target alive; distance from the object’s point to the target’s point (record + 0x60) < object radius + target radius (+0xb0: the character table radius, 5 u for the playable cast; corrected 11-12, was “10 u”); line of sight from the caster’s chest (position + centre height, +0x1a4) to the target point (0x1401641b0); then, if the target has a live defense (0x14026ee80), the defense check (0x14026dcb0) along the path from the target’s point to chest + 10 u × normalize(chest − target point), i.e. a point 10 u behind the attacker. Not blocked: the guard test 0x14026ecc0, then the hit 0x14026f870 (damage, reaction, hit effect, as a shot’s).

Blade (12) (init 0x140269c60, tick 0x140269db0): lifetime as melee; blade length 0x7C × 0.1 u. Each tick the blade runs from the attack point along the point matrix’s Z row for that length; the quad swept between last tick’s blade and this tick’s (two triangles) is tested against a 12 u sphere at each character’s point (.rdata 0x1402f7f9c; fixed, not the character radius) in 0x14026c730, then line of sight from the chest and the defense check with the same path as melee, then the same hit calls. Stage props along the segment, once.

Defense check for these kinds (0x14026dcb0). The attack’s radius (+0x190: the sphere’s, the blade’s length) pads the shapes. Types 0, 3, 4 (planes, 0x14026de21): the path is tested against the two planes the radius in front of and behind the barrier plane (the endpoints’ sign products ≤ 0, i.e. from either side), and the crossing point must lie within defense radius

Repelled end. A held or stopping break by a type-3 defense ends the attack with end reason 7 (0x14026cd70, jump table at 0x14026d79c, case 0x14026d368): for behaviours 3, 12 and 13 (not 14), with the caster alive (status +0x34 ≠ 0) and its status +0x10 clear, the caster starts action 26 (0x140258690) at its current facing. Action 26 is a type-3 (front/back) action, animations [121, 122] (rules.json repel_action). Other kinds turn around at reason 7.

Ground and air. The lunge state is chosen before the air state for these kinds. The gravity during the lunge was not followed. No close-range record has an air profile: the record’s 0x16 is 0 for all 50 (melee 29, blade 19, pursuit 2; anim.profiles.air = null in skills.json, checked 11-12), so by “Choosing the profile” an air cast plays the ground profile: its slot, release tick, active end and its lunge frames. The lunge in the air therefore uses the same frames as on the ground (MeleeLunge.from_record reads profiles.ground).

Auto (4): no projectile

Parabola (1)

Fall (2)

Multishot (6): curving shots

Crawl: floor-hugging homing shot

Mine (8)

Burst (9, mine_burst)

Hole (15) and hole_all (16)

Rain (20)

Rare kinds (parameters located, behaviour partly followed)

Defense (set 2)

Record fields: 0x54 type (0..7), 0x56 radius × 0.1 u, 0x58 lifetime + 2 ticks (lifetime = 0x58 − 2), 0x5A durability (+ 0x5C per use), 0x5E = 1 anti-pierce, 0x60 = 1 add-on for melee-type attacks only, 0x62 add-on with value 0x64 (below). 0x66 not followed.

Instant sets (1 erase, 3 special, 4 status)

The object applies its effect once at spawn and ends. Set 1 calls the erase routine, set 3 dispatches on 0x54 (with 0x56..0x5A as values); both are decoded in “Skill casting leftovers” (set 1 acts on field capsules, set 3 is jumps, teleports, levitate and the evades).

Status set (4). 0x54 = who: 0 the caster, 1 its locked target (no target: nothing), 2 every living character. Each of them gets up to four effects i = 0..3: id 0x56 + 2i (0 = none), value 0x5E + 2i, ticks 0x66 + 2i, through one 23-way switch on the id:

id effect
1 aura level + value (the level routine; bounded as in “Combat rules”)
2 aura + value
3 health + value (the health-change routine)
4, 5, 6, 7 add to status slot 0, 1, 2, 3 (strength, speed %, homing %, regen %), timed by ticks
8 when any slot is set: the status reset routine
9 aura + (value − 1) × current aura (when aura > 0)
10 aura level + the current level (doubles it)
11, 15 start a stance action (a character action with the record’s animation; 15 with action 0x16)
12 slot 8 (no lock-on) = 1, timed by ticks (0: permanent)
13 slots 8 and 11 = 1 (+ a float routine)
14 slot 33 (hit immunity) = 1, timed by ticks
17 slot 37 = 1 (team chat; no gameplay effect)
18 copy the target’s slots 0..3 (base, timed value, ticks)
16, 19..23 card / deck effects (decoded 11-10, see the full section)

Status slots

Each character has 47 slots of 12 bytes at status record + 0x61B8: {base, timed value, ticks left}. Three routines touch them:

What a slot means: an environment record of effect type k (set 5, 0x54) adds its 0x58 to slot k of every character, through the read routine above. So the slots mean what the environment records do. This is our reading of their effects, checked against the code paths that test the slots:

slot meaning slot meaning
0 strength: + damage of own attacks 21 / 22 attacks above / below a damage are banned
1 movement speed % 25 erase skills banned
2 homing % 29 no aura regen while moving
3 aura regen % (the s of “Combat rules”) 30 costs doubled (> 0) or halved (< 0)
4 bound (can’t move) 31 attack bonuses / pierce off
5 skill buttons locked 32 every skill single-use
6 each skill press costs health 33 hit immunity
8 can’t be locked on to 34 capsule respawn delay + value ticks
11 levitate 35 directional controls inverted
17 / 18 / 19 health per cast / per capsule / per aura particle 36 skill buttons scrambled
20 every attack pierces 38 / 39 skills above / below a cost banned
41..45 one school banned each

Slots 7, 9, 10, 12..16, 23, 24, 26..28, 40 and 46 are in the complete table of “Status slots, hit effects and environments in full” (docs 11-10).

Environment (set 5)

One environment slot per caster: casting stores the caster’s position and the skill, with expiry = now + 0x5A ticks when 0x5A > 0, else none (it lasts until erased or captured; a cast while another environment is active stores nothing, so it is not replaced: corrected 11-10). 0x54 is the effect type, 0x58 its value; 0x56 is the capture guard time. The effect type is a status slot number. While an environment is active, every status read of slot 0x54 adds 0x58 (see “Status slots”). Which environment counts, how they end and the capture are in “Status slots, hit effects and environments in full”.

Hit effects (set-0 field 0x62, values 0x64 / 0x66)

Applied to the character an attack hits, after the damage; a 52-way switch on 0x62 (0 = none).

Not decoded

The card effects 0x5C..0x60, knockdown and the hit animations 0x6E..0x74, kind 7 (partly, see “Skill casting leftovers”), the object side of kinesis, the exact pass list of an auto-shelter. Slots, status effects, hit effects and environments are in “Status slots, hit effects and environments in full”; the formulas, the erase and special sets, ricochet, the kinesis cast side and mine mode 2 are in “Skill casting leftovers” (both docs 11-10).

skills.json kind (one object per skill, additive): name, then the fields above in game units with suffixes: _ticks, _u (0.1 m), _upt (u per tick), _deg, _deg_per_tick (× the homing percent p at runtime), plus hit (swept_sphere, bone_sphere, swept_blade, direct, area, none), pass_through, explode_radius_u (hit effect 5), ignores_walls (0x6A = 2 or 3), pierce (0x68 = 2). Melee, blade and pursuit get lunge_distance (0x7E), lunge_turn_deg_per_tick (0x80 / 10), lunge_track (0x82 ≠ 0), radius_u (melee, pursuit) or length_u and target_radius_u (blade), life_ticks (the active window; pursuit 1). Defenses get type, placement, shape, radius_u, life_ticks, durability, durability_per_use, passes, response, auto (type 7), anti_pierce, addon (heal_blocked, aura_blocked, erase_card, bind_attacker, lock_attacker_skills, other, capture_card; null = none), addon_value, addon_melee_only. Status records (set 4) get target (self, target, all) and effects (id, effect (our name), slot, value, ticks). Environments get slot and slot_name, value (0x58), duration_ticks (0x5A, null = none) and capture_guard_ticks (0x56; envs: read as one four-field record, EnvRecord in skilldata.py).