Implement Baseball aiming, pooled projectiles and VR07 targets

This commit is contained in:
UnixNight committed 2026-11-02 22:54:19 -05:00
1 parent 50fcb87d90
commit d6ca417e9e
50 files changed
+3149 -32

No files matched your search

+204
View File
@@ -0,0 +1,204 @@
# Scooter: separate vehicle and deferred implementation
2026-11-02. Static source recovery only; **no live Scooter implementation or
original gameplay verification**. User parked broad collision. Scooter cannot
faithfully reuse only Jimmy's current body: original drive/steering depends on
separately constructed wheel children. Primary was advised before runtime work
and selected another gadget for the next implementation slice.
Original EXE SHA-256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
`tools/binary/scooter.py` guards17 complete bounded spans,13 virtual bindings,
10 constants,4 strings and the always-false sprint predicate. Generated ledger
`artifacts/scooter-contract/source-contract.json` contains exact VAs, PE offsets,
lengths and hashes. For every code VA in this report, file offset is VA−400000.
Data/table addresses must use the ledger's PE reader; do not assume this identity
for an arbitrary PE. Supplementary instructions are in the same artifact directory.
## REA evidence and coverage
Local `scripts/rea.sh`/Ghidra12.1.4 analyzed the generated copy
`artifacts/uncontrolled-phases/rea/Neutron.exe`; originals were not executed.
`rea-vehicle/01.json` recovered465220 with Evidence
`ev_09ecf350c8705d5f9c1da5b444eb8cd027f64f4859713b29c9d04bc4c55c2bc8`;
`02.json` recovered465830 with Evidence
`ev_dbb6ac283387e14f08d527a750c14af44c52ed80c612c40393a5434a16589916`.
Profile digest is
`e1ad533d4cc0333c2136fe0894217de2d61feea098240326e78633f9e4ddcbf9`.
Complete bundle and closed snapshot are retained.465220 pseudocode contains
incorrect float/pointer/local aliases and loses some x87 scalar producers;
the guarded instructions resolve the gates and arithmetic cited below.
421580 and412A90 returned explicit procedure-lookup/unmapped-file-offset
provider errors. Initial exploratory437F90/43A120 (Jimmy routines, subsequently
excluded from Scooter) also failed; `rea-native/` retains failures, empty export
and closed snapshot. No unchanged failed request was repeated. The first
sandboxed `rea-equip/` attempt saved only successful target-open metadata and no
pseudocode/Evidence or closed snapshot before its worker ended; no success is
attributed to it. Local static IPC allowance resolved the host restriction for
the later complete batches without changing client configuration.
## Actor, construction and selection
Inventory item4/raw mode4 is Scooter. Movement mode is a **separate vehicle
state**, not Jimmy movementmode3. C3DJEEP constructor4211A0 calls412870→464B90;
complete vtable4A2F8C, game interface+C0/vtable4A2AEC.4213F0 loads
`omt\\scooter.omt` (string4EEF2C). Radius is150 at42128E via game110→471240;
inherited factor is float.2 at412942 via4711E0. These are distinct from body
friction; do not replace friction with.2.
Jimmy game initialization423CE8..423DC1 lazily allocates6AC bytes, constructs
4211A0, and stores complete actor at Jimmy+A30 (game+970). Complete168→412A90
receives `(73,-30,3,3,1,true,true)` at423D58..75.412A90 constructs **four**
C3D wheel actors through type33574845/459CB0 into the first4 of6 pointer slots
complete578..58C and stores relative offsets in complete5A0+16*i. It also adds
mutual collision exclusions3A8. The slots are initialized null in464C9A..BC.
Thus the last2 generally remain absent in this constructor path; support code
still scans6. Wheel collision/body scheduling and wheel-type implementation are
not closed by this investigation.
Panel4278D7 already closes and invokes Jimmy cleanup178 before174(4), as in
[gadget-controls](gadget-controls.md). Item4 leaf4290B7 requires Jimmy+A1C
companion. It hides companion+994 via58(true), requires companion gameCC true,
sets raw4, copies companion root310/Euler328 into vehicle via16C/174, hides
vehicle and children through complete174→421800, enables vehicle gameD0/214,
then hides/disables companion gameD0/214. **This does not mount Jimmy or change
controlled pointer directly.** Failed companion gates still continue to practice
handling429297. Armed practice switches item9 to1 and loads VR05. Do not add an
energy requirement: the reviewed equip leaf has none.
Mount is a later Jimmy interaction callback:422F13..422FB9 recognizes target
`C3DJEEP`, invokes Jimmy complete1E0, calls game118(vehicle game interface),
stores Jimmy complete pointer into vehicle69C, hides Jimmy+A2C, adds Jimmy's
vehicle collision exclusion3A8, selects `SCOOT` with E0(...,true), then refresh148.
The callback's full interaction eligibility/caller and complete1E0 effect remain
separate gates. Merely selecting the tile must not fabricate a mount event.
## Fields, input and apply
Offsets here are **vehicle complete object** unless explicitly marked game.
| Offset | Source owner |
| --- | --- |
|578..58C|6 child pointer slots;4 populated by this setup|
|600/602/604|signed WORD front2/rear4/total child support counts|
|610/618/620/628|acceleration700/deceleration1200/base maximum2250/current maximum1485|
|61C|previous source scalar speed|
|63C/640|steering wheel angle/applied yaw rate|
|658/659|throttle/braking flags|
|65D/65F|keyboard-turn/reverse-held latch|
|650/654|camera mode/previous camera mode|
|690/694|engine channel/base sample frequency|
|698/69C/6A0|jump edge latch/mounted Jimmy pointer/animation clock|
464F60(100), called by base constructor, sets acceleration=100+600,
deceleration1200, base maximum=100*4.5+1800=2250 and default maximum=base*.66.
Vehicle game268/26C get/set scalar speed. Complete130→413A60 always returns false
in C3DJEEP, so the inherited sprint branch is inactive and normal maximum is
float1485. Mouse, controller and inherited AI/camera paths are not included in
the pure keyboard projection.
Input421880 rejects407060 true,475CA0 false or open gadget panel. Primary fire
509834 sets global4F8182; input then delegates465830. That input first copies
current scalar speed into61C, clears analog throttle/brake flags and fetches
mouse axes through completeF8. With mouseX0, keyboard Left precedes Right,
adds/subtracts200dt to angle63C and sets keyboard-turn latch. With no turn key,
that latch permits return toward0 by200dt, clamped at crossing. Angle caps±45.
Nonzero mouseX uses2*dt*mouseX and clears keyboard-turn latch; inherited return
does not necessarily continue after mouse release. Left/Right also accept
analogX<−.5/>.5 through421C10/40.
Forward predicate421C70 requires rear support count602>0 plus Up, primary fire,
controller button509AC4 or analogY>.5. It adds acceleration700dt while below
maximum and clamps there; at/above maximum normal no-sprint branch preserves
speed. Backward421CB0 also requires602>0 and supports Down/analogY<−.5, with
the source primary-fire/controller qualifications retained in instructions.
First accepted backward call sets reverse latch: positive speed subtracts1200dt
and clamps0; negative speed adds1200dt and clamps0. Subsequent held calls
subtract1200dt, allowing reverse down to−currentMaximum*.4 (about−594).
Braking flag659 persists through the continued-held path; release clears both
braking and reverse latch. Forward executes before backward. These are dt-based
vehicle increments, unlike Jimmy's fixed-per-callback Bubble throttle.
Apply421580 calls412ED0→465220, which calls462520 first, then requires475CA0
and game210. It scans actual nonnull children and their game218, recomputing
600/602/604. Steering requires nonzero incoming horizontal live velocity and
front count600>0. Scalar speed gives scale=min(horizontalMagnitude*.005,1);
ordinary yaw rate640=frontCount*angle63C*scale (inherited AI uses2 instead).
The dot between normalized horizontal velocity and rotated local forward
chooses forward/reverse yaw sign; yaw increment is rate*dt.
The drive-velocity rewrite at465594 requires **vehicle game218 AND total child
support604>=2**. Missing/unsupported children do not imply support. Unsupported
vehicle still publishes scalar speed but does not execute that rewrite.
Supported scalar decay/turn drag/slope terms, normalized live/forward direction
mixing and friction can change speed and velocity; the whole465220 span and
Evidence are retained but no full numerical drive projection is claimed. The
`drive_eligible` helper tests only its recovered eligibility gate. Jimmy's
ordinary application formula is not equivalent to this routine.
## Mounted update, animation, sound and cleanup
After vehicle apply,421580 with mounted69C calls Jimmy complete1AC(dt), handles
the five standard jump inputs and copies vehicle root/Euler into Jimmy. Jump
uses its own edge latch698: release clears it; held with latchfalse and vehicle
support queues `(0,700,0)` through game28C, then sets latch. Airborne hold does
not latch, so support can accept it later. This is pending velocity/impulse state,
not an immediate Y700 live-velocity assignment. No mounted pointer takes a
different stop/reset path421794; it does not run mounted jump/pose updates.
Animation timer6A0 stores float(timer+dt), compares to **double.3**, and when
greater selects Jimmy `SCOOTSTOP` for signed scalar speed<10, otherwise `SCOOT`,
both E0(...,true), then clears timer. Reverse speed therefore chooses stop at
this site. float32(.3) is already greater than double.3. Do not replace the
threshold with.3f equality. No Goddard195-vertex morph binding was proven;
[asset inspection](gadget-assets.md) and vehicle asset export retain that gap.
412ED0 starts positional looping SFX46 (`Scooter`) through4589C0 when vehicle
gameCC and audio global696008 are true and engine channel690 is−1. It captures
channel base frequency in694; later frames write a speed-dependent frequency,
minimum7000. No direct energy debit42A920 was found in the reviewed equip,
vehicle input/apply/update spans. This bounded result does not prove global
energy policy for every interaction/caller.
Cleanup178 raw4 jumps4281B3. If companion absent or companion gameCC already
true it proceeds to common raw−1 return42882F without the full vehicle teardown.
Otherwise it clears menu4B4, writes JimmyA20=.5 (consumer remains unknown),
copies vehicle root/Euler back to companion, shows/enables companion D0/214,
resets42AE90 clocks, removes Jimmy vehicle exclusion3B0, exposes vehicle children
through completeD8→464F00, disables vehicle D0/214, destroys retained helper via
complete164, stops engine690 and clears it−1. If mounted69C nonnull it additionally
clears Jimmy action latch1E25 and4F8182, restores game118(Jimmy interface), raises
Jimmy rootY by constant49FAD4, clears acceleration278/live velocity2C4, requests
`RUN`4ECA64, exposes Jimmy+A2C (unless509A13), and finally clears vehicle69C.
Every completed return sets raw−1. The exact elevation constant is intentionally
left in guarded source pending the full dismount/body policy; no new cleanup
Euler blend or Jimmy movement-mode reset was inferred.
## Camera and implementation boundary
Vehicle camera completeEC→4130A0 runs at the end of465830; it uses camera
mode650, previous654, global eye509A50, vehicle rotations/speed and native
collision clipping. Default mode1 is set in464D1F and its source branch begins
413234; Down/reverse and camera-mode inputs remain separate concepts. Full
camera branch arithmetic/obstruction ownership is unresolved, and using Jimmy
camera439900 for Scooter would be a declared approximation. There is no proven
complete camera contract here merely because source is retained.
Practical next slice, in order:
1. Close C3D wheel child transforms, support/contact scheduling, source body
properties and static VR05 eligibility; preserve actual4-child constructor.
2. Add distinct registered Scooter actor, spawned/mounted/control-owner state,
child exclusions, mount eligibility and atomic cleanup handoff.
3. Port465830 keyboard and465220 full arithmetic with regression projections,
then jump/pose/SFX46/camera. Preserve scalar/live/pending state separation.
4. Compare original mount/drive/jump/reverse/dismount runtime before claiming
faithful playability. Native Windows comparison remains unverified.
These dependencies make a movement-only Jimmy flag insufficient. Broad collision
remains parked; no runtime source was edited by this investigator. Nine Python
groups pass: identity/span/binding guards, spawn-vs-mount, real support gating,
steering caps/release, rear-support throttle, brake/reverse ordering, jump edge,
animation float/double boundary and bounded inputs. They validate source
projections, not original execution or port vehicle behavior.