Integrate source airborne tilt and logical-root rendering

This commit is contained in:
UnixNight committed 2026-11-05 10:19:12 -05:00
1 parent a61f1b0284
commit 27be8ed630
36 files changed
+1953 -62

No files matched your search

+89
View File
@@ -0,0 +1,89 @@
# 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/.
+155
View File
@@ -0,0 +1,155 @@
# Jimmy air targets: owners, initialization and mode transitions
2026-11-05. Original EXE SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
This closes the state boundary needed to integrate the
[twelve original air destination writes](jimmy-air-motion.md). It adds static
source/data verification, not another original runtime capture. JN-Engine's
saved original index was a navigation aid; its tuned movement is not used.
REA's retained complete instruction Evidence is
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
artifacts/jimmy-movement-audit/rea-original-disassembly.json. No unchanged failed
Ghidra selector was repeated. Focused extracts and the source report are under
artifacts/jimmy-air-target-state/. Preferred EXE VA maps to file offset VA−400000;
the helper independently uses PE sections and guards every listed anchor.
## Distinct state owners
Jimmy's game interface is complete object+C0. These are **data offsets**, not
same-numbered virtual slots:
| State | Game-interface data / complete data | Owner |
|---|---|---|
|Current Euler|224/228/22C /2E4/2E8/2EC|330→472420 sets XYZ;334→458F90→472480 adds Euler.|
|Destination Euler|274/278/27C /334/338/33C|36C→472660 writes all three axes and sets dirty byte+A.|
|Facing enabled/dirty|5/A /C5/CA|Init enables5, clearsA; source facing reads both; input destination writes setA.|
|Air forward/back pitch seeds|72C/730 /7EC/7F0|Constructor and movement apply callbacks, not input or current support.|
|Other yaw scalar|61C /6DC|Constructor0; Jimmy Init captures current yaw. No other direct access appears in the bounded437290..43B820 controller search.|
The last scalar is **not** the destination yaw captured by the ground probe.
`jimmy_ground_motion_probe.c` explicitly captures game+278 after its synthetic36C
writer. `JimmyGroundState.TargetYaw` therefore models retained destinationEuler.Y;
ordinary air input replacing that destination Y is expected. There is no evidence
for adding an independently consumed ground-yaw accumulator merely because Init
writes61C. The bounded direct-access search is not a whole-program proof that
61C is globally unused.
### Input publication
- Ground43915D..4395CF calls36C only when an accepted active heading path reaches
43957C,439599 or4395C9 (offset3957C/39599/395C9). It writes `(0,heading,0)`;
accepted Up/Down without a turn uses current yaw. Neutral leaves destination
Euler and dirty state alone. Backward acceptance is resolved before this suffix.
- Ground apply437C40..437F7F has no36C call or direct61C/6DC read. It does not
copy a saved ground yaw into the destination each pass. Its independent334
yaw addition does not become a destination write.
- Air input439A7A/439A80 clears accepted throttle6E4 and brake6E5, then sets them
in the accepted branches439AF2/439C29. In the bounded zero-mouse/analog case,
Up accepts throttle; Down accepts brake; mode2 additionally accepts primary fire
as throttle. Target publication reads these accepted flags, not speed>0.
- Ordinary target branch439DB7..439E33 (offset39DB7..39E33) chooses forward pitch
seed first, backward seed second, otherwise0; yaw=currentEuler.Y;
roll=−storedTurn. Both arrows select forward pitch even though both affect the
speed arithmetic. Mode2's preceding439CFx..439D7C branch uses roll=−.25*turn
(constant4AFD2C, fileAFD2C), with the same seed selection.
- Shared36C dispatch439E2D→472660 writes targets even when neutral or equal to
current Euler. Its setter stores274/278/27C at472668/472672/472678 and sets
dirty+A=1 at47267E. The existing12 native observations cover ordinary targets;
mode2 roll/first-tick sequencing here is statically recovered.
## Lifecycle and phase order
| Event / original VA (file offset) | Result |
|---|---|
|Constructor437445/43744F (37445/3744F)|Complete7EC=−40,7F0=+10.|
|Ordinary apply437FBC/437FC6 (37FBC/37FC6)|Reassert complete7EC=−40,7F0=+10 before composing ordinary air velocity.|
|Bubble apply43880A/438814 (3880A/38814)|Reassert complete7EC=−10,7F0=+10 before Bubble velocity/bounce.|
|Bubble cleanup428037..4280CC (28037..280CC)|If owned effect exists, mode7C4=0, maximum650, radius60/factor1.265 and effect/sound cleanup. No pitch-seed or destination-Euler reset appears in this resolved branch.|
|Generic Init4709CA/9D0/9D6 (709CA/709D0/709D6)|Clear destination XYZ.4709E2 enables facing5;4709E6 clears dirtyA. This is not a current-Euler zeroing policy.|
|Jimmy Init437890..4378CC (37890..378CC)|Calls4587F0→470540, clears speed/turn/published scalar, copies current yaw to61C. It does not re-seed7EC/7F0.|
|PostLoad4239E6 (239E6)|Copy the selected STRT's full authored rotation through174→4716D0. That setter copies authoredFC/100/104 and calls330→472420 to publish currentXYZ. Target Euler/dirty are not modified by this leaf chain.|
|Control preparation42AFC0→43A750|Clears speed/body XYZ velocity and stops sound, then requests STOP. It is not a destination/facing reset or evidence that all current Euler axes become0.|
Route property extraction does not reconstruct the object or re-run its
constructor: see [retained property stream](../checkpoint/retained-streamer.md).
Its verified20 descriptors do not point at game72C/730. The closed generic Init,
PostLoad and no-selected-gadget/jetpack cleanup route therefore retain these
pitch seeds while resetting destination Euler/dirty independently. This is the
bounded LV1B→VR04→LV1B→LEV1 contract, not arbitrary selected gadget/level cleanup.
Original save files do not gain these process fields; current R reset remains
an explicit modern debug policy and can restore constructor seeds.
The existing original registry/partial-order findings imply these concrete
transition cases; the joint sequence has not been newly executed here:
1. First Bubble activation on a fresh input-before-player tick may read the prior
−40 seed. Its later Bubble apply publishes−10, so subsequent Bubble input reads
−10. Retained player-before-input order seeds−10 before that first input.
2. Bubble cleanup leaves−10. Ground mode itself does not re-seed it. A subsequent
input already dispatched in ordinary air mode may read−10 until ordinary air
apply reasserts−40. Do not choose pitch solely from the current mode at input.
3. During a retained ordinary scene load, preserve the seed fields but initialize
targetEuler=(0,0,0), enabled=true, dirty=false. Reapply authored/current Euler
and subsequent destination writes through their own owners.
## Facing and control
43796A calls40E050→462520→473240 before the raw controlled-pointer check at
437A1B.47328D dispatches3D8→43A420. Facing itself checks global475CA0, game byte5
enabled and byteA dirty at43A426/43A433/43A43E; it does not query raw control.
475CA0's global pause/gameplay policy is not the controlled-player identity.
After accepting the gates,43A44F clearsA, then each unequal **before-step**
current/target component setsA again. Its comparisons are direct float equality,
before shortest-arc conversion/interpolation. It then calls334 even if all axes
were equal. A caller reproducing state needs to set `dirty = oldEuler != target`
when the facing callback actually runs; testing equality only after interpolation
can change that final pass. If a gate rejects the callback, dirty survives.
Canonical360 vs0 may remain unequal even when their angular delta is0. Direct
330 current-Euler writes do not synthesize dirty state or replace destinations.
## Initial current Euler is data, not target defaults
The source PostLoad copies full STRT XYZ. Default route GAM data nevertheless
supports keeping the present upright baseline:
| Original GAM / selected default STRT | Authored/current rotation after the resolved setter |
|---|---|
|level1b.gam /STARTEXP|(0,155,0)|
|VR04.gam /PHONEBOOTH|(0,290,0)|
|level1.gam /PHONEBOOTH|(0,220,0)|
The read-only helper records each GAM SHA256 and JIM1/STRT record offsets.
Arbitrary `--start` selections or authored script rotation with nonzero X/Z need
fullXYZ current publication; no source flattening is inferred from targetInit0.
RETURN restores a separate saved root, not a saved rotation; the selected STRT
rotation and its callback chain still apply. Other body/model animation offsets
belong to the render-transform investigation, not this Euler state report.
## Implementation contract and verification
Parent owns live implementation. Retain forward/back pitch seeds as fields,
seed them in apply callbacks, and read them at input time. Store current Euler,
destination Euler and facing enabled/dirty independently. Ground helpers' existing
destinationY state can remain a view of destinationEuler.Y; no extra6DC owner is
needed by proven ground math. Preserve source phase order, support/input gates,
and the explicit modern reset boundary. Full actor-root/model placement must be
handled by the sibling render bridge before enabling ordinary pitch visually.
`tools/binary/jimmy_air_target_state.py` guards32 source anchors,9 virtual targets,
11 bounded instruction ranges, the registered route descriptor boundary and
selected STRT data. Optional `--rea-disassembly` validates retained REA identity
and emits the bounded61C/6DC access and ground-apply call lists. Three Python
groups pass with exact source/offset/binding, separate target/current/default
route data and apply-owned seed checks. Run:
```
python3 -m unittest discover -s tests -p test_jimmy_air_target_state.py -v
python3 tools/binary/jimmy_air_target_state.py ../Original --rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json
```
Confidence is high for the guarded local contracts and route data. Full original
frame execution, unsupported modes/gadgets, other selected starts/levels, original
cadence, complete animation-root rendering and native Windows comparison remain
separate. No shared runtime or existing evidence fixture was changed here.
@@ -68,10 +68,11 @@ not an original-body result or a replacement friction/step tuning fix.
### Next coherent implementation chunks
1. Implement source destination-Euler pitch/roll with retained7EC/7F0, the full
actor-root visual bridge and mode/registration order together. Verify ordinary
jump, powered turning, Bubble cleanup, landing and RETURN. Baseline ordinary
air currently stays visually upright; the recovered−40/+10 targets are not live.
1. **Implemented bounded bridge:** source destination-Euler pitch/roll, retained
apply-owned7EC/7F0, Init/dirty, full authored XYZ and logical-root render basis.
[Air bridge](jimmy-air-bridge.md) records integration and subsequent validation.
The modern local sole correction and final OMT decomposition precision remain
explicit limitations; this does not close full original visual parity.
2. Finish Vec4 previous/live-root publication after callbacks; separate body
integration210 from world-response1D0. Verify successful fence/ladder entry,
animation-end/fallback completion and4255C0 hazard/impulse ownership before
+114
View File
@@ -0,0 +1,114 @@
# Jimmy logical/render Euler and compatible pivot bridge
2026-11-05. This investigates the original transform before enabling ordinary
up/down airborne tilt. The existing playable movement and upright placement are
the baseline. JN-Engine original class/decompiler notes supplied navigation leads;
its tuned movement and renderer are not copied as behavior references.
## Original facts and state ownership
Authoritative identities are EXE
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`
and OMT2.dll
`3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
`tools/binary/jimmy_model_bridge.py` guards their ranges, five Jimmy bindings and
both double angle constants. File offsets below are independently PE-mapped.
| VA / file offset | Recovered contract |
|---|---|
|EXE4624B0 /624B0|Jimmy game-interface3DC asks310→472300 for the current logical/body Vec4; copies XYZ to complete44/48/4C without scale or floor/sole subtraction.|
|EXE4624F0 /624F0|Angle publication hook3E0 jumps to473540.|
|EXE473540 /73540|Reads current degree Euler through328→4723F0; each axis is remainder360, multiplied by **double**45.51111111111111 at4D6408 and truncated through47F940, then masked16383. Double360 is4D6410.|
|EXE462500 /62500|Game3E4 stores the three resulting shorts at interface−70/−6E/−6C = complete50/52/54. Position and cached render angles are distinct records.|
|DLL1003FA60 /3FA60|OMediaElement::compute_hxform copies the parent hierarchy; obtains current animation dynamic offset from virtual7C and adds complete44/48/4C. With identity parent, resulting translation is exactly root+dynamic offset. Rotation does not rotate that root.|
|DLL1003FB26..1003FBE3 /3FB26..3FBE3|Reads cached angle shorts52/50/54 with negative signs and rotates the hierarchical basis. Row-vector form is Rz(−roll)·Rx(−pitch)·Ry(−yaw), with unit scale in the probed path.|
|DLL1003FC00 /3FC00|compute_model_matrix consumes the hierarchy and decomposes/re-quantizes its rotation through original angle lookup before publishing the final4×4. This additional precision behavior is distinct from the hierarchical basis.|
473540 does **not** duplicate Y into X: the0C stack load at473586 reads Y, then
pushZ at473595 shifts the stack. The0C load at4735A6 consequently reads original
X. Native asymmetric(-40,45,-15)→(14564,2048,15702) confirms independent axes.
The double render conversion is kept separate from physics472B10's float
45.5111122 factor. Render caching is not permission to mutate current degree
Euler or its destination state. Their phase/state owners remain in LabSimulation.
The position bridge has no hardcoded radius75.9, standing-minimum offset or scale.
Prior mode2 DLL import probes establish original jimstop geometry and zero dynamic
frame offsets for the tested clips; see [original collision](../analysis/original-collision.md).
That does not certify every clip, shape mutation, hierarchy or transform flag.
There is no newly recovered original correction for the port's sole alignment.
## REA and native evidence
The retained EXE instruction Evidence is
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
in artifacts/jimmy-movement-audit/rea-original-disassembly.json. The DLL REA
inspect-with-objdump Evidence is
`ev_af082632c98b34ccfcedef01466cafa03365e7fbf482496d01a4cda6d2f8f787`,
retained in artifacts/jimmy-model-bridge/rea-dll-disassembly.json. Its16MiB output
cap was reached, so it is a **bounded prefix**, completion unknown, not complete
DLL analysis. All transform ranges used here are present and separately guarded
against original bytes. An initial REA target-path error was corrected by making
a separate generated DLL copy; no missing-target result is cited as analysis.
The OMT probe calls exported compute_hxform and compute_model_matrix against a
synthetic element, identity parent and zero dynamic-offset callback. Fourteen
cases include upright, individual90° axes, full combined axes, ordinary forward/
backward air tilts, negative units,16383/16384 seams, halfturn, tiny angles and
two roots with the same rotation. No game/renderer entrypoint, GPU, body,
animation or audio runs. The original DLL is loaded only from an isolated copy.
The angle probe executes copied473540, original4723F0 getter and462500 setter
with synthetic actor fields. It bypasses CRT exception dispatch at4802CA into
its original finite x87 remainder primitive4802D4;47F940 truncation is original.
Twelve finite cases cover independent axes, negative/fractional degrees, multiple
revolutions, exact angle units, canonical360 and tiny seams. This does not verify
CRT exceptions, nonfinite inputs or the whole object scheduler.
Both isolated Wine32 runs exit0 with their success markers. First-time Wine prefix
creation exceeded the initial capture window; reuse of an already completed local
analysis prefix resolved setup. Successful model and angle logs/capture metadata
are retained separately under artifacts/jimmy-model-bridge. Fixture
`tests/GamePort.JimmyRenderTests/original-render-reference.json` commits all40
observations (14 hierarchy +14 final render matrices +12 angle writes), source
ranges/constants/bindings and generator/probe-EXE/output hashes.
## Implemented helper and explicit modern policy
`JimmyRenderTransform.AngleUnits` follows the recovered finite degree conversion.
`Source(root,euler)` uses those units and the original hierarchical axis order;
its translation is the unrotated root. `Aligned(root,euler,localYCorrection)`
pre-translates local vertices before that source rotation/root transform.
The helpers are pure and reject nonfinite inputs; no broader renderer or asset
rewriting is introduced.
For baseline upright placement, the caller may retain the fixed modern correction
`c = -modelMinimumY - rootHeight`, then use
`Translate(0,c,0) * Source(ActorRoot,Euler)`. For the standing mesh, minimumY is
approximately−64.6165 and the existing logical clearance is75.9, givingc≈−11.2835.
This preserves the upright sole location while combined pitch/roll rotate around
the logical root. The local point(0,−c,0) stays at ActorRoot under every rotation.
It is a **modern compatibility adapter**, not a recovered original pivot offset,
scale or new body clearance. It must not change collision/body support geometry.
The old world-space sole correction is not evidence for the source transform.
## Tests and remaining gates
The managed suite compares all12 original degree writes and14 hierarchical
transforms (basis tolerance1e−6), unit-scale determinant, unrotated translation,
modern upright/combined-tilt pivot invariants and nonfinite rejection. Two Python
groups verify source ranges/constants/bindings and complete native fixture/
provenance. Commands from GamePort:
```
dotnet run --project tests/GamePort.JimmyRenderTests
python3 -m unittest discover -s tests -p test_jimmy_model_bridge.py
```
Both pass. Final OMT model-matrix parity is deliberately **not** claimed. Its
approximate angle decomposition produces up to0.007286333 matrix-coefficient
deviation in the14 saved cases, largest at the16383-unit near-zero seam; ordinary
combined air tilt differs by roughly0.0002..0.0003. The test records that mismatch
instead of treating the final matrices as conforming. Exact decomposition/lookup,
all render flags/parents/dynamic offsets, complete source pivot/clip ownership and
whole-original/native Windows visual comparison remain separate gates. Runtime
integration/route/native checks are owned by the parent movement continuation.