Repository navigation
Fighter Recompiler Status
Scope: living progress page for the fixed Fighter recompiler plan. It records the current milestone, the task list and acceptance checklist agreed when each milestone starts, debt, owner decisions and baseline identities. Update it in the same PR as the work it records. The plan itself is not edited here.
Milestone 6 — next fighters: Rayden (MKT fighter 24), started 2026-11-13 (amendment 1: decisions and his power slots). Milestone 4 (Reptile) shipped as a product Fighter option (PRs #209, #210); its record follows below.
Steps as for Reptile: body, inputs, specials, icons and description, product option.
His MKT commands (reading aid, --fighter 24; Static-confirmed):
| Command | Action → body | Move |
|---|---|---|
| press 1, tokens D,F |
0x8004FA44 → special 0x2E → 0x80077DF8(0)
|
Lightning: proj_process(0x80077F2C), then sleeps 0x30 and 0x24
|
| press 1, tokens D,B |
0x8004FA64 → special 0x36 → 0x80077DF8(1)
|
the same bolt with flip_single (thrown the other way) |
press 6, tokens D,U; ticks_since(0x8012C668) ≥ 0x40
|
0x8004F3F8 → propell 0x1D → 0x80045624
|
Teleport: stamp_tick, sound 6, table-0 slots 0x21 (appear) and 0x22, match_ani_points, face_opponent
|
| press 8/9, tokens B,B,F |
0x8004F3A0 → propell 0x1E → 0x800450D4
|
Torpedo: towards_x_vel(…, 0x80000), table-1 slot 0, strike, then do_jump(0, 0xD999, 0x6CCC) back |
release HP; held ≥ 0x38 ticks (0x80257738) |
0x8004EBA0 → quick 0x1D → 0x80073228
|
Shocker: sounds 0xC and 5, table-1 slot 2, an opponent hold; details Pending |
Body proof v01 (MKMSZR_build_rayden-body_proof_v01.py; his description fighters/rayden.json, body only):
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_rayden-body_common_proof_v01.z64 |
48a618623ff39d514bb44368e7d98909e286fb89a581519279472873930a0e4b |
Sub-Zero's body replaced by Rayden's (142 frames, auto colour, the generic common animations, his MKT voice set); Sub-Zero's specials. Four generic body-builder changes came with him (below). Previews of every slot were shown to the owner before the build. | Pending owner test |
-
Cross-script jump (Static-confirmed): his sweep getup (slot
0x22) shows one frame, then jumps into his getup (slot0x21) at its second frame.body_build.linearisenow copies a jump into a script it has not reached inline. -
Taller images (Static-confirmed): frame
0x15DC(codec 22) decodes 125 rows for a 124-row descriptor. MKT draws the descriptor's rows from the top; frames with extra whole rows are cropped. -
Rising ramps (Static-confirmed): his palette (
0x800A3660[24]=0x800B9AAC) runs from dark to light (black up to cyan, greys up to white);palette_rampstook only light-to-dark runs, so every entry became its own ramp and the reduction fell back to median cut (speckled whites). Ramps are now found in either direction. Across the roster only fighters 3, 11 and 24 split differently; Reptile and Sektor are unchanged (test). -
Silhouettes (Static-confirmed; owner video and screenshot): seven codec-15 frames (
0x1CF8..0x1D88) are his white teleport. MKT uses them for the teleport and also as the first part of his getup and of a hit animation (owner: "the getup and the teleport use the same white animation"). Their descriptors name their own 8-colour palette0x800B9AF0(white to light cyan). The builder leaves such frames out of the body reduction and maps each of their colours to the nearest body colour. Only codec-15 frames are treated so: his first stance frame names0x800BB7EC, but its pixels only fit the table palette (rendered both ways), which settles the Pending note on fighter 24's palette layout above.
-
Body: a test ROM with Reptile's body (generic body builder, computed layout, auto colour) and his MKT voice set. The owner checks poses, colours, the common animations and the voices.
-
Inputs: combos and the remaining easy animations. Reptile's MKT special commands are wired to Sub-Zero's stock specials for now. Split into 2a (combos, combo animation, throw) and 2b (special commands; the host HP table needs room for three records, and the forceballs need their both-buttons condition).
-
Specials: each step changes only the actions; the commands from step 2 stay. Order and replaced power slot:
Order Reptile Replaces (Sub-Zero slot) 1 Acid spit Ice Blast (1) 2 Slide Slide (2) 3 Forceball (fast) Directional Ice, up/down Ice Blast (3) 4 Forceball (slow) Ice Clone (5) 5 Reverse Elbow Ice Shatter (6) 6 Super Slide (host power, new for Reptile) Super Slide (7) 7 Invisibility (Eye stealth) Freeze on Contact (8) 8 Polar Blast (host power, new for Reptile) Polar Blast (9) Acid spit and both forceballs count as one step (shared projectile lowering). Air Ice Blast (slot 4) is not in the list: removed, as for Sektor, its slot left blank for now (owner-confirmed 2026-11-11).
-
Description: Reptile's fighter description: slots as above, costs reused from the replaced Sub-Zero powers for now, removals and presentation (title, power names and help text, icons, outfit colours).
-
Full-seed run through the production build path, then the Sektor regression check.
- Reptile adds no code outside his description and reusable components (review and test).
- The owner accepts at runtime (bounded) the body (proof v03, 2026-11-11).
- The owner accepts at runtime (bounded) the inputs and combos (inputs proofs v03 and v05, 2026-11-11).
- The owner accepts at runtime (bounded) each special, in the agreed order (2026-11-12; Polar Blast deferred for every fighter, owner).
- The owner accepts a full-seed run.
- Sektor regression unchanged, or the difference explained and re-accepted; full suite passes; this page updated in each PR.
Step 1, body. Builders in Experimental/FighterRecompilerProofs/ (disposable test ROMs; MKMSZ USA Rev. 0 clean ROM plus MKT N64 USA Rev. 2).
| Test ROM | SHA-256 | State |
|---|---|---|
MKMSZR_reptile-body_common_proof_v01.z64 |
452e6afe85fb1e8b0f3897a39d970c65f7917285c13096282fec0a9247ca6569 |
Rejected / failed in part (owner, 2026-11-11): colours wrong; dead pose not lying flat; HP↔LP switch shows no animation; combos missing (step 2). Reproducible at commit dc6cc5a only. |
MKMSZR_reptile-body_common_proof_v02.z64 |
e5cd5d5149d1d16370fa92a10ea48c9ebea67c21c72b0c60901f5faacf62ccef |
Runtime-confirmed (bounded) by the owner for the lying pose (death and knockdowns) and the HP↔LP switch (both orders). Rejected / failed for colours ("as if the palette was mapped wrongly"; compared with MKT's character select). Pit-fall pose accepted as is. Reproducible at commit fce72cf. |
MKMSZR_reptile-body_common_proof_v03.z64 |
df6802800031d3b370354669b0173b7e749a5beafa6e5b5b23b781e1132487f2 |
Runtime-confirmed (bounded) by the owner (2026-11-11): colours match MKT ("It's perfect now"). v02 with Reptile's own palette; differs from v02 only inside file 0x87. Body accepted (step 1 done).
|
v01 causes and the generic fixes in v02 (fighter_import.body_build; Sektor's explicit layout and palette are untouched and its pinned outputs are unchanged):
-
Colours (Static-confirmed cause). Median cut merged across hues: black with the heavily used darkest green (the black undersuit turned green), and two greys with skin browns. MKT palettes are laid out as ramps (Reptile: 11 greys down to black, 7 greens, 13 browns). The
automethod now keeps each ramp's colours apart: contiguous segments per ramp, 15 in all, with the least pixel-weighted error (exact arithmetic). A palette that is not laid out as ramps (3 of the 26 MKT fighters' palettes) falls back to median cut. The brown belt, flap and shin wraps are in the donor art. -
Dead pose (Static-confirmed cause). Host routes show only the first frame of the knockdown's second phase (
0x8005AC00:select_primary_phase2(0x1E)and oneanimation_advance), and secondary 9 (lying) points at that phase. Stock Sub-Zero's phase is the single lying pose. Reptile's MKT landing is a bounce frame (0x27C8, legs up) and then lying (0x27DC). The computed layout now keeps only the landing's last frame there, so death and lying end flat. The bounce frame is dropped, and the knockdown now fits in place. -
HP↔LP switch (Static-confirmed cause). Stock primaries
0x0E/0x0Fcarry host-only phases after their loop: retract, a single pose, and switch phases that go through one frame of each punch and jump into the other punch's script (0x58C,0x57C,0x51C,0x50C). MKT scripts end at the loop, so the computed layout left those phases empty. When the imported script has the stock shape up to the loop, it now keeps the stock tail (tokens, operands, jumps) and translates each stock frame to the imported frame in the same place. This gives the same roles as Sektor's hand layout. -
Pit fall (unchanged): the held pose is the knockdown's last fall frame (
0x27B4), as for Sektor. -
Palette, v03 (Static-confirmed cause). v01 and v02 read Reptile's palette from
0x800A1738[19]. That table is not indexed by fighter id past 16: entry17 + kis the alternate palette of fighterk, so v01/v02 used another fighter's alternate (11 greys, 7 dark greens, 13 browns). The per-fighter table is0x800A3660. Its entry equals the palette that the fighter's first frame binds for every fighter with its own art (14 fighters, including 5 where0x800A1738differs). For fighters that share art (ninjas, robots) it holds the costume recolour in the shared layout. Reptile0x800BE864: entries 1–8 skin, 9–16 greys and black (16, the suit, is the most used), 17–31 green, which matches MKT's character select. Fighter 24 binds0x800BB7EC, but its entry0x800B9AAChas another layout. Resolved (2026-11-13, Rayden body): his frames' pixels fit0x800B9AAC;0x800BB7ECspeckles them (Static-confirmed by rendering). Generic projectile proofs v01–v03 showed the same wrong palette for the forceball; v04 onwards bind the forceball's own palette and are unaffected.
Step 2a, combos and throw.
| Test ROM | SHA-256 | State |
|---|---|---|
MKMSZR_reptile-inputs_common_proof_v01.z64 |
fe87bb2af266d0cc6505c4b967f78403ddb5488ae2f323113df0c3f37b698603 |
Runtime-confirmed (bounded) by the owner (2026-11-11): all three combos work, every hit is animated, and the finishers launch correctly with no corruption. The throw is "a bit off but acceptable". Reproducible at commit b9d1c80. |
MKMSZR_reptile-inputs_common_proof_v02.z64 |
51adc9d3c59af671062441020940541ca6d204375d84959a202a2ba5bec196a8 |
Changes from v01: knockback finisher at 10 damage (owner decision, Sektor too: build v62); throw by Sektor's lead-in rule (shift:-1). Owner (2026-11-11): damage Runtime-confirmed ("very good", Reptile and Sektor); throw Rejected / failed ("actually worse ... earlier instead of later"). Reproducible at commit e16c816. |
MKMSZR_reptile-inputs_common_proof_v03.z64 |
a3c7e4487d9dd56d225877862f6e95c7bf6349bf7d4ce76f3030d73c9490e570 |
Runtime-confirmed (bounded) by the owner (2026-11-11): the throw "looks much better now". v02 with the throw one place earlier than v01 (shift:+1); differs from v02 only inside file 0x87. Step 2a done.
|
v01 is the accepted body plus:
- Reptile's MKT combo strings through the generic
fighter_import.combos(record grammar):HP, HP, D+LP,HP, HP, HK, B+HKandHK, HK, B+HK; - his combo animation (MKT table-1 slot 0) in host primary
0x10(body.slot_sources); - his MKT throw poses in the host throw script (
body.phase_slots; host tokens and timing kept).
Outside file 0x87, v01 changes only the CRCs, the kick root (ROM 0xA1CE8) and the records 0xB1CB0..0xB1D00; v02 also changes the knockback damage byte at ROM 0xB1A3A.
Throw timing. In every version the host keeps its throw script (tokens, phase ends, timing), and the donor frames are aligned with it:
- v01 fitted the throw phase by phase: 2/6/7 MKT frames into the host's 2/5/2.
- v02 used the rule Sektor's throw was accepted with. In proof v55 his visuals ran about one tick ahead of the grab, so the fix moved them later and started on the stance pose. For Reptile, this made the throw worse.
-
v03 uses
body.phase_slotsmodeshift:N. Host position p, counted over all three phases, shows donor frame p + N of the grab and throw phases; the stance fills the positions before them, and the retract the ones after. v02 isshift:-1, Sektor's v55 corresponds toshift:-2, and Reptile v03 isshift:+1: his second reach frame, his six throw frames from the second position, then the retract's ends.
Step 2b, special commands.
| Test ROM | SHA-256 | State |
|---|---|---|
MKMSZR_reptile-inputs_common_proof_v04.z64 |
2b7de49257700fba35dddc4a56b8eb094fef9fae79b91f450085f3af0c48a30b |
Owner (2026-11-11): "everything else looking good". Runtime-confirmed (bounded): Acid Spit, Forceball fast, Invisibility and the kept commands. Pending: Forceball slow (see below). Rejected: the slide, which was still the generic duck-based recipe; ninjas have their own MKT slide. Reproducible at commit 469b725. |
MKMSZR_reptile-inputs_common_proof_v05.z64 |
317d2099abc6e1947e8e0e4ada30ee39b00fb2b9ad67a49429607044ec5216a7 |
Runtime-confirmed (bounded) by the owner (2026-11-11): the slide "looks fantastic", and Forceball slow outside Wind takes Ice. v04 with Reptile's MKT slide (table-1 slot 2: crouch and two slide poses) on host secondary 2 (Slide and Super Slide) through body.secondary_slots. Step 2 done.
|
v04 is v03 plus Reptile's MKT commands through the generic fighter_import.commands (description commands), each calling the Sub-Zero power it replaces:
| Reptile command | Calls | Host table |
|---|---|---|
| Acid Spit, F,F + HP | Ice Blast | HP |
| Forceball fast, F,F + HP+LP | Directional Ice (down) | HP and LP, both buttons checked |
| Forceball slow, B,B + HP+LP | Ice Clone | HP and LP, both buttons checked |
| Invisibility, U,D + HK | Freeze on Contact | HK |
| Reverse Elbow, B,F + LK | nothing yet (Ice Shatter has no command record; from specials proof v15 its own special, commands.COMMANDLESS_POWERS) |
LK emptied (v15: the elbow) |
The other powers and records:
- Directional Ice up is removed (D,F + HK).
- Spine Rip and Polar Blast keep their HP commands.
- Slide and Super Slide keep the host's own recognizers (Reptile's MKT slide is the same B + LP + BL + LK).
The HP table grows to five records, so it moves to the v6 proof arena (allocations). The arena's loader also sets maximum EXP, so every power is unlocked. Until step 4 removes Air Ice Blast, Acid Spit uses Ice Blast's stock condition, so an airborne F,F + HP still gives Air Ice Blast from tier 4.
Forceball slow (v04: "didn't seem to work"). Statically, every input order reaches Ice Clone's stock condition 0x8004A22C, as Forceball fast reaches Directional Ice's:
- the held check needs HP and LP at
0x800BF2EE; - the HP and LP tables scan on from the next record when it fails;
- the run double-taps accept forward only;
- Super Slide's check needs exactly LP+HP+Block.
That condition refuses in native stage 1 (Wind, 0x8009A910 == 1), within 320 ticks of the timestamp 0x80111FD4, with Ice below 0x60, while airborne, or without a free 128×128 texture. Outside Wind (v05, owner) the command works and takes Ice Clone's Ice, so the v04 report was the stock Wind refusal. No clone appears with Reptile's body. The clone's own presentation with an imported body is not investigated (Pending, low value), because step 3 replaces the action.
Step 3, specials. Test ROMs build on inputs v05:
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_reptile-specials_common_proof_v01.z64 |
a0b8f788c8100b5fce48125daf399543770e486922f39b0fc3e9a354ea63f6fd |
Both forceballs as Reptile's own specials (special actions). Forceball fast is in Directional Ice's slot (tier gate 0x8004A4F4, Ice 0x60); Forceball slow is in Ice Clone's (gate 0x8004A2A8, Ice 0x60). His MKT throw (table-1 slot 5, phases 1–2) is in host secondary 0x25. The projectile is backend v1 at MKT speeds (fast 0x59999, slow 0x26666) with the accepted strike, arc and sounds. Acid Spit is still Ice Blast. The MKT cooldown and opponent-state conditions are not lowered yet; the host's one-live-projectile rule applies instead. |
Runtime-confirmed (bounded) by the owner (2026-11-11): commands, both facings, speeds, throw timing and position, the toward-arc, sounds, Ice cost and refusals ("looks amazing"). Rejected / failed in one detail: Reptile "blinks" invisible several times while firing. Reproducible at commit d39cd75. |
MKMSZR_reptile-specials_common_proof_v02.z64 |
a5536f176e1ded86b3923a9822ab3969358f7473b611d63c48a69a6fa1549faf |
v01 without the blink. Cause (Static-confirmed): in MKT's throw, the frame after token 12 belongs to the helper object token 11 creates (the ball forming in his hands, frames 0x3000, 0x3028, 0x3050). The frames-only reader had taken them as body poses, so the small glow replaced Reptile for those frames. The reader now skips the frame after tokens 12 and 14. The throw is his five body poses (2FBC 2FEC 3014 303C 3064) and the retract. The ball-in-hand glow is not shown. |
Owner (2026-11-11): blink gone (Runtime-confirmed, bounded); the owner wants the forming ball shown. Reproducible at commit 9c5d63f. |
MKMSZR_reptile-specials_common_proof_v03.z64 |
94ebebe615cd7ce828eb39eb9dc84ef353f533e44547096c8c2f7e668f1aeb94 |
v02 plus MKT's throw helper, the ball forming in his hands:
0xF30 bytes. |
Owner (2026-11-11): shown, but Rejected / failed on placement and timing: it formed over his chest ("more to Reptile's front") and too late ("sooner"). Reproducible at commit cf45a90. |
MKMSZR_reptile-specials_common_proof_v04.z64 |
9f007285862837657bae6d8db47c6baf9ec711e19a92f7611c051968bc6d1677 |
v03 with the helper aligned to Reptile and earlier:
|
Rejected / failed (owner, 2026-11-11): still not in the right place, now low in front of his knees. After the forming ball and the flying ball were both on screen, the game crashed (black screen, artifacts, emulation stopped). Reproducible at commit c5dfc7f. |
MKMSZR_reptile-specials_common_proof_v05.z64 |
b080dafc3796e952bc4c4985e4c788c2b6faddbd6e2822fdf7cb513ec437f8d1 |
v04 with a handover and a height fix:
0x1010 bytes, in a 6 KiB arena: ROM [0xF10000,0xF11800), heap floor 0x801B0C20. |
Runtime-confirmed (bounded) by the owner (2026-11-11): no crash. The forming ball was "still a bit too slow": at the arm-up pose MKT shows the large crescent 0x3050 and v05 a thinner, earlier frame. Reproducible at commit 077d8b1. |
MKMSZR_reptile-specials_common_proof_v06.z64 |
4f7803ee2deb4fccb24a612804dd3cfd9473eaecdab943e0962bb4bb1b8d2f34 |
v05 with the helper at the body's real pace. Cause (Static-confirmed): the host's animate-to-phase-end 0x80031070 sleeps rate - 1 for an odd rate ≥ 2 (0x80031094..0x800310AC), so at rate 3 the throw changes pose every 2 ticks, while the helper stepped every 3. The helper now steps at phase_end_ticks(rate): 2 ticks per frame, 10 ticks in all. |
Rejected / failed (owner, 2026-11-11): the big crescent 0x3050 (the arc spanning both hands with a bright end at each, as in MKT) still never shows; at the arm-up pose the thinner 0x3028 is on screen. The owner also recalls a later MKT frame (the arc mid-way into the ball) that is missing. Reproducible at commit 538a241. |
MKMSZR_reptile-specials_common_proof_v07.z64 |
9dae0e937f958bec723cf95aa11bb4caa21ae6c2d142c9127ae4abac872c18e3 |
v06 with the helper two poses ahead of MKT's script (helper_lead=2). Its own process runs about a pose behind the body: it is scheduled after the action and needs a frame to build. The tiny 6×7 spark 0x2FD4 drops out; 0x3000 shows with the first pose, then 0x3028, then 0x3050 until the launch. The later "arc into ball" frame is in neither the throw script (table-1 slot 5, parts 1–2) nor the flight part (0x3078/0x308C/0x30A0); its source is Pending (owner to compare). |
Rejected / failed (owner, 2026-11-11, five screenshots). The target per body pose is: nothing, nothing, small arc, big arc, broken arc. v07 showed arcs from the first pose, the big arc a pose early, and no broken arc. Reading of the owner's sequence against the script: the spark 2FD4 (6×7) is "nothing", 3000 the small arc, 3028 the big arc, 3050 the broken arc. That is MKT's exact script order, one helper step per body pose. Reproducible at commit a8ef922. |
MKMSZR_reptile-specials_common_proof_v08.z64 |
77bf582d70e3ace08bf6267a20b7260560a0d42821f9988c375d32357de391ae |
The helper follows the body instead of a clock (emit_helper(body_slot=...)). Each tick it reads the player's cursor in the throw script (S25): after body pose k is shown, the cursor is start + 4(k+1) (animation_advance 0x800304C0 reads the word, then advances; Static-confirmed). It then shows that pose's helper frame: 2FD4 with pose 2, 3000 with 3, 3028 with 4, 3050 with 5. It is built when pose 2 comes up and goes at the launch handover. The helper script is one word per frame. Payload 0x1080 bytes. |
Runtime-confirmed (bounded) by the owner (2026-11-11) for timing and frames: "almost perfect". Only the height is off, "1 or 2 pixels down". Reproducible at commit f04ad00. |
MKMSZR_reptile-specials_common_proof_v09.z64 |
b5ebb1d74a27fb715cd87334b92d12789104c9fead9663848bd4fe5496f2bf0b |
v08 with the helper 2 px higher (owner fine-tune HELPER_DY_PX = -2 on the ball's height). |
Runtime-confirmed (bounded), accepted by the owner (2026-11-11). Both forceballs are done, with the forming ball. Accepted detail: the flying ball starts "2–3 pixels too close" to Reptile (spawn x offset; revisit later if wanted). |
Step 3.2, Acid Spit.
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_reptile-specials_common_proof_v10.z64 |
7a9394536b68fef282799083c59a7a04045afa229187ee29fed13b038e80b61d |
|
Rejected / failed (owner, 2026-11-11):
6fde7ac. |
MKMSZR_reptile-specials_common_proof_v11.z64 |
2e885824419c6aa061d793d9466892d42ea714a210cf07c8edfa066f1cd17a85 |
v10 with the owner's Acid Spit report (2026-11-11) addressed, and both forceballs at once:
|
Rejected / failed for the hitbox (owner, 2026-11-12): now "too wide, it's kinda hitting everywhere". The other fixes are still to be confirmed. |
MKMSZR_reptile-specials_common_proof_v12a.z64 |
3d59a6af6c36a42421397dbabc7ead0002b5c5fa5927c4d2fd28f3896a088b83 |
v11 with a shorter acid strike band (strike box and both close-range checks): y 21..61, 40 units, half of v11's. That is MKT's band plus 22 units below it. MKT's x and width are kept. The spit's visible flight pixels are y 25..29 in the object's frame. | Superseded by v13 before testing: the box analysis predicts no hits (see v13). |
MKMSZR_reptile-specials_common_proof_v12b.z64 |
adade81d904865ab30e620a6d5407dd5ab9dd678558be05c8e8f84179aecd5ff |
Same as v12a with y 21..45: 24 units, twice MKT's, which is MKT's band plus 6 units on each side. | Rejected / failed (owner, 2026-11-12): "not hitting at all". |
MKMSZR_reptile-specials_common_proof_v13.z64 |
b506bdf0da9d2de06150af37339187bde18dad9500cb6e6136abae6aadc488d9 |
v11 with the acid box placed on the drawn spit (lower_projectile.centre_on_art):
|
Runtime-confirmed (bounded) for the hitbox (owner, 2026-11-12): "feels better". The splash showed "way lower" than the hit (fixed in v14). |
MKMSZR_reptile-specials_common_proof_v14.z64 |
1a8e7409f445ccd4ce0ac32c4ed5d7012b0a612da81b3d1e71e592a3fb9def4a |
v13 with the acid splash at the height of the hit.
|
Runtime-confirmed (bounded), accepted by the owner (2026-11-12): "looks good". It includes v11's fixes (no turning, 15-tick recovery, arc frames once, splash not mirrored) and v13's box. Still open:
|
Step 3.3, Reverse Elbow.
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_reptile-specials_common_proof_v15.z64 |
04bef2c418dadb36b5a9b4d82795655e5ca33fe994077f30883f83badcad6c01 |
v14 plus Reverse Elbow (B,F + LK) as Reptile's own special.
|
Runtime-confirmed (bounded), "almost perfect" (owner, 2026-11-12), except:
e36d487. |
MKMSZR_reptile-specials_common_proof_v16.z64 |
4d445b0a41dbfd01b24aa08032463263417fede0d3d82b8a0dc0c609e98963c5 |
v15 with the report addressed:
0x8002DF28..0x8002DF4C; 0x8002E104 awards XP from strike-record byte +0x0E, which our special strikes leave at 0), the reaction preamble 0x80053028 / 0x80053520, the generic special start 0x80032880, and the per-tick floor and platform check 0x80024BA8. |
Runtime-confirmed (bounded) (owner, 2026-11-12): "almost perfect ... looks marvelous". Pass-through, the still hold and the roundhouse launch work. Clearing actor bit 0x1000 plus re-applying the speed lets him through; which of the two is needed is not isolated. Two details remained: a blood effect while passing through, and no footsteps. Reproducible at commit 926127f. |
MKMSZR_reptile-specials_common_proof_v17.z64 |
942c18809e8add0094f0cb5b500d26819da968f11c37489cfff519e904ec1bc5 |
v16 with:
|
Runtime-confirmed (bounded), accepted by the owner (2026-11-12): "it worked perfectly". Reverse Elbow is done. Merged in PR #206. |
Step 3, Slide and Super Slide: Runtime-confirmed (bounded) by the owner (2026-11-12): "Slide and Super Slide work perfectly". Both keep the host's moves with Reptile's MKT slide animation (secondary slot 2, inputs proof v05); no further work.
Step 3, Invisibility.
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_reptile-specials_common_proof_v18.z64 |
41e4f3f3e2344520057c6449df9f8acd1d69b51ee027bd6aed67750fc57b2a5c |
v17 plus Invisibility (U,D + HK) as Reptile's own special in Freeze on Contact's slot.
|
Runtime-confirmed (bounded), "very good" (owner, 2026-11-12), with three requests:
|
MKMSZR_reptile-specials_common_proof_v19.z64 |
89329394fb1fd0f9cae06b01a315b99d6ea6b3b96fb15fd708c346e6e8ca09fd |
v18 with the owner's requests:
|
Runtime-confirmed (bounded) except two details (owner, 2026-11-12):
|
MKMSZR_reptile-specials_common_proof_v20.z64 |
2e9ab9c6beb2fcc2e4f42af5590d0b4534b5705d297d08af3493d18699970d59 |
v19 with:
|
Runtime-confirmed (bounded) (owner, 2026-11-12): no further Invisibility notes; "Reptile is almost fully done". Invisibility is done. |
Polar Blast (owner, 2026-11-12): deferred to a later stage for every fighter, Sektor included ("not sure what to do with that one"). It keeps the stock power and icon.
Step 4, Power Ups icons.
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_reptile-specials_common_proof_v21.z64 |
7e96c139341af99bfa2fef1ee0c5f5f61e9d91a3308a5243f61c0ffceba8014e |
v20 plus Reptile's Power Ups icons, from the icons recipe in his fighter description, built by the reusable fighter_import.fighter_icons.
|
Runtime-confirmed (bounded), accepted by the owner (2026-11-12): "The icons look amazing ... Reptile looks amazing. I guess this means it's done." |
MKMSZR_reptile-specials_common_proof_v22.z64 |
1ae769b5831b620514794851436df2d400e445b07a540a55f9e22e29150a5296 |
v21 with the rest of step 4 from his fighter description.
|
Pending owner check (text only) |
Step 5, production (milestone 5 work, agreed 2026-11-12: production builder for described fighters, generic Fighter option, composition proof, then the product option and the full-seed run).
-
Generic builder (
fighter_import.fighter_build.build): a described fighter built into a 16 MiB image from its description and components, without the proofs' harness.- Per-move owner tuning lives in the description's new
specialssection. It covers offsets, facing, recovery, the per-move projectile limit, footsteps, stealth drain and effects, in build order. - Moves with the same projectile art share art, helper, sounds and strike data.
- Selectors (from 3), spare reaction entries (
0x2B,0x23,0x4C) and isolated sound chains are allocated from pools. - Static-confirmed: for Reptile it reproduces the accepted v22's payload and fighter file byte for byte (test pins). The rest of the image differs from v22 only in the proof harness and in the presentation, which the product patch applies.
- Per-move owner tuning lives in the description's new
-
Production placement (
fighter_build.production): Sektor's accepted "option C" layout, made generic.- The payload is a relocatable blob in the free body tail of the fighter file. Links at three bases find 94 relocations; the deltas are 16-aligned, because the payload aligns its records.
- The 17 stock words that point into it are refreshed by a
0x244-byte fixed loader in file0x1A. The moved HP command table is read through a pointer word, the fixed part's first word (commands.install(indirect=...):lui a0; lw a0, lo(a0)at ROM0x3D48C). - The fighter file and samples are in the generated-output tail. Sub-Zero's stock file and the proof scratch stay clean.
-
Generic Fighter option (
patches/fighter_swap._apply_described): every word the production build changes is the fighter's, so no list is kept. The owner-conflict check, the tail, the fixed loader, and the icons and help from the description follow. Sektor's path is unchanged (his pinned build tests pass). -
Product option (2026-11-13, owner: "let's add this to the webapp character selector"):
reptileis aRandomizerConfig.fightervalue, a CLI--fighterchoice and a selectable cell in the web "Swap character" window (MKT fighter id 19, column 4, row 1). The web fills the title withREPTILE. Outfit (owner, 2026-11-13: "I want the recolors on Reptile as well"): his description'soutfitnames his body palette's greens, entries 10–14 (15 is near-black, as Sektor's excluded entry 1), and his own colour, green. The genericfighter_import.outfitapplies the same modes as Sektor's: hue presets, seeded, custom RGB and hue set an absolute hue;greenis no change andredswaps red and green. Skin, greys and black stay. The recolour is applied to his fighter file in the tail (_apply_described); a described fighter withoutoutfitrefuses a non-vanilla outfit. A stance preview of every mode was shown to the owner before the build. Test: a purple build changes only those five palette words of his file. Runtime Pending.-
Implementation/CI-confirmed: CLI
--fighter reptile --seed REPTILE-PROD-1(defaults otherwise) is byte-identical to the owner-validated composition v03 (SHA-25631c22f52…; test pin). The production build takes about 17 s in CPython, against 12 s for Sektor. -
Full-seed runs (static, builds only): seed
REPTILE-FULL-2with--edition-name REPTILE --enemy-randomization --shuffle-power-progression --required-powers seed --global-completion game_beatable --difficulty medium --lives 3 --continues 2(SHA-256d9d513fa…), and seedREPTILE-FULL-3with--no-powers-as-pickups --debug-all-keys --no-persist-hp(SHA-25606fedd08…). Both build with no owner conflict. Runtime coverage is Pending. - Sektor regression: his pinned build and CLI tests pass unchanged, and the select screen's Sektor-only render keeps its digest.
-
Browser (Implementation/CI-confirmed, headless Chromium on the local site):
- the Swap window shows Reptile in colour ("REPTILE — click to select");
- choosing him sets the title to
REPTILE, locks Specials Modern, keeps the outfit option, and builds the ROM; - the browser output with seed
REPTILE-WEB-1and the web defaults (outfitseeded) is byte-identical to the CPython build of the same configuration (SHA-256098b5d12…). Before the recolour (outfit locked to Vanilla) the same check gave920e921f….
-
Implementation/CI-confirmed: CLI
| Test ROM | SHA-256 | Contents | State |
|---|---|---|---|
MKMSZR_reptile-production_composition_proof_v01.z64 |
b4787dcdab82f88e215a3f2ae1fdffa53e33b81b1af024f05e5149a3190f3432 |
A CLI randomizer ROM (seed REPTILE-PROD-1, defaults: Sub-Zero, SPECIALS: CLASSIC) with Reptile put in by FighterSwapPatch("reptile") through the generic path: 1120 words transplanted with no owner conflict. Icons go into the inventory HUD's relocated file 0x5D. His code runs from his fighter file for the first time. |
Pending owner test |
MKMSZR_reptile-allpowers_production_composition_proof_v01.z64 |
3b702584a54d604e27646255ada3b3b9accce4c709efc7597633febc75c80e10 |
The same with --all-powers (XP 20000 at every stage entry; the Sektor composition builders' test convenience). |
Runtime-observed defect (owner, 2026-11-13): if Reptile is hit during a forceball throw, the forming arc (the throw helper) stays until its 120-tick cap. The helper ended only on the launch request; the defect is in every earlier specials proof too. |
MKMSZR_reptile-production_composition_proof_v02.z64 |
ef332aefa0be3c50ba6672d5495a59f4584b48e68fb63d727feb8608e6826fa3 |
v01 with the helper fix: lower_projectile.emit_helper also ends as soon as the owner is in a hit reaction (controller +0x6BE bit 0x04) or in another action than at its start (+0x6AA). The same applies to the acid's mouth helper. Same seed and options; 1120 words. |
Pending owner test |
MKMSZR_reptile-allpowers_production_composition_proof_v02.z64 |
723014dec77e9c4759dcb8296bd3a951e19eceaa34cbe365531e2d42f2369d42 |
v02 with --all-powers. |
Runtime-observed defect (owner, 2026-11-13, Temple, lower floor, save state supplied): a slow forceball hitting an enemy hung the game. Before that, on the same floor, slide inputs did nothing; the owner had all powers and had collected a Power Upgrade. Diagnosis below. |
MKMSZR_reptile-production_composition_proof_v03.z64 |
31c22f522fe98cbc3230793b405a64b65ff7ec5f9310b301242d1761db23d93c |
v02 with the knockback fix: the forceballs' knockback reaction calls the two stock victim morphs first (0x800572C4, 0x80057478), as the stock launch reaction 0x0C does (lower_projectile.REACTION_LOWERING["knockback_arc"], ten words). Same seed and options. |
Runtime-confirmed (bounded) (owner, 2026-11-13): "v03 works, the forceball no longer hangs on the monk". The report does not say which of the two v03 ROMs was used. |
MKMSZR_reptile-allpowers_production_composition_proof_v03.z64 |
a70542cd3232270f919dd31bb380bb367bdfe31909dfb5145ef01a5705a79e9e |
v03 with --all-powers. Static check: in the 16 MiB part it differs from v02 only in the checksum and in three ROM-default words of stock pointers into the blob (reaction entry 0x23 and two command-record words at 0x800B0F14/0x800B0F40), which the fixed loader rewrites at load; the rest is the fighter file in the tail. |
Runtime-confirmed (bounded): see the v03 row (one owner report for v03). |
Composition v02 hang (static diagnosis of the owner's save state, 2026-11-13).
-
Where: the game thread (libultra thread 2) is stopped by a CPU exception: a TLB store miss (cause
0x0C, bad address0x133216F8) at stock0x8001BF04, in the frame reader0x8001BDA0that the script interpreter calls at0x80030E3C. It runs on the hit enemy's process stack. The other threads only wait, and the CPU idles, so the screen freezes. -
Why: the enemy is a Temple MONK3 (actor type
0x78 = 2). Its own fighter file has only six primary roots filled (0,3,0x0E,0x1C,0x1D,0x2B); roots up to0x28are otherwise0xFFFFFFFF, and the rest are 0. The forceballs' knockback reaction is a copy of host reaction0x25(0x80057C14). It plays the shared root0x1Ethrough0x800321D0(sixth argument) with no morph first. So the script cursor became file base − 1, and a pixel word was read as a texture-slot number. -
What stock does: the stock launch reaction
0x0C(0x80052898) first calls0x800572C4and0x80057478on the victim. For type 2,0x800572C4rebinds the actor to MONK2's file (0x801AE46C, file0x89, where root0x1Eis+0x518) and makes it type 1. Host0x25has no morph, so in stock it is never used on such enemies. - Static checks on the state: Reptile's relocated blob in RAM equals the build relocated to its load address, except one runtime data word. All 17 refreshed pointers hold the expected values. The relocation is not the cause.
-
Other reactions: the Reverse Elbow hold selects no animation, the acid stagger (a copy of the stock Fire trap stumble) already calls
0x800572C4, and the roundhouse uses stock0x0C. Only the forceballs' knockback arc lacked the morph. Strong inference: the earlier proofs' forceball tests only hit enemies that need no morph. -
Slide inputs (Pending): in the save state, the native special lock
0x800BF308is 1 while Reptile runs (action0x30E). The stock special recognizer0x8003C9B4skips every special input, Slide included, while the lock is set. The XP gate is not the cause: XP is 20000, and Slide's tier check evaluates current XP. The forceball still worked because it is a command-table move. The lock was set when the forceball began, so this post-crash state cannot show what set it before. A save state taken while slides fail (before any special) is needed.
Other stand-in poses left after the body: relocated stock scripts that nothing points to any more, and host-only states with no MKT counterpart established: the Ice projectile script P24, inherited "flipped by" labels P28–P31, and secondary slots S05–S0C and S2A. These are not "easy" animations; reachability is Pending.
Milestones 2 and 3: done (2026-11-11).
Milestone 3:
- Reading aid: command record → MKT routine → annotated disassembly, with known engine calls named, constant arguments resolved and unknown calls flagged — done (MKT move readings;
fighter_import/reading.py,mipsdis.py). - Registry of the MKT engine routines that Sektor's and Reptile's specials use — done (
fighter_import/mkt_registry.py). - Annotated readings of all Reptile specials (acid spit, both forceballs, invisibility, slide, elbow dash) — done for the move bodies; Pending: the readers of the invisibility flag and of the slide stamp.
Milestone 2:
- Component catalogue page: meaning, parameters, neutral units, ending and MKMSZ lowering — draft done (components;
fighter_import/components.py), awaiting owner review (task 7). - Done (static): RE check of the reuse ideas, both host-side: MKMSZ Quan Chi's forceball and the Eye item's effect for invisibility. Quan Chi's forceball is a code/gameplay reference for projectile creation, hit triggers, the launch effect and sound; the assets still come from MKT (owner, 2026-11-10). Findings on components: Quan Chi's projectile uses the native enemy-projectile build and collision path, which a type-4 (player) projectile can use after one guarded table edit; the Eye is a timed stealth-from-AI state with a dark tint.
- Move-program format and validator; Reptile's and Sektor's moves written as data; gaps listed — done (
src/mkmszr/fighters/moves/*.json, 12 gaps listed). - Owner review of the catalogue.
- Backend v1, starting with the generic projectile (no Ice Blast patching) — proof line done: generic projectile lowering, Runtime-confirmed bounded in proof v06 (Sub-Zero throws Reptile's MKT forceball; owner: "really good"). Backend v1:
fighter_import/lower_projectile.pybuilds it from the move program; proof v07 (backend, fromreptile.json) is byte-identical to v06.
- Every special of Sektor and Reptile is read, with unknown calls flagged and nothing guessed (
tests/test_fighter_reading.py: no unknown calls, ROM-backed). - The registry covers every routine those moves call.
- Provenance convention agreed (owner, 2026-11-11; enforced by the program validator).
- Component catalogue reviewed by the owner (2026-11-11; answers under Owner decisions).
- Every Reptile special and every Sektor move expressible as a move program; gaps listed (
tests/test_fighter_components.py). New components follow the owner review. - Each implemented component has a lowering test (
projectile:tests/test_lower_projectile.py). - Generic projectile built without Ice-root patches (backend
lower_projectile; v07 = v06 byte for byte, Runtime-confirmed bounded). - Sektor's pinned outputs unchanged (
tests/test_fighter_swap.py, ROM-backed); full suite passes; this page updated in the same PR.
Milestone 1 — Fighter description and generic body builder: done (2026-11-10).
- Inventory every Sektor-specific item and classify it — done: Fighter recompiler inventory.
- Fighter description format (body part), JSON with a validator; descriptions for Sektor and Reptile — done (
fighter_import/description.py,src/mkmszr/fighters/*.json). - Generic body builder: split
sektor_build.pyinto a generic builder plus Sektor's description, leaving the frozen move code untouched; only frames used by mapped animations and declared extras are imported — done (fighter_import/body_build.py; Sektor's accepted layout is data insektor.jsonbody.layout). - Codec 23 and a roster-wide decode test — done (also codec 16, even-height storage and multi-part records; findings).
- Size report and Reptile's body built statically, with the colour method
auto— done (computed layout; Reptile fits with0x13E88bytes free for moves).
- The inventory classifies every item; nothing is "unknown".
- The validator accepts Sektor's and Reptile's descriptions and rejects broken ones (
tests/test_fighter_description.py). - The generic builder plus Sektor's description reproduces the pinned Sektor build byte for byte (
ad2ceb4b…ed86;tests/test_fighter_swap.py). - A test checks that no Sektor-only constant from the inventory remains in the generic builder (
tests/test_fighter_body_build.py). - The roster-wide decode test passes, or its documented exceptions are listed (Sonya slot
0x15object descriptors; ids 26–30 are not fighters). - Reptile's body builds; the size report says whether he fits (yes: stock-size file,
0x13E88bytes free; no trimming needed). - Full suite passes, Sektor's pinned outputs are unchanged, and this page is updated in the same PR.
PRs: 1 inventory and description format; 2 generic builder; 3 codec 23, roster decode, Reptile body and size report.
| Item | Identity |
|---|---|
Sektor build (fighter_import.sektor_build, v61, fixed loader 0xA01B30F0) |
SHA-256 ad2ceb4bfe80b4316338207baf49684d54c0ee7c570534692266c9751a88ed86
|
CLI --fighter sektor --seed SEKTOR-PROD-1 --debug-all-keys
|
SHA-256 7fe0ed360472359e28a81447d16b8c57762037e8fb877b71c57db06bd5601bda
|
| Pinned by |
tests/test_fighter_swap.py (ROM-backed) |
| Milestone | Status | Agreed tasks / checklist | Evidence / PR |
|---|---|---|---|
| 1 Fighter description and generic body builder | Done (2026-11-10) | See above | #197 inventory and format; #198 generic builder; PR 3 roster decode, computed layout, auto colour, Reptile body |
| 2 Component library and MKMSZ backend v1 | Done (2026-11-11) | See above | #201 components, programs, host references; #202 review, projectile proofs v01–v07, backend lower_projectile
|
| 3 Reading aid for MKT moves | Done (2026-11-11) | See above | #200 reading aid, registry, readings |
| 4 Reptile | In progress | See above | — |
| 5 Generic product integration | Not started | — | — |
| 6 Review and next fighters | In progress (2026-11-13): Rayden | Amendment 1 | Rayden body proof v01 |
Fighter- or move-specific code outside fighter descriptions and components (plan rule 3). At plan start: everything Sektor-specific in fighter_import/ (including sektor_build.py and actions/robo_*, frozen legacy under rule 4) and patches/fighter_swap.py; milestone 1 itemises it.
-
The readers of Reptile's MKT invisibility flag (object
+0x24bit0x20) and of the slide stamp are not traced (milestone 3 leftovers; not needed while invisibility lowers to the Eye). -
Backend v1 lowers only
projectile; the other components lower with milestone 4. Production placement of move code and art (fighter file, fixed loader) is milestone 5; the proofs use proof-only allocations. -
MKT timing: frames and sound cadence convert one host tick per MKT tick (projectile proofs); the rocket speed conversion is to be revisited (owner: slightly off, not twice).
-
Reptile's body (computed layout, auto colour) is Runtime-confirmed (bounded, body proof v03). The owner did not comment on the voices separately, and slide was not tested (no powers unlocked); both are rechecked with the specials.
-
Codec-16 frames in some fighters' body slots: palette semantics Pending (not needed for Reptile).
- 2026-11-10: next fighter is Reptile. Owner's expectation for his specials (to verify in milestones 2–4):
- acid spit is a normal projectile (data on the generic projectile);
- forceballs work like MKMSZ Quan Chi's, possibly with the same visual effects and sprites;
- invisibility copies the Eye item's effect;
- slide is Sub-Zero's;
- the elbow dash is the only fully new move.
- 2026-11-10: automatic recognition of MKT machine code is deferred to milestone 6; Sektor's move modules are frozen legacy.
- 2026-11-11 (projectile proofs): Reptile's forceball launches its victim toward him (v03 over v02); MKT frames and sound cadence convert at one host tick per MKT tick; the rocket speed conversion stays for now (owner: slightly off, not twice) and is to be revisited later.
- 2026-11-11 (catalogue review): the component list is accepted and grows as needed; Reptile's invisibility uses the Eye's stealth for now (a mana-draining version is a later idea); Quan Chi's projectile confirmed as the reference move; the generic-projectile direction is still being discussed.
- 2026-11-11: provenance convention accepted: every move-program value names its source (
MKT 0x…,host,owner). - 2026-11-10: MKMSZ Quan Chi's forceball is a code/gameplay reference (projectile creation, hit triggers, launch effect, sound) so the host side is not reinvented; Reptile's forceball art and sounds still come from MKT.
MKMSZR current documentation · Wiki source: wiki/ · Evidence/archive: ChatGPT Library MKMSZR Research · Product source: smeagol44/MKMSZ-Randomizer
Orientation / Project
- Home
- Contributor start here
- Project status
- 1.0 requirements and roadmap
- Runtime validation status
- Architecture overview
- Research methodology and evidence
- Glossary
Core Technical Reference
- Core runtime and native payload
- Memory and allocation map
- Function registry
- Address and patch-site registry
- Data structures and encodings
- Resource and overlay system
- Address quick reference
- Testing and CI
Randomizer / Product Systems
- Stage flow and selector
- Pickups and stage-local randomization
- Global item materialization and solvability
- Persistence, inventory and lifecycle
- Lifecycle static closure / unbuilt v05
- XP and progression
- Native HUD and UI
- Presentation and branding
- Audio system
- Palette and recoloring
- Web patcher and product
Stage Reference
Gameplay / Enemy / Donor Research
- Enemy randomization
- Player actions and special moves
- Fighter recompiler plan · status
- MKT compatibility overview
- MKT adapter primitives
- MKT fighter asset translation
- Sub-Zero ↔ Sektor animation mapping
- Sektor takeover proof history
- Toasty audio research
- Toasty visual research
- PS1 research
- N64–PS1 comparison
- N64 -> PS1 port planning and strategy
History / Failures / Superseded Material