vwemirror/firestorm
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ad49ec708f7300e7d31ad8e1e6f0a5e520912aa1
firestorm/MW4COMPARE/reports/hsh-diff.txt
T
dicionClaude Opus 5GitHub Copilot
 83478b7666 Add MW4COMPARE: .mw4 decompiler toolchain and V4H comparison harness 
Tooling built to recover editable source for six 'Mech chassis that exist
in the parallel FS_Build_V4H build but not in this repo. Reverse-engineers
every compiled record type in the .mw4 package format back to the .data /
.instance / .subsystems / .damage / .contents / .torso / .engine /
.armature sources the content pipeline consumes.

Nothing here is wired into the game build. It is a standalone analysis
harness run from Linux.

Package format
--------------
"#VBD" container. Directory records are [len][name][FILETIME][origSize]
[storedSize][offset], payload base at dword 0x0C. A record is stored raw
when storedSize == origSize, otherwise LZW (9->12-bit LSB-first codes,
256=clear, 257=EOF, dict from 258), per Database.cpp:451.

GameModel records are flat /Zp4 structs following the C++ inheritance
chain Entity(0) -> Mover(28) -> MWObject(80) -> Vehicle(664) -> Mech(756),
1636 bytes total. CreateMessage records follow Replicator -> Entity ->
Mover -> MWMover -> MWObject -> Vehicle -> Mech from start=16 (the
undeclared Connection__Message header), ending at 341 and padded to 344.

tools/decompile/
----------------
  datamap.py        header-driven layout engine; CHAIN + ANCHORS
                    {Vehicle:664, Mech:756} assert the struct offsets
  mw4msg.py         CreateMessage reader/walker
  data.py           .data      constants.py  define/table symbol resolution
  damage.py         .damage    contents.py   .contents
  smallmodel.py     .torso + .engine         instance.py  .instance
  armature.py / armature_parts.py  .armature + armaturedata/armaturevideo
  assembly.py       joint hierarchy renderer
  make_generic_doll.py  builds generic MFD/Radar damage dolls
  verify_*.py       per-type round-trip verifiers

Verified round-trip across all 64 shared chassis:
  .armature      2938/2976 pages     .subsystems  7579/7585 keys
  .data map      6071/6071 values    .data trip   8291/8306 keys
  .damage        6605/6605 keys      .contents    7480/7480 keys
  .torso+.engine 1280/1280 keys      .instance     896/896 keys, 64/64 pages
  armature_parts 1202/1202 .data, 1149/1202 .video

Layout-discovery lessons (documented in DECOMPILING.md)
-------------------------------------------------------
- Never let a field map be discovered by the values that verify it. A
  value-matching pass reported 4288/4288 while mis-assigning 34 keys. The
  map was rebuilt from header declaration order, anchored on uniquely
  resolved fields.
- Read the factory, not the data. 12 .data fields and 5 Torso fields are
  declared plain Stuff::Scalar but multiplied by Radians_Per_Degree in
  Mech_Tool.cpp:889 / Torso_Tool.cpp.
- Strip typedefs before walking a header. A stray `typedef int AttributeID;`
  masked a missing ClassID - two 4-byte errors cancelling out, caught only
  by the ANCHORS assertion.
- A verifier that silently narrows its own input reports success. Braced
  blocks must be hidden before splitting pages, replacing both CR and LF,
  because a `Shadow={...}` block contains a line reading `[shadow]` and
  splitlines() also splits on bare CR.
- NSWIZZLE is undefined, so the #else branch is live and orders members
  differently. bool is 1 byte; char x[MaxStringLength] is 256.
- V4H carries stale Mech IDs (their Atlas is 5, ours 6), so 64 of 65 shared
  chassis are off by one; --retarget-ids emits $(M_<Chassis>)/$(IDS_<Chassis>).

reports/ holds generated diffs. The two ~5 MB manifest-*.tsv intermediates
are gitignored; regenerate everything with run-comparison.sh.

Co-authored-by: Claude Opus 5 (Anthropic) <noreply@anthropic.com>
Co-authored-by: GitHub Copilot <copilot@github.com>
2026-08-08 16:47:57 -05:00

305 lines
10 KiB
Plaintext
Raw Blame History

# V4H=279 files, OURS=456 files | identical=182 differ=68 V4H_only=29 OURS_only=206
+V4H decals/DDC.bmp 30056
+V4H hud/Champion.bmp 263224
+V4H hud/Convert.txt 586
+V4H hud/Dasher.bmp 263224
+V4H hud/Griffin.bmp 263224
+V4H hud/jenner2c.bmp 263224
+V4H hud/Marauder.bmp 263224
+V4H hud/Thunderbolt.bmp 263224
+V4H Mechs/battlemasteriic.bmp 600054
+V4H Mechs/champion.bmp 600054
+V4H Mechs/Dasher.bmp 600054
+V4H Mechs/griffin.bmp 600054
+V4H Mechs/jenner2c.bmp 600054
+V4H Mechs/mad cat mk.ii.bmp 600054
+V4H Mechs/marauder.bmp 600054
+V4H Mechs/thunderbolt.bmp 600054
+V4H MFD/champion.bmp 43254
+V4H MFD/Dasher.bmp 43254
+V4H MFD/griffin.bmp 43254
+V4H MFD/jenner2c.bmp 43254
+V4H MFD/marauder.bmp 43254
+V4H MFD/thunderbolt.bmp 43254
+V4H radar/hud/champion.bmp 263224
+V4H radar/hud/Convert.txt 579
+V4H radar/hud/dasher.bmp 263224
+V4H radar/hud/griffin.bmp 263224
+V4H radar/hud/Jenner2c.bmp 263224
+V4H radar/hud/marauder.bmp 263224
+V4H radar/hud/thunderbolt.bmp 263224
-OURS decals/decal_46.bmp 11080
-OURS decals/decal_47.bmp 30056
-OURS decals/decal_49.bmp 30056
-OURS hud/annihilator.bmp 263224
-OURS hud/archer.bmp 263224
-OURS hud/arcticwolf.bmp 263224
-OURS hud/ares.bmp 263224
-OURS hud/argus.bmp 263224
-OURS hud/assassin2.bmp 263224
-OURS hud/assassinii.bmp 263224
-OURS hud/Atlas.bmp 263224
-OURS hud/avatar.bmp 263224
-OURS hud/awesome.bmp 263224
-OURS hud/battlemaster.bmp 263224
-OURS hud/battlemasteriic.bmp 263224
-OURS hud/behemoth.bmp 263224
-OURS hud/behemothii.bmp 263224
-OURS hud/blackhawk.bmp 263224
-OURS hud/blackknight.bmp 263224
-OURS hud/blacklanner.bmp 263224
-OURS hud/brigand.bmp 263224
-OURS hud/bushwacker.bmp 263224
-OURS hud/catapult.bmp 263224
-OURS hud/cauldronborn.bmp 263224
-OURS hud/chimera.bmp 263224
-OURS hud/commando.bmp 263224
-OURS hud/cougar.bmp 263224
-OURS hud/cyclops.bmp 263224
-OURS hud/daishi.bmp 263224
-OURS hud/deimos.bmp 263224
-OURS hud/dragon.bmp 263224
-OURS hud/fafnir.bmp 263224
-OURS hud/flea.bmp 263224
-OURS hud/gladiator.bmp 263224
-OURS hud/grizzly.bmp 263224
-OURS hud/hauptmann.bmp 263224
-OURS hud/hellhound.bmp 263224
-OURS hud/hellspawn.bmp 263224
-OURS hud/highlander.bmp 263224
-OURS hud/hollanderii.bmp 263224
-OURS hud/hunchback.bmp 263224
-OURS hud/kodiak.bmp 263224
-OURS hud/loki.bmp 263224
-OURS hud/longbow.bmp 263224
-OURS hud/madcat.bmp 263224
-OURS hud/madcat2.bmp 263224
-OURS hud/masakari.bmp 263224
-OURS hud/mauler.bmp 263224
-OURS hud/novacat.bmp 263224
-OURS hud/osiris.bmp 263224
-OURS hud/owens.bmp 263224
-OURS hud/puma.bmp 263224
-OURS hud/raven.bmp 263224
-OURS hud/ryoken.bmp 263224
-OURS hud/shadowcat.bmp 263224
-OURS hud/solitaire.bmp 263224
-OURS hud/sunder.bmp 263224
-OURS hud/templar.bmp 263224
-OURS hud/thanatos.bmp 263224
-OURS hud/thor.bmp 263224
-OURS hud/uller.bmp 263224
-OURS hud/urbanmech.bmp 263224
-OURS hud/uziel.bmp 263224
-OURS hud/victor.bmp 263224
-OURS hud/vulture.bmp 263224
-OURS hud/warhammer.bmp 263224
-OURS hud/wolfhound.bmp 263224
-OURS hud/zeus.bmp 263224
-OURS Mechs/battlemaster iic.bmp 201068
-OURS Mechs/behemoth ii.bmp 201080
-OURS Mechs/behemoth.bmp 201080
-OURS Mechs/black hawk.bmp 201080
-OURS Mechs/longbow.bmp 201080
-OURS Mechs/mad cat mkii.bmp 201080
-OURS Mechs/solitare.bmp 201080
-OURS Mechs/victor.bmp 201080
-OURS MFD/annihilator.bmp 15480
-OURS MFD/archer.bmp 43256
-OURS MFD/arcticwolf.bmp 43256
-OURS MFD/ares.bmp 15480
-OURS MFD/argus.bmp 43256
-OURS MFD/assassin2.bmp 15480
-OURS MFD/atlas.bmp 43256
-OURS MFD/avatar.bmp 15480
-OURS MFD/awesome.bmp 43256
-OURS MFD/battlemaster.bmp 15480
-OURS MFD/battlemasteriic.bmp 15480
-OURS MFD/behemoth.bmp 15480
-OURS MFD/behemothii.bmp 15480
-OURS MFD/blackhawk.bmp 15480
-OURS MFD/blackknight.bmp 43256
-OURS MFD/blacklanner.bmp 15320
-OURS MFD/brigand.bmp 43256
-OURS MFD/bushwacker.bmp 43256
-OURS MFD/catapult.bmp 43256
-OURS MFD/cauldronborn.bmp 43256
-OURS MFD/chimera.bmp 43256
-OURS MFD/commando.bmp 43256
-OURS MFD/cougar.bmp 15480
-OURS MFD/cyclops.bmp 43256
-OURS MFD/daishi.bmp 15480
-OURS MFD/deimos.bmp 15480
-OURS MFD/dragon.bmp 15480
-OURS MFD/fafnir.bmp 15480
-OURS MFD/flea.bmp 15480
-OURS MFD/gladiator.bmp 15480
-OURS MFD/grizzly.bmp 43256
-OURS MFD/hauptmann.bmp 43256
-OURS MFD/hellhound.bmp 43256
-OURS MFD/hellspawn.bmp 15480
-OURS MFD/highlander.bmp 43256
-OURS MFD/hollanderii.bmp 43256
-OURS MFD/hunchback.bmp 43256
-OURS MFD/kodiak.bmp 15480
-OURS MFD/loki.bmp 15480
-OURS MFD/longbow.bmp 15480
-OURS MFD/madcat.bmp 15476
-OURS MFD/madcat2.bmp 43256
-OURS MFD/masakari.bmp 43256
-OURS MFD/mauler.bmp 43256
-OURS MFD/novacat.bmp 43256
-OURS MFD/osiris.bmp 43256
-OURS MFD/owens.bmp 43256
-OURS MFD/puma.bmp 43256
-OURS MFD/raven.bmp 43256
-OURS MFD/ryoken.bmp 43256
-OURS MFD/shadowcat.bmp 15480
-OURS MFD/solitaire.bmp 15480
-OURS MFD/sunder.bmp 15480
-OURS MFD/templar.bmp 43256
-OURS MFD/thanatos.bmp 15480
-OURS MFD/thor.bmp 43256
-OURS MFD/uller.bmp 43256
-OURS MFD/urbanmech.bmp 43256
-OURS MFD/uziel.bmp 43256
-OURS MFD/victor.bmp 15480
-OURS MFD/vulture.bmp 43256
-OURS MFD/warhammer.bmp 15480
-OURS MFD/wolfhound.bmp 43256
-OURS MFD/zeus.bmp 43256
-OURS radar/hud/annihilator.bmp 263224
-OURS radar/hud/archer.bmp 263224
-OURS radar/hud/arcticwolf.bmp 263224
-OURS radar/hud/ares.bmp 263224
-OURS radar/hud/argus.bmp 263224
-OURS radar/hud/assassin2.bmp 263224
-OURS radar/hud/assassinii.bmp 263224
-OURS radar/hud/Atlas.bmp 263224
-OURS radar/hud/avatar.bmp 263224
-OURS radar/hud/awesome.bmp 263224
-OURS radar/hud/battlemaster.bmp 263224
-OURS radar/hud/battlemasteriic.bmp 263224
-OURS radar/hud/behemoth.bmp 263224
-OURS radar/hud/behemothii.bmp 263224
-OURS radar/hud/blackhawk.bmp 263224
-OURS radar/hud/blackknight.bmp 263224
-OURS radar/hud/blacklanner.bmp 263224
-OURS radar/hud/brigand.bmp 263224
-OURS radar/hud/bushwacker.bmp 263224
-OURS radar/hud/catapult.bmp 263224
-OURS radar/hud/cauldronborn.bmp 263224
-OURS radar/hud/chimera.bmp 263224
-OURS radar/hud/commando.bmp 263224
-OURS radar/hud/cougar.bmp 263224
-OURS radar/hud/cyclops.bmp 263224
-OURS radar/hud/daishi.bmp 263224
-OURS radar/hud/deimos.bmp 263224
-OURS radar/hud/dragon.bmp 263224
-OURS radar/hud/Fafnir.bmp 263224
-OURS radar/hud/flea.bmp 263224
-OURS radar/hud/gladiator.bmp 263224
-OURS radar/hud/grizzly.bmp 263224
-OURS radar/hud/hauptmann.bmp 263224
-OURS radar/hud/hellhound.bmp 263224
-OURS radar/hud/hellspawn.bmp 263224
-OURS radar/hud/highlander.bmp 263224
-OURS radar/hud/hollanderii.bmp 263224
-OURS radar/hud/hunchback.bmp 263224
-OURS radar/hud/kodiak.bmp 263224
-OURS radar/hud/loki.bmp 263224
-OURS radar/hud/longbow.bmp 263224
-OURS radar/hud/madcat.bmp 263224
-OURS radar/hud/madcat2.bmp 263224
-OURS radar/hud/masakari.bmp 263224
-OURS radar/hud/mauler.bmp 263224
-OURS radar/hud/novacat.bmp 263224
-OURS radar/hud/osiris.bmp 263224
-OURS radar/hud/owens.bmp 263224
-OURS radar/hud/puma.bmp 263224
-OURS radar/hud/raven.bmp 263224
-OURS radar/hud/ryoken.bmp 263224
-OURS radar/hud/shadowcat.bmp 263224
-OURS radar/hud/solitaire.bmp 263224
-OURS radar/hud/sunder.bmp 263224
-OURS radar/hud/templar.bmp 263224
-OURS radar/hud/thanatos.bmp 263224
-OURS radar/hud/thor.bmp 263224
-OURS radar/hud/Thumbs.db 8704
-OURS radar/hud/uller.bmp 263224
-OURS radar/hud/urbanmech.bmp 263224
-OURS radar/hud/uziel.bmp 263224
-OURS radar/hud/victor.bmp 263224
-OURS radar/hud/vulture.bmp 263224
-OURS radar/hud/warhammer.bmp 263224
-OURS radar/hud/wolfhound.bmp 263224
-OURS radar/hud/zeus.bmp 263224
~DIF decals/Thumbs.db V4H=8704B OURS=8704B
~DIF hud/rifleman.bmp V4H=263224B OURS=263224B
~DIF hud/Thumbs.db V4H=8192B OURS=830768B
~DIF logo.bmp V4H=481080B OURS=481080B
~DIF Mechs/annihilator.bmp V4H=600056B OURS=201080B
~DIF Mechs/archer.bmp V4H=600054B OURS=201080B
~DIF Mechs/arctic wolf.bmp V4H=600054B OURS=201080B
~DIF Mechs/ares.bmp V4H=600054B OURS=201080B
~DIF Mechs/argus.bmp V4H=600054B OURS=201072B
~DIF Mechs/assassin ii.bmp V4H=600056B OURS=201080B
~DIF Mechs/atlas.bmp V4H=600054B OURS=201080B
~DIF Mechs/avatar.bmp V4H=600054B OURS=201080B
~DIF Mechs/awesome.bmp V4H=600054B OURS=201080B
~DIF Mechs/battlemaster.bmp V4H=600054B OURS=201072B
~DIF Mechs/black knight.bmp V4H=600056B OURS=201080B
~DIF Mechs/black lanner.bmp V4H=600056B OURS=201080B
~DIF Mechs/brigand.bmp V4H=600056B OURS=201080B
~DIF Mechs/bushwacker.bmp V4H=600054B OURS=201080B
~DIF Mechs/catapult.bmp V4H=600054B OURS=201080B
~DIF Mechs/cauldronborn.bmp V4H=600054B OURS=201080B
~DIF Mechs/chimera.bmp V4H=600054B OURS=201080B
~DIF Mechs/commando.bmp V4H=600056B OURS=201080B
~DIF Mechs/cougar.bmp V4H=600054B OURS=201080B
~DIF Mechs/cyclops.bmp V4H=600054B OURS=201080B
~DIF Mechs/daishi.bmp V4H=600056B OURS=201080B
~DIF Mechs/deimos.bmp V4H=600054B OURS=201080B
~DIF Mechs/dragon.bmp V4H=600054B OURS=201080B
~DIF Mechs/fafnir.bmp V4H=600054B OURS=201080B
~DIF Mechs/flea.bmp V4H=600054B OURS=201080B
~DIF Mechs/gladiator.bmp V4H=600054B OURS=201080B
~DIF Mechs/grizzly.bmp V4H=600056B OURS=201080B
~DIF Mechs/Hauptmann.bmp V4H=600054B OURS=201080B
~DIF Mechs/hellhound.bmp V4H=600054B OURS=201080B
~DIF Mechs/hellspawn.bmp V4H=600054B OURS=201080B
~DIF Mechs/highlander.bmp V4H=600054B OURS=201080B
~DIF Mechs/hollander ii.bmp V4H=600054B OURS=201080B
~DIF Mechs/hunchback.bmp V4H=600056B OURS=201080B
~DIF Mechs/kodiak.bmp V4H=600054B OURS=201072B
~DIF Mechs/loki.bmp V4H=600054B OURS=201080B
~DIF Mechs/mad cat.bmp V4H=600054B OURS=201080B
~DIF Mechs/Masakari.bmp V4H=600054B OURS=201080B
~DIF Mechs/mauler.bmp V4H=600054B OURS=201080B
~DIF Mechs/nova cat.bmp V4H=600054B OURS=201080B
~DIF Mechs/osiris.bmp V4H=600054B OURS=201080B
~DIF Mechs/owens.bmp V4H=600054B OURS=201080B
~DIF Mechs/puma.bmp V4H=600054B OURS=201080B
~DIF Mechs/raven.bmp V4H=600054B OURS=201080B
~DIF Mechs/rifleman.bmp V4H=600054B OURS=201080B
~DIF Mechs/Ryoken.bmp V4H=600054B OURS=201080B
~DIF Mechs/shadow cat.bmp V4H=600054B OURS=201080B
~DIF Mechs/sunder.bmp V4H=600054B OURS=201080B
~DIF Mechs/templar.bmp V4H=600054B OURS=201080B
~DIF Mechs/thanatos.bmp V4H=600054B OURS=201080B
~DIF Mechs/thor.bmp V4H=600054B OURS=201080B
~DIF Mechs/Thumbs.db V4H=79872B OURS=140800B
~DIF Mechs/Uller.bmp V4H=600054B OURS=201080B
~DIF Mechs/urbanmech.bmp V4H=600054B OURS=201080B
~DIF Mechs/uziel.bmp V4H=600054B OURS=201080B
~DIF Mechs/vulture.bmp V4H=600054B OURS=201080B
~DIF Mechs/warhammer.bmp V4H=600054B OURS=201080B
~DIF Mechs/wolfhound.bmp V4H=600056B OURS=201080B
~DIF Mechs/zeus.bmp V4H=600054B OURS=201080B
~DIF MFD/rifleman.bmp V4H=43256B OURS=15476B
~DIF MFD/Thumbs.db V4H=8704B OURS=288256B
~DIF missionover.bmp V4H=481080B OURS=481080B
~DIF radar/hud/rifleman.bmp V4H=263224B OURS=263224B
~DIF radar/Thumbs.db V4H=7680B OURS=18432B
~DIF Thumbs.db V4H=30208B OURS=45056B
Reference in New Issue View Git Blame Copy Permalink