Recover Rocketship flight components against original-code probes

This commit is contained in:
UnixNight committed 2026-11-03 11:09:16 -05:00
1 parent c6eb1861cd
commit a274670fe8
23 files changed
+2462 -2

No files matched your search

+123
View File
@@ -0,0 +1,123 @@
# Grappler source contract and integration gate
2026-11-03. Item7/raw7, using the supplied target6 decompiler bodies as leads,
then independently reading the hashed EXE instructions. No friend gameplay code
imported. Static recovery and twelve Python source/projection tests only: no live
Grappler, original gameplay execution or Windows validation is claimed.
## Identity, REA and guarded evidence
Neutron.exe SHA256 is `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
All addresses below are preferred-base EXE virtual addresses; for these text spans
the file offset is VA−400000. `tools/binary/grappler.py` guards twelve spans,
three virtuals, two dispatch entries, sixteen constants and four strings;
`artifacts/grappler-contract/source.json` records each exact offset/hash.
REA6.8.0/Ghidra12.1.4 with project launcher/profile
`e1ad533d4cc0333c2136fe0894217de2d61feea098240326e78633f9e4ddcbf9`
decompiled jump predicate42A730, Evidence
`ev_4c43cfa8fa5d66c31111d49510aba391f069b446160a448c5544ea042dd452c4`.
Complete replies/export/snapshot are in
`artifacts/grappler-contract/rea-trajectory-20261103/`.
426A70's VA selector failed fallback file mapping; corrected offsets26A70,
29D00 and29C10 mapped correctly but have no recognized procedures in this
default Ghidra analysis. Those explicit errors are retained separately under
`rea-trajectory-offset-20261103/`; no identical retry followed. The older
`rea-controller/` attempt had an IPC denial. This run used the permitted local
Unix socket access and closed both owned sessions. No REA/config repair occurred.
Supporting decompilation is `../../../jn-engine-master/docs/decomp/evidence/
c3djimmy_target6.md`, helpers426A70/429D00/429C10. Its forced `__thiscall`,
`unaff_retaddr` and uninitialized aliases are not ABI proof. Byte-guarded objdump
and known game-interface helpers establish the contracts below; full-Euler/x87
and body execution still need separate references.
## Owners and fields
Jimmy complete pointer owns game interface+C0. Complete vtable4A3BDC has
188→429D00 (swing/aim),1C0→426A70 (held primary),204→429C10 (detach).
These offsets are distinct from movement mode complete+7C4.
| Owner | State and evidence |
|---|---|
| Jimmy complete+B0C | Owned C3DGraplingHook: ctor41EEB0 called422800, pointer stored422810, named at422821..82C; not a nearest serialized hook actor |
| Jimmy complete+B14 | Owned C3DTargetCursor: ctor4453B0 called42255B, stored42256B, named/hidden42257C..59D |
| Jimmy complete+A1C | Companion hidden and movement/collision disabled on equip/attach; cleanup restores only under its own9E8/visibility gates |
| Jimmy complete+1E04 | Loop34 audio handle;−1 sentinel; also touched by pre-mode-check swing helper |
| Globals4F8210/4F82CC | Attached byte / signed16 anchor index; constructor422761/767 initializes zero |
| Global4F8214+index*16 | Float4 anchor, copied from ray hit5CFC60 at426BA7..BD6; no tagged target search |
| Globals4F82B4/B8 | First rope length/current rope length; constructor zeroes both; first-length/scaling write only when B4==0 |
| Globals4F82BC/C0/C4/C8 | Horizontal swing scalars, elapsed damping time, fast-reel target |
| Jimmy complete+864 | Set on attach, cleared detach/cleanup; retain as an action flag until inherited consumers are fully recovered |
| Jimmy complete+7C8..7E0,854..85C | Follow eye/target and smoothing fields changed during equip/attach/detach |
Constructor zeroes the first anchor XYZ and scalars at42276E..7BE. Neither
guarded detach nor raw7 cleanup clears first lengthB4. Full helper persistence
through retained level loads remains a separate lifetime question. The indexed
region permits multiple slots by address arithmetic; do not invent a wrapping
rope/anchor stack: the bounded EXE references inspected show initialization and
reads of index, with no proven advancing writer.
## Input/update and state transitions
426030 receives Jimmy's game interface. After modal/game/control gates it runs
438A60 input then complete188→429D00 at426098; a true result ends Jimmy's active
controller pass. Held primary later reaches1C0→426A70 at4266C8 before the common
energy helper1C4 at4266DB. Thus Grappler attachment has no local energy charge and
precedes that shared zero-energy reject. Do not add an energy cost from menu index.
- **Equip:** jump-table4298E8 slot8 selects4297DD; hide/disable companion,
follow eye(0,50,−350), target(0,150,80), raw mode7. Optional inventory/menu
tutorial command9B remains its own branch.
- **Aim:** 429D00 samples root+Y116. After mode7's fast reel and optional jump
detach, its end portion performs a geometry ray from current root to full-Euler
local point(0,2400,2400), helper47C210. Distance<450 hides cursor and returns
true. Selected-polygon material IDs60..69,80..89,210..219,−1,170 also hide/block.
Polygon without material blocks; material without definition passes this test;
absent selected polygon passes it. A valid cursor is placed100 back from the
hit along ray direction. This is not a query for the nearest3GRA entity.
- **Attach / held primary:**426A70 returns false outside raw7; otherwise consumes
primary even on a miss. While unattached it stops+A3C, repeats the root/local
point ray, stores hit anchor, sets current length=distance(root,hit)−100.
If B4==0, scale rope Z by length/600 and preserve first length. Set attached
byte and+864, reset jump word+7E8 and linked jump effect+6C0, emitSFX31, restart
loop34, clear horizontal swing/time, preserve velocityX/Z but setY100.
Fast-reel target=anchorY−rootY−200; eyeY400/Z−650, smoothing(.8,1,.8).
- **Reel:** when already attached and old length>250, subtract250*dt and ensure
loop34. Otherwise stop loop34. There is **no final250 clamp**. Swing helper
independently subtracts950*dt when target<current length, also without clamp.
- **Swing:** root+Y116 is constrained to length from anchor, perturbed by horizontal
scalars*dt*30. Proposed displacement passes through source body47B4B0 before
writing root314; velocityY is then cleared. SetSWING. Update scalars by
−constrained rope offsetX/Z*dt*.17 (stack0C/14, not body displacement64/6C).
At elapsed>=double.2, clamp each±50, multiply .95 when
length<350 else .98, then subtract float.2 **once**, not in a while loop.
Rope model orientation/placement and a separate shadow down-ray are also owned
here. This depends on full Euler/table math and body/camera shared context.
- **Detach:** independent jump predicate42A730 with attached and no held fire
calls204→429C10. Clear attachment/+864, restore eye(0,50,−350), target(0,130,100)
and smoothing(1.6,1,1.6). Multiply swing globals by.96 but **set body velocity
to(0,0,0)**, selectFALL, stop loop34 and hide rope. No invented launch impulse.
- **Collision:** game-interface override42A660 calls base43AA40, clears horizontal
swing and releases if their prior magnitude>60; pointer adjustment−C0 reaches
complete204. Shared collision dispatch/callback ownership remains a live gate.
- **Unequip:** raw7 cleanup4287AC restores eligible companion, detaches, restores
ordinary camera170, clears attached/+864, hides cursor; common tail sets raw−1.
## Implementation boundary and verification
The twelve Python tests verify byte identities, selected-material range edges and
missing-material branches, accepted-hit scalar initialization/reattach retention,
250/950 overshoot behavior, damping threshold/clamp/one-step timing and independent
jump/fire release. Host arithmetic projections explicitly omit x87 intermediate
precision, actual ray traversal, body/camera/actor execution. They do not establish
original runtime parity.
Safe now: use these isolated scalar rules and ownership map as implementation
contracts/tests. **Do not enable live Grappler as nearest-hook/direct pull.** Close
full-Euler ray/filter and selected-material context in VR08; body47B4B0 under
attached state including callback42A660; model/pose placement and shared camera
ownership; fresh/retained helper lifetime and control-loss cleanup. B4's first
length retention and simultaneous jump/fire are necessary regressions. REA's
missing function boundaries could be addressed on a copied analysis project using
the supplied explicit-boundary approach, without blindly trusting forced ABI.