Implement verified Grappler body camera and helpers in VR08

This commit is contained in:
UnixNight committed 2026-11-04 11:27:03 -05:00
1 parent ffea678e90
commit 43806fe862
39 files changed
+2429 -40

No files matched your search

+58
View File
@@ -0,0 +1,58 @@
# Grappler shared body/contact composition
2026-11-04. Original EXE SHA256 f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8.
Static VAs in this report map to file offset VA−400000. Source ranges/hashes,
relocation allowlist and generator: `tools/binary/grappler_body.py`;
`artifacts/grappler-body-live/source.json`. Reuses REA47B4B0
`ev_d45e078c585d3773494c0e0dfb1696178dd0b8ce8b696caf133892ff070e552e`
and43AA40 `ev_4f2a6aa666451db831efd46f5c587573e22d8072315626b8bc2f844f9c6f0cae`.
This checkpoint adds execution of copied components, not new whole-original play.
## Recovered ownership and order
479BC0..479D1B traverses enabled body integration before ordinary object callbacks.
479D20 initializes shared sphere state once: last polygon695D4C=NULL,
nearest face695D5C=130000, nearest edge5CFBE0=radius. Sphere hit point is5CFBE8.
Body motion invokes47B4B0; callback370 handles normalY<=−.7 and374 handles
normalY>−.7. Support47B890→47C6E0 and ray47C210 use selected polygon695D54 /
hit5CFC60 instead. They preserve all four sphere state fields.
429D00's attached branch invokes47B4B0 at42A016 without resetting that sphere
context. Therefore movement *away* from a previously accepted wall can replay
374 even when the new movement accepts no polygon. Zero delta skips dispatch.
A fresh context on each attached move would silently lose this callback.
Jimmy374→42A660 first invokes full Player43AA40. For the bounded VR08 material
IDs0/2/3/4, all probed grounded/mature combinations leave the body unchanged.
The derived suffix clears horizontal swing globals4F82BC/C0, then detaches
strictly when their incoming magnitude exceeds60; equality60 stays attached.
The action latch is set by this same fast-contact branch. Detach429C10 zeros
velocity, selects FALL, damps swing .96 and stops loop34; it adds no impulse.
Ordinary ceiling370→472690 clears positive Y velocity and acceleration separately.
Attached input later clears Vy unconditionally. After an attached callback the
429D00 tail still executes, including swing publication and pre-collision rope root.
Normal frame/player update still runs after input returns.
## Copied-original observations
`artifacts/grappler-body-live/probe/wine.log` ends
GRAPPLER_BODY_COMPONENT_COMPLETE; private Wine32 probe exit0. Generated code
uses copied original body/support/ray/static dispatcher, synthetic grid and
callback counters. Its8 chained observations cover body wall+floor, support/ray
preservation, stale replay, zero delta and the −.7 boundary.32 cases execute full
43AA40 then42A660 across four materials ×grounded ×mature ×fast/slow swing.
A final case checks ceiling's independent positive-Y rules.41 observations and
input/log hashes are retained in `tests/GamePort.GrapplerLiveTests/original-body-reference.json`.
These are original-component execution with synthetic inputs, not whole-game,
original scheduler, historical hardware or original render evidence.
## Implemented bridge and limits
OriginalBodyPhysics retains its mutable StaticCollisionContext. MoveAttached
requires the preceding body phase and reuses that object. LabSimulation invokes
370/374 after publication, feeds attached contact back to GrapplerGadget and
continues ordinary player update. Normal physics wall callbacks also reach it.
Bounded live admission adds only VR08, whose materials are independently guarded.
Other actors/global sphere-context interleavings, dynamic pairs, special-material
callbacks and other levels remain outside this integration. The per-player
context is a bounded adapter, not a recovered general scene-global scheduler.
+125
View File
@@ -0,0 +1,125 @@
# Grappler follow camera: local fields, consumers and live adapter
2026-11-03. Static recovery against Neutron.exe SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Originals remain untouched. All VAs below have PE file offset VA−400000 at
the guarded sites. `tools/binary/grappler_camera.py` emits actual mapped offsets,
span hashes, virtual targets and constants to
`artifacts/grappler-camera-live/source.json`. Its twelve tests exercise a bounded
Python projection, not original game execution or a live camera comparison.
## State writers are not camera poses
Jimmy complete+7C8/7CC/7D0 stores local eye XYZ; +7D8/7DC/7E0 local look XYZ;
+854/858/85C stores follow gains. These fields feed shared viewport eye
+44/48/4C and pitch/yaw +50/52 through the active follow callback. They are not
ready-to-use world coordinates or camera height/distance parameters.
| State / original writer | Eye local | Look local | Stored gains XYZ |
|---|---|---|---|
|Normal defaults437740..43778D, complete170|0,200,−350|0,80,0|1.6,1,1.6|
|Equip42981A..429844|0,50,−350|0,150,80|**Unchanged**|
|Attach426D59..426D7F|X unchanged,400,−650|**Unchanged**|.8,1,.8|
|Attached detach429C34..429C74|0,50,−350|0,130,100|1.6,1,1.6|
|Cleanup4287FC..42880A|Detach then normal defaults|Detach then normal defaults|Normal defaults|
Detach429C10 is a strict no-op when attached4F8210 is already false. Cleanup
still calls437740 in that case. Equip does not clear attachment or first rope
length in its selected branch. Higher-level selection/cleanup order owns those
transitions. Attaching again after detach retains look(0,130,100); equipping
again restores look(0,150,80). Always rebuilding a generic "attached camera"
would erase this observable difference.
## Ordinary walking follow
Complete124→438BC0 uses the normal subpath439625..4398EF when special camera
flag828 is false. The source adjustment complete84C defaults to10 and normal
walking resets it to10 at438CC6 when its enclosing camera/gadget conditions
permit; Grappler raw7 is not the special raw6 exception.
The effective points are:
```
eye = root + fullEulerRotate(eyeX, eyeY − 2*adjustment, eyeZ)
look = root + fullEulerRotate(lookX, lookY + 1.9*adjustment, lookZ)
gain = (storedX, storedY + .2, storedZ)
```
439652 and4396DA invoke game384→472980, the full logical Euler point
transform, using the source negative Z/X/Y table rotation. Thus equipped normal
eyeY is30 and lookY169 at zero rotation; attached eyeY380. Neither is a direct
substitution into the port's existing ordinary hardcoded follow offsets.
439658..439686 caches desired eye at complete804..810. Normal4397B1..4397F8
multiplies each delta by its effective gain, obstacle gain and dt; there is no
final interpolation-factor clamp in this path.
Flag828 can instead choose a different transformed/cached eye and uniform
gains; flag851 selects fixed .2 smoothing independent of the normal branch.
These are explicit excluded branches, not proven absent from every level.
## Ordinary airborne follow
Complete128→439900 captures OLD viewport eye at439E33.439E38..439E6B
passes raw eye locals to complete120→43A5D0. This helper does **not** add120
to Y:120 is a virtual-slot coordinate. At43A5EA it reads logical Euler, then
43A5F0..43A67B uses pitch0, yaw=`AddAxis(logicalYaw, complete6D4)`, and logical
roll. The helper applies the table rotation, reads root310 at43A6FB, and adds
root XYZ. Complete6D4 is the source turning accumulator, not a camera-local Y
offset. Negative yaw addition follows the previously recovered truncation/360
seam from `RocketOrientation.AddAxis`.
439E81..439EAA transforms unadjusted look locals using game384 full Euler.
For ordinary movement mode other than2,43A03C..43A06C uses **fixed**
gains(1.2,2,1.2), multiplied by obstacle gain and dt. It never reads stored
854..85C there. Attached air therefore uses eyeY400, with look150/80 on first
attach or130/100 after detach/reattach. Body pitch affects the look but not air
eye pitch; body roll affects both. Turn accumulator affects only air eye yaw.
Movement mode2 has separate Bubble gains and flag851 still selects its special
.2 branch. Do not claim these ordinary Grappler formulas cover those branches.
## Shared obstruction and old-eye orientation
Both paths call complete16C→43B820 after computing points. Its caller supplies
look by value and desired eye by pointer; the two preliminary actor310 reads
are not additional point offsets.47C210(false) traces look→eye with original
static grid/order/filter semantics. On hit43B884..43B8F4 writes:
```
desiredEye = look − .75*(look − hit) = .25*look + .75*hit
obstacleGain = 1.5 # miss returns1
newEye = oldEye + (desiredEye − oldEye) * gain * obstacleGain * dt
aim = look − oldEye # deliberately NOT look − newEye
```
Walking captures old eye in complete714/718/71C before this path and uses it
at439830..439865. Air captures old eye in locals and uses it at43A09F..43A0CE.
OMT vector `angles` IAT48D108 yields signed14-bit orientation; subsequent
viewport delta arithmetic gives the new quantized pitch/yaw. Reusing the Rocket
orientation helper is justified; using its gain2 obstacle callback instead of
the Jimmy gain1.5 is not. See [camera-ray-predicate.md](../checkpoint/camera-ray-predicate.md)
for the independently recovered obstruction query.
## Adapter recommendation and verification boundary
Keep a small mutable source-local camera state with the exact writers above.
For bounded VR08, dispatch ground versus air with the stored movement-mode
decision recovered in438A60, then use full source transforms and one source
camera ray. Preserve shared viewport history and compute aim from old eye.
Do not use support alone to pick a camera branch, reset look on each attach,
apply stored gains to air, or post-correct with a second collision query.
Resetting camera state at a reconstructed scene boundary must follow the actual
PostLoad/default/control event; the persistent-state report is separate.
REA was used through the existing local launcher on a generated EXE copy.
The first new helper request mistakenly supplied VA as a numeric file offset;
the corrected file offset3A5D0 mapped to43A5D0 but Ghidra12.1.4 had no recognized
procedure there. Both complete failures are retained in
`artifacts/grappler-camera-live/rea-eye*/`. No pseudocode success is claimed and
no unchanged failed request was repeated. Existing successful REA evidence for
437740 is ev_d2502f41c45731b86d4365634fbc6f0d1b3b70d880fd5741275fd36f1d585aa4;
47C210 is ev_ff5aab3bdc275e6626753743a3567a556f698209ad9f65689cf49a4b5f56107d.
Guarded disassembly supplies the missing follow/eye entries.
Unresolved: runtime original-versus-port VR08 camera comparison; flag828/851
transitions outside the bounded normal case; complete scene-entry shared-camera
cache continuity. No new copied-original camera probe was run in this chunk.
+132
View File
@@ -0,0 +1,132 @@
# Grappler lifecycle and retained state
2026-11-03. Static source contract, EXE SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Preferred-base VAs map to raw file offset VA−400000 at the guarded code sites.
Source guards/projection tests are recorded in grappler-camera-live/source.json
and python.log. No original gameplay was executed for this investigation.
## State ownership and reset boundaries
Jimmy complete owns rope+B0C, cursor+B14, companion+A1C and sound handle+1E04.
Raw selected gadget4F0588 and Grappler globals are process storage, not fields
serialized into the TSK inventory. Retained Jimmy is reused by ordinary loads;
its constructor must not be simulated on every scene entry.
| Storage | Fresh Jimmy constructor | Attach | Detach / selected cleanup |
|---|---|---|---|
|attached4F8210|422761→false|426C7F→true|429C28/428810→false|
|anchor index4F82CC, first anchor XYZ4F8214..1C|422767..422782→zero|Current ray hit copied to indexed anchor|No clear|
|first length4F82B4|422796→0|426C24 tests0;426C6B writes current length only on zero sentinel|**Preserved**|
|current length4F82B8|42278C→0|426C1E stores distance−100|Preserved; reel/swing own later updates|
|swingX/Z4F82BC/C0|4227A0/AA→0|426CE2/EC→0|429C7E..CA5 multiply each by float.96|
|elapsed4F82C4|4227B4→0|426D2E→0|Preserved|
|fast target4F82C8|No explicit constructor write; process zero-fill initially|426D4D→anchorY−rootY−200|Preserved|
|complete864 action byte|Not renamed as generic control state|426C85→true|429C2E/428816→false|
|loop34 handle complete1E04|4227CD→−1|Stop old, play new34, save handle|Stop if valid; store−1|
The complete EXE disassembly scan has only two direct writes to first lengthB4:
constructor zero422796 and first-attach assignment426C6B. The inspected retained
Init437890 and full PostLoad423610 route do not repeat that constructor reset;
the global writes in equip/detach/cleanup are bounded above. This supports
retaining B4 across ordinary retained-player loads and re-equips. It does not
establish a disk save/load serialization contract or arbitrary indirect memory
write absence. First attachment's length/600 scales owned rope Z only whenB4=0;
recreating the port visual requires preserving/reconstructing that first scale
as an implementation bridge, not rescaling it from each current length.
Constructor reset is tied to a newly constructed Jimmy, not just a new game
screen. Current length and swing state also survive the listed cleanup paths,
but attach always assigns/reset them. Session storage is appropriate for these
globals; a scene-local active attachment/query reference still needs an explicit
safe boundary in a modern adapter. Such teardown is not evidence that the
original ordinary stage reset attachment.
## Equip, attach, detach and helper visibility
4297DD equip hides the companion via complete58(1), gameD0(0), game214(0)
when present, writes camera locals and raw7. No attach/reset is implicit. The
optional inventory/tutorial menu command9B is a separate branch.
426A70 attachment is reached only after429D00's enclosing aim/blocking gates.
It stops prior +A3C audio, repeats its ray, stores length/anchor/first scale,
sets attached/action, clears jump+7E8 and linked jump effect+6C0, plays one-shot
31 and restarts loop34. It zeros swing scalars/time, preserves velocityXZ,
writes velocityY100, sets fast target, and changes camera fields. The rope's
non-null/resource-visible guard426D85..426D9D calls complete58(0) and records
the visibility-related70 state. The exact owned-resource rendering is separate
from the camera/lifecycle contract.
Held primary while attached reduces length by250*dt only while old length>250,
ensuring loop34; the alternate branch stops that loop. Before raw7 dispatch,
429D5D..429DBB maintains loop34 according to42A7A0 held-primary and attached.
This prelude is not an unconditional loop: it stops a valid handle when the
appropriate predicate fails. Fast reel950*dt and its target test are separate.
Do not combine all sources into a forever-running equipped sound.
429C10 returns immediately if already unattached. Otherwise it clears attached
and action, resets detached camera locals, damps residual swing.96, **sets body
velocity XYZ0**, directly selects FALL, stops loop34 and marks−1, and hides rope
via complete58(1). It does not supply launch velocity, reset first length, clear
movement speed, rewrite jump/movement mode or erase pending impulse. Caller
preparation may do some of those things independently.
Selected cleanup4287AC conditionally restores the companion if its+9E8 gate is
zero: show58(0) only when visibility-related70 is nonzero, then gameD0(1) and
game214(1). It calls detach204, ordinary camera170, clears attached/action again,
hides cursor58(1), and sets raw−1 in common tail428832. The +9E8 guard prevents
unconditional companion visibility restoration. Inactive detach is not an
independent catch-all loop stop; valid source state keeps loop ownership aligned.
The prior independent resource investigation owns exact helper retention/draw.
## SWING is protected from ordinary action requests
The controlled frame calls438A60 then429D00 before later primary426A70. A true
429D00 return ends remaining426030 input only; normal Jimmy437940 still runs.
An attached swing sets logical Euler pitch/roll0 while preserving yaw at429E4A..
429E7C, then requests complete150(`SWING`) at429E84..429E8B before rope/body
constraint work. Ordinary437940's movement/body publication must continue.
Complete150→43AFF0 first compares current action with the requested action and
protected actions. Literal SWING4EF6D8 is checked at43B096..43B0B0; matching
current SWING returns43B597 before RUN/STOP/LEFT/RIGHT conditional changes.
Thus normal437940 requests do not overwrite SWING. Detach uses direct complete
E0(`FALL`,1) and bypasses that conditional action guard. The air jump/FALL path
in437F90 can directly request FALL only for jump modes3/4; attachment already
clears jump mode0. A retained SWING render pose is justified while this contract
holds; it must yield to direct scripted/hit/death action ownership rather than
being a universal per-render override of every action.
## Control and transition events are different boundaries
Source [cutscene-preparation.md](../checkpoint/cutscene-preparation.md) recovers:
| Event | Proven operation affecting Grappler |
|---|---|
|CAM with NULL control|Jimmy438→42AE00→selected cleanup178, then410 speed/velocity preparation, orientation flatten, raw control clear|
|Initial non-none MCA activation|410 first, orientation flatten, then438 selected cleanup and raw clear|
|Later MCA shot|No repeated410/438/raw-clear preparation|
|AI with NULL control|410 and raw clear; **no438 selected cleanup**|
|Raw control owner changes alone|Controlled426030/437940 tail stops; no generic detach follows from that fact|
|RETURN457FF7|Selected cleanup178 before return flags and staging|
|Ordinary LOAD/practice stage43B5A0|No selected cleanup;148→429A00 only stops+A44, distinct from loop34|
|Retained Init/PostLoad|No blanket first-length reset; specific scene/gadget/camera rules remain separate|
410→42AFC0 clears speed/velocity through43A750 and requests conditional STOP.
When SWING is current,43AFF0 can preserve it; do not infer detach from STOP
preparation alone. Menus pause or gate input under their existing phase rules.
Debug noclip is a modern policy, with no source semantics. A chosen noclip/scene
safety detach should be labeled as that adapter boundary and retain proven B4
persistence. Debug force control likewise changes modern effective ownership;
it must not erase already delivered authored selected-cleanup events.
## Remaining questions and claim boundary
The ordinary VR08 lifecycle is sufficiently specified for a bounded live
adapter plus tests for first attach, held reel, jump release, high-contact
detach, reattach, re-equip, CAM/MCA cleanup and RETURN. Save-file serialization
of global first length is not recovered. Whole-original menu/control/render
comparisons, malformed selected/attached/loop combinations and all other
levels' special follow/action policies remain open. These are static facts and
projection checks; managed compilation or VR08 smoke must be reported separately
by the integrating primary, and Windows user testing remains runtime evidence.
+91
View File
@@ -0,0 +1,91 @@
# Live Grappler: bounded VR08
2026-11-04. Supersedes component-only status in grappler-query.md. Original
EXE/DLL/assets remain authoritative and untouched. The playable orbit70cba65,
lab69d0187 and parked collision35a2a66/0272f7b checkpoints remain preserved.
All prior investigators returned ownership; primary integrated and verified.
## Coverage and implementation
| Contract | Original evidence | Current adapter / verification |
|---|---|---|
|Root/full-Euler first-hit ray, material/close gate|429D00 and enclosing426030;23 native aim cases|GrapplerRay/Geometry; actualVR08 and close-surface regression. Early input return still permits ordinary player update.|
|Attach/reel/swing/detach scalars|426A70/429D00/429C10;30 native scalar +10 constraint cases|GrapplerGadget composes recovered components; no direct-pull replacement, reel clamp or launch impulse. Normal body and frame phases continue.|
|Shared sphere/body/base contact|479D20→47B4B0,42A016,43AA40→42A660;41 new native cases|OriginalBodyPhysics retains mutable context; attached Move reuses it. Normal and attached wall callbacks both reach Grappler. Live actual-wall scalar/root fixture verifies high-contact detachment.|
|Camera|438BC0/439900,437740, attach/equip/detach writers; guarded static/Python projection|GrapplerCamera dispatches by movement mode, uses distinct ground/air transforms/gains, obstruction gain and old-eye quantized aim. Managed checks and rendered replay; no original-camera runtime comparison.|
|Rope/SWING/cursor|HIROPE/HISWING bindings, OMT shape-scale consumer,445580 final110 dimensions|Exact exported art, dedicated source-pivot morph; fixed first-length scale, pre-collision rope root, alpha cursor. Generic billboard remains modern renderer bridge.|
|Selection/companion/control|427FF0→4287AC, CAM/MCA vs AI_NULL, RETURN457FF7|Normal selection and F1 grant; cleanup hides helpers/stops34/restores camera and eligible companion. Raw control loss alone does not detach. Actual intro and RETURN tests pass.|
|Persistence|Ctor/first-attach-only B4 writes; source lifecycle in grappler-lifecycle.md|GrapplerMemory lives in Main across reconstructed scenes; helpers are scene-local. Retained scalars tested; not serialized into TSK.|
|Debug policy|Modern tool boundary, not original recovery|F3 releases attachment/selection. R resets memory. GiveGrappler outsideVR08 retains practice selection but enables no unsupported live mechanics.|
State belongs to three scopes: process/session scalar memory (anchor, first/current
length, reel target, swing), scene-local helper/controller state (equipped/attached,
loop/cursor/pose), and LabSimulation body/shared viewport history. Cleanup releases
attached motion, default camera, visuals and sound without erasing first scale.
RETURN raises selected cleanup before the transition event. An ordinary modern
scene teardown also releases scene-local resources before SceneAudio disposal;
this is a modern safety boundary, **not** a claim that every original LOAD detaches.
Retained scalar memory survives that boundary; scene-entry shared-eye continuity
and arbitrary non-RETURN attached transitions remain unresolved.
On attach, clear jump word/effect only, set Vy100, preserve movement mode, hold,
acceleration and pending impulse. Input runs before ordinary player apply on fresh
entry and after it on retained entry. StepCamera precedes gadget input. SWING uses
a separate source-pivot draw and preserves ordinary body publication. Collision
may detach during attached movement; the source tail still updates swing/helper
state using the unclipped constraint root. Surface aim is then recomputed; fire
performs a fresh trace when unattached. No cached cursor-to-anchor substitution.
## Checks and captured evidence
-113 original-component observations total: prior72 scalar/aim/constraint/contact
plus41 body/support/ray/full-contact cases. Native probe generation/log/reference
hashes are retained; source execution uses copies under artifacts, never Original.
-13 managed live groups (`tests/GamePort.GrapplerLiveTests`) cover fresh/retained
input order, attachment/normal body, held reel/simultaneous fire+jump, detach/
reattach/first-scale, strict60 impact, actual wall constraint collision, shared
stale-contact replay/zero delta, camera consumers/transitions, ownership/intro,
actual RETURN, noclip/reset/retained memory, helper art and close-surface gate.
The actual-wall test explicitly positions Jimmy and sets rope/swing state;
this is distinct from the unseeded input replay below.
-40 Grappler Python checks: guarded original spans, camera projections, assets and
saved native-body observations. The broader Python suite passed296 tests before
adding the final source-presentation guard; its final total is297.
-Existing managed suites,33-scene GPU/material audits and original hash check are
driven by scripts/test.sh. Selected-source Patrol/Interaction projects needed
explicit Grappler/heading dependencies; initial compile failures were fixed.
-Headless llvmpipe1280×720 and native Linux GTX1070/private Xvfb1920×1080 replay
pass all9 phases with enabled Vulkan validation, zero errors. SDL Left/Ctrl/Up/
Shift/F3 events are received.120 extra ordinary ticks reuse received input;
no root/velocity/rope scalar/timer is seeded. Capture stages include attach,
original SWING/rope, detach, reattach, cutscene, noclip and reset. Images inspected.
Logs `artifacts/grappler-live-{smoke,window}.log`; captures share those prefixes.
-1920×1080 Player-page capture (`artifacts/grappler-debug-wide.ppm`) fits all32
rows including Give/Select Grappler. Managed navigation/repeat/bounds checks pass.
Reproduce from GamePort with `source scripts/env.sh`, then:
```
dotnet run --project tests/GamePort.GrapplerLiveTests
dotnet run -- --scene artifacts/extracted/VR08/scene.json --level gam/VR08.gam \
--smoke-grappler --headless --screenshot artifacts/grappler-check.ppm
```
Native-window replay uses `--width 1920 --height 1080` without `--headless`,
private Xvfb and SDL_AUDIODRIVER=dummy
where no hardware output is available. Dummy audio verifies stream/lifecycle,
not audible quality. Original whole-game VR08 and native Windows play remain
unverified; cross-publishing is recorded separately below.
## Remaining work
Full scene-global body interleavings/dynamic pairs, other levels/material policies,
special camera828/851/mode2, complete source renderer flags/lighting, arbitrary
attached ordinary LOAD continuity and save serialization of globals remain open.
These do not block the boundedVR08 implementation. Next gadget candidate is
Scooter, whose support/wheel/contact contracts are explicitly unresolved in
scooter.md; recover them before implementing its vehicle behavior. Preserve the
parked general collision work and avoid expanding Grappler to other levels until
those shared contracts and actual original comparisons support it.
Package/provenance results are appended after final local packaging.
+50
View File
@@ -0,0 +1,50 @@
# Grappler source resources and helper presentation
2026-11-04. Exporter: `tools/extractors/grappler_resources.py`; generated manifest
`artifacts/extracted/grappler/grappler.json`. Six source-file SHA256 values are
checked before export; originals remain untouched. Export includes rope01.ASE,
jimswing.ASE, jimstop topology, jimycarl pixels and RetainedSprites canvas8.
## Recovered bindings and consumers
EXE VAs map to file offset VA−400000 at these sites. HIROPE points to rope01.ASE;
HISWING→jimswing.ASE and SWING are bound422BCC..422BDA. Source rope has6 indexed
vertices/6 triangles, longitudinal Z0..600.9758 after the established ASE axis
conversion. Init41F0FA..41F12E applies roll180; attached429D00 sets pitch/yaw
from the quantized constraint offset and resets roll0. Render position is the
unclipped constraint desired root+Y116, even when collision clips Jimmy elsewhere.
First attachment426C63 mutates shape geometry through virtual34 using
(firstLength/600) longitudinal scale. Original OMT2.dll10005970 (file5970) is
OMedia3DShape::scale, not an actor transform or radius setter. Reeling does not
repeat that geometry mutation. The modern renderer equivalently applies the
retained first scale to fresh base vertices each render; it never accumulates it.
SWING has426 indexed vertices,814 faces, source samples0/480. Its absent UVs use
jimstop's source topology and exact jimycarl atlas.43AFF0 protects SWING from
ordinary conditional RUN/STOP requests; body integration is still active. The
port draws a dedicated source-pivot morph and hides the ordinary standing draw.
Cursor4453B0 inherits SpriteSize150, but its init445580 (file45580), invoked by
virtual40C, converts final signed words complete5E8/5EA=110 to world dimensions
completeAC/B0. Thus the visible cursor is110×110.4645F0 sets alpha blend6/7 and
center alignment3/3; canvas8 is64×64, decoded SHA256
8d31014cb9b9661ebed902c864bf740f562460e74da3f6b86ed3d2be4d10f0ec.
Flags248 and source constructor metadata remain in the manifest.
## REA and verification boundary
REA on generated copies retained complete replies/snapshots in
`artifacts/grappler-assets-live/rea-{shape,sprite,bind}/`. Shape consumer Evidence
`ev_e337ad879cea5877eb463324d48d15f860ceacf80c8225e66e9f35bc4b8ed660`;
sprite replies include `ev_9af340590afc1e0c64a249af250a520b2f09eba484e95d097f134b3254b67a8d`,
`ev_ab13438ec345f10472d10965048c34d31654e6d9303d729df98b65aa92d37a1e`,
`ev_69c4b496b5da7846245164028f0cb994222b0f136d24bb5fa3da7fdf236b228d`.
464430 was not recognized; failure retained, no decompilation success claimed.
Disassembly and guarded byte spans supplement those results.
Six Python checks verify exact source samples/pixels, source binding/consumer
spans, final cursor sizing and bounded output. Managed live tests verify constant
first-scale rendering, helper cleanup and110-unit cursor dimensions. Native
Linux VR08 captures show rope/SWING/cursor. Generic sprite billboarding uses the
existing modern camera-facing bridge; full original flags/renderer behavior,
lighting and original-versus-port visual comparison remain unresolved.