215 lines
16 KiB
Markdown
215 lines
16 KiB
Markdown
# Live Scooter: VR05 and outside LEV1
|
||
|
||
2026-11-04. Supersedes the deferred status in [scooter.md](scooter.md).
|
||
The user requested normal outside use after the vehicle implementation. Item4
|
||
now summons an independent C3DJEEP at Goddard; walking into it mounts Jimmy.
|
||
An owned tile in the normal Tab/Space gadget panel works in both scenes. F1 →
|
||
Player → Give/Select Scooter supplies the same selection path. Up/primary fire
|
||
accelerates, Left/Right steers, Down brakes then reverses, jump queues a supported
|
||
jump, and Tab/Space unequips. There is no invented equip-energy requirement.
|
||
Other scenes retain the tile/Practice flow without enabling an unsupported body.
|
||
|
||
## Source and evidence
|
||
|
||
Authoritative EXE SHA256:
|
||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||
Original files remain untouched. The friend's source supplied leads; binary and
|
||
resource checks against this project's originals determine the contracts.
|
||
`scooter.py` retains17 spans/13 virtual bindings/10 constants; `scooter_motion.py`
|
||
adds20 bounded ranges, PE offsets, hashes and relocation operands. The committed
|
||
`tests/GamePort.ScooterTests/original-motion-reference.json` identifies source,
|
||
probe generator, generated executable and Wine log, with53 observations. Code
|
||
addresses below have file offset VA−400000, independently checked by PE mapping.
|
||
|
||
| Original VA / file offset | Caller, owner and recovered contract |
|
||
|---|---|
|
||
|4211A0 /211A0;464B90 /64B90|Jimmy Init423CE8 lazily constructs6AC-byte Jeep, stored Jimmy+A30. Complete vtable4A2F8C, game+C0 vtable4A2AEC. Radius150, support factor.2, friction.9, suppression1. Explicit464C75 sets prevent-lowering true;464C7D disables bounce.|
|
||
|4290B7 /290B7|Selection requires enabled Goddard, copies his root/Euler into vehicle, enables/shows vehicle, disables/hides companion. Selecting alone does not mount.|
|
||
|47B3E0 /7B3E0;47A430 /7A430;422F13 /22F13|Strict quick-magnitude sphere contact invokes Jimmy's interaction dispatcher422D30, identifies C3DJEEP, calls complete1E0→425120, transfers raw owner5099E4, sets rider69C, selects SCOOT.425120 only cancels mode1 jump/effect when eligible.|
|
||
|412A90 /12A90;468020 /68020|Construct four wheel children, first4 of6 pointer slots578..58C. Local positions (−3,1,73),(3,1,73),(−3,1,−30),(3,1,−30). Mutual wheel/vehicle/passenger exclusions. Wheels have no independent integration/gravity; support queries are manual.|
|
||
|465830 /65830;421C10 /21C10|Keyboard steering±200dt, cap45, Left precedence; return-to-zero latch. Rear support required for throttle/reverse. Accel700, brake1200, maximum1485, reverse−594. Down's first edge brakes; held reverse additionally waits through the source one-second timer branch. No sprint predicate.|
|
||
|465220 /65220|Counts prior child supports, applies yaw only with front contacts/horizontal motion, coasting/steer/slope terms, then full-velocity/forward mixing only with parent support and≥2 child supports. Direction sum is intentionally not renormalized. Scalar, velocity and pending impulse are distinct state.|
|
||
|421910 /21910;467000 /67000;4669F0 /669F0|Head-on contact with horizontal quick speed>20 and abs(forward·normal)≥.9 starts impact: speed/acceleration0. No bounce reflection. Four-second enabled-body state damps horizontal velocity/angular velocity, then clears them. Glancing positive-speed throttle applies source minimum230, even if it raises a slow scalar.|
|
||
|473770 /73770;412F90 /12F90;467080 /67080|Post-normal registry phase sets roll=−steering/2, manually queries each wheel's real support, clamps local suspension±15, spins from horizontal travel/radius, then synchronizes visuals. Radius23.769514 from OMT shape1 header. Wheels do not fabricate support from the parent.|
|
||
|476FF0 /76FF0;466AF0 /66AF0;473320 /73320|Stored support normal→signed14-bit angle components→yaw-rotated pitch/roll. The target yaw is overwritten with live yaw. Source full AddEuler normalizes all axes during drive. Facing uses shortest delta, rate*dt and strict small-step snap. No contacts selects pitch340/rate2; unmounted sets rate10.|
|
||
|421580 /21580|Mounted jump latch queues Y700; float pose clock strictly exceeds double.3 before selecting SCOOTSTOP for signed speed<10, otherwise SCOOT. Jimmy copies root/Euler before the later wheel/lean phase.|
|
||
|4130A0 /130A0|Default mode1 eye uses rotated(−30,0,−200)+worldY50, quick-distance gains1/1.7/2.8, smoothing before clipping, new-eye quantized aim toward rotated(0,50,100). Impact retains eyeY, approaches rootXZ at.3dt and aims at root.413870 explicitly passes edges=false.|
|
||
|413852 /13852;47B4B0 /7B4B0|Camera resets nearest face distance130000 only, inherits edge/contact state, clips from vehicle root with cube75's sphere radius64.9519043. Ordinary body initializes its own sphere context; no invented camera sweep.|
|
||
|412ED0 /12ED0|Enabled/visible vehicle starts loop SFX46 and retains base sample frequency. Pitch=max(7000,trunc(base+signedSpeed*(1/1.9)*51)). Parked vehicle also sounds; cleanup stops it.|
|
||
|4281B3 /281B3;457FF7 /57FF7|Selected cleanup restores eligible Goddard at vehicle root/Euler, disables/hides vehicle, stops engine. Mounted branch restores Jimmy raw control, raises root40, clears acceleration/live velocity, preserves movement mode/pending impulse. RETURN explicitly invokes cleanup before requesting transition.|
|
||
|
||
Vehicle complete offsets:600/602/604 front/rear/total support WORDs;610/618/620/
|
||
628 acceleration/brake/base/current maximum;61C prior scalar;63C angle;640 yaw
|
||
rate;648 brake timer;64C impact timer;650/654 camera modes;658/659 throttle/brake;
|
||
65C impact;65D/65F keyboard/reverse latch;690/694 engine channel/base frequency;
|
||
698 jump latch;69C rider;6A0 pose clock. Full source structures remain partial.
|
||
|
||
REA/Ghidra12.1.4 evidence is retained under artifacts/scooter-{wheels,assets,
|
||
lifecycle,motion}-live, including complete replies, exports and closed snapshots.
|
||
Important Evidence IDs:
|
||
|
||
-465220 `ev_09ecf350c8705d5f9c1da5b444eb8cd027f64f4859713b29c9d04bc4c55c2bc8`;
|
||
465830 `ev_dbb6ac283387e14f08d527a750c14af44c52ed80c612c40393a5434a16589916`.
|
||
-467080 `ev_3e6bc2c29886888f3d70087b38b7a8b933d70394908f0328e1a3032a39cd9077`;
|
||
468020 `ev_2bbed17bcf63926b0ed8202ebf6d7320bf49ddb5bc4427a541c2bff4e448e84b`;
|
||
4682A0 `ev_f083ee63317f9d4d999b16da31c770e0f5c0517caebf73ba53e8769bc4ee7699`.
|
||
-4213F0 `ev_4ef0cec31d2f339f8e10213acabaa71f0fee3f7c6c96f278f691947616dbaa22`;
|
||
422AC0 `ev_a689f8970de2072f0e2b18babfa9f20c9aa9824a37acdb76c158218d4b85d992`;
|
||
477550 `ev_d44b004b6fe8045d4f9592712cda51bcb3cfb331d58980493bd7ced707d68150`.
|
||
-476FF0 `ev_9d38be2acca1063e7d91783adc0e928f9f9128cfb9031e258eaa51e94f0adfa1`;
|
||
467990 `ev_c4db605fd549572edcee03e01e5c0026ba856ad5ad0016678fd1ca2902e5610b`.
|
||
|
||
Some selectors, including4130A0/422D30/466AF0, were not recognized as complete
|
||
procedures. Saved instructions and callers fill those bounded gaps; no successful
|
||
decompilation is attributed to them. x87 aliases in465220/476FF0 are unreliable;
|
||
assembly plus copied-original numeric execution resolves arithmetic. No unchanged
|
||
failed selector was retried. Profile identity and exact metadata remain in the
|
||
saved REA bundles.
|
||
|
||
## Implementation and ownership
|
||
|
||
`Scooter` owns vehicle body, previous wheel contacts, input latches, impact/pose
|
||
clocks and shared-camera history. `ScooterMotion`, `ScooterWheels` and
|
||
`ScooterCamera` isolate the recovered formulas. `PlayerSceneBinding` steps body
|
||
before input, tests contact after Jimmy's independent physics, transfers ownership,
|
||
steps vehicle frame, copies passenger transform, then steps wheel phase. Fresh/
|
||
retained input order follows the existing player registration-order switch.
|
||
Raw control loss alone does not teardown; named-Jimmy CAM/MCA/RETURN cleanup does.
|
||
`SceneInteractions` accepts vehicle-owned pickups and coincident Jimmy LOAD, with
|
||
separate radii150/60. Excluded wheel/passenger pair callbacks are not dispatched.
|
||
General dynamic pair discovery remains unimplemented. Provisional moving-door
|
||
response is an explicitly inherited modern adapter.
|
||
|
||
Source PostLoad41E0F9 places active-follow Goddard250 behind Jimmy when a ray is
|
||
clear; retained STRT placement4239EC and RETURN423AE3 remain separate source paths.
|
||
The port creates the owned companion in VR05/LEV1 before runtime bindings and uses
|
||
behind250 or STRT fallback. Its opt-in state4 follow subset uses408E40/408BC0
|
||
velocity/arrival hysteresis and41E303 speed450/600 plus far warp1500→behind800.
|
||
It retains the existing provisional NPC body and heading/animation bridge; this
|
||
is not full Goddard AI. Lab patrol behavior is unchanged. Modern R reset releases
|
||
selection, clears vehicle state and restores the companion near the start. F3
|
||
releases it before noclip. Modern scene teardown disposes the engine before audio.
|
||
Vehicle/wheel allocation is scene-local; arbitrary non-RETURN persistence and
|
||
full retained-source reconstruction are unresolved, not silently claimed exact.
|
||
|
||
`ScooterVisuals` uses source-pivot, unit-scale scooter.omt shape0 and four shape1
|
||
wheels. Null-material faces remain undrawn (DLL1003756C), rather than invented
|
||
white caps. Exact original canvases are exported. HISCOOT and HISCOOTSTOP bind
|
||
jimscooter/Jimscooterstop morphs, with jimstop topology and original opaque Jimmy
|
||
atlas; the rider uses the Euler copied before wheel lean. godscooter.ASE is a
|
||
separate Goddard transformation resource, not the active vehicle shape.421535→
|
||
477550 makes the source shape unlit; there is no impact scale change.
|
||
|
||
## Verification and unresolved questions
|
||
|
||
-53 copied-original Wine32 component observations match managed formulas:22 drive,
|
||
9 input,8 normal→Euler (unused output yaw excluded),3 facing,7 wall and4 impact.
|
||
Harness supplies synthetic base actor/camera/audio/wheel support and original
|
||
OMT vector/trig. It never runs the original game entrypoint. Source quarter-turn
|
||
table sin=1/cos=0 is observed, explaining exact cardinal terrain endpoints.
|
||
-11 managed integration groups use real VR05/LEV1 data: ordinary outside tile,
|
||
summon/contact mount, body/wheels, drive/steer/brake/jump/no energy debit,
|
||
actual front-door wall and four-second recovery, default/impact camera math,
|
||
dismount40/companion/audio, named cleanup/noclip/reset, actual RETURN and visual
|
||
repeat/hide, plus follow/freeze/warp/reset of the companion. Front-door +Z driving hits the house steps, correctly entering impact.
|
||
-The original OMT cube probe observed75→bounds±37.5/radius64.9519043 with false
|
||
flag before a later unrelated true-flag call faulted. That diagnostic run was
|
||
not a clean complete camera probe; full camera execution is not claimed.
|
||
-Source guards and exact-resource exporter checks run through scripts/test.sh.
|
||
Runtime replay/build/package results are recorded below after verification.
|
||
|
||
Remaining: original whole-game comparison and native Windows play; mouse/analog
|
||
input and camera modes2..20; special cutscene camera helpers; scene-wide shared
|
||
collision globals including Jimmy/vehicle/other body ordering; general dynamic
|
||
pairs, mission/hazard callbacks and other levels; exact Goddard body/animation;
|
||
full retained vehicle/wheel/helper lifetime and save/load; render/cadence/pivot
|
||
parity. Jimmy's lab/outside capsule remains parked; Scooter uses its independent
|
||
source static body and does not bypass special Jimmy policies. Fixed60Hz and
|
||
modern wide UI are explicit port policies. Dummy audio verifies transport and
|
||
lifecycle, not speakers or audible pitch quality.
|
||
|
||
## Port replay evidence
|
||
|
||
Headless llvmpipe1280×720 and native Linux GTX1070/private Xvfb1920×1080
|
||
pass10 render phases in both VR05 and LEV1: summon, contact mount, drive, steer,
|
||
brake/jump, dismount, remount, named cleanup, noclip and reset. All seven injected
|
||
SDL keys are received; Vulkan validation is enabled with zero errors. The outside
|
||
replay explicitly uses authored school1 and turns away from obstacles; front-door
|
||
head-on behavior is covered separately by the actual-geometry managed test.
|
||
248 extra player/vehicle/interactions/director ticks reuse received input, without
|
||
root/speed/timer seeding. Companion/patrol and HUD clocks are not included in those
|
||
extra fixture ticks; this is not a source cadence or manual tutorial-completion
|
||
claim. Final native R exercises the real reset command; the headless fixture calls
|
||
the bounded reset helpers directly. Logs: artifacts/scooter-{vr05,outside}{,-window}.log;
|
||
stage captures share those prefixes. Images were inspected, including source
|
||
rider/body/wheels and the full32-row2560×1080 Player page.
|
||
|
||
From GamePort, `source scripts/env.sh`, then:
|
||
|
||
```
|
||
dotnet run --project tests/GamePort.ScooterTests
|
||
dotnet run -- --scene artifacts/extracted/VR05/scene.json --level gam/VR05.gam \
|
||
--smoke-scooter --headless --screenshot artifacts/scooter-check.ppm
|
||
dotnet run --no-build -- --scene artifacts/extracted/level1/scene.json \
|
||
--level gam/level1.gam --start school1 --smoke-scooter --headless
|
||
```
|
||
|
||
For native SDL replay omit --headless and add `--width 1920 --height 1080`. Set SDL_AUDIODRIVER=dummy only when hardware output is
|
||
unavailable. The audio replay executes SDL frequency-ratio calls and cleanup;
|
||
audible behavior and native Windows playback remain unverified.
|
||
|
||
Final regression: scripts/test.sh exits0 (artifacts/scooter-final-tests.log):303
|
||
Python tests plus2 separate HUD checks, all managed suites,36 main GPU completions
|
||
with zero enabled Vulkan validation errors,17 material readback checks, route/
|
||
checkpoint/transition/animation and SDL dummy audio checks. All539 originals
|
||
verify unchanged. The later companion-active guard and first-engine-frame frequency
|
||
ordering were verified by the final11-group Scooter and10-group Patrol runs;
|
||
source guards and final .NET10 build pass. The build retains the existing NU1900
|
||
unavailable vulnerability-metadata warning; there are no compilation errors.
|
||
Native Windows runtime and original whole-game comparison are still pending.
|
||
|
||
## Packaged checkpoint
|
||
|
||
Both self-contained platform packages identify clean runtime commit
|
||
`62c07a3d59ca6d71a7456957d8586c268d27c439` with source_dirty=no. Packaging log:
|
||
artifacts/scooter-package.log. The local cached-dependency publish used
|
||
NuGetAudit=false. All14 Scooter resource files match the prepared originals in
|
||
both packages; binary identities are retained in artifacts/scooter-package-identity.json.
|
||
|
||
The packaged Linux apphost runs from /tmp with DOTNET_ROOT, DOTNET_CLI_HOME and
|
||
NUGET_PACKAGES unset and uses only its packaged asset paths. Both native1920×1080
|
||
SDL replays pass10 phases and all keys, with enabled Vulkan validation/zero errors.
|
||
Logs: artifacts/scooter-package-{vr05,outside}.log. All20 stage readbacks match the
|
||
development/native captures byte-for-byte; artifacts/scooter-package-readbacks.json.
|
||
The final post-package audit verifies all539 originals unchanged. The Windows
|
||
package was cross-published and its resources checked; native Windows execution,
|
||
audible quality and whole-original comparison remain pending. Validation notes
|
||
are copied into each package; BUILD-INFO.txt separately identifies their commit.
|
||
|
||
## User feedback: pitch and angled dismount
|
||
|
||
The follow-up fixes the missing consumers rather than changing the original
|
||
handoff: Goddard keeps the source copied Euler at release, then his enabled
|
||
follow update gradually levels X/Z with source.3 axis factors. ScooterAudio
|
||
applies recovered positional frequency/history after the nominal engine command,
|
||
using the shared listener (including script and parked Jimmy camera). The nominal
|
||
pitch ramp already matches the original.11 new original facing traces and11
|
||
frequency traces are retained separately from the earlier53 drive observations.
|
||
13 Scooter,2 audio,10 Patrol and24 targeted Python groups pass, as do lab/
|
||
underground navigation and SDL dummy audio regressions. Native Linux GTX1070
|
||
1920×1080 replays pass both10-phase scenes with zero enabled validation errors.
|
||
The sound correction is slight; audible/native Windows comparison is still open.
|
||
See [leveling](scooter-dismount-leveling.md) and [pitch](scooter-pitch.md) for the
|
||
source/evidence, phase boundaries and limits.
|
||
|
||
Follow-up packages identify clean runtime commit
|
||
`fccc0b9d1b6ae962d32147e4ae1433fce6a1a23e`; both self-contained publishes pass.
|
||
Log: artifacts/scooter-fixes-package.log. All14 Scooter resource files match in
|
||
both platform packages; binary identities are in scooter-fixes-package-identity.json.
|
||
Standalone Linux from /tmp with SDK variables unset passes both10-phase native
|
||
SDL replays, with zero enabled Vulkan validation errors. All20 native readbacks
|
||
match development byte-for-byte (scooter-fixes-package-readbacks.json). Logs:
|
||
artifacts/scooter-fixes-package-{vr05,outside}.log. All539 originals verify
|
||
unchanged after packaging. Windows cross-build/resource validation is distinct
|
||
from the pending native Windows and audible comparison.
|