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

+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.