Files
Neutron/docs/gameplay/jimmy-default-decompilation.md
T

61 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# DEFAULT source recovery through a mapped analysis carrier
2026-11-06. This closes a provider function-boundary gap, not the Carl return
behavior gate. No gameplay change follows from this result.
The original PE database did not recognize447CF0 as a function. Instead of
repeating that failed selector, `tools/binary/default_raw_carrier.py` maps the
verified EXE's initialized sections from VA447CF0 onward into a separate raw
analysis file. It retains the original virtual spacing and zero-fills virtual
tails/gaps. `mapping.json` identifies every source file range and carrier offset.
This file is static analysis input; it is neither an executable nor a captured
process image. Imports, earlier code and runtime-initialized state are not supplied.
Source EXE SHA256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Carrier SHA256:
`a5bf4114beaf23fcaaf608e042a5873ff353ab4fa1189ba6b7466ed55fe91b99`.
The regenerated carrier is byte-identical to the analyzed file.
REA/Ghidra12.1.4 successfully decompiled entry447CF0 using this changed input.
Evidence:
`ev_58ecada52eaf5028945af6330fc9721a6a085495dbfd8ffdbb665a1fcad27420`.
Complete result, provider snapshot, mapping and stderr remain local under
`artifacts/jimmy-skip-raw-default/`. The Evidence subject is the carrier hash,
not the EXE hash. The existing original-instruction guard independently binds
the relevant instructions to EXE offsets447CF0−400000 and onward.
## Recovered behavior and limits
The complete decompilation agrees with the guarded original instructions:
- `none` returns; named triggers resolve and dispatch according to concrete type.
- DEFAULT447D34..447FC5 resolves JIM1. If JIM1 already owns raw control, its early
branch447D5C..447D9A loads sound effects, clears the applicable actor flag and
shared skip, and returns. It does not execute the later owner/camera/music branch.
- Otherwise it selects the appropriate Jimmy/vehicle owner, grants through118,
conditionally snaps the shared camera eye when distance exceeds1000, and handles
sound/music/UI/shared state. The SCENE30 menu callback is a separate conditional.
- No direct Jimmy mode704/turn614/current-or-destination-Euler reset appears in
DEFAULT. A raw owner grant is still475A40's pointer store, not actor Init.
Carl's MCA completion names JIM1 before dispatching Carlwalk→DEFAULT, making the
already-owned early branch relevant. This result supplies no hidden reset to
explain the user's upright original return. Indirect callees retain the coverage
and limits documented in the return-source report; pseudocode is a navigation aid,
and the original instructions remain authoritative.
## Reproduction
From GamePort, with the local REA/Ghidra environment:
```sh
python3 tools/binary/default_raw_carrier.py ../Original --output artifacts/default-recovery
scripts/rea.sh decompile artifacts/default-recovery/default.bin 0x447cf0 \
--provider ghidra --target-format raw-binary --architecture x86 \
--entry-point 0x447cf0 --snapshot artifacts/default-recovery/snapshot.json \
--format json --full-output > artifacts/default-recovery/result.json
```
No original code was executed by this analysis and no original files were changed.