Files
Neutron/tools/binary/jimmy_cutscene_rotation.py

78 lines
3.8 KiB
Python

#!/usr/bin/env python3
"""Guard original camera orientation suffixes and prepare a separate native probe."""
import argparse
import hashlib
import json
from pathlib import Path
import re
from checkpoint_script_state import EXE_SHA256, find_case, read_va
from pe_inspect import PE
REA_ID = 'ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904'
RANGES = (
('CAM orientation suffix', 0x416671, 0x4166eb, 'ded5dc3a2eeb96b8a970ade5193f98c6fcfd565e031efb9ce807348c821f854b'),
('MCA orientation suffix', 0x431518, 0x431590, 'abfb135a13645f0388da3c44f592053a2738eb6c4399e8e66cade6d86c1892ab'),
('current Euler getter', 0x4723f0, 0x47241a, 'f576bd9ce9d110bc9f6228ad84351add5aa2ce0a5fd2bcbb6ac1873a69d588e8'),
('current Euler full setter', 0x472450, 0x472474, '28a62af15c1ebffac1313d212fc3279d73b6cab8a37aca55bf0b4c48ccc76e32'),
('Jimmy facing', 0x43a420, 0x43a5cd, '1080773fae9170a107488528780efcd349cb930ca8a33fc8a845358b95f9ad38'),
('Euler-add thunk', 0x458f90, 0x458fb0, 'f63412bcbafc82323cff26c093e41a457e40a5b60afd2ed5fed02340a4405b1a'),
('Euler-add leaf', 0x472480, 0x47265b, '77e017813241344ff0f6fdde80102d08774dd044ae65f29f48f999ccd1e03d3d'),
)
def collect(original, rea_disassembly=None):
pe = PE(find_case(Path(original), 'Neutron.exe'))
if hashlib.sha256(pe.data).hexdigest() != EXE_SHA256:
raise ValueError('Unsupported original EXE identity')
rows = []
for name, start, end, expected in RANGES:
actual = hashlib.sha256(read_va(pe, start, end-start)).hexdigest()
if actual != expected:
raise ValueError(f'Changed original {name}')
rows.append(dict(name=name, va=hex(start), file_offset=hex(pe.offset(start-pe.base)),
length=end-start, sha256=actual))
result = dict(source_sha256=EXE_SHA256, rea_evidence_id=REA_ID, ranges=rows,
current_euler='game+224..230', destination_euler='game+274..280',
dirty='game+A; unchanged by both orientation suffixes',
scope='Static byte guard; generated probe executes bounded copied suffixes, not camera activation or the whole game.')
if rea_disassembly:
bundle = json.loads(Path(rea_disassembly).read_text())
record = next(r for r in bundle['records'] if r['evidence_id'] == REA_ID)
assembly = record['raw_result']['stdout']
extracts = {}
for name, start, end, _ in RANGES:
lines=[]
for line in assembly.splitlines():
m = re.match(r'\s*([0-9a-f]+):', line)
if m and start <= int(m[1],16) < end:
lines.append(line)
if not lines:
raise ValueError(f'Retained REA misses {name}')
extracts[name]='\n'.join(lines)+'\n'
result['rea_extracts'] = extracts
return result
def generate(original, output, rea_disassembly=None):
original = Path(original).resolve()
output = Path(output).resolve()
if output.is_relative_to(original) or original.is_relative_to(output):
raise ValueError('Probe directory must be separate from originals')
result = collect(original, rea_disassembly)
output.mkdir(parents=True, exist_ok=True)
for name in ('jimmy_cutscene_rotation_probe.c', 'grappler_scalar_probe.c'):
(output/name).write_text(Path(__file__).with_name(name).read_text())
(output/'source.json').write_text(json.dumps(result,indent=2)+'\n')
return result
if __name__ == '__main__':
parser=argparse.ArgumentParser(description=__doc__)
parser.add_argument('original',type=Path)
parser.add_argument('--rea-disassembly',type=Path)
parser.add_argument('--generate-probe',type=Path)
args=parser.parse_args()
result=generate(args.original,args.generate_probe,args.rea_disassembly) if args.generate_probe else collect(args.original,args.rea_disassembly)
print(json.dumps(result,indent=2))