Implement verified Grappler body camera and helpers in VR08
This commit is contained in:
1 parent
ffea678e90
commit
43806fe862
39 files changed
+2429
-40
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user