| # Replay System |
|
|
| WA's replay system records and plays back game inputs from `.WAgame` files. |
|
|
| ## Command-Line Entry Points |
|
|
| In `Frontend__MainNavigationLoop` (0x4E6440): |
| - `/play <file>` -- play replay from start |
| - `/playat <file> [MM:SS.FF]` -- play from specific time offset |
|
|
| Globals set by arg parsing: |
| - `0x0088AF58` -- replay filename buffer |
| - `0x0088C77C` -- playback position (frame number) |
| - `0x0088C778` -- position valid flag (0 or 1) |
|
|
| ## DDGame Replay Offsets |
|
|
| | Offset | Type | Description | |
| |----------|-------|-------------| |
| | +0x7E41 | byte | Deferred hurry flag. Set to 1 during replay when spacebar triggers a hurry. Consumed by GameFrameEndProcessor which converts it to a local Hurry message (0x17). | |
| | +0xDB08 | byte | Replay state flag A. Both A and B must be non-zero for the replay hurry path. | |
| | +0xDB0A | byte | Replay state flag B. | |
| | +0xDB0B | byte | Replay state flag C (checked by SendGamePacketConditional). | |
| | +0xDB1C | ptr | Replay payload pointer (malloc'd from file data). | |
| | +0xDB48 | dword | Replay active flag (set to 1 by ReplayLoader). | |
| | +0xDB50 | dword | Replay frame pointer/state. | |
| | +0xDB54 | dword | Replay frame pointer/state. | |
| | +0xDB58 | dword | Replay frame pointer/state. | |
| | +0xDB60 | char[0x400] | Input replay file path. | |
| | +0xDF60 | char[0x400] | Output replay file path (for recording). | |
| | +0xEF60 | dword | Init counter (set to 0 by loader). | |
|
|
| ## Spacebar Advance Mechanism (Fully Traced) |
|
|
| When spacebar is pressed during replay playback, this chain fires: |
|
|
| ``` |
| Keyboard input |
| -> Control task (0x5451F0) translates keyboard action |
| -> Sets TurnGame+0x1F4 = 1 ("hurry requested") |
| -> TurnGame ProcessInput (msg 4) |
| -> TurnGame_HurryHandler (0x55E5F0) |
| checks TurnGame+0x1F4 |
| Normal game: SendGamePacketWrapped(0x17, 0) |
| Replay mode: DDGame+0x7E41 = 1 (deferred hurry) |
| -> GameFrameEndProcessor (0x531960) end-of-frame |
| reads DDGame+0x7E41 |
| if set: sends msg 0x17 (Hurry) locally + via SendGamePacketConditional |
| clears flag |
| -> Turn ends, next turn begins from replay data |
| ``` |
|
|
| Packet 0x17 = TaskMessage_Hurry (value 23 from wkJellyWorm enum). In replay mode |
| this is processed locally, not over the network. The deferred flag (0x7E41) bridges |
| the gap between "input detected during ProcessInput" and "end-of-frame processing." |
| |
| ## Key Functions |
| |
| | Address | Name | Description | |
| |----------|------|-------------| |
| | 0x462DF0 | ReplayLoader | Loads .WAgame file. Validates magic 0x4157 ("WA"), stores payload at DDGame+0xDB1C. param_2: 1=play, 2=getmap, 3=getscheme, 4=repair. | |
| | 0x4E3490 | ParseReplayPosition | Parses "MM:SS.FF" -> frame number. Returns -1 on failure. | |
| | 0x531880 | SendGamePacketConditional | Sends packet if network buffer allows. | |
| | 0x531960 | GameFrameEndProcessor | End-of-frame. Reads deferred hurry flag, sends Hurry message. | |
| | 0x531D00 | GameFrameDispatcher | Main frame loop. Message queue + GameFrameEndProcessor. | |
| | 0x5451F0 | ControlTask_HandleMessage | Translates keyboard input (msg 0xC) -> game messages. | |
| | 0x553BD0 | GameMessageRouter | Routes messages through task handler tree. | |
| | 0x55DC00 | TurnGame_HandleMessage | Message dispatcher. Case 2=FrameFinish, 4=ProcessInput. | |
| | 0x55E5F0 | TurnGame_HurryHandler | Hurry logic. Normal: packet 0x17. Replay: deferred flag. __usercall(ESI). | |
| | 0x55FDA0 | TurnManager_ProcessFrame | Per-frame turn timer, decrements by 0x14 (20ms). | |
| | 0x5611E0 | TurnGame_AutoSelectTeams | Iterates teams during ProcessInput, sends packet 0x2B. | |
| |
| ## Replay File Format |
| |
| - Magic: 4 bytes, value 0x4157 ("WA" in little-endian) |
| - Version in upper 16 bits of first dword |
| - Size: 4 bytes (payload length) |
| - Payload: binary game state + recorded inputs |
| |
| ## Direct Replay Control (Future) |
| |
| To bypass keyboard simulation entirely, set DDGame+0x7E41 = 1 from our DLL thread. |
| The game's existing GameFrameEndProcessor converts it to a local Hurry message every |
| frame. This is the simplest approach and faithfully replicates what spacebar does. |
| |
| Prerequisites: replay flags DB08 and DB0A must both be non-zero (true during normal |
| replay playback). |
| |
