Files
Neutron/docs/gameplay/jimmy-ground-motion.md
T

100 lines
8.2 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 ordinary ground movement audit
2026-11-04. User paused gadget expansion to stabilize Jimmy. Preserve the current
playable fccc0b9 baseline. This report isolates original keyboard ground input
and ground velocity apply; it does not replace collision, timing or animation.
The supplied JN-Engine C3DPlayer report/target3 decompiler dump supplied function
names/field leads only. Its tuned/native gameplay is not used as an oracle.
## Original evidence and ownership
EXE SHA256 `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`;
OMT2.dll `3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
`jimmy_ground_motion.py` validates both identities and six bounded ranges, with
PE-mapped offsets and hashes. The listed EXE text offsets are VA−400000.
REA/GNU objdump produced source observation
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
Complete Evidence is under artifacts/jimmy-ground-audit/rea-disassembly.json;
summary projection `ev_eeefcf5542ee0c3151932829c0e898696754a264ac7fccb208fa26cceb36f0c0`
is in rea-summary.json. The command completed, output was not truncated, and
pre/post source digests match. The provider's executable-version/format metadata
is unknown; the independent PE reader establishes the image mapping. This is
static instruction evidence, not successful Ghidra pseudocode or target execution.
Previously failed unchanged procedure selectors were not repeated.
| Source VA / offset | Owner and contract |
|---|---|
|438BC0 /38BC0;438CE3 /38CE3|Ground input clears complete6E4 accepted forward/back flag. Mouse/side-camera/idle prefix is outside the pure keyboard suffix.|
|43915D..43928D /3915D..3928D|Clear870 keyboard lateral bias. Left precedes Right. Left adds20 yaw delta and−1000 lateral, Right−20/+1000. Set6E6 keyboard-turn latch. Add30 to6C8 only when below6C4 cap, then clamp an actual crossing.|
|43928D..439318 /3928D..39318|Up halves nonzero keyboard yaw delta and applies a second below-cap30 increment. Sets6E4. Up+turn can therefore increment twice. Existing overspeed is preserved, not clamped down.|
|438F66..438FE3 /38F66..38FE3|Earlier backward-acceptance gate uses Down/analog/side qualifications. In raw−1/3, true primary predicate15C suppresses accepted backward. Flags864/828 also qualify acceptance. This prefix is caller-owned, not part of the suffix probe.|
|439318..439416 /39318..39416|Accepted backward850 sets6E4; ordinary subtract35*1.5 and clamp−cap*.5. If seeded830 is strictly>double1.5, set latch828, speed=cap, stored target710=currentYaw+180, keyboard yaw delta0. Already latched backward keeps cap. Releasing acceptance clears830 and latch. The830 clock's increment owner remains unresolved.|
|439416..439490 /39416..39490|Without Up or accepted backward, release positive/negative scalar toward0 by35. Left-only still receives this decay after its acceleration. Keyboard side bias can move while scalar remains0.|
|43951E..4395CF /3951E..395CF|Accepted active input publishes destination yaw even with zero turn: ordinary currentYaw+delta; latched with delta uses currentYaw−delta*.5, otherwise stored710. No active input retains the previous destination.|
|437C40..437DF6 /37C40..37DF6|Read current live velocity; special global4F83E0 returns unchanged. Only nonzero incoming velocity OR nonzero keyboard lateral admits yaw addition and side computation. That gate does not suppress the later base forward rewrite. Side=(turn*(1−friction)*speed*float(1/45)+bias)*dt. Read full Euler via328, add yaw via334 and use full-Euler38C(0,0,speed). Publish its X/Z plus side, preserving incoming Y.|
|437E10..437F4B /37E10..37F4B|Only supported218 and nonnull support polygon338 reaches the support suffix. It subtracts float250 at4A3E58 from current live Vy. The rest of the normal/angle calculation does not project X/Z onto a slope or publish a new actor Euler here.|
|437C22..437C2D /37C22..37C2D|Controlled wrapper publishes complete6C8 controller scalar into body160 afterward. This is separate from live velocity and body friction state.|
Complete/game interface displacement isC0. Complete6BC acceleration30,6C0 decay35,
6C4 current cap600,6C8 controller scalar,6D4 turn rate,6D8 applied turn,6E4 accepted
forward/back,6E6 keyboard-turn latch,710 stored backward heading,828 auto-turn latch,
830 clock,850 accepted-backward and870 lateral bias. Live Euler is game224/228/22C;
destination is game274/278/27C. Ground only sets6E6 on turns; neutral/up/back do
not clear it. The source's air handler owns later keyboard-turn return behavior.
## Confirmed differences from the pre-audit port
1. RecoveredMotion.AddSpeed's unconditional Min(speed+30,cap) reduces existing
overspeed; the original only adds while below cap. This affects ground/air use
of that helper; changing the shared helper requires checking its other callers.
2. Active forward/backward input without turn must publish current yaw as the new
destination. LabSimulation only changed targetYaw for a nonzero turn delta,
allowing residual destination-yaw drift after releasing turn while keeping Up.
3. Ground direction uses full Euler X/Z, not yaw alone. A pitch30/yaw45/roll20
native case projects speed300 to X/Z≈−183.725/+183.725, not±212.132. This matters
during tilt restoration after gadgets/script placement; no new slope tilt is
invented by the helper.
4. Live support with a real polygon supplies downward Vy−250 pressure. The port
preserved Y unchanged. Supported/no-polygon and unsupported cases retain Y.
5. Side computation shares the incoming-motion/bias gate. The existing simplified
apply computes side outside it. Most ordinary landings reset turn0, but the
mathematical distinction is explicit and tested.
6. Primary/backward acceptance and the latent auto-turn state are not modeled by
the old simplified input. Do not enable a fabricated1.5-second timer: its live
clock owner must be recovered first. The pure helper permits explicit source
state inputs so the seeded branches can be compared without claiming live use.
## Implementation, tests and integration
`JimmyGroundMotion.Input` returns state, keyboard lateral and heading-update flag.
Callers resolve backward acceptance (ordinary raw−1/3 primary blocks it), retain
shared6E6 on neutral ground input and set it on Left/Right. BackSeconds defaults0;
leave auto-turn live admission gated until its clock owner is established.
`Apply` accepts full live Euler, source turn/bias, actual support and actual support
polygon presence. It returns velocity and Euler. Body integration, input/apply
order, ordinary/gadget mode dispatch, collision and published-speed copy stay
with the caller. In particular, do not derive a support polygon merely from a
provisional capsule's Grounded flag or apply this ground suffix during air mode.
Twenty-five copied-original observations execute successfully in isolated Wine32:
17 keyboard suffix cases (combinations, release/crossing, cap/overspeed, backward
cap and seeded exact/over1.5/latch branches), eight complete437C40 cases (rest,
stationary turn, lateral-only, turn, full tilt, supported polygon, missing polygon,
unsupported). Synthetic actor/root/support/animation methods surround the copied
routines; original OMT vector/trig methods execute from a copied DLL. No original
game entrypoint, camera prefix, general dynamic body or complete Jimmy executes.
The initial missing OMT export qualifier was corrected before the final run;
only the final exit0/JIMMY_GROUND_COMPLETE output establishes observations.
The committed original-ground-reference.json records both source identities,
bounded spans, generator/shared harness/executable/log hashes and all25 cases.
Two managed groups compare every case and check active-versus-idle heading and
caller-owned primary/backward suppression. Two Python groups validate identity,
provenance, ranges/offsets and complete observed counts. Logs and final capture
metadata are under artifacts/jimmy-ground-audit/. Parent owns live integration,
route/render/platform checks and root status documents; this agent made no shared
runtime edits or commits. Whole-original/native Windows movement parity remains
unverified. Mouse/analog, camera side timers, generic clock registration, full
standing/pose/climb branches and engine cadence remain separate evidence gates.