Files
Neutron/docs/gameplay/grappler-component.md
T

6.9 KiB

Grappler scalar checkpoint

Continuation: aim/constraint/contact checkpoint adds42 original component observations and corrects the enclosing aim→primary gate. The attachment leaf's broad acceptance does not bypass aim's earlier return.

2026-11-03. Continues user-requested gadgets after the Rocketship/orbit fixes. The latest playable packages include the orbit Left/Right correction70cba65. GrapplerMotion is an isolated component; no live equip/ray/swing/camera path is enabled. Originals and supplied friend files remain untouched. All investigator ownership returned after their usage limits; primary integrated retained results.

Implemented coverage

Original span, exclusive end File offset Managed coverage / verification
426BE8..426C70 26BE8 Explicit x87 sqrt distance minus100, first-length sentinel and initial rope Z scale.8 native cases, including reattach, fractions and short/negative lengths.
426DAC..426DD5 26DAC Held reel: old length strictly>250, subtract250*dt without final clamp.6 native cases; loop-audio branches are outside the snippet.
429DC9..429DF5 29DC9 Fast reel: target<old length, subtract950*dt without target clamp.6 native cases.
42A077..42A1A2 2A077 Swing scalar offset acceleration, stored elapsed>=double.2, clamp50 and350 damping boundary, subtract float.2 once.10 native cases; no body constraint/position execution.

tools/binary/grappler.py guards the authoritative EXE identity and enclosing source spans; grappler_motion.py records the four exact span hashes/offsets and imports completed probe results. The numeric fixture in tests/GamePort.GrapplerTests/original-scalar-reference.json includes source, generator, executable and log hashes. Eight attachment observations measure only length/initial-length/scale callback; managed velocityY100 and reel target are supported by the separate guarded426CDE..426D4D source, not those observations. Independent jump/fire detach is retained from the prior source contract.

42A0C2 stores Z while retaining its unrounded x87 value until damping; the new managed helper preserves a double intermediate there. X is reloaded after its float store. Both are bounded projections; general x87 bit identity is unclaimed. Neither negative lengths nor250/target overshoot are silently repaired.

Probe boundary and verification

grappler_scalar_probe.c copies the hashed EXE into private memory, relocates only whitelisted absolute scalar operands in the four slices, seeds synthetic frame/root/state, stubs the rope shape's scale callback and exits at bounded slice boundaries. It never invokes the original entrypoint, ray/body dispatch, audio or renderer. Separate copied Wine32 installation/prefix runs with no network or Original mount. Thirty cases finish with GRAPPLER_SCALARS_COMPLETE.

The initial fresh Wine prefix exceeded an8-second allowance and could not load kernel32 on retry; those failures are retained. A copied previously working prefix resolved startup. A fixed original-image allocation was unavailable; the final successful probe uses private image relocation instead. Earlier map failure logs are retained, and no results from failed runs enter the fixture. The initial C build collided with Windows' byte typedef; emitter naming was corrected before successful compilation.

Five managed groups compare all30 native observations within.0002 and cover first-length retention, source-only velocity/target, overshoot, one-step damping, simultaneous fire/jump and bounded inputs.14 Python source/projection checks, existing25 movement/15 gadget groups and the main .NET10 build pass. This is component execution/port compilation, not original or modern Grappler gameplay. Evidence is under artifacts/grappler-scalars/{source.json,probe-ready/wine.log, probe-ready/capture.json,managed.log,python.log,movement.log,gadgets.log,build.log}.

Retained source investigation and remaining integration gates

The following source evidence narrows the next work; it is not a live adapter:

  • Aim cursor and attachment have different gates.426A70 attaches on a successful ray hit without repeating429D00's450-distance/material rejection. Both query root→full-Euler local(0,2400,2400) using47C210(false). The aim path refreshes root at42A384, discarding the earlier swing pivot+116. VR08 game vtable4D00D0 slot134 at4D0204→475CD0(false) supports static filter admission, but selected material/global context and attached callback composition remain to implement.
  • 429D00 returning true only ends the remaining active input426030. Ordinary Jimmy437940 still dispatches437C40/437F90, publishing velocity independently after swing root work; do not skip normal movement wholesale. Swing constraint normalization uses OMT quick_magnitude, unlike attachment's explicit sqrt.
  • Constructor/helper bindings point to HIROPE→rope01.ASE/jimycarl.png and the owned cursor's retainedsprites.omt8. Cursor constructor4453B0 includes misleading shadow debug strings; full draw/size/material consumers and helper retention remain gates before an exact resource exporter/live visuals.

Retained REA replies, export bundles and closed snapshots:

Artifact / procedure REA Evidence
grappler-ray/rea/01.json47C210 ev_ff5aab3bdc275e6626753743a3567a556f698209ad9f65689cf49a4b5f56107d
grappler-ray/rea/02.json469A10 ev_03ea52bd4de36f296429073b5478032e7e55f7dc64c8545de8151bb893dd3542
grappler-motion/rea-base/00.json43AA40 ev_4f2a6aa666451db831efd46f5c587573e22d8072315626b8bc2f844f9c6f0cae
grappler-motion/rea-base/01.json47B4B0 ev_d45e078c585d3773494c0e0dfb1696178dd0b8ce8b696caf133892ff070e552e
grappler-resources/rea-constructors/00.json41EEB0 ev_307511ff899b91988b77796923fdfc31fa0f1bda5549f13b34c775fdc4917591
grappler-resources/rea-constructors/01.json4453B0 ev_423e61df2143a9dd441abffb09540b8c4ce401a0a05774d59221db623c2a7007
grappler-resources/rea-constructors/02.json445540 ev_76d17159215638e5e200985b3b83fa917c484805543a80a6b0ec2b86d466a488
grappler-resources/rea-constructors/03.json41F030 ev_2c7479a578411c7248c48387125c005db3241e79a3cb91254f1c81bff267957f

All artifact paths are under artifacts/. The unrecognized475CD0 pseudocode request has a retained provider error; raw vtable/code supplies that leaf's evidence. Prior unrecognized429D00/426A70 calls were not repeated. No provider configuration changed. Source disassembly supplements successful recognized helpers; no whole-function pseudocode success is attributed to missing entries.

Next: selected polygon/material context and exact original attached constraint / collision callback42A660; helper model/cursor draw+reset/cleanup and shared follow camera ownership. Then boundedVR08 integration with simultaneous jump/fire, reattach, control loss, menu, noclip and RETURN tests. No nearest-hook/direct-pull substitute, invented launch impulse, generic helper persistence or original/native Windows gameplay claim is enabled by this checkpoint.