Files

8.1 KiB
Raw Permalink Blame History

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 final full Python suite passes297 tests plus2 separate HUD checks.
  • The final scripts/test.sh run exits0:297 Python+2 HUD checks, all managed suites, route/gadget GPU replays, checkpoint/transition and audio checks pass; all539 original hashes verify. Log artifacts/grappler-live-final-tests.log. 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 validation

Both self-contained packages identify clean source43806fe86224c685f56e897b88b4656305d16bdd in BUILD-INFO.txt. Linux executable is native ELF x86-64, Windows is PE32+ x86-64. All9 Grappler resource files compare byte-for-byte with extraction in both packages, including both exact RGBA canvases, original morph samples and manifest. artifacts/grappler-live-package.log records successful publishes/preparation; NU1900 vulnerability-metadata lookup warnings are the existing restricted-network condition, not compilation failures. No runtime online dependency was introduced.

Final standalone Linux test ran from /tmp with DOTNET_ROOT/DOTNET_ROOT_X64 unset, bundled assets, native GTX1070/SDL3 and private Xvfb1920×1080. All9 phases and five injected SDL key bindings pass with zero enabled Vulkan validation errors; all9 stage GPU readbacks are byte-identical to the development native run. Log: artifacts/grappler-live-standalone.log; resource/readback hashes are retained in artifacts/grappler-live-package-check.json. Packages are dist/linux-x64 and dist/win-x64. Native Windows gameplay and whole-original comparisons remain pending; Windows publication is not represented as runtime validation.