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

81 lines
4.7 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.
# Rocketship arithmetic and resource checkpoint
Historical a274670 checkpoint; superseded for live VR02 status by
[rocketship-live.md](rocketship-live.md). Later source/probes corrected the
unconditional input-after-apply wording: game and ship callbacks are separate,
ordered by fresh/retained registration. Mounted Jimmy still runs static physics.
2026-11-03. Continued gadgets after the supplied jn-engine assessment c6eb186.
Kept the playable d6ca417 source/packages and parked collision baseline intact.
Independent investigators owned Rocketship source, resources and Grappler source;
primary reviewed/integrated their files. All ownership has returned.
## Implemented and tested
`src/GamePort/Game/RocketFlight.cs` implements ordinary keyboard scalar/bank input
from41A6C0 and vertical publication from41A470..41A6A8. It is an isolated component,
not a connected live vehicle. Input updates retained state after application in
the ordinary source update; no input-before-integration reorder was introduced.
Caller owns body integration, X/Z vectors, facing and camera state.
Important source behavior preserved:
- Acceleration400 is per callback; support loss500*dt follows it. Down brakes
even with Up held, then Up wins the published vertical flags.
- Bank changes160*dt, clamps±45, and prior keyboard bank returns at130*dt.
- Up/Down650/−650 are acceleration commands, not direct velocities. Publication
subtracts global gravity; current velocity independently clamps±650.
- Below speed100, prior vertical command survives and the height clamp is skipped.
At the ceiling, root Y clamps but positive Vy survives; neutral snapping uses
a strict(−60,60) band.
Two isolated copied-original probes establish14 input-prefix and14 vertical-suffix
references. Generated Win32 harnesses used synthetic mouse/support/transform/audio
or body accessors, skipped camera/horizontal/integration paths and ran in separate
Wine32 namespaces. Original entrypoint/gameplay did not execute. Source bounds,
REA Evidence, file offsets and complete provenance are in
[rocketship.md](rocketship.md) and `artifacts/rocket-contract/`.
Numeric fixtures in `tests/GamePort.RocketFlightTests/` retain source, body,
generator, executable and log hashes. Thirteen managed groups compare all claimed
scalar/flag outputs with absolute tolerance.0002, reject nonfinite comparisons,
and cover phase/threshold/priority/invalid-input cases. Destination Euler and
source-preserved X/Z values are outside this scalar API's comparison. The test
is registered in `scripts/test.sh`; no live simulation path uses the component
yet. No bit-identical general x87 or original cadence claim is made.
`rocketship_resources.py` exports exact Strato/firestrato geometry, compatible
Jimmy/Goddard morph samples, PNG pixels and VR02 records after12 source hashes and
topology/pixel checks. Five tests cover output protection and resource identity.
It remains opt-in; shared preparation/package resources were not changed.
## Research integrated
[Rocketship source](rocketship.md) establishes Jimmy's owned ship, rider/control
handoff and cleanup, radius50/factor.6/friction.8, FireStrato binding and VR02's
false game polygon filter. The friend's label “visual scalar50” was corrected
through the original setter. Live body/factory admission remains unchanged.
[Grappler source](grappler.md) establishes owned rope/cursor, full-Euler ray and
material gates, attach/reel/swing/detach ordering and retained first rope length.
Twelve Python source/projection checks pass. No nearest-hook/direct-pull mechanic
or friend gameplay code was imported. Guarded tools also preserve provider gaps;
the existing local REA launcher was used without configuration changes.
Validation:13 Rocket managed groups,3 Rocket source groups,5 resource groups,
12 Grappler groups,15 existing Gadget and25 Movement groups pass. Main .NET10 build
passes with the existing NU1900 unavailable metadata warning;539 original hashes
verify unchanged. Independent read-only review agrees with the declared component
scope. No new Vulkan/live gameplay/native Windows checks or package rebuild was
needed or claimed; prior playable releases remain the user testing baseline.
## Next coherent chunk
Close the aircraft-specific370/374/378 collision callbacks, normal Euler/slip/
roll/facing and shared camera record update. Establish owned-versus-placed3ROC
property/reset behavior and retained helper lifetime. Then integrate explicit
vehicle ownership, passenger/Goddard/fire transforms and audio, mount/cleanup,
VR02 live body and F1 controls, with input/unequip/control-loss/RETURN regressions.
The source radius/support alone cannot justify using Jimmy's body/camera as a
vehicle replacement. Grappler's body/camera/material-context gates remain separate.