Files
Neutron/docs/gameplay/jimmy-air-bridge.md
T

90 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Jimmy airborne targets and rendering bridge
2026-11-05. Continuation of [movement stabilization](jimmy-movement-stabilization.md).
Preserve the playable controller baseline and original550 impulse/−800 gravity;
JN-Engine is used only for original-code navigation, verified with REA/source.
## Recovered contracts and integration
[Target state](jimmy-air-target-state.md) records source addresses/offsets, Init,
accepted input, pitch seeds, destination/dirty ownership and route retention.
[Render transform](jimmy-render-transform.md) records source-degree/OMT matrix
recovery and copied-original observations. These distinguish instruction/data
recovery, native component execution, implementation and port verification.
- `JimmyAirMotion.Destination` matches all12 previously recovered ordinary-air
writes: Up reads retained forward pitch, Down reads backward pitch, Up wins,
neutral pitch0, yaw=current and roll=−turn. These are now live.
- `LabSimulation` retains forward/back pitch seeds. Constructor/debug reset seeds
−40/+10; ordinary air apply reasserts−40/+10, Bubble apply−10/+10. Input reads
whatever the preceding apply left. Bubble equip/cleanup does not reseed.
- `PlayerLevelState` carries these two process scalars only through its already
bounded lab/VR04/outside ordinary/jetpack route. Init resets targetEuler0 and
dirty=false independently. Original TSK files gain no fields. Debug reset R
remains a modern constructor-style reset.
- Current Euler, destination Euler and dirty state are separate. Accepted active
ground input writes upright destination; neutral leaves it. Air writes each
pass. Facing runs before raw control gating, only when dirty, then retains dirty
according to the before-step equality check. Authored fullXYZ writes current
Euler without replacing destination. Default route STRTs are upright; arbitrary
selected STRT Euler is now passed in full instead of dropping X/Z.
- `PlayerSceneBinding` and application sync publish full current Euler. The old
Bubble-only orientation switch/seeding bridge is removed. Vehicle passengers
continue to copy their full authored Euler; Scooter's existing copied-destination
adapter is retained as its separate compatibility boundary.
- The character model now uses `JimmyRenderTransform`: source-degree quantization,
proven local rotation order and the unrotated logical root. The former sole
correction becomes a fixed model-local translation before rotation. Upright
placement is preserved; tilt pivots around the logical root. This correction
remains modern, not an original recovered offset or complete pivot parity.
Debug noclip/Stop Motion explicitly freezes the pending facing request along
with body motion, so enabling/debug-stopping flight cannot retain an unseen tilt
request. This is modern tool policy, separate from original script preparation.
Script STOP still preserves destination and queued body/effect work.
## Verification in progress
12 destination observations compare against the managed target helper. New
integrated cases cover Init/dirty/current writes, control locks, ordinary tilt,
scalar versus horizontal velocity, fresh/retained first Bubble input, cleanup,
route carry/reseed and noclip.28 movement groups,20 body groups and13 Grappler
integration groups pass in targeted runs. Lab and underground input-only routes
pass. Renderer component/whole-regression/native/package results follow below.
The old powered-path regression required50 units of lateral displacement under
flat air. Source pitch attenuation produces about38 units on both paths in its
same60-step fixture; the test now requires30 measurable lateral units and retained
lift. No gameplay tuning was changed to recover the old flat-air distance.
Artifacts: artifacts/jimmy-air-bridge/{movement-diagnostic,movement-targets,
movement-bridge,body-targets,grappler-targets,lab-route,underground-route}.log.
## Remaining gates
The source hierarchical transform is recovered; OMT's later final render-matrix
decomposition/re-quantization is still approximated, with measured seam deviation
recorded in the transform report. The model-local sole alignment and original
animation-root/completion behavior remain distinct. No radius, support, dynamic
or special-contact admission changes are made here. Root-changing callback Vec4
publication, world-response versus integration, hazards/climbs and dynamic pair
eligibility remain the next Jimmy body checkpoint. Whole-original trajectories,
original cadence and native Windows gameplay still require comparison.
### Native movement integration
Native Linux GTX1070/private Xvfb1920×1080 passes300-step VR04 powered steering
and240-step lab walking for shift/right-shift/insert/keypad0/right-mouse, including
actual SDL event receipt and resize. New smoke captures at powered step75/110 and
ordinary jump step90 record current/target Euler and the rendered frame. All25
final/airborne readbacks match across bindings, with zero Vulkan validation errors.
The first forward/brake/ordinary airborne captures were visually inspected.
Powered step75 has currentEuler≈(323.858,293.333,349.214), target(−40,292.917,−25);
step110 has≈(5.430,307.417,342.110), target(10,307.333,−5). Current Euler continues
through its own interpolation/turn phase rather than snapping to the target.
The300-step fixture travels359.19 versus the prior flat-air403.88; maximum rise
418.93, one burst/two landings and VR energy20 are preserved. This is port replay
measurement, not original whole-game trajectory evidence. Native Carl input lock
and control-independent body/fire/resumption also pass. Logs, images and all25
hashes: artifacts/jimmy-air-bridge/window/.