Versus-mode systems map

A survey of every system the multiplayer versus mode needs. Each entry says what is decoded (and where it is written up), what the rebuild does with its own behaviour (the PLACEHOLDERS.md rows), and the leads for the rest: function addresses, the data they read, and how sure we are. Later decode runs start from here. Formats are in FORMATS.md; this file holds the map, not format details.

Executable: PDUWP.exe of the Store build 1.3.25854.2. Addresses are virtual addresses (image base 0x140000000). Functions are named by what they do. “Branch X” means decoded in that branch and not merged into main when this was written (11-03). Survey tooling (disassembly indexes, string/xref tables, class vtables) is on the data machine (q.py str|refs|callers|callees|show|fn).

Confidence: H read in the machine code and checked against data or footage; M read in the code, meaning inferred from what the code does; L a lead only (location found, behaviour not followed).

How the executable is laid out

The build keeps MSVC run-time type information, so the code splits into modules by class. The class names are developer identifiers, not game text; they are listed here only as handles for the code ranges. Methods of a class sit together, so the ranges below are where to start reading.

Range (approx.) What lives there Conf.
0x140015e00–0x140016600 main loop frame limiter, timers H
0x1400c5000–0x140100000 platform services: online sessions, matchmaking, friends, saves, gamepad wrapper (0x1400dd380–0x1400dda40) M
0x14010a000–0x14011f000 effect particle functions M
0x140128000–0x14012c800 battle flow: the match phase machine (writers of the phase global, see “Match flow”) H
0x14012ea00–0x140148800 boss characters (story only) M
0x14014ee70–0x14014fa60 battle start: capsule placement, deck shuffle (0x14014f910) H
0x1401501b0–0x140155400 battle HUD (2-D battle menu class; capsule icons 0x140151bfa, clock 0x140154cc9, player status panel 0x140155310) M
0x14015b270–0x14015d500 deck files (load/save), character select M
0x14015e700–0x140168400 menus (main, mission, pause 0x1674b0, shared menu 0x167d00) M
0x14016bf60–0x14016e000 arsenal editor screen (the “n/30” counter at 0x14016d5f0) L
0x1401631a0–0x140164e00 collision control and stage collision callbacks (player shot, object attack, object jump, moving object, structure) L
0x14017c630–0x14018c000 game control, lobby, setup-file loader (0x14017da00 area), quick decks (0x14017df00), effect cache M
0x14018f940–0x14018fe00 remote player state (net position, fire requests) M
0x1401ad000–0x1401c3800 story event system (out of scope) M
0x1401c8000–0x1401da400 stage: sky, intro camera, stage set, stage collision load and world (0x1d3c80–0x1d8400, query 0x1d5860; see §9), ground (0x1d9a30), net stage sync (0x1d9f80) L
0x1401dc000–0x140202000 stage objects: ~100 classes (breakables, crumbling, rolling, falling, doors, jump pads, chairs, triggers) L
0x14021a000–0x14024500 battle objects: capsules (0x21b270…), camera shake (0x21af70…), crash/collapse/destroy effects, glow, positional shake sources (0x22bf80), sound, menu sprites M
0x14024cf10 character object constructor (4 target records of 0xC0 at +0x40, 48 skill objects of 0x1F0 at +0x4A0) M
0x14024d000–0x140276000 character and skill-object code (status, aura, deck, reactions, movement, evade, casting, hits) H
0x14027c080–0x14027d100 network message senders and receivers (table at 0x1403fb4d0) H

Shared globals: local player index 0x1404bbe00; per-slot character objects 0x1404bc9d8[4]; per-player status pointers 0x1404bc608[]; match phase 0x1404bc950; match mode 0x1404bc5dc; skill table 0x1404bdc50 (record = id × 0x90); gsdata buffer 0x1404c5228; capsule/deck block 0x140584f80.

Systems

1. Simulation clock and tick rate

2. Match setup and flow (countdown, time limit, KO, results)

3. Capsules and the deck draw (RNG)

4. Aura gain and costs

5. Skill casting (all kinds)

6. Status effects

7. Hit reactions and invincibility

8. Lock-on and targeting

9. Movement and physics

10. Camera

11. Throwable objects and breakable props

12. Arsenal builder rules

13. Playable characters

14. Stage hazards, out-of-bounds, fall-off

15. HUD and menus

16. Audio

17. Controller rumble

18. Teams (2v2) and versus options

19. CPU opponents (in scope from 11-10; docs 11-10 cpu run)

Full write-up: FORMATS “CPU opponents”. Dump tool: converter/comdata.py.

20. Online services around the match

21. The original network model

Full write-up: FORMATS “The original network protocol (executable)” (docs 11-10).

22. Skill effects and stage effect records (docs 11-12 effects)

23. Effects on the Xbox against the PC port (docs 11-10 xboxfx)

24. Stage sky, light sets and glow (docs 11-13 skyglow)

25. The straight fire shot against the game (docs 11-13 bofcmp)

26. Character aura glow, flare, pickup cue (docs 11-14 auraglow)

27. Pose mixer and the character file (docs 11-14 armpose)

28. Debug character viewer: the skill bench (docs 11-14 bench)

Ranked next decode runs (multiplayer)

0-sky. Sky backdrops (24, docs 11-15 skybright): decoded and built (skycol2 11-15: pdconv converts format 0x0B sky layers; Godot draws svc / svcal unlit by vertex colour with culling and the material blend; black frame clear; set 2’s point light from skycol). One small decode left: the SVC fog coordinate (c16) on the Xbox.

0-bench. Skill bench (28, docs 11-14 bench): no decode needed to use it. A build run first (the rebuild’s viewer mode as the third row), then per-skill comparison runs take their answers from the bench instead of footage. 0-char. Character file (27, docs 11-14 armpose): no decode left for the jump arms; a build run: convert the variant files, re-derive joint indices and slot-length timings, re-check every animation-derived statement made on the plain file. Small decodes after it: the neck / head look twists, the extra-motion files. 0. Open questions (docs 11-12, doc-answers): all settled from the files, nothing left to decode; three build tasks follow (multishot re-aim flight; blast mask / order / 31 ticks; aura card after an environment capture, aim points, lunge test floor). Footage only to confirm the explosion look’s size. 0-lock. Lock-on marker (4, docs 11-15 lockring): decoded; a HUD build run next (ring by grade, torso-root aim point, closing-in + cue 4, ring swap, gauge / number / name). Small decodes left: the marker’s blend states, the needle’s turn direction (one bench frame settles both). 0-ui. HUD / menu placement and the arsenal screen (15, docs 11-14 uifix): decoded; build tasks follow (one 853:480 screen frame for HUD, menus and the 3-D view; re-convert skills for the aura card; the arsenal editor’s card panel and grid). Small decode leads left: name plate pieces, lock reticle size, the detail panel’s labels. 0-sky. Sky and light sets (24, docs 11-13 skyglow): a build run first (format 0x09 vertex colour, light set 2 for the sky model and set 3 for model 1, sky centred on the camera, boot-time storm clock), then a short Xbox decode for the cloud pass’s fog state. (skycol 11-15) Build next: set 2’s point light 0 on the sky model (pdconv points, PdData p0 for set 2); it fixes st03’s purple sky and changes 13 more stages. 0a. Effects (22, docs 11-12 effects): joints, slots and attach decoded; next decode runs: the stage model draw (break effects; the debris manager is done, docs 11-14 crater: a build run for craters, debris and prop debris comes first), then the element order against its joint and the environment visual object. The larger part is a build run (joint transforms for every element, release slot on the caster, defense slots 4 / 5). 0b. Effect packs (23, docs 11-10 xboxfx): a build run first (convert effects from the packs instead of the loose files; draw mseftbb01s as point sprites), then a decode run for the msparticle draws on both platforms. 0c. Title screen (15, docs 11-12 title): drawing decoded; a build run next (title scene from the tables, levels from the tick), then a short decode run for the movie open path and the shared dialog, and one footage comparison of the intro. 0-move. Movement parity (9, docs 11-14 movepar): decoded to the tick; a build run next (integer angles + sine table, state 1 order, turn starts, air turn step, roll along the facing, floor flag, contact order, 1 u long-move back-off), with the replay test of FORMATS “Movement parity” section 8 built first; then one recording session (needs the playtester for the capture) for the bench cases and the tolerances. 0d. Skill records (5, docs 11-13 step3): every unplayed record has a decoded path except the deck view (1) and the levitates’ hold (2). Build runs next, by records unlocked: the card eraser (19 + 6 close-range), the refusal fix (5), level cost (6), the instant sets (erase 9, special 7), status leftovers and auto cards (8), hit effect 45 (3), fast rain (3), hold (3), set 6 (2). Decode leftovers: state 0x18, the levitate hold, reaction row + 6.

  1. Lock-on and targeting (8): decoded in branch lockon (section 8); the vertical aim of casts is decoded (docs 11-10 vaim) and waits for a build run plus a footage check; other leftovers are ledger rows.
  2. Match flow (2): done in branch matchflow (phases, end check, time-out, pit). The loading screen and the results screens are decoded (docs 11-10, hudtext); the heavy mode is game rule 4 (docs 11-10, rules). Left: the countdown / KO / time-up art.
  3. In-match camera (10): decoded (docs 11-10: the full tick, presets, walls, yaw-follow, lock turn, spectator camera, shake application). Left: an implementation run, then the shake sources’ numbers and the look-at anchor point.
  4. Status effects and the instant/environment sets (5, 6): decoded (docs 11-10): slots, status set, hit effects, environments (FORMATS “Status slots, hit effects and environments in full”); sets 1 and 3, the formulas, ricochet, the kinesis cast side and the remote mine (FORMATS “Skill casting leftovers”: 281 of 387 usable records fully written up, coverage table there). Left to decode: the stance and deck view action states (0x15 / 0x16 / 0x18), hit effect 18, card fields 0x5C..0x60, fast_rain, the auto-shelter pass list. The larger part left is implementation: power carried by the shot and compared by the block, the formulas, the skill-allowed check, the hit-effect table, environments with capture.
  5. 30 Hz fixed tick (1, done in branch gamespeed): step gameplay at the game’s rate (also simplifies netplay ticks). Mostly an implementation run; the constants are decoded.
  6. Wall pass and body push (9): decoded (docs 11-10: collision response, body push, attribute table, masks, shot casts, ground attribute); left: implementation, the cast each skill kind uses, the turn step and roll steering.
  7. Stage objects (11, 14): breakables and pieces decoded (docs 11-10), the pieces’ start pose (docs 11-13 piecepose; climb re-check 11-13: the gravity / launch factor record is decoded and is not the cause of the Palace deck climb; the object pass, the 8-tick delay and the exact launch jitter are decoded (climb 3); the point numbering, the constraint table, the cell order and the rest rule are decoded (collapse 6, 11-14); next = put those four into the build and re-measure, plus side-on footage of section 1; deeper joints); jump pads, throwables (object side), support links, timed falling platforms, the net events and a hazards-per-arena table decoded (docs 11-10 stageobj2); link tests, the links per stage, the crumble variant and the collapse family decoded (docs 11-12 collapse). Left to decode (the 0x400 attack body and landing damage are done, docs 11-13 hurt; the crater placement is done, docs 11-13 landmark, its debris manager and mark models are done, docs 11-14 crater: a build run): collapse animation export, falling platform numbers. Mostly an implementation run now, cheapest arena first (st07: jump pads only). (docs 11-15 stagefx) The Highway storm sphere, the pieces’ impact sound and the object hit mark are decoded: a build run (converter: second vksand texture, scroll rates, MD00 pairs; Godot: sphere at the eye, piece thuds, mark on object hits). Small decode left: the shot callback’s kind words.
  8. Per-character data (13): decoded (docs 11-09); left is implementation (converter columns, turn step, body size, lying-pose rule).
  9. Battle HUD from the game’s textures and font (15): sprites done (hud run), font atlas layout done (docs 11-09); font widths, text drawing, status icons and the menu script VM done (docs 11-10); now an implementation run (PdFont, icon row, result banners, results list). Left to decode: the status panel’s other-player rows and animations. Menus (docs 11-10 menus): engine, menu table, screen graph and the split-screen versus path decoded; next is an implementation run (script interpreter + menu engine running the user’s vsmenu), then a decode run for the arsenal editor screen and the window frame.
  10. Audio leftovers (16): decoded (docs 11-10 audio): stage ambience, countdown, menu cues, footstep table, music payload spec, the unused XACT bank. Left is implementation (music converter step and player, stage emitters, countdown) and the small leads: battle cue sites → events, footstep trigger states. Ambient run 11-14: 3-D sends, listener, volume classes and the event length decoded; left is implementation (stage bank + emitters, the 3-D send routine, event length) and the leads: effect sends 11 / 12, the class fader’s users, the Doppler step.
  11. Arsenal builder rules (12): decoded (docs 11-10 rules run: copy limit 3, school capacity, rule flags, lobby check). Left: implementation; the capacity’s source. 11a. Versus options, teams, pad mapping (8, 18): decoded (docs 11-10 rules run). Left: the lobby’s team-side choice, respawn rules, the unread pad bits; then the 2v2 / 4-player implementation.
  12. Rumble (17): decoded (docs 11-10 audio); left: implement the cast sequencer; shake-source numbers come with the camera shake sources (10).
  13. Original network model (21): battle side decoded (docs 11-10: packet, reliability, all 26 messages, remote playback, clock stall, authority) and, docs 11-12 netcompat, the mesh layer, wrapper, header and lobby messages, with Rebirth’s EOS mapping described (converter/NETCOMPAT.md). Docs 11-12 netcompat2: session control (join / reply / introduction / leave / keep-alive / ping), mesh searched to the end, lobby values, card trade, skill object net classes. Docs 11-14 netmsg: verified on two captures of a live Rebirth 1v1 (all datagrams parse; corrections and the event timeline in FORMATS “Versus network messages”, parser converter/netmsg.py). Left for the compatible mode: the join / hello on the wire and a 3-4 player capture; then it is an implementation project (task list in NETCOMPAT.md).
  14. CPU opponent (19): data files, tick, input path and built-in table decoded (docs 11-10 cpu); the shot-threat built-in 0x40BA is read for every behaviour and the sight pair’s point is identified (docs 11-12 doc-body, M). Left to decode: the route follower / stuck recovery insides and the CPU battle menu’s character and deck choice; then an implementation run (script interpreter for eneprog006, built-ins, nav conversion).
  15. Fire shot differences (25, docs 11-13 bofcmp): stage effect light, cast pose and the flash / burst elements decoded. The character aura glow is decoded (26, docs 11-14 auraglow) up to its filter taps and composite. Next decode runs, in order: the aura glow’s GFilter2 taps and composite (0x140287460, then a build run); the joint rotation after the animation evaluator (arm pose); the additive particle sum (render probe first); the skill card gate at a cast press; msparticle00.