Files
Neutron/docs/gameplay/jimmy-turn-fire-fixes.md

69 lines
4.1 KiB
Markdown
Raw Permalink 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.
# Turning animations and rotating jetpack fire
2026-11-05. User requests restoring turning animation and reports that jetpack
fire does not follow Jimmy's rotation. Movement/physics arithmetic is preserved.
## Changes and evidence
[Turning recovery](jimmy-turn-animation.md) records REA instruction evidence,
original addresses/offsets, source animation acceptance and supplied clip hashes.
`jimleft.ASE`/`jimright.ASE` each contain six original morph samples. They were
missing from default preparation and runtime pose/action mapping. Preparation
now exports them with jimstop's topology/UVs; the player loads LEFT/RIGHT, retains
the input-owned side field, and chooses the matching clip when grounded at
nonnegative speed≤10. Forward movement above10 retains RUN, negative travel keeps
the existing backpedal path, and takeoff/air/primary-action ownership takes
precedence. Repeated requests retain the same clip/time. Existing generic morph
loop timing remains its separately documented port policy.
The retained REA EXE disassembly Evidence
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
also covers jetpack42204C..4220BC (file2204C..220BC): owner310 returns its root,
then effect314 copies it; owner328 returns full Euler, then effect32C copies it.
Focused instructions are retained in artifacts/jimmy-turn-fire/fire-follow.asm.
The old JetpackVisuals used a yaw-only matrix. It now samples the original fire
morph through the same model transform as Jimmy, including pitch/yaw/roll and the
shared local sole-alignment correction. That correction is explicitly modern;
sharing it preserves original relative attachment instead of leaving the flame
in another visual frame. Geometry, scale, timer, visibility and energy are not
retuned. Exact final OMT matrix decomposition/animation cadence remain open.
## Verification
New PlayerVisualTests exercise both source six-frame clips, pose selection,
left precedence, release/run/jump/primary ownership, actual morph advancement and
same-pose time continuity. Fire tests compare the actual vertex buffer through
three combined rotations/translations, preserve unit determinant, and verify
hidden/reset behavior. The former movement assertion requiring idle while turning
now expects the left clip.28 movement groups, original-data/Director regressions,
14 jetpack groups, the new visual groups and333 Python tests pass; build has zero
warnings/errors. The source turn guard passes. These are bounded source and port
checks, not whole-original gameplay or native Windows comparison.
Native Linux GTX1070/private Xvfb replays pass the300-step right-mouse jetpack
sequence and both original turn-clip previews at1920×1080, zero Vulkan validation
errors. Forward/braking flame captures and the left clip were visually inspected;
flame orientation now follows the owner rather than remaining vertical. New
visual tests cover actual runtime pose selection as well as the sampled mesh.
Artifacts: artifacts/jimmy-turn-fire/window/. Native Windows and exact original
morph timing remain separate verification boundaries.
## Final packages
Both self-contained packages identify clean runtime commit
`f0be8504ddc4d740ccd8d9c92b97856dfedb4a16`. Each contains519 verified original
copies and4285 matching prepared files, including both six-frame turn clips.
The539 originals remain unchanged. Package identities and hashes are retained
in artifacts/jimmy-turn-fire/package-identity.json.
Standalone Linux apphost checks from /tmp with SDK environment variables unset
pass the powered SDL replay and both turn previews. All five GPU readbacks match
the development captures byte for byte; all three runs report zero Vulkan
validation errors. Logs and comparisons are retained as package-*.log and
package-readbacks.json in the same artifact directory. The first explicit-scene
preview invocation omitted its required GAM argument and exited before rendering;
the corrected invocation supplies the matching level and original camera.
Windows is cross-published and resource-verified; native Windows runtime checks
remain outstanding. Package BUILD-INFO retains the runtime commit above; this
validation record is added after packaging.