Animation timing: modes, records, the schedule, the frame advance, rates, breakpoints and the gates
Purpose
Section titled “Purpose”When a unit enters a mode, the server looks up the mode’s animation record, sets the unit’s frame fields, computes its rate from the unit’s stats and weapon, and either schedules the mode’s frame events and its end on the game frames they fall on, or (for a monster’s every-frame modes) advances the frame once per game frame. The frame events run the do function, the melee strike and the sequence steps; the end starts the next mode. This page specifies that machinery for players, monsters and objects, the rate of every mode and the breakpoints it gives, and the gates that sit on it: the do frame, the skill delay, hit recovery, the block, the get-hit roll and the player’s mode tests. How far a moving unit gets per frame is anim/movement. Which mode a unit is asked to enter, and when, is an input: the request for a player, the AI’s command for a monster (phase (5)). Overview and boundary: anim.
Entry points
Section titled “Entry points”| When | Function | Tag |
|---|---|---|
| A unit’s mode changes | UNIT_SetMode → UNIT_AnimInit |
[C] (every new-mode set followed by one UNIT_AnimInit rate call or an object start, 280 292) |
| A server player or monster mode starts | SUNIT_AnimInit |
[C] (its rate call precedes all 46 722 schedules) |
| A scheduled mode’s events are queued | SUNIT_ScheduleModeEvents |
[C] (25 848 schedules) |
| An every-frame mode starts | SUNIT_ModeEveryFrame |
[C] (9 682 starts) |
| Each game frame, the unit event lists run | GameRunUnitEvents |
[C] (families tick and run) |
| An every-frame monster’s frame advances | UNIT_AnimAdvance |
[C] (4 110 advances over both parts) |
| A unit’s rate is (re)computed | UNIT_AnimSetRate |
[C] (298 373 calls) |
| A player’s mode ends | PlayerModeEnd |
[C] (10 718 kind-1 dispatches; g_PlayerEventFuncs[1] is this function) |
| A monster’s mode command | MonSetMode |
[C] the start’s order, rate, cancels, then schedule or every-frame event (140 936 starts); [I] that each logged start is MonSetMode’s (SUNIT_AnimInit’s callers not scanned) |
| A hit reaches the defender’s mode | COMBAT_GetHit |
[C] the commands by result bit; [I] the town return and the kill branch (M1) |
| The get-hit decision | GetHitRoll |
[C] (7 195 calls) |
| A player mode request is tested | PlrModeLeaveOk, PlayerModeAllowed |
[C] (26 574 PlrModeLeaveOk and 50 321 PlayerModeAllowed returns at the requests) |
Inputs
Section titled “Inputs”Tables
Section titled “Tables”| Anchor | Used for |
|---|---|
animdata.d2 (animdata#layout: name, frames, speed, events) |
the record of a mode: length, speed, the event byte of each frame (§ B) |
PlrType.txt:Token, MonStats.txt:Code, ObjType.txt:Token |
the first part of the record name (§ B) |
PlrMode.txt:Token, MonMode.txt:token, ObjMode.txt:Token |
the mode token of the name (§ B) |
CharStats.txt:baseWClass, Weapons.txt:wclass, Weapons.txt:2handedwclass, MonStats2.txt:BaseW |
the weapon class of the name (§ B) |
MonStats2.txt:compositeDeath, MonStats2.txt:mDT (the m<mode> bits), MonStats2.txt:A1mv (the *mv bits) |
the death record, the modes a class has, the every-frame attack and skill modes (§§ B, I) |
States.txt:gfxtype, States.txt:gfxclass, States.txt:meleeonly |
the shapeshift display and its attack base (§§ B, J) |
Skills.txt:seqnum, Skills.txt:seqtrans, Skills.txt:UseAttackRate, Skills.txt:interrupt, Skills.txt:delay, Skills.txt:durability |
sequences, the rate branch, the mode tests, the delay (§§ G, J, L, M) |
MonStats.txt:Sk1mode, MonStats.txt:Skill1, monseq (MonSeq.txt:sequence, mode, frame, event) |
a monster’s sequence (§ G) |
MonStats.txt:SplGetModeChart, MonStats.txt:SplEndGeneric, MonStats.txt:SplEndDeath, MonStats.txt:aidel |
the monster mode overrides and ends (§ I) |
Objects.txt:FrameCnt0, Objects.txt:Start0, Objects.txt:FrameDelta0, Objects.txt:Sync, Objects.txt:Mode1, Objects.txt:Mode2, Objects.txt:FrameCnt1 |
an object’s frame fields, its start draw and its operate end (§§ C, I) |
Missiles.txt:animrate, Missiles.txt:AnimLen |
a missile’s frame fields (§ C) |
ItemStatCost.txt:Stat (stats 67–69, 93, 95, 96, 99, 102, 105, 164), ItemStatCost.txt:damagerelated |
the rate terms (§ J), the block gate (§ M) |
Weapons.txt:speed, Weapons.txt:hitclass, MonStats2.txt:HitClass, Missiles.txt:HitClass (codes: HitClass) |
the attack rate (§ J), the hit class (§ M) |
Runtime state
Section titled “Runtime state”| State | Type | Source |
|---|---|---|
Unit+0x44 |
i32, frame 8.8 (a scheduled mode: the schedule’s game frame << 8) |
§ C, § E, § F |
Unit+0x48 |
i32, length, frames << 8 (a sequence: the frames left << 8) |
§ C, § G |
Unit+0x4C |
i16, rate 8.8 per game frame, clamped to [0, 0x7FFF] |
§ J |
Unit+0x4E |
u8, the event byte of the frames last crossed (1–4), else 0 | § F, § G |
Unit+0x50 |
the animdata.d2 record (AnimDataRec) |
§ B |
Unit+0x30, Unit+0x34, Unit+0x38, Unit+0x3C, Unit+0x40 |
a sequence’s frames, length << 8, position 8.8, step 8.8, current frame’s mode |
§ G |
Unit+0xC4 |
bit 6 (the do ran), bit 14 (sequence mode changed), bit 19 (monster mode command) | § G, § L |
Unit+0x20 |
the unit seed (Seed64, rng) |
the object start draw (§ C), the get-hit roll (§ M) |
Game+0xA8 |
i32, the current game frame T |
§ E, § H |
| the unit’s stat lists | stats 67, 68, 69, 93, 96, 99, 102, 105 as the aggregate holds them | § J |
Inputs and oracles
Section titled “Inputs and oracles”| Input | How it enters | Tag |
|---|---|---|
| The mode request (a player’s packet, the pilot’s client) and the AI’s command | logged and taken as given; the server’s handling from the request on is specified | [C] |
| The stats behind the rate | values of the aggregate | [C] |
Constants
Section titled “Constants”| Name | Value | Tag |
|---|---|---|
| fallback record | 2 048 frames, speed 256, no event byte | [C] (4 834 returns in play) |
| event-byte scan bound | frames < 0x90 (144) |
[C] (family sched: 158 cases with events past 0x90) |
rate bonus k |
120 (stats 93, 99, 102, 105), 150 (stat 96) | [C] |
| attack and default factor clamp | 15..175 | [C] the attack’s 175; the attack’s 15 at X 10 and the default’s 15; [I] the attack floor’s threshold for X 11–14, the default’s 175 |
| cast factor cap | 175 | [C] |
| player sequence attack term | −30 | [C] |
| block gate | ⌊stat 102 / 8⌋ + 15 frames |
[C] |
PlrModeEndPending slack |
5 frames | [I] |
Algorithm
Section titled “Algorithm”A. The two clocks and the event kinds
Section titled “A. The two clocks and the event kinds”- A1. [C] Two clocks. A player’s attack, cast, skill, get-hit, block, death and sequence modes, and a monster’s
A1–S2, get-hit, block and death modes outside its
*mvbits, are scheduled at their start: one pass ofSUNIT_ScheduleModeEventsqueues a unit event of kind 0 per frame-event byte on the game frame it falls on and one event of kind 1 (the mode end). A monster’s walk, run, knockback and sequence modes, and its A1, A2, SC and S1–S4 modes whose MonStats2*mvbit is set, run an every-frame event that steps and callsUNIT_AnimAdvance. Every player and monster start of the 131 logs falls on the clock stated, with 0 mismatches (players schedule modes 0, 4, 7, 9–12, 14–16 and 18 and run 2, 3 and 19 every frame; S1 127 times and S2 16 times every frame by*mv). The schedule and the advance themselves are E1’s and F1’s. [C] - A3. [I] Event kinds: mode start (inputs the mode, type, class, transform states, used skill, weapon
items, record, the rate’s stats and
T; outputs+0x10, the frame fields, the queued kind-0/1 events; the object start draw only), frame event (kind 0 with codeaand indexb; outputs the mode frame function’s effects), mode end (kind 1; outputs the next mode and its start), frame advance (every-frame monsters; no draw), rate change (§ J; no draw, no queued event). [C] The draws in it: a second tool finds none under the advance (27 functions), the rate (101) or the schedule (34), and the object start draw is the only one at a start. The input and output lists stay as read.
B. The animation record
Section titled “B. The animation record”B1. UNIT_AnimSetRecord(unit, type, class, mode): [C] (UNIT_AnimSetRecord, ANIMDATA_Lookup, COMPOSIT_BuildCofName, all of B1) (type, class, mode) are the display values (B3) name ← token(type, class) ‖ modeToken(type, mode) ‖ weaponClass(unit, type, class, mode) ; spaces removed unit.+0x50 ← ANIMDATA_Find(name) or, when none, the fallback record (2 048 frames, speed 256, no event) ; [C] none for an absent name; the fallback's values: 4 834 returns in play
B2. ANIMDATA_Find(name): [C] (ANIMDATA_Find, all of B2) uppercase name in place ('a'..'z') block: u8 ← (sum of the name's bytes) & 0xFF for each record of that block, in order: fatal if the name is longer than 8 characters ; inside the loop: an empty block returns none fatal if the record's name is longer than 8 characters ; [I] read from the code, no stock record if the record's first two dwords equal the name's: return it return none-
B1. [C] The name, met at all 298 373 logged rate calls: a player’s PlrType token, the PlrMode token (
GHfor modes 18 and 19), andCOMPOSIT_WeaponClass(CharStatsbaseWClasswithout a weapon, the item’s one- or two-handed class,hthin modes 0 and 17 and for a throw with a class other than1hs,1ht,1js,1jt,1ss,1st, the dual classes1ssandht2); a monster’s MonStatsCode, the MonMode token (KB→GH) and MonStats2BaseW(hthin modes 0 and 12 withoutcompositeDeath); a shapeshifted player’s display class with the mode mapped throughg_PlrToMonModeand its fallback chain. -
B1. [C] The fallback record is returned in play: 4 834 times in 11 sessions (
MonStatsSpeedsat the load 4 202,UNIT_AnimSetRecord632 for classes FS, BN and MO in mode 14), each with frames 2 048, speed 256 and the name and 144 event bytes zero, its name absent fromanimdata.d2. -
B1. [I] Which Items codes carry the class indices 2 and 3 (
1hsand1htby the stock code map) isg_ItemWeaponClassIndex’s runtime content; no case separates them. A right hand that is not an item unit returns 0 with the index unwritten. An object’s name is its ObjType token, the ObjMode token andhth, but the server never looks an object’s record up (C3). -
B2. [C] Duplicate names. Of two records with one name (29 names in
animdata.d2, 9 with different content), the one earlier in its block wins (87 of 87 duplicate cases, run whole on the stock file). [I] That the block order is the file’s (the loader’s walk, not run), and that only%s\AnimData.d2underDATA\GLOBALis loaded (d2exp’s copy by the archive precedence;eanimdata.d2is not read by this loader). -
B2. [I] The compare is of the first two dwords of the 8-byte buffers, bytes after the NUL included; no stock name leaves room for such bytes.
-
B2. [I] The COF bundles are not a source. The client loads
cmncof_a*.d2into its own COF cache, which only its drawing reads; 11 bundle COFs differ fromanimdata.d2in frames per direction and 2 in event frames, and none of that reaches the server’s mode lengths, which come fromanimdata.d2alone. -
B3. [C] The shapeshift display. With
Unit+0xC8bit 3 set, the first state of the DataTables transform list that the unit has decides: Statesgfxtype1 shows a player as a monster of classgfxclass(its mode mapped byg_PlrToMonModeand the MonStats2 fallback); the record, the start frame and the rate all take the display values (758 transformed calls of the werewolf and werebear, display classes 430 and 431). -
B3. [C] The fallback’s steps (maps, every callee run): down 5, 7 → 4; 6 → 3; 9–11 → 8; 15 → 2; others → 1 until MonStats2
mDT…mRNhas the mode (bitmof the u16 at+0xF0is them<mode>column on all 609 rows), over the 20 player modes on all 734 stock MonStats classes.gfxtype2 shows a monster as a player of classgfxclass, its mode mapped byg_MonToPlrMode, except display class 6 in monster mode 4, which takes player mode 12. A form of the other kind (gfxtype1 on a monster, 2 on a player) sets the display type and class and keeps the mode. -
B4. [C] A record’s
framesgives+0x48 = frames << 8at every non-sequence start (all 45 913 non-sequence schedules and 907 first every-frame advances), and the schedule reads its event byte for framefonly forf < 0x90. [I] Itsspeedis the base of the rate (§ J), and the advance’s own0x90bound (F1) is read from the code.
C. The mode start
Section titled “C. The mode start”C1. UNIT_SetMode(unit, mode) → bool: [C] (UNIT_SetMode, all of C1 but the lines marked) if unit is null or unit.type = 5: return 0 ; [I] no stock case if unit.mode = mode: refresh only (no animation start); return 0 unit.mode ← mode; drop the stat lists flagged to end on a mode change ; [I] the drop UNIT_AnimInit(unit); return 1
C2. UNIT_AnimInit(unit): [C] (UNIT_AnimInit, all of C2) +0x4E ← 0; +0x44 ← UNIT_AnimStartFrame(unit) << 8; (type, class, mode) ← display values type 0 (player form): if mode ∈ {3, 19}: RunVelocityStat (anim/movement A2) if mode ≠ 18: +0x30 ← 0; UNIT_AnimSetRate; +0x48 ← rec.frames << 8 else: UNIT_SeqInit; UNIT_AnimSetRate type 1 (monster form): a player shown in mode 13 or 15: RunVelocityStat ; shapeshifted: 833 rate calls equal (H6d) if mode ≠ 14: UNIT_AnimSetRate; +0x30 ← 0; +0x48 ← rec.frames << 8 else: UNIT_SeqInit; UNIT_AnimSetRate type 2 (object, mode < 8 else fatal): +0x48 ← Objects.FrameCnt[mode] ; already << 8 at load +0x44 ← Objects.Start[mode] << 8 fd: i32 ← (i16) Objects.FrameDelta[mode] if Objects.Sync ≠ 0: +0x4C ← fd else: d: i32 ← 0 if (fd >> 3) ≥ 1: d ← RNG.RangeB(seed: unit.seed, n: fd >> 3) ; draw#1 +0x4C ← clamp(fd − (fd >> 4) + d, 0, 0x7FFF) ; >> arithmetic type 3 (missile): +0x4C ← Missiles.animrate × 256 ÷ 1024; +0x48 ← (u8 AnimLen) << 8 ; 0 without a row ; ÷ truncates toward zero: a negative animrate rounds up type 4 (item): mode 3: +0x4C ← 0, +0x48 ← 0x1100, +0x44 ← 0x1000; mode 5: +0x4C ← 0x100, +0x48 ← 0x1100
C3. SUNIT_AnimInit(unit): [C] (SUNIT_AnimInit, all of C3) +0x4E ← 0 if (monster in mode 14 or player in mode 18) and the used skill has a sequence record: UNIT_SeqInit; UNIT_AnimSetRate; return +0x30 ← 0; +0x44 ← 0 if unit has a path (+0x2C): UNIT_AnimSetRate else UNIT_AnimSetRecord(unit, unit.type, unit.class, unit.mode) ; the unit's own +0, +4, +0x10 +0x48 ← rec.frames << 8-
C1. [C] In
UNIT_SetMode, a request for the mode the unit is already in runs noUNIT_AnimInit(no draw; 42 445 same-mode sets against 280 292 new-mode starts). A server mode start still resets the frame through C3 (+0x44 ← 0), so a monster restarted in its mode by a new hit starts its animation again (F1; 9 restarts whose first advance starts from 0 afterSUNIT_AnimInit’s rate call only). -
C2. [C] The object start draw. At 725 logged object animation starts the rate is
FrameDelta − (FrameDelta >> 4) + drawwith draw#1RangeB(object seed, FrameDelta >> 3)whenSyncis 0 (490 starts) and no draw otherwise (235), and+0x44,+0x48as C2. The draw’s place in the object seed’s draw order is objects § G’s; no chained pair of two start draws on one object was logged (7 pairs, each with another draw between). [I] -
C2. [C] An object’s server frame fields come from the Objects row, never from its
animdata.d2record: the object branch, [), calls only the Objects row lookup andRNG_RangeB, neitherUNIT_AnimSetRatenorUNIT_AnimSetRecord. The Objects loader shifts the eightFrameCntdwords left by 8, so an object’s+0x48is 8.8 like every other type’s (eightshl … 8). [I] So a disagreement between the two (FrameCntequals the record’sframesin 1 173 of 1 483 joined modes) has no server effect. -
C3. [C] A scheduled mode starts from C3’s
+0x44 ← 0, written before its rate call whatever C2 set (335 path cases); the schedule reads the start frame fromUNIT_AnimStartFrameitself (§ E; 45 913 schedules). C3’s second rate call, after C2 has written the new+0x48, is the one that sets the rate a schedule uses (all 168 starts whose two rates differ). [C] The rate call leaves+0x44as at its entry (48 118 of 48 118 logged calls), and atSUNIT_AnimInit’s 17 005 calls+0x44is 0 at entry and exit. [I] That it is still 0 when the schedule reads it: the schedule’s entry value is not logged.
D. The start frame
Section titled “D. The start frame”D1. UNIT_AnimStartFrame(unit) → i32: [C] (UNIT_AnimStartFrame, g_AttackStartFrames, all of D1) if display type = 0 and (mode ∈ {7, 8} or (mode ∈ {15, 16} and UNIT_CanDualWield(unit))): ; the S3/S4 half returns 0: see D1 below item ← SkillSrcDamWeapon(unit, 1) wc: i32 ← item ? ItemWeaponClassIndex(item) : 0 ; bow 1, 1hs 2, 1ht 3, stf 4, 2hs 5, 2ht 6, xbw 7, ht1 12, else 0 return g_AttackStartFrames[wc × 7 + class] return 0-
D1. [C] The return equals
g_AttackStartFrames[wclass][class]at all 25 149 logged schedules that read it: 1 or 2 in the Amazon’s and the Sorceress’s A1 with a weapon, 0 elsewhere. -
D1. [C] The table’s non-zero cells are those two classes’ only: 1 for hand to hand, 2 for
1hs,1ht,stf,2hsand2ht; rowsbow,xbwandht1are 0 for every class (a second read, the 12 non-zero cells exactly). The S3/S4 dual-wield half reads its cell only for classes 4 and 6 (the trace’s), and every class-4/6 cell is 0, so that half returns 0 whatever the weapon class (BAS31SS,AIS4HT2met in the run). [C] The start frame is added at the schedule’s start (E1) and after each wrap of the advance (F1; 478 wraps with start frame 1).
E. The schedule
Section titled “E. The schedule”E1. SUNIT_ScheduleModeEvents(game, unit): [C] (SUNIT_ScheduleModeEvents, all of E1) T: i32 ← game.frame; t: i32 ← T; S: i32 ← UNIT_AnimStartFrame(unit) << 8 if unit.+0x30 ≠ 0: r ← unit.+0x3C; L ← unit.+0x34 ; a sequence else: r ← (i32)(i16) unit.+0x4C; L ← unit.+0x48 if r = 0: UnitQueueEvent(kind 1, frame T + 1); return ; [C] no logged rate is 0; 40 cases f: i32 ← S >> 8; n: i32 ← 0; acc: i32 ← S + r while acc < L: ; signed 32-bit compares t ← t + 1 while f ≤ (acc >> 8) and f < 0x90: ; [C] the 0x90 bound e ← unit.+0x30 ? SeqFrameEvent(f << 8) : rec.events[f] if e ∈ {1, 2, 4}: UnitQueueEvent(kind 0, frame t, a: e, b: n); n ← n + 1 else if e = 3: UnitQueueEvent(kind 0, frame t, a: 3, b: 0) f ← f + 1 acc ← acc + r if t = T: t ← t + 1 ; [C] no step: E2 UnitQueueEvent(kind 1, frame t + 1) unit.+0x44 ← T << 8- E1. [C] All 25 848 logged schedules (players and monsters, sequences among them) queue exactly E1’s kind-0 list and kind-1 end from the start frame, the rate and the length of the unit’s last rate call and record, and the 42 542 queued events fire at their frames unless cancelled first; no dispatch fires an event the schedulers did not queue (42 449 dispatches).
- E1. [C] Over both parts (81 logs) the closing check holds
sched34 647 schedules,fire56 941 anddispatch56 800 with 0 mismatches. - E2. [C] The length. For
L = 256 FandF > Sthe end fires atT + n,n(r) = max(2, ⌈256 (F − S) / r⌉), at every logged rate (25 848 lengths). - E2. [C] The event frames, derived from E1’s loop: with
N = ⌈256 (F − S) / r⌉ − 1steps, framef ≥ Sfires atT + k_f,k_f = max(1, ⌈256 (f − S) / r⌉), only whenk_f ≤ N; the first step carries frameSand every frame up to(256 S + r) >> 8; frames after the last step’s are never scanned; no frame event shares the end’s frame. Whenr ≥ 256 (F − S)(no step) no frame event fires at all, not even frameS’s, and the end is atT + 2. The closed forms equal the logged kind-0 list and end at all 45 913 non-sequence schedules; thek_f ≤ Ndrop and the no-step case, which no logged schedule meets, hold at 1 115 emulated schedules (128 with an event past the last step, 104 with no step and an event). - E3. [C] Reschedules (catalogue).
RescheduleSkipandRescheduleAtcancel kinds 0 and 1 and rebuild the list from an elapsed positionp(frames): steps256 p + k r < L, the scan from framep − 1, every code 1–4 queued withb = 0, no0x90bound, the end as E1.RescheduleSkip(n > 0):p = T − (+0x44 >> 8) − n(Inferno, Blade Fury), then+0x44 = (T − p) << 8;RescheduleAt(n):p = n,+0x44 = (T − n) << 8(Charge, Whirlwind, Leap Attack). Their logged lists equal this at 819 and 74 reschedules. [I] The third,RescheduleFromPct(pct), rebuilds the same way withp = (T − (+0x44 >> 8)) · (100 − pct) / 100(signed) and+0x44 = (T − p) << 8(Dragon Talon, Strafe, Fend); no logged reschedule reaches it. The arguments of all three are catalogue values. - E4. [C] Callers.
SUNIT_ScheduleModeEventshas six call sites: the player starts for get-hit, block, the two skill starts and death, andMonSetModefor a scheduled monster mode; each first cancels the unit’s kinds 0 and 1 (a second read; in all 140 936 logged starts the cancels precede the schedule). The skill starts schedule beforeSKILLS_StartUsedSkill, so a start function can still reschedule (88 player starts reschedule after it in the frame).
F. The per-frame advance (every-frame monsters)
Section titled “F. The per-frame advance (every-frame monsters)”F1. UNIT_AnimAdvance(unit): [C] (UNIT_AnimAdvance, all of F1) +0x4E ← 0 if +0x30 ≠ 0: the sequence advance (G3); return f: i32 ← +0x44 >> 8; if (i16) +0x4C ≥ 0x100: f ← f + 1 ; 16-bit signed compare +0x44 ← +0x44 + +0x4C while +0x44 ≥ +0x48: for f ..< (+0x48 >> 8): take(f) +0x44 ← +0x44 − +0x48; f ← 0; +0x44 ← +0x44 + (UNIT_AnimStartFrame(unit) << 8) ; [C] a start frame ≠ 0 for f ... (+0x44 >> 8): take(f) ; take(f): if f < 0x90 and rec.events[f] ∈ 1..4: +0x4E ← rec.events[f] (the last one wins)
F2. UNIT_AnimAtEnd(unit) → bool: [C] sequence: +0x48 < 1; else: +0x48 ≤ +0x44 + (i32)(i16) +0x4C ; a 32-bit add; fatal on a null unit-
F1. [C] 4 110 consecutive advances of windowed every-frame monsters (knockback among them) give the next
+0x44and event byte (2 924 of them part 1’s under the restart rule below). -
F1. [C] A restart is not an advance. When a new hit restarts a monster’s every-frame mode in the same mode (a mode start of the unit between two advances; the first cases were knockbacks, mode 13), the next advance starts from
+0x440, not from the previous position plus the rate; two advances pair only with no mode start of that unit between them (15 restarts over the 81 logs by that rule, a mode start of the unit between two advances; 3 in part 1’s). [C] The 0 is C3’s+0x44 ← 0, whichMonSetModereaches whether or notUNIT_SetModesaw a new mode (C1, I2): over the 131 logs, 9 restarts by a narrower rule (a same-mode set followed by an advance of that unit) runSUNIT_AnimInit’s rate call only and advance from+0x440. -
F1. [C] Below a rate of
0x100the frame the unit stood on is scanned again, so one event byte can be taken on two consecutive frames; at0x100or more each frame is taken once (604 emulated cases below0x100). -
F1. [I] A wrap on a record whose frame count is at or below the start frame never ends: the loop subtracts
+0x48and addsS << 8back. Whether a stock record reaches it is not checked. -
F2. [C] A rate call leaves
+0x48as at its entry (48 118 of 48 118 logged calls, 25 059 of them with a changed record and a non-zero length; J2). [I] The every-frame monster frame functions call F2 after advancing; the length+0x48stays the start’s, so a rate change shortens such a mode only through the frame position (no monster call outsideUNIT_AnimInit’s own changed its record in the logged sessions).
G. Sequences
Section titled “G. Sequences”G1. Which sequence record: [C] (all of G1) player: idx ← Skills[used].seqnum; monster: idx ← MonStats.Sk<k>mode ordinal, k the first with Skill<k> = used (0 when absent or for skill 199) if idx < 1: no sequence player: g_PlrSeqTables[idx] + 12 × column(weapon class) ; no bound test on idx column: COMPOSIT_WeaponClass's index through g_PlrSeqColumns, fatal when unmapped monster: the monseq sequence of that ordinal (MonSeqRecord: 0 ≤ idx < count)
G2. UNIT_SeqInit(unit): [C] (UNIT_SeqInit, all of G2) +0x30 ← frames; +0x34 ← length << 8; +0x38 ← 0; +0x3C ← 0x100; +0x48 ← frames << 8 UNIT_SeqReadFrame(0); +0xC4 |= 0x4000 ; the record is looked up three times, the second and third after ; +0x30 is written, so a player's column then comes from the mode at +0x40, not +0x10
G3. the sequence advance (in UNIT_AnimAdvance, monster mode 14): [C] (UNIT_AnimAdvance, UNIT_SeqReadFrame, SEQ_ReadFrame, all of G3) prev ← +0x38; +0xC4 &= ~0x4000 +0x38 ← +0x38 + +0x3C; if +0x38 ≥ +0x34: +0x38 ← +0x38 − +0x34 +0x48 ← +0x48 − +0x3C the frame at +0x38 >> 8: +0x40 ← mode; +0x44 ← frame << 8 +0x4E ← the last non-zero event of the rows (prev >> 8) + 1 … (+0x38 >> 8) ; its own row's when +0x38 = prev; 0 after a wrap if +0x40 changed: +0xC4 |= 0x4000 ; the mode ends when +0x48 < 1 (F2)-
G1. [C]
MONSEQ_Loadsets a sequence’s length and frame count to its row count (it adds 1 to both fields per row). The player tables have 207 non-empty entries, each with length = frames; the 25 stock rows with acharclassand aseqnumstay within the 24 entries (seqnum≤ 23). [I] A sequence frame is 6 bytes (mode, frame, direction, event, after a u16 sequence id). -
G1. [I] For a non-player unit
SkillSeqIndexreads the MonStats record with no null test, so a class out of range faults; and whenCOMPOSIT_WeaponClassleaves its index unwritten (B1: a right hand that is not an item unit) the column lookup searches with an uninitialised local. Neither is reached on stock data. -
G2. [C] The three lookups can disagree: in 9 of 223 emulated starts the length or the count came from another record than the frames. The logged monster starts show
+0x380 and+0x34 = +0x48 = rows << 8at their first advance (301 starts). -
G3. [C] 1 453 logged monster sequence advances (mode 14, the
monseqrows of the used skill) give the next position, length, frame, event byte and mode. -
G3. [C] The only stores of 0 to
+0x4Ebesides the advance are do 87’s, do 89’s and do 103’s (an exhaustive scan with a second tool). [I] In two advances the byte was 0 where the rows give 1: read as the do of that event clearing it, a catalogue write after the advance, not the advance’s result. -
G4. [C] The event of a sequence is the sequence row’s, never the
animdata.d2byte of the row’s frame, in the advance: with+0x30set,UNIT_AnimAdvancetook every output from the sequence rows while+0x50pointed at undeclared memory and no read of it was traced (1 500 cases, 647 with an event). [I] The schedule reads the sequence record too while+0x30is set (not run), and a row’sframeonly sets+0x44; somonseqsteps whose frame lies past the user’s record (249 on stock data) read nothing through the record. -
G5. [C] A player’s sequence (mode 18) is scheduled once from its step
+0x3Cand length+0x34(E1) and is not advanced on the server; at each of its frame eventsPlrModeSkillFramewrites the running event’s indexbinto+0x38 >> 8when a skill is in use. So for a player+0x38 >> 8is the index of the code-1/2/4 event being run (0 for the first), which is what skills/dispatch’s sequence delay gate and do 35’s parity read. (PlrModeSkillFrame,UnitSetSeqPos; the writer and its readersSKILLS_SrvDoand do 35 by a second read, with no server advance of a player)
H. The event queue and the frame order
Section titled “H. The event queue and the frame order”-
H1. [C]
UnitQueueEvent(game, unit, kind, frame, a, b)takes kinds below 15, raises a frame at or below the current one to the current + 1, and appends the record to slotframe & 63of the unit type’s list; a frame of −1 puts it at the head of the type’s every-frame list. (UnitQueueEvent,EventQueueAt,EventQueueEveryFrame,Game+0xA8: familyqat, 400 cases, the refused kinds, the raise, the slot and the every-frame head) -
H1. [C] A queued kind-0 event with
a ≠ 0and a kind-1 event fire at the queued frame with the queued(a, b), from the schedulers (E1) and from the catalogue’s own calls (E1, 83 dispatches). Kinds 2 and 12 are not compared:[I]. -
H2. [C] Each game frame runs the missile, player, monster, object and item lists in that order, each its every-frame list (newest first) and then the current frame’s slot (oldest first, only records whose frame equals the current one, then freed), so a unit’s every-frame event runs before its slot events of that frame (an emulation of the runners: families
tick, the ten walks in order, andrun, the every-frame list before the slot and the slot’s due records only); the frame around it, and how far windows test this order, are sim/frame § D and § K. -
H2. [C] Monsters’ every-frame walk before their slot walk, in the game’s own runs: 4 637 logged pairs in the kept corpus and 207 adjacent walks in the counted windows, none inverted; for the other types the emulation above holds the order.
-
H2. [C] The first run of an every-frame event: in the frame it is queued when queued before its type’s every-frame list is walked (the runner’s phase below 3 for players, below 5 for monsters), else in the next frame (9 682 starts; every player start ran next-frame). So the first step of a moving mode and the first knockback advance run in the start’s frame only when the start comes before the type’s list.
-
H3. [C] Dispatch, the ends. A player’s kind-1 record runs
PlayerModeEnd(g_PlayerEventFuncs[1]), and each of the 10 718 logged player kind-1 dispatches is followed in its frame by the next mode I1 gives; a monster’s kind-1 record runs its mode record’s end function (DT → 12 at 4 520, GH, BL and A1–S2 → 1 at 23 483). A monster’s kind-0 record runs the mode record’s frame function, called with the game and unit only, and its return is not used: neitherMonModeFrameEventnorMonEventDispatchtests it, and both runner sites overwriteEAXfirst. -
H3. [I] A player’s kind-0 record runs the mode’s frame function and, on its return of 2,
PlayerModeEnd.MonEventDispatchdrops every kind but 3, 4, 5, 8 and 12 while a living monster has state 1 (freeze); a dropped scheduled record is freed, so a frozen monster loses those frame events and its mode end (no frozen dispatch is logged). -
H3. [C] With no mode record or no function in it, the monster handlers call: clear the used skill and, unless the unit is dead outside DT and DD, start neutral; both handlers and
MonSetModecall it (a second read).
I. The mode machines
Section titled “I. The mode machines”I1. Players
Section titled “I1. Players”| Mode | Start | Events | End → | Tag |
|---|---|---|---|---|
| 1 NU, 5 TN | PlrModeStartNeutral (5 in a town room) |
none | — | [C] (PlrModeStartNeutral: 1 in the field 20 201, 5 in a town 131; the start table) |
| 2 WL, 3 RN, 6 TW, 19 KB | PlrModeStartMove |
every frame (PlrModeMoveFrame) |
neutral on arrival | [C] 2, 3 and 19: every start queues an every-frame event and no schedule, and the arrival sets the mode in its frame; [I] 6, not met |
| 4 GH, 9 BL | PlrModeStartGetHit, PlrModeStartBlock |
scheduled | neutral | [C] (PlrModeStartGetHit: 756 GH and 1 442 BL starts) |
| 7, 8, 10–16, 18 | PlrModeStartSkillXY / …Unit |
scheduled (PlrModeSkillFrame) |
neutral | [C] modes 7, 10–12, 14–16 and 18; [I] 8 and 13, not met |
| 0 DT | PlayerDeath |
scheduled | 17 DD | [C] (PlayerDeath: 41 death starts, 39 ends) |
-
I1. [C]
PlrModeStartMove: a walk sets 2 in the field (1 930) and a run keeps 3 in a town (981); a run with stamina 0 becomes a walk (anim/movement § D: 75 turns in the drain’s frame). Every move start queues an every-frame event and no schedule, and on arrivalPlrModeMoveFramesets the mode in the step’s frame. [I] A walk and a town walk become 6 in a town (no 6 met); knockback sets path type 8; a refused path gives neutral; otherwiseSUNIT_SetMode, cancel,SUNIT_ModeEveryFrame.PlrModeMoveFramesteps, drains a run, and on arrival sets neutral (or runs the queued interact or skill) and returns 2; soPlayerModeEndsees mode 1 or 5 and its knockback branch is not reached from this path, and no kind-1 event is queued for mode 19. -
I1. [C]
PlrModeStartGetHitandPlrModeStartBlock:SUNIT_SetMode(4 or 9),SUNIT_AnimInit, clear the used skill, cancel, schedule;PlrModeStartSkillXY: path target,SUNIT_SetMode,SUNIT_AnimInit, cancel, schedule, clear+0xC4bit 6,SKILLS_StartUsedSkill. (PlrModeStartGetHit,PlrModeStartBlock,PlrModeStartSkillXY; the rate, cancel and schedule order in every logged start; the rest by a second read)
I2. Monsters
Section titled “I2. Monsters”| Row | Mode | Frame function | End | schedule |
Tag |
|---|---|---|---|---|---|
| 0 | DT | not moving: mode 12 at once; moving: step, advance, 12 at the end | mode 12, event 13; SplEndDeath |
1 | [C] |
| 1 | NU | UNIT_CancelEvents(0, 0) |
— | 0 | [C] |
| 2, 15 | WL, RN | trails, step; arrival → generic end | — | 1 | [C] the step and the generic end on a return of 2; [I] “trails” as the meaning of WL’s state 13 and 22 calls |
| 3, 6 | GH, BL | UNIT_CancelEvents(0, 0), run at a frame event of the record |
generic | 1 | [C] |
| 4, 5, 7, 8, 9 | A1, A2, SC, S1, S2 | MonAttackFrame |
generic | 1 | [C] |
| 10, 11 | S3, S4 | S3: step, advance, at the end mode 11; S4: UNIT_CancelEvents(0, 0) |
S3: a bare ret; S4: — |
0 | [C] |
| 12 | DD | UNIT_CancelEvents(0, 0), never queued |
— | 0 | [C] |
| 13 | KB | step, advance; at the end MonKnockbackEnd |
MonKnockbackEnd |
1 | [C] |
| 14 | SQ | MonSeqFrame |
generic | 1 | [C] |
-
I2. [C]
MonSetMode(game, cmd, flag): fatal under state 54; for a mode other than 3, the path target, the move plan and the attack stats; the record’s start (0 → clear the used skill and start neutral); then+0xC4 |= 0x80000,SUNIT_AnimInit,MonModeVelocity,UNIT_SetUsedSkill(unit, 0)again, cancel kinds 0 and 1, and by the record of the resulting mode:schedule0 → no event, else every frame (A1) orSUNIT_ScheduleModeEvents. (MonSetMode,MonModeEveryFrame; the order by a second read; the rate, cancels and event by the resulting mode with 0 mismatches) -
I2. [C] Class overrides. When MonStats
+0x1A5(SplGetModeChart) is non-zero, a class switch gives: 243, 333 and 705 attack records for S3 (row 17) and S4 (row 16); 403 rows 18 (A1, A2) and 19 (S1, S2); 417 and 418 row 20 for S4; 543, 544, 570 and 709 row 7 for S3. All ten haveSplGetModeChartset; ten more stock rows set it with no case of the switch (404, 546–550, 559, 571–573), so they keep the plain records. (MonModeRecord,MonStats.txt:SplGetModeChart; the jump tables and a full-table check) [I] Rows 18 and 19 each end in a mode-8 command. -
I2. [C]
MonAttackFrame, no used skill, scheduled. A code-1 kind-0 event of a no-skill A1 or A2 is followed in its frame by a hit of the attacker in 18 160 of 18 637 dispatches; a code-2 event by none, in 2 248 of 2 248 dispatches. [I] A code-1 event strikes throughMON_MeleeHitandCOMBAT_DeliverQueued(the code reading). The reading that every code 1–4 strikes is contradicted for code 2; codes 3 and 4 keep it, untested. Which test drops code 2, and so whether a code-2 event reaches the strike’s to-hit test and its draw at all, is not read: the frame function gets no code (MonModeFrameEventpasses onlyECXandEDX), so the drop lies belowMON_MeleeHitor in its gates. -
I2. [I] An every-frame mode steps, advances and strikes only on a frame whose event byte is 1 (mode 14: bit 6 set). With a used skill it runs
SKILLS_DoUsedSkillon every call, then advances. -
I2. [C]
MonModeEndGeneric(GH, BL, A1–S2, SQ; WL and RN on arrival): the kind-1 ends of GH, BL and A1–S2 give the neutral command (23 483), and WL and RN arrivals go toUNIT_SetMode(1)directly (85 507). [I] ASplEndGenericbase class in its listed mode gets only the AI event (unless frozen and alive); otherwise, wheng_MonModeEndDirect[mode]is 0 (all but WL and RN), the delayed hit of state 54 and the used skill’s clear come before the neutral command; WL and RN get the AI event after their mode set. -
I2. [I]
MonModeStartNeutral:SUNIT_SetMode(1); when the next AI event is not later than now, re-queue it atT + 45under state 21 (stunned), else atT +MonStatsaidel(by difficulty; 15 when 0). The AI’s delay itself is phase (5)‘s.
I3. Objects
Section titled “I3. Objects”- I3. [I] After a chest’s drops
OBJOP_Chestsets mode 1 (whenMode1is set) and queues object event 1 atframe + (FrameCnt1 >> 8) + 1; event 1 setsUnit+0x10 = 2when the object is still in mode 1 and the row hasMode2, withoutUNIT_SetMode(no animation start, so no start draw), and unmarks the footprint whenHasCollision2is 0. The same queue form appears at 46 sites, two of them read. [C] None of the 161 logged object event-1 dispatches is followed by a mode set or an animation start of that object.
J. The rate (UNIT_AnimSetRate)
Section titled “J. The rate (UNIT_AnimSetRate)”J1. AnimRateBonus(unit, i) → i32: [C] (g_AnimRateBonus, all of J1) (k, stat) ← (120, 93) | (120, 99) | (120, 105) | (120, 102) | (150, 96) ; i = 0..4: IAS, FHR, FCR, FBR, FRW s: i32 ← UnitGetStat(unit, stat, 0) return s = 0 ? 0 : (k × s) ÷ (k + s) ; signed imul, idiv toward zero
J2. UNIT_AnimSetRate(unit): [C] (UNIT_AnimSetRate, all of J2 but the lines marked) if unit is null or unit.type ≥ 4: return (type, class, mode) ← display values; UNIT_AnimSetRecord(unit, type, class, mode); spd: u32 ← rec.speed if IsCast(type, mode): X ← min(100 + B_FCR, 175); q ← (spd × X) mod 2³² ÷ 100 (unsigned) else if (type, mode) ∈ {(0, 9), (1, 6)}: X ← B_FBR + (HasState(unit, 101) ? 100 : 50); q ← max(1, (spd × X) mod 2³² ÷ 100) ; [I] the 1: no case else if (type, mode) ∈ {(0, 4), (1, 3)}: X ← B_FHR + 50; q ← (spd × X) mod 2³² ÷ 100 else if (type, mode) ∈ {(0, 19), (1, 13)}: q ← vbase(type, class, mode); PathSetSpeed(path, 0x1000) else if IsMove(type, mode, class): if no path: return ; +0x4C kept; [I] no case X ← max(B_FRW + stat67, 25) ; the floor 25: monster calls only q ← (vbase × X) ÷ 100 (signed); PathSetSpeed(path, (pbase × X) ÷ 100) ; anim/movement A1 else if IsAttack(type, mode, class): WeaponListsRelink2(unit, 1) X ← B_IAS + stat68 if UNIT_CanDualWield(unit) and both hands hold a usable weapon (type 45): X ← X + (stat68(R) + stat68(L)) ÷ 2 − stat68(R) ; R body location 4, L 5 if unit.type = 0 and unit.mode = 18: X ← X − 30 ; the real type and mode X ← clamp(X, 15, 175) ; the floor 15 met at X 10; [I] X 11–14 base ← (HasStateFlag(unit, 38) and w ← WereformAttackBase(unit), w ≠ 0) ? w : spd q ← (base × X) mod 2³² ÷ 100 (unsigned) else if IsFixed(type, mode, class): q ← spd else: q ← (spd × clamp(stat69, 15, 175)) ÷ 100 (unsigned) q ← q ≤ 0 ? 0 : min(q, 0x7FFF); +0x4C ← (i16) q ; signed test, then the cap; [I] neither reached if cast or attack: +0x3C ← (i32)(i16) q ; the sequence step-
J1. [C] The bonus map holds over 3 413 emulated cases (
sfrom −119 to 65 535 and random values); thatsis the unit’s full stat is the reading ofUnitGetStat(unit, stat, 0),[I]. Fors ≥ 0the bonus rises from 0 towardkand never reaches it. -
J1. [C] For
−k < s < 0the bonus is negative and unbounded below (the signed divide: 832 negative emulated calls equal, where an unsigned divide changes 798 and a floor divide 562). No stock property block makes a rate-bonus stat negative (353 blocks write the five stats, all withmin/max≥ 3; a full-table check). [I]s = −kdivides by zero; and since other negative sources (slows, curses) are not scanned, that the negative cases and the wraps below are not reached on stock data is not shown. -
J2. [C] Every branch holds at all 298 373 logged exits,
+0x4Cand (cast and attack) the 39 901 sequence steps+0x3C: cast (players 4 672, monsters 33), block (1 150, 233; Holy Shield’s 100 in the Paladin’s rates), get-hit (173, 3 526), knockback (2, 1 331), moving (3 191, 123 060), attack (7 532, 27 664), fixed (72, 7 698), default (9 129, 108 907). The attack clamp’s 175 is reached by 31 player and 74 monster calls (Burst of Speed with two fast katars, Double Swing). -
J2. [C] The floors met. Under a Holy Freeze slow (session
sp-pal-slow) the moving floor 25 is reached by 105 monster calls (X−15, −9, 5 and 8) and the attack floor 15 by 111 monster calls, all atX10; the default branch’s floor 15 by 139 monster and 14 player calls (stat 69 at −4 and 0). Each rate equals the model, and the controls (a floor of 24 or 26, 14 or 16, or none) differ in all of them. No player reaches the moving or the attack floor (least loggedX150 and 80). -
J2. [I] The attack floor’s threshold for
X11–14 (one input value met), the default branch’s 175, block’s floor 1 and the0x7FFFcap are reached by no logged call (48 118 rate calls in H6d), nor is a moving call with no path. Cast, get-hit, block, attack and default divide unsigned, so a negative factor would wrap to the cap (FCR ≤ −55, FHR or FBR ≤ −36, FBR ≤ −55 under Holy Shield); moving divides signed. -
J2. [C] The record is set again at every call, so a mid-mode call can change
+0x50: the record changes at logged mid-mode calls (players 52 fromITEMS_AttachToOwnerand 54 fromSKILLS_ApplyAuraStats, monsters 1 390), its frame count with it at 1 355. [C] It never changes+0x48, which only the mode starts write: kept in 25 059 of 25 059 logged record-changing calls with a non-zero length, 72 of them outsideUNIT_AnimInit’s own calls, all players. [I] The monster half: no monster call outsideUNIT_AnimInit’s own changed its record in those sessions. Objects and missiles never reach J2 (their start branches do not call it). -
J3. [C] The
npcrule (classes 257 and 405 in S1–S4 take the default branch, 70 calls) and a classic monster’s S1–S4 at the moving rate (1 818 calls over classes 6, 19, 20, 111, 180 and 190, 19 under a changed stat 67) are met. -
J4. [C] The dual-wield term
(R + L) ÷ 2 − R(toward zero) replaces the right hand’s stat 68 by the two hands’ mean, over the dual-wield calls of Double Swing, Frenzy, A1 and S3/S4; the sequence term− 30applies to a player whose real mode is 18 with an attack-rate skill (Jab, Double Swing, Frenzy, Fists of Fire); Charge and Leap Attack take the default branch (noUseAttackRate). 186 dual-wield attack calls equal the term (152 with the hands’ stat 68 differing; the control without it differs in 141 of the 152). The right hand’s stat 68 is the one replaced also when the left weapon is the linked one (the term subtracts the right hand’s whichever is linked), read from the code:[I](which hand the skill links is not logged). -
J4. [C] The shapeshift base. Under state flag 38 (
meleeonly) a transformed player’s attack base isw = (+0x48 & ~0xFF) ÷ D(signed),D19 without a weapon, elseHumanAttackFrames(unit, weapon) = (F_h << 8) ÷ ((spd_h · (100 + stat93(weapon) + stat68(weapon))) ÷ 100)from the player’s own A1 record with that weapon’s class;+0x48is the previous mode’s length atUNIT_AnimInit’s calls and the new one atSUNIT_AnimInit’s (235 calls; 50 separate the two lengths). The previous mode’s length is the live+0x48its start wrote, not its current record’s: at 3 074 init attack calls the rate equals the model fed that value, which differs from the previous record’s length in 34. -
J4. [I]
HumanAttackFramestakes speed 45 when the name has no record, and a zero divisor faults. -
J5. [C] A new monster’s stats 67, 68, 69 are 75, 100, 100 (13 693 plain monsters at their start; 2 others start at 75, 95, 100, unexplained); in stat 67,
championandpossessedmonsters start at 95,fastones at the clamp below and the two loggedfanaticunits at 175 (75 and the clamp only), and 74 units fit none of these values (anim/movement § A A3). -
J5. [I] Where the terms come from (to the depth the rate needs): stats 67, 68, 69 are 100 on a new player; a weapon’s stat 68 is
−speed; stats 68 and 93 aredamagerelated, so only the weapon the attack uses counts afterWeaponListsRelink2;championandpossessedadd 20 to stat 67,fastandfanaticclamp(2048 ÷ Velocity − 128, 10, 100); chill sets 67, 68 and 69 to the cold effect; Slows Target’s state carries 68 and 69 only; a monster’s mode command can carry a velocity into stat 67 (anim/movement A3). No difficulty, player-count or game field is read. -
J7. [C] A rate change in a scheduled mode moves no queued event: the events fire at their queued frames whatever rate call comes after (
fire). [C] Behind it:UNIT_AnimSetRate’s 19 direct callees include neither the queue nor the cancel, and their closure (101 functions) reaches no queue, cancel or scheduler entry; only E3’s reschedules rebuild the list, from the rate at their call.
K. Breakpoints (derived)
Section titled “K. Breakpoints (derived)”The breakpoints are not a table in the game: they follow from E2’s length and J2’s rate. The statements below are derived formulas. Their inputs are [C]: the length n(r) (E2, every logged rate), the rate branches (J2) and the bonus map (J1). [C] The closed forms also equal the game’s logged schedules: K1 at all 45 913 non-sequence schedules, K2 at the 39 550 plain-rate ones and K3 at 9 919 cast, get-hit and block ones; K3’s attack form equals a brute force through J1 and J2 at 1 297 362 targets. [I] At the factor floors (15, 25, block’s 1) no logged schedule checks them: they stay derived only (the rates at 15 and 25 are J2’s monster calls).
K1. Length and event frame at rate r (F frames, start S, F > S): [C] (derived from E1 and E2, SUNIT_ScheduleModeEvents, all of K1) n(r) ← max(2, ⌈256 (F − S) / r⌉); N(r) ← n(r) − 1 ; the end at T + n(r); the sources' count N(r) steps(r) ← ⌈256 (F − S) / r⌉ − 1 ; E2's N: the event steps, 0 when r ≥ 256 (F − S) frame f ≥ S fires at T + max(1, ⌈256 (f − S) / r⌉) when that is ≤ steps(r)
K2. The least factor for a length ≤ m (r = ⌊spd · X / 100⌋): [C] (derived, UNIT_AnimSetRate, all of K2) R_m ← ⌈256 (F − S) / m⌉; X_m ← ⌈100 · R_m / spd⌉ the breakpoints of a record are the X_m of every m its factor range [X_lo, X_hi] reaches: attack and default 15..175; cast 100..175 (FCR ≥ 0); get-hit and block 50 upward; block under Holy Shield 100 upward
K3. The least item stat for a bonus ≥ y: [C] (derived from J1, all of K3) y ← X_m − base ; base 100 cast, 50 get-hit and block, 100 under Holy Shield s_min ← ⌈k · y / (k − y)⌉ for 0 < y < k (none for y ≥ k: the bonus never reaches k) attack: if X_m = 15 (the clamp's floor): no IAS is needed, whatever stat68 and the terms are else y ← X_m − stat68 (− the dual and sequence terms), the IAS needed is s_min with k 120-
K1. [C] The event bound is E2’s step count, not
N(r). The two are equal whenever the action has a step (r < 256 (F − S)); with no step (r ≥ 256 (F − S))n(r)is 2 andN(r)1, butsteps(r)is 0 and no frame event fires, not even frameS’s, as E2 states. The no-step case, which no logged schedule meets, holds at 104 emulated schedules with an event. -
K1. [I] Block’s
max(1, …)and the moving and knockback branches (which do not dividespd) are outside K2; a sequence’sFis its row count withS0 (a player sequence is scheduled from its step, G5). -
K2. [C] A gain shows only when it lowers
⌈256 (F − S) / r⌉: between twoX_mevery factor gives the same length, and a breakpoint is met at the listed value or above:X_n ≤ X < X_{n−1}at all 39 550 plain-rate schedules, 28 922 of them exactly atX_n. -
K3. [I] Illustrations from stock records (
p50b-bp.txt, the tool’s model, not a run):SOSCHTH(14 frames, speed 256, event at frame 7) at FCR 0, 9, 20, 37, 63, 105, 200 lasts 14, 13, 12, 11, 10, 9, 8 frames (n; the last at the cap, any FCR ≥ 200 the same);PAGHHTH(5 frames) at FHR 0, 7, 15, 27, 48, 86, 200 lasts 10, 9, 8, 7, 6, 5, 4.[C] In the logs,
SOSC1HSandSOSCSTF(the same 14 frames, speed 256, event at 7) at FCR 0, 20, 40 and 50 last 14, 12, 11 and 11 frames, andPAGH1HS(the same 5 frames, 256) at FHR 0, 24 and 48 lasts 10, 8 and 6; theHTHrecords themselves and the other tiers are not logged. -
K3. [C] The schedule lengths equal
n(r)at every logged rate (sched-len34 647 over the 81 logs of parts 1 and 2, 46 722 over the 131 logs of parts 1–3, 0 mismatches): three FCR rates of 30 events for the Sorceress, Necromancer, Paladin and Druid; three FBR rates of 30 for the Paladin and Druid; one A1 record per class at three IAS rates of 30; get-hits at an FHR rate with 30 starts for the Barbarian (two rates) and the Paladin. -
K3. [C] The get-hit FHR tiers of five classes (FHR 0, 24 and 48 from the same stock rate items in every part, single player; part 3 added clvl 99 builds in Act I Nightmare to the starts of parts 1 and 2, whose builds and difficulties differ): the get-hit schedule lasts
n(r)at three FHR rates with 30 starts or more each, counted over parts 1–3, for the Amazon (rates 128 / 179 / 215: 32 / 40 / 33 starts), the Necromancer (38 / 32 / 42), the Sorceress (50 / 35 / 38), the Assassin (40 / 42 / 52) and the Druid (rates 124 / 173 / 208: 49 / 35 / 32; its 179 is the werewolf form’s); the closing check over the 131 logs holdssched-len46 722 andghr13 932 with 0 mismatches. -
K3. [I] Recorded short (not a mismatch): three FHR rates of 30 for the Barbarian (it has two) and the Paladin (it has one), which part 3 did not build; and, survivability-bound at part 2’s build and not part 3’s target, a third FCR rate for the Amazon, Barbarian and Assassin, a second weapon type of the IAS rates, and two FBR rates of 30 for the classes the records do not name (part 1 had two for three classes; part 2’s record names the Paladin and Druid at three). Their breakpoints stand on K1–K3 and the
[C]inputs only.
L. The frame events as gates
Section titled “L. The frame events as gates”-
L1. [C] The kind-0 events of a scheduled player mode fire at the frames E1 gives (A1, cast, kick, throw, sequence, get-hit and block among the 7 092 scheduled player modes). [I]
PlrModeSkillFrameruns the used skill’s do on an event of code 1 or 2 whileUnit+0xC4bit 6 is clear (the start cleared it; most do functions set it), so the do runs atT + max(1, ⌈256 (f − S) / r⌉)for the first framef ≥ Swhose event byte (or sequence event) is 1 or 2 within the scanned steps, and again at a later code-1/2 event only if the do left bit 6 clear; codes 3 and 4 do nothing there. A move-first skill runs its do on the arrival frame of its step instead. -
L2. [I] The attack’s delivery is on the do frame: a player’s normal attack is skill 0’s do, which runs the hit test, the build, the queue and
COMBAT_DeliverQueuedin that call; a monster’s plain attack strikes inMonAttackFrame(I2). A skill’ssrvmissileis created bySKILLS_SrvDoafter the do function in the same call, so on the do frame. [C] 18 168 of 18 347 logged monster A1 and A2 hits fall in a frame of the attacker’s kind-0 dispatch; a player’s melee hit is not separated there from missile hits. -
L3. [C] The skill delay runs from the do. With Frozen Orb held, 72 of the 73 next casts that start within 3 frames of the delay state’s end start exactly at the
SKILLS_SetDelayStateframe (the do’s) plusd, one 3 frames later; the frames from the mode start to the do are not part of the delay. -
L4. [C] The interval between two actions (P1b-1). The schedule’s last event step is at
T + Nand its end atT + n,N = n − 1(E2; an action with a step, as every logged one here). The server starts the next action in the frame of its request, whatever that frame: of the first action requests after a cast’s start, 1 816 of 2 084 are followed by the next scheduled mode in their own frame, 23 of them two or more frames beforeT + N; after A1 1 685 of 2 332, after a throw 90 of 149, after a kick 368 of 569 likewise (the rest start it from a later request). -
L4. [C] The stock client’s held request (an observation of the oracle input, not a server rule) comes at
T + Nfor a held normal action and atT + nfor held Lightning: the next scheduled mode within 3 frames of the end started atT + N448 times and atT + n103 after a cast, 107 and 63 after A1, 36 and 2 after a throw, and after held Lightning (mode 18) atT + n68 times, never atT + N. So a breakpoint table’s frame countNis the interval a held button gives with this client. -
L4. [I] The client’s own rule for when it sends a held request is not read (the client is presentation and an oracle). [C] For the other player modes, the first request after
Tand the next start are tallied over the 131 logs for get-hit (756), block (1 442), S2 (536), S3 (11) and S4 (21); no A2 or S1 action is logged. -
L5. [C] Get-hit and block are never left before
T + n: over the 131 logs the next mode set after a player’s get-hit (756) or block (1 442) start comes at its end (746, 1 436) or is a death (10, 5), andPlrModeLeaveOkrefuses 781 requests, all from GH, BL and DT; the reading is its refusal of every request but death and neutral from GH and BL (M4).
M. Hit recovery, the block, the get-hit roll, the mode tests, stun and the hit class
Section titled “M. Hit recovery, the block, the get-hit roll, the mode tests, stun and the hit class”M1. COMBAT_GetHit(defender, packet; attacker), the timing part: [I] (COMBAT_GetHit, all of M1; the parts logged: M1 below) if the defender is in a town room and not (attacker is a monster with MonStats +0x00D bit 2): return if result & 1 (hit): if not packet.+0x64 and (packet.+0x60 & 0xF0) = 0: packet.+0x60 ← HitClassPick(packet, packet.+0x60) defender.+0xB0 ← packet.+0x60 if HasState(defender, 54): (if result & 2: STATE_Set(92, 1)); return player defender, by result bits in this order, each returning: 0x80 dodged, 0x100 avoided, 0x200 evaded (their skills' modes or events) 0x8010 blocked: unless 0x4000: if frame − stat95 > stat102 ÷ 8 + 15: block command (mode 9); then stat95 ← frame 0x2 killed: mode 0 (unless in DT or DD) 0x8 knockback: PLAYER_ModeCmdUnit(19, attacker) 0x4 get-hit: if stunned (state 21's list) or GetHitRoll(def, pkt, pkt.+0x60) = 0: PlayerModeCmd(4, unforced) ; passes M4's two tests first monster defender (not in DT or DD): knockback → get-hit without a KB mode; base class 78 adds 0x8 unless frozen; 0x2 → UnitKilled; 0x8 → command 13; 0x10 → block mode 6 unless 0x4000, classes 243, 333, 705 or no BL mode; 0x4 → command 3 if stunned or GetHitRoll = 0
M2. GetHitRoll(def, pkt, hc) → i32 (0 get hit, 1 not): [C] (all of M2) if HasState(def, 1) or (pkt.poison ≠ 0 and pkt.poison = pkt.total) or pkt.total < 0x100: return 1 hp: i32 ← UnitGetMaxHp(def) ; 1/256 units, as the total D: i32 ← hc ∈ {2, 6, 10, 11} ? 8 : hc ∈ {4, 8} ? 32 : hc = 5 ? 64 : 16 ; hc is the whole +0x60; [C] 32: 4 of 38 calls separate it; [I] 64 not separated if pkt.total < hp ÷ D: return 1 if pkt.total < hp ÷ (D ÷ 2) and RNG.RangePow2(seed: def.seed, n: 2) = 0: return 1 ; draw#1 if pkt.total < hp ÷ (D ÷ 4) and RNG.RangePow2(seed: def.seed, n: 4) = 0: return 1 ; draw#2 (or the only one) if def is a monster and not MonModeAllowed(def.class, 3): return 1 ; [C] 28 separating calls return 0-
M1. [C] The block gate. For 867 blocked hits on a player the block command is issued exactly when
frame − stat 95 > ⌊stat 102 / 8⌋ + 15(618 open, 249 shut); of the 618 the mode test refused 51. [C] Stat 95 is written only when the test passes, whether or not the command is accepted: at the next hit it is the open gate’s frame (1 440, 185 of them after a refused command) and unchanged after a shut one (18 759). [I] The division by 8 is signed toward zero (stat 102 is never negative in the logs); the block result itself is combat’s. -
M1. [C] What the logs hold of M1, the commands by result bit over the 131 logs: a player get-hit command iff the roll is 0 or the player is stunned (955 of 4 760 rolls; the 2 stunned get-hits roll nothing), a block at an open gate, mode 19 at a knockback; a monster’s command 3 iff the roll is 0 (3 651 of 4 566), command 13 at a knockback (919); under state 54 (22 hits) no command. The town return and the kill branch are not separated.
-
M1. [C] A player’s knockback (P1b-10). Of 15 hits on a player with result bit
0x8, 13 by Blood Raven in Hell (MonPropknock), 12 set the player to neutral in the hit’s own frame and one later; 2 by class 462 started mode 19. [I] Why Blood Raven’s knockback commands end in neutral at once (the planner’s point equal to the start, or a refusal in the mode command) is not logged; the length of mode 19 (two starts) stays unstaged (Phase 2 parts 2 and 3 name player knockbacks short: part 3’s three Hell sessions never met Blood Raven, class 267, and logged no new player knockback); its reading is anim/movement § E. -
M2. [C] All 7 195 logged calls return what M2 gives with 0–2 draws on the defender’s seed (none 5 977, one 928, two 290): early returns 809, below
hp ÷ D4 518, the two drawing bands 605 and 613, athp ÷ (D ÷ 4)and above 650;D16 (5 589 calls) and 8 (774). 102 consecutive pairs on one defender chain (the second’s seed before is the first’s after); 701 have other draws between. Over both parts’ 81 logs the closing check holdsghr9 858 andblock-gate2 309 with 0 mismatches. [C] -
M3. [I] Hit recovery is the get-hit mode’s schedule: the
GHrecord at the get-hit rate⌊spd · (B_FHR + 50) / 100⌋(J2),n(r) = max(2, ⌈256 F / r⌉)frames (start frame 0), then neutral (I1); a monster’s the same with its record. The block’s length is the block mode’s schedule at the block rate. [C] Both rates and both schedules hold at every logged call and schedule (E2, J2), 0 mismatches over the 131 logs of parts 1–3; the get-hit’s at three FHR rates of 30 starts or more for the Amazon, Necromancer, Sorceress, Druid and Assassin (K3). The Barbarian’s and Paladin’s FHR tiers stay short (K3).
M4. Player mode tests (both mode commands; the second unless forced): PlrModeLeaveOk(unit, requested) → bool: [I] (all of PlrModeLeaveOk) an item on the cursor: only 0 and 17 pass requested ∈ {0, 1, 5, 17}: pass by the current mode: DT, GH, BL, DD refuse A1, A2, SC, TH: pass while PlrModeEndPending, else only a GH or BL request KK: pass while PlrModeEndPending; S1 refuses for class 0, S3 for class 5; SQ: PlrSeqLeaveOk every other mode passes PlrModeEndPending(unit) → bool: frame ≤ E + 5, E the least positive frame of the unit's kind-1 events (0 when none) [C] E; [I] the + 5 PlayerModeAllowed(requested, 1, skill) → bool: [I] (all of PlayerModeAllowed) 0 under state 54 or in DT or DD; 1 without a used skill 1 when the request is for the used skill itself and its srvdofunc is 67 or 76 used skill without interrupt: in neutral a forced neutral command and 1; else only 7, 8, 10, 11, 13, 18 pass while a mode end is queued used skill with interrupt: under state 42: c ← RNG.Range(seed: unit.seed, n: 100) ; draw#1 refuse if c < stat 164 of state 42's list refuse under state 15 a refusal in neutral is a forced neutral command and 1- M4. [C] 1 027 logged
PlrModeEndPendingvalues equal the frame of the kind-1 end queued when the request comes. [C]PlrModeLeaveOkreturned 1 at all 5 633 first requests after an A1, cast, throw or kick start, and at every request in those modes over the 131 logs (1 731); over the 131 logs it refuses 781 requests, all from DT, GH and BL, and passes the requested modes 0, 1, 5 and 17. [I] Its cursor test, the A1–TH and KK refusals without a pending end, the S1 and S3 class refusals and SQ’s test are not reached. OnePlrModeEndPendingvalue after a catalogue requeue is not compared. - M4. [C] 26 696
PlayerModeAllowedcalls leave the player’s seed unchanged; none is under state 42. [I] So the Concentration draw is read from the code only: a get-hit, block or knockback during a non-interruptible skill (12 player skills, Kick, Jab, Fend, Zeal, Frenzy and Whirlwind among them) never starts, and during an interruptible one under Concentration it starts with probability1 − stat 164 / 100, one draw per command. - M5. [I] Stun.
COMBAT_ApplyStunsets state 21 untilframe + length(capped at 250, 13 for a hireling from 12 up) with a unit event 12 at that frame; a stunned defender’s get-hit skipsGetHitRoll(M1); a monster’s next AI event after a neutral start comes atT + 45under stun (I2);sandleaper1’s knockback end waits 45. No state-21 test is in the two player mode tests. [C] The 2 logged stunned player get-hits skipGetHitRolland the command 4; no stunned monster get-hit,T + 45, cap or event 12 is logged. - M6. [I] The hit class is the packet’s
+0x60. Melee delivery fills its low nibble when+0x64and+0x60 & 0xFare 0 fromUnitBaseHitClass(attacker): a player’s weaponhit class(the base record’s+0x13C), 1 without a weapon; a monster’s MonStats2HitClass; else 0. A missile’s hit sets+0x60 = Missiles HitClass | (+0x60 & 0xF0).COMBAT_GetHitthen ORs an element nibble byHitClassPick(cold 0x30, fire 0x20, lightning 0x40, poison 0x50: the first with damage above 0 in an order rotated by a global byte counter; else 0x10 for a doubled hit; a class 0 becomes 13) and copies the whole intoUnit+0xB0. The server gate found on it is M2’s divisor, where any high nibble gives 16, so the counter changes no server outcome found.
N. Draws and seeds per event kind
Section titled “N. Draws and seeds per event kind”- N1. [C] Over the 171 functions under the animation machine’s 29 roots (three indirect stat-list callbacks
unfollowed), the only RNG call is the object start draw (C2); the rate (J2), the schedule, the advance and the
sequences draw nothing: a second, independent walker over the same roots and stops reaches 164 functions with one draw,
the call to
RNG_RangeB, and the first walker’s 171 bodies walked again find onlyUNIT_AnimInit’s. - N2. [I] On a hit, in delivery order: the durability draws,
the stat events, the knockback handler, then
COMBAT_GetHit:GetHitRoll(defender seed, 0–2, M2), then the command’sPlayerModeAlloweddraw (player seed, 0 or 1, M4). On a player defender these are all the player’s own seed. The mode functions reach other draws only through other subsystems (skills, combat, death drops, the AI, the path plan), plus monster death’s class-212 area damage and a quill rat’s local seed. - N3. [C] The
GetHitRolldraws chain on the defender’s seed (M2, 102 chained pairs). [I] The object start draw and thePlayerModeAlloweddraw have no chained pair in the run; their draw order stays as read.
Outputs
Section titled “Outputs”-
[C] Per scheduled mode start: the record
+0x50, the rate+0x4C(and+0x3C), the queued kind-0 events(frame, code, index)and the kind-1 end frame; per every-frame monster frame,+0x44and+0x4E. -
[C] The next mode at each end (§ I; players 10 718, monsters 28 003 logged ends) and the get-hit, block and knockback commands of a hit (§ M). [I] An object’s start rate and draw (§ C), its draw’s place in the object seed’s order as read.
Worked example
Section titled “Worked example”- [I] A Sorceress cast at FCR 20 (
SOSCHTH: 14 frames, speed 256, event byte 1 at frame 7,S0). J1:B = (120 × 20) ÷ 140 = 17. J2:X = min(117, 175) = 117,r = (256 × 117) ÷ 100 = 299. E2:n = ⌈3584 / 299⌉ = 12,N = 11. The do (frame 7) fires atT + ⌈1792 / 299⌉ = T + 6. At FCR 9:B = 1080 ÷ 129 = 8,r = 276,n = 13. K2 form = 12:R = ⌈3584 / 12⌉ = 299,X = ⌈29900 / 256⌉ = 117; K3:y = 17,s = ⌈2040 / 103⌉ = 20. So FCR 20 is the 12-frame breakpoint. [C] The logs hold these numbers onSOSC1HSandSOSCSTF, which shareSOSCHTH’s 14 frames, speed 256 and event at frame 7: at FCR 20 the rate is 299, the length 12 and the do atT + 6(112 casts);SOSCHTHitself is not logged. - [I] A Paladin get-hit (
PAGHHTH: 5 frames, speed 256). FHR 0:X = 50,r = 128,n = ⌈1280 / 128⌉ = 10. FHR 7:B = 840 ÷ 127 = 6,X = 56,r = 143,n = ⌈1280 / 143⌉ = 9. [C] The logs hold FHR 0 onPAGH1HS(the same 5 frames, speed 256): rate 128, length 10 (28 get-hits); FHR 7 is not logged. - [I] An Amazon’s one-handed swing (
AMA11HS: 16 frames, start frame 2, event at frame 10) at factor 100:r = 256,n = ⌈256 · 14 / 256⌉ = 14, the event (the do) atT + ⌈256 · 8 / 256⌉ = T + 8. [C] The logs holdAMA11HSat factors 80, 130, 147 and 160: lengths 18, 11, 10 and 9, the do atT + 11,T + 7,T + 6andT + 6; factor 100 is not logged.
Reimplementation notes
Section titled “Reimplementation notes”-
[C] Count the end. A scheduled mode’s end is
nframes after its start; the community tables countN = n − 1(the event steps). With the stock client a held normal action restarts atT + N, held Lightning atT + n; the server itself starts the next action in the frame its request arrives (L4: after A1, a cast, a throw and a kick). -
[C] Two rate calls per server start.
UNIT_AnimInitcalls the rate before it writes the new+0x48, andSUNIT_AnimInitcalls it again after (44 415 logged starts with both,UNIT_AnimInit’s first); the schedule uses the second call’s rate (all 168 starts whose two rates differ). [C] The shapeshift base reads+0x48, so the first call sees the previous mode’s live length, the one its start wrote (3 074 init attack calls; in 34 it is not the previous record’s length; J4). -
[I] Unsigned divides. Cast, get-hit, block, attack and default take
(spd × X) mod 2³² ÷ 100unsigned; only the moving branch divides signed. A negative factor gives the fastest rate, not a slow one (unreachable on stock data). -
[C] The record is the display’s. A shapeshifted player takes the form’s record, start frame and rate (the logged rate calls hold it: attack 235, cast 160, default 231, block 71, move 61), with the mode mapped through
g_PlrToMonModeand the MonStats2 fallback (B3). -
[C] A monster’s frame function result is ignored (H3: neither
MonModeFrameEventnorMonEventDispatchtests it). [I] So an every-frame monster attack or skill mode with no end call of its own lasts until another command (open questions). -
[C] An object’s opened mode is set without an animation start: no start draw at the operate end (161 logged event-1 dispatches, none followed by an object start).
-
[I] A frozen monster loses its scheduled events (dropped and freed), its mode end among them.
Evidence
Section titled “Evidence”- Upstream: rng, stats/aggregate, monsters/stats. Downstream: skills/dispatch, combat, objects, anim/movement.