Recover retained route state and complete PostLoad availability tails

This commit is contained in:
UnixNight committed 2026-10-26 03:58:52 -04:00
1 parent 1dddfefc68
commit 9ad5a8ef6b
36 files changed
+1559 -32

No files matched your search

+141
View File
@@ -0,0 +1,141 @@
#!/usr/bin/env python3
"""Read-only GAM retained-object property-stream callback and descriptor evidence."""
from __future__ import annotations
import argparse
import hashlib
import json
from pathlib import Path
import struct
import sys
sys.path.insert(0, str(Path(__file__).resolve().parent))
from checkpoint_script_state import EXE_SHA256, find_case, read_va
from pe_inspect import PE
sys.path.insert(0, str(Path(__file__).resolve().parents[1] / 'levels'))
import gam
DLL_SHA256 = '3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943'
EXTRACTION_NAME = '??5OMediaStreamOperators@@QAEAAV0@PAVOMediaClassStreamer@@@Z'
# (name, pointer argument LEA VA, exact LEA, interface offset, wire type,
# property-name literal VA, push-name VA). These are Jimmy's actual registered
# destinations, not inferred destinations from GAM key spelling.
DESCRIPTORS = (
('ObjectTag', 0x470403, '8d8ea0030000', 0x3A0, 1, 0x4F6044, 0x47040C),
('RotateToDest', 0x470427, '8d460a', 0xA, 2, 0x4F6034, 0x47042D),
('ObjectID', 0x47043E, '8d8604040000', 0x404, 6, 0x4F6028, 0x470447),
('PositionX', 0x470458, '8d86ec000000', 0xEC, 3, 0x4F601C, 0x470461),
('PositionY', 0x470472, '8d86f0000000', 0xF0, 3, 0x4F6010, 0x47047B),
('PositionZ', 0x47048C, '8d86f4000000', 0xF4, 3, 0x4F6004, 0x470495),
('RotationX', 0x4704A6, '8d86fc000000', 0xFC, 3, 0x4F5FF8, 0x4704AF),
('RotationY', 0x4704C0, '8d8600010000', 0x100, 3, 0x4F5FEC, 0x4704C9),
('RotationZ', 0x4704DA, '8d8604010000', 0x104, 3, 0x4F5FE0, 0x4704E3),
('TaskName', 0x45883F, '8d8630040000', 0x430, 1, 0x4F2870, 0x458848),
('Debug', 0x458859, '8d86a4040000', 0x4A4, 6, 0x4F2868, 0x458862),
('RequiredLevel', 0x40D3CC, '8d8e78050000', 0x578, 6, 0x4ED294, 0x40D3D5),
('ExactLevel', 0x40D3E6, '8d867c050000', 0x57C, 6, 0x4ED288, 0x40D3EF),
('RemoveLevel', 0x40D400, '8d8680050000', 0x580, 6, 0x4ED27C, 0x40D409),
('HasCollision', 0x40D41A, '8d8684050000', 0x584, 6, 0x4ED26C, 0x40D423),
('InitiallyVisible', 0x40D434, '8d8688050000', 0x588, 6, 0x4ED258, 0x40D43D),
('CanMove', 0x40D44E, '8d868c050000', 0x58C, 6, 0x4ED250, 0x40D457),
('SecondPass', 0x40D468, '8d8690050000', 0x590, 6, 0x4ED244, 0x40D471),
('PickupLink', 0x40D482, '8d8695050000', 0x595, 1, 0x4ED238, 0x40D48B),
('StartPoint', 0x43784F, '8d8664060000', 0x664, 1, 0x4EFB3C, 0x437858),
)
SITES = (
('loader_extraction_import', 0x46E3CB, '8b1d90d14800'),
('loader_property_call', 0x46E3FC, '56ffd3'),
('jimmy_ctor_property_registration', 0x422245, 'e876080000'),
('jimmy_properties_parent', 0x422AD7, 'e8544d0100'),
('player_properties_parent', 0x437846, 'e8755bfdff'),
('actor_properties_parent', 0x40D3C3, 'e8784f0500'),
('shape_properties_parent', 0x462356, 'e8c564ffff'),
('task_properties_parent', 0x458836, 'e8757b0100'),
('reader_name_read', 0x473B94, 'ff1508d24800'),
('reader_lookup', 0x473BA3, 'ff9000040000'),
('reader_wire_type_metadata', 0x473BC0, '894704'),
('reader_type_jump', 0x473BD0, 'ff2485783e4700'),
('reader_string_destination', 0x473BEE, '8b47488bce50ff1508d24800'),
('reader_int_destination', 0x473C43, '8b57488b4424348902'),
('reader_float_destination', 0x473C5F, '8b47488bce50ff15e4d34800'),
('reader_long_destination', 0x473CA7, '8b4f48518bceffd3'),
('reader_finish_returns', 0x473E6F, '81c4e8000000c20400'),
('lookup_returns_descriptor', 0x473F8F, '8b43085f5e5d5b81c408010000c20400'),
('register_destination_pointer', 0x473FFA, '8b4c241c894b48'),
)
FUNCTIONS = (
('registered-property reader', 0x473B30, 0x473E78,
'31d5e0051c36501b2251d136338650d0f1786238c844aea30916c4f9fc976ffb'),
('registered-property lookup', 0x473EB0, 0x473F9F,
'ee1435c3eb5d2728f10c70c900560afd459585b392e78c9248017ff49908c211'),
)
def site(pe, name, va, expected):
actual = read_va(pe, va, len(bytes.fromhex(expected))).hex()
return dict(name=name, va=hex(va), file_offset=hex(pe.offset(va-pe.base)),
expected=expected, actual=actual, matches=actual == expected)
def collect(root: Path):
pe = PE(find_case(root, 'Neutron.exe'))
dll = PE(find_case(root, 'OMT2.dll'))
exe_hash = hashlib.sha256(pe.data).hexdigest()
dll_hash = hashlib.sha256(dll.data).hexdigest()
sites = [site(pe, *s) for s in SITES]
sites.append(site(dll, 'DLL extraction receiver slot4', 0x10073E00,
'568bf18b4c2408568b01ff50048bc65ec20400'))
tables = []
for name, table in (('Jimmy', 0x4A373C), ('fire', 0x4A3160), ('Goddard', 0x49F480)):
for slot, expected in ((4, 0x473B30), (0x400, 0x473EB0)):
actual = struct.unpack('<I', read_va(pe, table+slot, 4))[0]
tables.append(dict(name=name, table=hex(table), slot=hex(slot), target=hex(actual),
file_offset=hex(pe.offset(table+slot-pe.base)), matches=actual == expected))
descriptors = []
for name, va, instruction, field, wire_type, literal, push in DESCRIPTORS:
matches = (read_va(pe, va, len(bytes.fromhex(instruction))).hex() == instruction
and read_va(pe, push-3, 2) == bytes((0x6A, wire_type))
and read_va(pe, push, 5) == b'\x68'+struct.pack('<I', literal)
and read_va(pe, literal, len(name)+1) == name.encode()+b'\0')
descriptors.append(dict(name=name, argument_va=hex(va), file_offset=hex(pe.offset(va-pe.base)),
interface_offset=hex(field), complete_offset=hex(field+0xC0),
wire_type=wire_type, literal_va=hex(literal), matches=matches))
functions = []
for name, begin, end, expected in FUNCTIONS:
actual = hashlib.sha256(read_va(pe, begin, end-begin)).hexdigest()
functions.append(dict(name=name, begin=hex(begin), end_exclusive=hex(end),
file_offset=hex(pe.offset(begin-pe.base)), sha256=actual,
matches=actual == expected))
route = []
for filename in ('gam/level1b.gam', 'gam/VR04.gam', 'gam/level1.gam'):
path = find_case(root, filename)
level = gam.parse(path.read_bytes())
jimmy = next(e for e in level.entities if e.kind == '3JIM')
route.append(dict(file=filename, code=level.code, offset=hex(jimmy.offset),
sha256=hashlib.sha256(path.read_bytes()).hexdigest(),
player_properties=sorted(jimmy.values()),
exact_descriptor_set=set(jimmy.values()) == {d[0] for d in DESCRIPTORS}))
imported = next(i for i in pe.imports() if int(i['iat'], 16) == 0x48D190)
exported = next(e for e in dll.exports() if e['name'] == EXTRACTION_NAME)
return dict(known_binary=exe_hash == EXE_SHA256 and dll_hash == DLL_SHA256,
exe_sha256=exe_hash, dll_sha256=dll_hash, sites=sites, vtables=tables,
descriptors=descriptors, functions=functions, route=route,
extraction_import=imported, extraction_export=exported,
import_export_matches=(imported['dll'].lower() == 'omt2.dll'
and imported['name'] == EXTRACTION_NAME
and int(exported['va'], 16) == 0x10073E00),
scope='Static bytes/data only; no original execution or runtime claim.')
if __name__ == '__main__':
cli = argparse.ArgumentParser(description=__doc__)
cli.add_argument('original', type=Path)
result = collect(cli.parse_args().original)
print(json.dumps(result, indent=2))
if (not result['known_binary'] or not result['import_export_matches']
or not all(x['matches'] for key in ('sites', 'vtables', 'descriptors', 'functions') for x in result[key])
or not all(x['exact_descriptor_set'] for x in result['route'])):
raise SystemExit(1)