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

+10
View File
@@ -5,6 +5,16 @@ SDL3 for platform windowing, input and audio. Linux x64 and Windows x64 are
equally required. Source is `src/GamePort/`; root executable csproj allows
`dotnet build` and `dotnet run` from GamePort. No runtime network dependencies.
`BaseballGadget` keeps pending/saved/displayed aim, camera adjustments and20 owned
`BaseballProjectile` entries distinct from equipped raw mode. Cleanup hides its
UI/restores the companion but retains the latch and flying balls. `SceneBaseballs`
steps bodies before controller input and target frame state afterward; six duplicate
3TAR tags retain source-instance identities. The source body has an explicit ball
profile for delayed landing impulse, prevent-lowering=false and reflection/friction.
Sphere-pair discovery remains a declared bounded adapter. `BaseballVisuals` and
`BaseballAimOverlay` append source Canv2/253 and TIME16-pixel glyphs using the
existing world/overlay pipelines and uniform viewport. See baseball-implementation.md.
Bubble adds separate `BubbleMotion` input/apply, `BubbleEffect` owned clock and
`BubbleVisuals` original canvas. LabSimulation keeps body factor, current maximum,
movement mode and captured sprite root distinct. The source static factory also
+13
View File
@@ -3,6 +3,19 @@
Compilation, native runtime, original behavior and full feature completion are
separate evidence categories. **The game is not fully reconstructed/playable yet.**
Baseball (2026-11-02): source hold/release/20-slot pool, exact ball/aim/TIME art,
bounded ball body, VR07 moving-target callbacks and F1 grant are implemented.
12 managed/6 visual/16 Baseball Python groups and independent review pass.
Native Linux GTX1070/private Xvfb1920×1080 passes real SDL Ctrl/Left/Up/Tab,
all eight render phases, actual target hit/respawn and zero enabled Vulkan
validation errors. Its1010 extra ordinary player/target ticks are an accelerated
port fixture. Sphere contact discovery, angular wall response, full enemy combat,
retained helper lifetime and original/native Windows comparisons remain open.
Complete regression passes232 Python+2 HUD, all managed suites,32 GPU runs and
17 material checks;539 originals verify. Package status is in progress.md; gameplay/baseball-implementation.md
records the coverage map. Scooter's recovered wheel/control dependencies are
documented but not implemented as invented Jimmy movement.
Bubble (2026-11-02): original mode2 controller, sprite/flags/pulse/fade, controlled
drain, loop/boing ownership, cleanup650 and boundedVR01 source body/floor111 are
integrated. Six isolated copied-original body references match managed output.
+3
View File
@@ -35,6 +35,9 @@ energy/recharge gates; a grant is not instant activation. The header shows
remaining time, recharge and targetability. Full enemy sensing is not implied.
Give/Select Bubble uses the implemented mode2 controller, while Unequip starts
its original fade. Diagnostics show Bubble phase and source radius/factor.
Give/Select Baseball grants item6 and shows aim/pending/throw diagnostics. Hold
primary fire and use Up/Down to aim; release to throw. Cleanup preserves its
source pending latch and existing flying balls. See gameplay/baseball-implementation.md.
State0 means unowned,1 enabled and4 disabled by the level. The full availability
action re-enables the matching VR practice gadget and applies LV1B restrictions
on gadgets1/7 after the common prefix. Other level-specific tails remain incomplete. These controls expose
+12
View File
@@ -219,3 +219,15 @@
not invented sphere geometry. Keep the render bridge, generic camera/Euler,
other damage states and retained helper lifetime explicit. Bubble practice
precedes live equip; menu gating reads raw mode, not display selection.
39. **Keep Baseball ownership beyond selection.** Preserve the original20-slot
ring, pending release after cleanup, prior-capture label and source release
cost/sound order. Landing queues a full impulse before support clears Y;
use a ball-specific profile rather than Jimmy callbacks. VR07 target state
belongs to source instances despite duplicate tags, with strict parent hit
threshold and conditional collision activation. Exact TIME glyph binding
replaces the temporary font policy. Keep current sphere-pair discovery,
angular reflection, mouse/analog aim and helper retention across loads explicit.
40. **Save Scooter recovery before implementing it.** Its separate C3DJEEP actor,
mount/control handoff and wheel-dependent drive/support cannot be represented
by a Jimmy mode or an invented constant wheel count. Preserve the source
report/exporter and close wheel bodies before live Scooter integration.
+145
View File
@@ -0,0 +1,145 @@
# Baseball original resources and VR07 fixture
2026-11-02. Original serialized resources and decoded pixels were read locally;
originals were not modified or executed. Binary activation/projectile/target
behavior belongs to the separate Baseball contract investigation. This report
records asset identity and a resource interface suitable for integration.
`tools/extractors/baseball_resources.py` exposes `export_baseball(original, output)`
and writes schema1 `baseball.json`. It preserves five exact canvases from
RetainedSprites.omt and the authored VR07 start/target/intro properties, including
every property source offset/raw bytes and duplicate target tags. It rejects
original subtree/ancestor outputs and existing descendant symlinks, checks both
archive and GAM identities before writing, and guards dimensions/pixel hashes.
```bash
python3 tools/extractors/baseball_resources.py ../Original --output artifacts/vehicle-assets/baseball
python3 -m unittest discover -s tests -p test_baseball_resources.py -v
```
Six regression checks pass: exact RGBA/PNG/provenance, original aim/glyph pixels,
six distinct target
records with authored property bytes, protected output paths, changed decoded
pixels and changed archive identity. Local output and test log are
`artifacts/vehicle-assets/baseball/` and `artifacts/vehicle-assets/baseball-tests.log`.
No shared prepare/runtime/build files were changed by this investigator.
## Port visual implementation and tested limits
`Application/BaseballVisuals.cs` appends20 hidden world alpha quads to a supplied
Mesh, preserving its collision metadata and existing draws/textures. `Update`
uses the caller's pool visibility/position, exact Canv2 and25×25 world dimensions.
It does not animate frames2..5 or invent a lifetime. Camera-facing centered
billboard orientation is a declared modern policy pending exact inherited sprite
render recovery. Degenerate straight-up/down cameras use a finite orthonormal
basis. Resource paths are bounded to the prepared Baseball directory, input
size/depth/dimensions and exact original pixel hashes are validated.
`Application/BaseballAimOverlay.cs` uses exact screens.omt Canv253 CrossHairs
15×210 pixels, SHA256
`2e16e11b151c8474ba68fd5017d1a3a6304a594a7f34c3b423f3417c7edfb453`.
The complete strip stays stationary at logical(315,100), without frame cropping.
Visibility follows AimVisible; text reads the separate prior-capture DisplayPitch,
not the newly captured SavedPitch. Source numeric position is
`y=trunc((45-DisplayPitch)*4.3+100)`, source text anchorx286, with positive-space
plus two zero-padded decimal digits from `% .2d`.
The subsequent [TIME font recovery](baseball-font.md) closes that binding:
set5 digits use alpha.omt118,127,120..126,119, all16×16. A null positive-space
glyph has zero advance; visible digits begin286 and302. Exact green pixels are
preserved with white vertex tint. Runtime/exporter/tests now use that source
mapping; the temporary SMAL policy is superseded.
The exporter writes these plus the source strip into `aimTextures`, each with
its source database key, byte range and decoded hash. `aimArchiveSha256` guards
screens.omt and alpha.omt. Source table, formatting and advance Evidence is in
baseball-font.md.
UiViewport retains uniform scale and centered640×480 placement at widescreen
and portrait sizes. Screen/world quads use alpha blending with unmodified source
texture alpha. Six standalone checks pass in
`artifacts/vehicle-assets/baseball-visual-tests.log`:20-slot/pixel/source metadata,
billboard bounds/camera degeneracies, stationary aim/number/selected glyphs,
widescreen and portrait scaling, combined world/overlay isolation and rejection
of altered pixels/dimensions/path traversal. Invocation:
```bash
source scripts/env.sh
dotnet run --project tests/GamePort.BaseballVisualTests
```
These are compiled port-side deterministic mesh/pixel checks. They do not verify
a displayed Vulkan frame, original source execution or native Windows behavior.
## Projectile and retained target artwork
Archive `omt/RetainedSprites.omt` SHA256
`b584ffa4a38f4bc809b3ea8f4321e0c08f2719e22df41a3fb4cd143ed89b3bef`.
This archive contains Canv resources, not 3D shapes.
| Canv / name | Offset / bytes | Dimensions | Decoded RGBA SHA256 |
| --- | --- | --- | --- |
|2 ball0000|72372 /3786|32×32|`68904b758e69139de0b01329b2a9844ecd2a466f31598c24324affaccfa2cab9`|
|3 ball0001|68582 /3790|32×32|`005def070e18111fbdb067e75285dad8ec677c1608020f55c3db7a4b9745205c`|
|4 ball0002|64788 /3794|32×32|`c368a59d5d7a57824c1c6b56b617cf058f5d5d53e18e5e48989710413490c536`|
|5 ball0003|58830 /3794|32×32|`e5da21c359d3215759e5c3c238107f526f7109203c0ff9fa391a3c8bc40c17ed`|
|8 target|48796 /10034|64×64|`8d31014cb9b9661ebed902c864bf740f562460e74da3f6b86ed3d2be4d10f0ec`|
Manifest `textures` records id/name/width/height/path/png/sourceOffset/sourceBytes/
sourceSha256/rgbaSha256. `ballCanvasIds` lists source IDs2..5 in source-number
order, without assigning animation cadence. `retainedTargetCanvasId:8` names
the literal retained artwork only; it is not the six VR07 target actors' artwork.
Pixels are neither recolored nor resized. The source target8 image visibly has
a four-corner frame/cross pattern; inspected original pixels are available as
`artifacts/vehicle-assets/retained_8.png`.
The contract investigator corrected an early interpretation of constructor40FC50:
its complete57C=25 is the inherited sprite dimension, complete580=2 the initial
canvas ID, and complete5F8..604 retain IDs2..5. It is not shape25. Exact REA
Evidence, frame selection, billboarding, size and render-state policy belong in
that investigator's source report; this exporter embeds no unverified cadence.
## Actual VR07 target visuals
All six authored `3TAR` records explicitly serialize `SpriteDatabase=sprites.omt`,
`SpriteIndex=135`, `SpriteSize=150`. The source resource is Canv135 **star**,
128×128 at offset2750568/35394 bytes. It is a pale purple jagged starburst with
8,016 alpha255 and8,368 alpha0 pixels. Exact RGBA SHA256:
`42bbea6c33fc2889cad0cd659af2274f936be10643254af233779c44f1e41e07`.
Archive SHA256:
`c8e016ea73e6104b9b672139b1d0b0ac83afc4feff6cc744a7fa4f6ba919e2a2`.
Inspected pixels: `artifacts/vehicle-assets/sprites_135.png`.
The existing `prepare_entities` exporter already follows this explicit sprite
database/index and can supply the exact texture; no duplicate sprite export is
necessary. Primary independently traced actual factory45CA06 to430220, inheriting
the sprite base441980; it is distinct from the Jimmy-owned retained target actor
and from the other class constructor4453B0 sharing a FourCC. That factory/default
recovery is separate from the serialized values verified here. The integration
must establish that the source loader respects the serialized overrides before
claiming runtime target appearance parity.
## Authored tutorial instances
VR07.gam SHA256
`1260b75d82ec794f9375ada30e186424746bc1dd4e4b0540c9b69bb7ad12d0b1`.
Six target offsets are0x885,0xAD6,0xD27,0xF78,0x11C9,0x141C. Every target uses
the same tag `C3DMOVINGTARGET`; identify instances by source offset/ordinal.
All serialize Speed100, HitsRequired3, NumPoints10, RespawnTime15 and
ActivateObject=`none`. These are data values, not reconstructed hit/motion rules.
| Offsets | Authored start | Authored destination |
| --- | --- | --- |
|885,AD6,D27|(-755,188,277)|(815,188,277)|
|F78,11C9,141C|(815,333,1520)|(-755,333,1520)|
Do not silently replace each instance's serialized Position with StartPos; both
are retained in the manifest. Constructor/postload/frame behavior determines how
these fields interact. PHONEBOOTH is STRT0x48C, authored position
(7.5705023,216.7101440,-1525.1119385), yaw0, StartTrigger=`bb1`.
Intro3MCA0x1892 serializes PlayerControlled=`NULL`, DeactivateInv1,
NextTrigger=`default` and source voicepractice IDs36,19,35,33,34.
This fixture has authored visuals sufficient for projectile and six target
rendering using the current sprite infrastructure. Source targeting, motion,
contacts, inventory/intro state, score, respawn and original/native Windows
execution comparison remain independent implementation/verification gates.
+114
View File
@@ -0,0 +1,114 @@
# Baseball TIME font closure
2026-11-02. Static original-binary and asset recovery. No original executable was
run or original file modified. This closes the font resource/advance/tint
questions, not displayed original pixel alignment or general renderer parity.
Primary owns the exporter and runtime changes; this investigation edits only this
report and generated `artifacts/baseball-font/`.
## Recommended integration
Replace the temporary SMAL digits with TIME set5's original **16×16** alpha.omt
canvases. Decimal0..9 maps to **118,127,120,121,122,123,124,125,126,119**.
The format is `% .2d`, but TIME's leading positive space maps to a null glyph
and has **zero advance**. For the current declared logical overlay rectangles,
draw the visible digits at **x286 and302**, width/height16, and the existing
source y formula. Do not add an8- or16-unit leading-space advance.
Retain the exact source RGBA with white vertex tint. All ten glyphs have opaque
RGB **(17,255,73)** and alpha0/255; preserve these green pixels without recoloring.
The leaf sets material RGB=(1,1,1), alpha from global4F4ED4 (initially1), and blend
enums from4F4ECC/4F4ED0 (initial6/7). The text function resets that alpha global
to1 after ordinary text. The Baseball caller does not supply an additional tint.
Exact shared-alpha scheduling across all possible text callers is outside this
bounded recovery; ordinary opaque glyph material alpha1 is the evidenced default.
## REA Evidence and supporting bytes
REA analyzed the existing generated copy
`artifacts/uncontrolled-phases/rea/Neutron.exe`, SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Ghidra12.1.4 returned all four requested routines. Complete replies, exported
Evidence and the closed snapshot are in `artifacts/baseball-font/rea-local/`.
| Routine | REA Evidence |
| --- | --- |
|4683E0 font initialization|`ev_f5dd8e211882ec340474745de486b4d431a981816a512773fd57a51cb6bfa1bc`|
|468660 formatted text/layout|`ev_e20b6c0cc47aa285935609ad63ea77cf92d9d23b3ca18fe52c7dd6fc286f2308`|
|4689F0 glyph emission|`ev_8a5c0ce796b76993a6e86e19a1d2a36fb1945f1a23c6416ad446213e1e0e043c`|
|468B80 font/character selection|`ev_bd91c2e5548e4e627af7f3faf7e8d5f2a70fa830bff9c3a5bbcbeb55c545e5d9`|
The first sandboxed attempt failed when Ghidra's local Unix socket bind returned
Operation not permitted. The task's owned failed batch was interrupted and its
session closed; its complete failure replies remain in `rea/`. The approved
local static run resolved that host IPC restriction without configuration edits.
This was not a source-execution observation. Both owned sessions are closed.
`font-assembly.txt` and `aim-call-assembly.txt` cross-check the same generated
EXE's instructions. `source-spans.json` records original VAs/file offsets/lengths/
SHA256 for the four functions, bounded Baseball call and font table. Ghidra's
468660 prototype loses its variadic arguments, and4689F0 reports a spurious
unaff_retaddr parameter. Argument and x-advance facts below therefore come from
checked instructions, not literal translation of those pseudocode signatures.
The four code entries map to file offsets683E0,68660,689F0,68B80; the font
table maps toF4ED8. `tools/binary/baseball.py` also guards/exports the table hash,
TIME digit IDs and null-space mapping so this binding remains reproducible.
## Table and glyph identity
4683E0 loads alpha.omt via string4F51D8, then at46844A..46849F walks six groups
of64 signed16-bit table entries startingVA4F4ED8. Index−1 stores a null pointer;
all other IDs are looked up through477890. Runtime pointer table is5091E0.
468B80 uppercases the character, admits ASCII32..95, and selects TIME
`54494D45`→set5 at468C23; SMAL `534D414C` instead selects set1 at468C39.
Runtime index is `font*64+uppercase(character)-32`. The set5 table starts4F5158;
digit0's word is4F5178. The768 source table bytes have SHA256
`910bef1d7aca6f1aa328ba9f671831bdbbda19b419fb0c693117cb096d542226`.
alpha.omt SHA256
`53cb9f47a588b1f19eb0adc4d43c8066a8b78aedd764b9e9314c81e287991126`.
Every digit below is16×16. `glyphs.json` records exact source resource byte
ranges, RGBA SHA256, alpha counts and opaque RGB. No regenerated substitute font
or scaling of the existing8×8 SMAL images is needed.
| Character | Canv / name | Source offset / bytes | RGBA SHA256 |
| --- | --- | --- | --- |
|0|118 t1600|74484 /642|`edc60e65dcf7320813a80d4312e3c45951ccfc566ea79dfabf7a22ebc4b96049`|
|1|127 t1601|25406 /466|`1fd058ad5bdc0f8a064ef7d2d52b2b036df3f35515691a366799d7e8aab5297f`|
|2|120 t1602|73236 /450|`62aaeaaf107300a6f4f7ff52e98106c1520a9edbe2137626ee41091cf243e5c5`|
|3|121 t1603|76660 /450|`d78bf1895f5838b9eb8c6a22565a9588dae4fc8f7106697df373f4408aae634c`|
|4|122 t1604|19604 /562|`f6d628639de4e40005f62f63a49308ff9ee0656a36bb6eb7787230b4830a5ed9`|
|5|123 t1605|19154 /450|`9f58cad5621d89b7a7012036daa8532b2397b0d9d267ab7d1aa5a7cd10d7ae87`|
|6|124 t1606|73872 /530|`49cdc9ec812f4ef3826011d542c30afbb10229c4b4ce549e7820233bbaa53dd9`|
|7|125 t1607|17298 /458|`aaef2d59c2636c059b446bed643985ca55d15b2d070b0582b2d8994b3bf74f1e`|
|8|126 t1608|23440 /610|`bade574a4624a3f763ddd9c87fa2f102562b00d8d604e9faf32a43b372de64e0`|
|9|119 t1609|2438 /530|`0a663ddf2df9f1065f5e4ffe27b4d1fa96edd5f19b6323217bad4148f8d2f3d7`|
|space|−1 /null|table word4F5158|no canvas/no advance|
|minus|−1 /null|table word4F5172|no canvas/no advance|
## Formatting, advance and material facts
Baseball426754..42678D truncates the previously captured1D68 pitch to an integer,
pushes format string4EF440 (`25 20 2e 32 64 00`, `% .2d`), fontTIME, computed y
andx286 into468660. Y is `trunc((45-priorPitch)*4.3+100)`, with45 as source
float49D5C8 and4.3/100 as doubles4A3E40/4A3130. This occurs before4268A3..8A9
captures current camera pitch into1D68, supporting the separate DisplayPitch.
468660 formats into its local buffer and iterates characters.46891A gets the
glyph pointer,468931 calls the glyph emitter, and468939 tests that pointer.
For null pointers46893B jumps directly to46894C, skipping the x addition.
For non-null pointers46893D..468948 advances by `canvas.width*screenWidth/640`.
Therefore TIME space and minus are absent and zero-width. Every available digit
advances16 logical units; there is no kerning or extra letter spacing in this
path. A format result ` 09` draws0 and9 consecutively with no leading gap.
Pitch is clamped0..45 in the sustained-hold path, so a negative-number glyph is
not required for this bounded Baseball label.
4689F0 rejects null glyphs immediately at4689F8..4689FA and allocates no slot.
For a real glyph it binds the source canvas, sets custom width/height from its
pixel dimensions scaled byscreenWidth/640 andscreenHeight/480, alignment fields
BC=1/C0=2, source blend globals, white RGB at468AFE/468B08/468B0F and alpha from
4F4ED4 at468B17. 4689BF resets global alpha to1 after ordinary formatted text.
This closes the resource sizes, per-glyph step and material tint. General sprite
alignment caches, original frame scheduling, fixed-function alpha tests and
widescreen policy remain renderer boundaries rather than font-table gaps.
+88
View File
@@ -0,0 +1,88 @@
# Baseball gameplay integration
2026-11-02. User-directed gadget continuation after clean1ae5f42/50fcb87 Bubble.
Broad collision investigation remains parked. Scooter's recovered separate vehicle
and wheel dependencies are saved in scooter.md; no invented drive support was added.
## Coverage map
| Recovered original | Current implementation | Evidence / remaining boundary |
| --- | --- | --- |
| Item6/raw6 equip without energy gate | Source selection, Goddard hide/body flags, F1 grant | baseball.md; availability and display remain separate from raw mode |
| Hold/first-arm/later capture/release | Supported SHOOT, source Up/Down pitch, Left/Right yaw, first-arm saved value, prior label | Keyboard/primary subset; mouse/analog aim and global suppressor lifecycle remain open |
| complete84C camera scalar and7CC height | Default10, equipped height+30, source eye/target scalar terms, cleanup0/height200 then ordinary reset10 | Existing camera ray/smoothing/Euler/viewport boundaries remain |
| Release even after cleanup/at zero energy | Sound10 before launch, then pending clear and fixed−1 shared energy helper | Twenty owned entries persist independently of raw mode; no invented ammo or TTL |
| Launch local point/vector, speed1800 | Local(0,80,50), aim slope saved/45, quick magnitude, full transform bridge | Upright yaw tested; full source trig/Euler equivalence is unverified |
| Ball radius15/factor1/friction.46 | Explicit source body profile, prevent-lowering=false, delayed full-vector landing impulse, horizontal wall response | Angular reflection tail and general dynamic pairs remain open |
| Ball appearance | Exact RetainedSprites Canv2, source25-square billboard | Other preloaded ball canvases are not animated without a proven cadence |
| Aim strip/text | Exact screens253 at315,100; exact TIME set5 green16-square glyphs at286/302 | Full original sprite alignment/render state remains separate; uniform widescreen policy retained |
| VR07 registration/body | False game filter and bounded static Jimmy/ball body, textureless collision retained | Full material/scene flags and dynamic body interactions remain incomplete |
| Six moving3TAR records | Source-instance identity, source speed/destination/reset-to-start, hidden movement and15-second respawn | Body/controller partial order is implemented; full original registry order remains open |
| Target/parent callbacks |10-point hit, missing-parent198, strict>HitsRequired, parent collision/visibility and199 | Current sphere overlap discovers contacts; other enemies/ball consumers remain unported |
| Cutscene/debug/reset/load | Dedicated unconditional Baseball companion restoration, named-Jimmy cleanup, modern reset clears pool | Original retained helper/pool/latch lifetime across ordinary loads remains unresolved |
Source addresses/file offsets, fields, guarded bytes, REA Evidence and provider
limits are in [Baseball](baseball.md), [targets](baseball-targets.md),
[resources](baseball-assets.md), [TIME font](baseball-font.md) and
[review](baseball-review.md). All investigations used local generated copies;
originals were neither modified nor executed. Static projections, managed tests,
port GPU/native checks and original gameplay observations are separate categories.
## Runtime ownership
LabSimulation owns BaseballGadget, its shared camera scalar/height bridge and20
projectiles. Input updates camera adjustment before follow, then primary actions
after ordinary steering. Hold clears controller speed, requires support and the
shared energy gate for a new arm/capture, and selects SHOOT. First hold retains
old saved pitch; later hold captures clamped0..45. DisplayPitch stores the value
used before that capture. Release hides the UI and checks pending alone, so cleanup
does not silently cancel a throw. Audio request precedes launch; energy follows it.
SceneBaseballs owns source moving-target state and the bounded world/pair adapter.
Bodies run before player control; target timers and next velocity run afterward.
Landing sets an impulse from the old live velocity before support zeros Y; the
next body tick consumes it, including X/Z. Pool reuse preserves pending impulse
and support. Unequip retains flying balls. Modern reset/new scene clears the
port-owned pool explicitly; it is not a claim of original retained-loader parity.
Target activation calls the parent's source428 behavior, not the script trigger
interpreter. VR07's initially hidden trophy cannot be collected before activation.
Its HasCollision property controls pair enable independently of visibility and
integration. Baseball cleanup restores Goddard even in Invisible's six blocked
levels; that policy is covered separately in regressions.
The shared body remains the ordinary source composition for Jimmy. Ball response
is an explicit profile; allowing ball wall materials does not imply recovered
special Jimmy contacts or lab/outside source-body replacement. Its horizontal
reflection uses the source normal/damping; the angular tail is omitted. Current
target/Jimmy recovery detection uses per-tick sphere overlap, with no claim of
source pair membership, discovery order, swept discovery or full enemy combat.
## Verification
Twelve managed groups cover arm/capture/display order, sound/launch/cost ordering,
release after cleanup, twenty-slot reuse, upright launch, queued landing impulse/.46 floor friction, wall reflection,
actual VR07 duplicate identities, target respawn/start reset, cutscene cleanup,
all six companion restoration exceptions, and real target contacts activating
the trophy on the strict fourth hit with HasCollision0/−1. Six visual groups
cover exact pixels, ball dimensions, degenerate camera bases, source aim layout,
widescreen/portrait scaling, combined mesh isolation and bounded resources.
Sixteen Baseball Python groups cover source projections, byte guards and exports.
Scooter source/resource regressions are separate. Independent review findings
were corrected and rerun; see baseball-review.md.
Headless and native Linux GTX1070/private Xvfb1920×1080 pass all eight rendered
phases: equip, first hold, prior-label/capture, release, flight, actual authored
target hit, unequip retaining the ball, and respawn. Real SDL Ctrl/Left/Up/Tab
arrives; enabled Vulkan validation reports zero errors. The fixture advances1010
extra ordinary player/body/target ticks between captures, preserving VR07 energy20.
No actor relocation or direct timer/body-state writes are used. This is an
accelerated port fixture, not original cadence/manual tutorial completion.
Aim/flight/hit readbacks are inspected. Logs: artifacts/baseball-implementation/.
Complete scripts/test.sh passes232 Python+2 HUD, all managed suites,32 main GPU
completions and17 material checks, zero enabled validation errors, SDL dummy
lifecycle and539 unchanged originals. Final focused12-group/16-source-group checks
cover the additional callback numeric assertions and font table guard. Clean package
results are recorded in progress.md when available. Native Windows, whole-original runtime/visual comparison, retained
helper lifetime and complete combat remain open.
+81
View File
@@ -0,0 +1,81 @@
# Baseball implementation review
2026-11-02. Independent read-only review of BaseballGadget, SceneBaseballs,
OriginalBodyPhysics, LabSimulation, PlayerSceneBinding and Program wiring.
Source baseline/evidence and provider limitations are in
[baseball.md](baseball.md); no unchanged REA queries were repeated.
## Resolved findings
1. **Companion cleanup policy differs by gadget.** The initial implementation
subscribed Baseball.EquippedChanged to InvisibleEquipped, incorrectly skipping
restoration in LEV6/LEV7/LV1C/LV1D/LV4A/LV6A. Source raw6 cleanup42871D..878D
restores Goddard when its pointer exists without Invisible's9E8 skip test
(compare428144). PlayerSceneBinding now uses a dedicated BaseballEquipped
handler with unconditional restoration. A regression verifies all six levels.
2. **Initially hidden tutorial trophy contact must be disabled.** At review time
SceneBaseballs activated its parent with Active=Visible=true, while
SceneInteractions3TRO contacts used Active regardless of visibility or pair
enable. This permits collecting VR07's initially hidden trophy before earning
it. Primary subsequently added a narrow trophy pair-enable/activation correction
in SceneBaseballs and requires trophy pair enable in SceneInteractions. The
regression exercises real ball/target contacts, strict fourth-hit activation,
and HasCollision0/−1 behavior. It passes.
Do not replace this with a scene Trigger: target430570 calls parent428(1).
The source alias needed for the second correction is proven: pickup property
reader40D41A passes interface+584 and literal4ED26C=`HasCollision` to3FC, type6.
C3DVRTrophy interface table4BE404 has428→40E1F0. For argument1 it calls
3AC→4730E0→224(true) only when HasCollision is nonzero, then unhides through
complete58(0) when needed. Argument0 calls3A4→473030→224(false), then hides.
It does not enable214 integration, award score or invoke the script interpreter.
These are supplemental reviewed instructions; primary owns adding the exact
guards to baseball_targets.py. They are not attributed to new REA pseudocode.
## Checked source contracts
- Equip has no fresh energy gate. Camera height adds30; cleanup restores200
through170→437740 and clears pitch to0. Ordinary non-raw6 input subsequently
restores pitch10. Current Forward/Backward mapping correctly increases pitch
on Up and decreases on Down,20*fixed-dt; this source keyboard field is unrelated
to PageUp/PageDown.
- First supported hold shows the aim strip and arms without refreshing saved
pitch. Later holds clamp0..45. DisplayPitch is copied before capture, matching
the original one-invocation label delay. Release hides the strip and launches
once from the saved pitch, including after unequip and at zero energy.
- Cleanup retains pending throw, saved pitch and20 projectile entries. Source
ring reuse does not clear pending impulse/support; current Launch preserves
both. Modern scene reset clears the pool and is an explicit lifecycle boundary.
- Projectile launch uses local(0,80,50), normalized local aim slope pitch/45,
source quick magnitude and speed1800. Upright yaw cases pass. Continuous
full-Euler transform remains a declared original table-precision boundary.
- Ball floor friction and wall damping both read slot248/live150=.46;
authored24=3.2 belongs to a different field. Floor support uses radius15,
factor1, prevent-lowering=false. Current Projectile.Step explicitly supplies.46.
- Landing queues oldX,−.65*oldY,oldZ into impulse before support zeros velocityY;
next body consumes it. Current implementation preserves this phase order.
- Program runs ball/target bodies before player input, and target frame callbacks
afterward. Input ownership follows LabSimulation's controlled path. Release
from a pending latch is processed even when raw6 is no longer equipped.
## Declared limits, not release claims
SceneBaseballs uses per-tick sphere overlap instead of original pair membership,
registry order and swept discovery. It can re-hit an overlapping ball after a
target respawns, whereas original enter callback timing still needs the pair
scheduler. Whole-scene pair response and other ball consumers remain incomplete.
Ball angular wall response is omitted, and each managed ball tick supplies zero
angular state; its billboard's positional path is the bounded tested subset.
Only Canv2 is used because no four-canvas animation advancement was recovered.
The full original game and native Windows input have not been runtime-compared
by this review.
## Verification
`dotnet run --project tests/GamePort.BaseballTests --no-restore` passed11 groups
with the local .NET environment. Python discovery `test_baseball*.py` passed16
groups covering source guards, resources and target projections. These results
were rerun after the companion/trophy fixes. No remaining concrete blocker was
found within this bounded review; the declared limits above remain. No runtime
or shared source was edited by this reviewer.
+98
View File
@@ -0,0 +1,98 @@
# VR07 moving targets and Baseball contacts
2026-11-02. Static recovery and source projections; original whole-game execution
has not been observed. Original EXE SHA256 is
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
`tools/binary/baseball_targets.py` guards the reviewed spans, virtual bindings,
factory and false registration filter. It reports PE-mapped offsets. All code
addresses below have file offset VA−400000 in this executable.
## Evidence and identity
The generated EXE copy was inspected with local REA/Ghidra12.1.4, profile digest
`e1ad533d4cc0333c2136fe0894217de2d61feea098240326e78633f9e4ddcbf9`.
Complete Evidence and a closed snapshot are retained in
`artifacts/baseball-targets/rea-local-ipc/`:
| Procedure | Evidence |
| --- | --- |
|430220 moving-target construction|ev_3e420d49b2d4d524b6a80f3aebddef7d54863186d417cfc3b48d0f2a20b0fa29|
|430570 Baseball contact|ev_3a2778c478e072e201b1e3baaf87434837fd570a00b5ee84022491175c00c7c4|
|441AC0 sprite PostLoad|ev_236e87925819c8924f5becb9a72da56152655b79d0527a2d81bdef32c912917f|
|4573F0 VR07 construction|ev_11fddbe40ea4b959e27cba000aa4557cb04b2d4d104b11f155feedf88a97f04c|
4306B0 and475CD0 were not recognized procedures and the provider's numeric
fallback interpreted them as unmapped file offsets. Their behavior is supported
by guarded disassembly, not attributed to pseudocode. The initial restricted
attempt failed at the Ghidra local socket; its owned batch was interrupted and
closed. Permitted local IPC resolved that host restriction. No client configuration
or original bytes changed. REA inspection is static, not target execution.
3TAR's actual factory45CA06 constructs430220, complete table4A8E74, game interface
complete+C8/table4A8A10. Do not confuse it with Jimmy's C3DTarget aim helper or the
different4453B0 class also registering3TAR. Actual runtime type is C3DMOVINGTARGET.
VR07 constructor4573F0 binds complete game4CFAE0; slot134→475CD0 returns false
(`32c0c21800`), permitting the previously recovered NC/checkpoint registration
filters. VR07 has134 serialized triangles and no special Jimmy wall materials.
Textureless triangles remain collision candidates even though rendering skips them.
## State and interaction
| Complete field | Meaning / writer |
| --- | --- |
|57C/580/584|Sprite size/index/database; defaults100/98/sprites.omt; GAM overrides150/135/sprites.omt|
|5EC..5F8|Start XYZ/W, W initialized1|
|5FC..608|Destination XYZ/W, W initialized1|
|60C|Speed, default100|
|610|Respawn timer, initialized0|
|614|ActivateObject name|
|678/67C/680|HitsRequired(default5), NumPoints(default10), RespawnTime(default15)|
Source radius75 is set at430485. World response and support are disabled by
430478/430480; integration is enabled430495. Frame game3C4→4306B0 first invokes
463090, then updates orientation, respawn and velocity. Positive respawn subtracts
dt with a float store; <=0 clamps0 and unhides. Hidden targets keep moving.
The vector to Destination is quick-normalized and multiplied by Speed. Ordinary
sqrt distance<100 then teleports to Start through314. Endpoints are not swapped;
the just-published velocity survives the teleport into the next integration phase.
Zero-length normalization is explicitly bounded to zero in the modern port.
Contact game40→430570 first calls470A90, then accepts C3DBASEBALL only while
timer<=0. It hides the target, copies RespawnTime, and awards NumPoints through
42ADC0. It does not hide/destroy the ball. Lookup of ActivateObject returns the
first matching tagged actor. Missing parent requests SFX198. A C3DTROPHY or
C3DPICKUPITEM parent has its respective hit counter incremented; activation
occurs only when count **> HitsRequired**, then resets counter and requests199.
This strict comparison requires four qualifying contacts for VR07's value3.
Trophy interface4BE404 slot428→40E1F0 takes activation1, conditionally enables
collision via3AC when interface584 is nonzero, then unhides. It does not execute
the script trigger interpreter or restart integration. Activation0 disables
collision via3A4 and hides. The port preserves that limited visibility/contact
operation; its existing actor flags remain a narrower adapter than all source flags.
## Actual tutorial and implementation boundary
VR07 GAM SHA256 is
`1260b75d82ec794f9375ada30e186424746bc1dd4e4b0540c9b69bb7ad12d0b1`.
Six3TAR records at file offsets885,AD6,D27,F78,11C9,141C all use the same tag
C3DMOVINGTARGET. They must be stored by source instance/offset, never collapsed
by a tag dictionary. Each has speed100, score10, respawn15 and HitsRequired3.
Only record11C9 names parent `trophy`; the others name `none` and produce198.
The original visible target is the explicitly serialized sprites.omt Canv135
star,150×150.441AC0 proves that binding; RetainedSprites Canv8 `target` is separate.
SceneBaseballs separates body integration before controller from target frame
updates after controller. Pair discovery currently checks current sphere overlap
at radii15+75 and Jimmy recovery15+player radius. This is a declared modern adapter,
not recovered47A580 registry ordering, swept dynamic contacts or full enemy combat.
Static ball response uses the source body/grid/support with ball callbacks; its
angular reflection tail and full logical/render Euler lifecycle remain open.
VR07's hidden trophy has contact disabled until its source activation so the
existing pickup adapter cannot collect it while invisible.
Four Python groups cover identity/spans, duplicate source identities, hit gate,
stored respawn subtraction and strict parent threshold. Modern managed/native
results are recorded separately in baseball-implementation.md. Retained helpers
across level loads, moving target generic flags/rotation, full original cadence,
original runtime and native Windows comparison remain unresolved.
+144
View File
@@ -0,0 +1,144 @@
# Baseball source contract
2026-11-02. Static recovery; original EXE SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Text raw offsets equal VA−400000. The helper PE-maps and guards15 reviewed
source ranges,13 virtual targets and8 constants. No original game code was run.
## Practical scope
Baseball is feasible as the next bounded gadget with VR07 targets. It needs a
20-entry projectile pool, original sprite, primary hold/release state and narrow
ball-specific physics callbacks. Broad enemy AI is unnecessary for VR07's six
3TAR objects. Target behavior/registration is independently owned in
[baseball-targets.md](baseball-targets.md); resources in
[baseball-assets.md](baseball-assets.md). Generic full-scene collisions remain
outside a claim of finished gadget fidelity.
## Evidence and provider boundary
Local REA/Ghidra successfully decompiled constructor40FC50, Evidence
`ev_5c45397cd90b6247920a64a8b27d2838d805a8e1eebba69886f7ffd81d62993a`,
and physics scheduler479BC0, Evidence
`ev_56b7e074ec8509d1c5b3576d02361ff051963b777d7ccb8259ed9c65dc2db52f`.
Complete replies, exported bundle and closed snapshot are in
artifacts/baseball-contract/rea-local/. The initial sandbox attempt could not bind
the Ghidra Unix socket; its errors remain in rea/. The local permitted execution
completed. Queries426030,429A30,40FF40,40FF80,427FF0,428D50,472B10 were not
recognized as procedures; provider then interpreted numeric selectors as unmapped
file offsets. Their behavior below uses reviewed guarded disassembly, not claimed
successful pseudocode. Whole-game execution, original runtime comparison and
arbitrary-input x87 equivalence are unverified.
## Owners, equip and cleanup
Jimmy complete table4A3BDC:174→428D50 equip,178→427FF0 cleanup,
180→429A30 throw,148→429A00 stops saved soundA44 only,170→437740 camera defaults.
Item6 dispatch table4298E8+7*4→4296F8; raw6 cleanup428844+6*4→42871D.
Equip4296F8 sets raw4F0588=6 with **no energy gate**, adds30 to camera scalar
complete7CC, hides menu+4E4 if needed, then hides Goddard and disables its body
214 and visibilityD0. Practice item9==2 then selects VR07 through42976C..7D8.
Cleanup42871D clears complete84C (camera/aim scalar), restores Goddard and shadow,
calls170 camera defaults, hides menu4E4, then common tail sets mode−1.
It **does not clear** pending throw complete1E26 or saved pitch1E28, and does not
destroy or hide the20 flying balls. A later release can therefore still throw.
Constructor422609..269C allocates20 C3DBaseball complete objects of61C bytes,
stores pointers at Jimmy+AB4..B00 and initializes signed WORD B04=0. Ball game
interface is complete+C8 (table49141C), unlike Jimmy+C0. Pool capacity is not an
ammo count; current nonnull slot is reused and B04 increments modulo20. Null
slot leaves index unchanged. No ammo decrement is present in this launch path.
## Hold, pitch and release
426030's existing ownership/modal gates and movement438A60 precede primary
actions. Held predicate is helper42A7A0 OR separately polled Enter; release means
both false. Helper includes mouse/Enter/Ctrl/controller and suppressor4F83E0.
42668F..66BD rejects busy1D65, modal4F8182 or raw0, then zeroes controller
speed608. Energy helper4269D0 rejects energy<=0 unless complete9F8 override.
No minimum1-energy threshold is required. Ground support is necessary to enter
the raw6 aiming branch; airborne raw6 follows existing primary behavior.
Ground hold426718 selects SHOOT, calls148 to stop sound, then raw6:
1. Emit angle text for the **previous saved pitch**1E28, before any new capture.
2. Show fixed menu4E4 crosshair strip.
3. First held tick sets pending1E26 and calls148 again; it does not capture pitch.
4. Later held ticks clamp complete84C to[0,45], then copy it to1E28.
The same complete84C is modified by ordinary input438C2C..CC6;4267D3 reads it
as interface+78C. It is **not logical EulerX**. Down(VK_DOWN28/address509860) decreases
it20*dt; Up(VK_UP26/address50985E) increases it20*dt. Otherwise signed mouseY*dt
is added, with analog threshold branches. Raw6 preserves it when not firing;
other modes ordinarily reset10. The camera uses it through439625 (eyeY offset
7CC−2*84C) and4396A9 (targetY7DC+scale*84C). This is independent of throw's
full logical-Euler point/vector transform.
Menu4E4 is screens Canv253,15×210 at logical(315,100), scale1, initialized hidden
at4020DD..2104. Hold shows it, release426585 hides it. The adjacent numeric text
call468660 is variadic formatted text (vsprintf at468694), not sprite animation:
x286,y=trunc((45−savedPitch)*4.3+100), identity54494D45, format`% .2d`,
value=trunc(savedPitch). This yields a positive blank plus two precision digits.
TIME selector468C23 uses font5;46844A loads its64-word map from4F4ED8.
Digits0..9 map to alphaCanv[118,127,120,121,122,123,124,125,126,119].
SPACE maps−1/null; null-glyph advance is separate asset/UI work.
Release42659F..65F9 tests pending alone, plays SFX10 once, stops soundA44,
calls complete180 with(0,80,50,savedPitch), sets interfaceA48=0, clears pending,
then energy42A920(−1). It performs **no fresh mode, support or energy gate**.
Shared energy exemptions/clamps/warnings apply; VR07 is exempt. SHOOT uses the
existing authored shooting clip; no bespoke baseball throw clip was established.
## Launch and body callbacks
429A30 transforms local spawn point(0,80,50) through interface384 (472980),
unhides selected pool entry, enables collision224 and integration214, publishes
root314, transforms local vector(0,float32(savedPitch*float32(1/45)),1) through
38C (472B10), quick-normalizes, then sets velocityXYZ×1800 through2C4.
It does not clear pending impulse or support on reuse. For upright logical
pitch/roll0, yaw theta gives spawn root+(−50sin(theta),80,50cos(theta)) and
velocity1800*normalize(−sin(theta),savedPitch/45,cos(theta)). Source trig-table
quantization and imported quick magnitude differ from continuous host math.
Constructor40FC50 binds retainedsprites.omt Canv2 with sprite size25; preloads
Canv2..5. Complete57C=25 is size, **not a3D shapeID** (435430→464430).
It sets radius15, authored property24=3.2, wall damping28=.46, and leaves the
floor support factor1. Floor friction also reads slot248 and is.46 (47A356); suppression scale.5.
Pool initialization hides it, disables integration214 and collision224; launch
enables both. Generic defaults include support1C8=true, world1D0=true,
reflection1D8=true, prevent-lowering208=false. Constructor sets authored204=false
and224=false. Do not confuse authored field offsets, live fields and slots.
|Ball interface slot / implementation|Effect|
|---|---|
|370→40FF50→472690|Ceiling callback: independently clear positive velocityY and positive accelerationY.|
|374→40FEE0→458890→378472750|Generic wall reflection. Normalize horizontal velocity; reflect using supplied normal; rescale by old horizontal magnitude; preserve oldY; damp resulting XZ by(1−slot248), where slot248 reads wall damping.46. Angular heading response is an additional source tail.|
|37C→40FF80|Read live velocity2BC; store queued impulse288=(oldX,−.65*oldY,oldZ). **This is not a velocity write.**|
|3C4→40FF40→463090→458930→473240|Generic update; no baseball-specific TTL or canvas-frame advancement recovered.|
Support47BB10..BBA7 publishes floor root, zeros accelerationY, invokes37C only
on previous-support=false, then zeros velocityY and sets support true. Next
ordinary body tick consumes queued impulse before acceleration/gravity. Because
37C queued full X/Z, horizontal speed can increase on the next tick; do not
silently discard those components. See existing
[body composition](../checkpoint/collision-body-composition-source.md) for
gravity, displacement, static support/friction and publication order. Ball's
factor1/radius15 and no prevent-lowering must be supplied to a ball adapter;
Jimmy-specific callbacks are unsuitable. No automatic first-hit destruction or
fixed-distance/time expiry is justified by this class.
Jimmy enter423014..307D recognizes C3DBASEBALL, disables ball214/224 and hides
it. Other objects own their contact effects. A target hit cannot be presumed to
consume a ball solely from its name; target and dynamic-contact scheduling need
their own source boundary. Cleanup6 leaves balls active; scene/pool ownership
must survive until its actual loader/reset boundary.
## Verification
tests/test_baseball.py verifies source identity/ranges/virtuals, first-hold versus
later pitch capture, stale displayed pitch, hold gates, release after cleanup,
ring reuse/null behavior, upright launch offsets and delayed full-vector landing
impulse. These are bounded static projections, not original execution or modern
runtime verification. Frame animation of the four preloaded ball canvases,
general dynamic collision response and exact trig precision remain unresolved.
+3 -2
View File
@@ -103,8 +103,9 @@ prepared standing mesh, so existing morph preparation can preserve its topology.
|rope01.ASE,rope02.ASE|1 each /30|6 vertices/6 faces and4 vertices/2 faces.|
|laser02.ASE,missile.ASE|1 each /30|8 vertices/8 faces and7 vertices/10 faces; missile's goo.bmp reference is not a verified gadget attachment.|
scooter.omt contains shape0 `goddard01`, shape1 `wheel`, matching material/canvas
resources0 `goddard128` and1 `scooterwheel2`; archive SHA256
scooter.omt contains shape0 `goddard01`, shape1 `wheel`; material0 `goddard128`
links Canv1 `goddard128`, material1 `scooterwheel2` links Canv0 `scooterwheel2`.
This corrects the earlier ambiguous material/canvas association; archive SHA256
`8d4ffdafee5fd819c5220ee4f608c901a5988fe6b8b13316e15618f5eec75e81`.
inventory.omt is an older-looking icon set with BUBBLE/GODJEEP/SCOOTER/jetpack etc;
its names alone do not justify replacing screens.omt menu art or IDs.
+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.
+97
View File
@@ -0,0 +1,97 @@
# Scooter / Rocketship resource contract
2026-11-02. Read-only original asset inspection. No original executable was run
and no original file was modified. Source binding recovery belongs to
`scooter_contract`; geometry/sample/pixel observations here do not establish
attachment, steering, visibility, sound ownership or interpolation policy.
`tools/extractors/scooter_resources.py` exposes `export_scooter(original, output)`.
Its schema1 `scooter.json` references two independent original OMT shape scenes,
Jimmy's two renderable Scooter animation manifests, and the two unbound Goddard
Scooter source morphs. It checks original hashes before output, rejects original
subtrees/ancestors and existing descendant symlinks, and uses portable
case-insensitive asset lookup. Original PNG pixels and OMT canvas alpha are kept.
```bash
python3 tools/extractors/scooter_resources.py ../Original --output artifacts/vehicle-assets/scooter
python3 -m unittest discover -s tests -p test_scooter_resources.py -v
```
Five checks pass: shape/material/pixel identity, exact Jimmy base topology and
sample positions, preserved unbound source times/absent UVs, source/output
protection and changed-source rejection before output. Generated inspection data
is `artifacts/vehicle-assets/inventory.json`; generated resources are under
`artifacts/vehicle-assets/scooter/`. No shared prepare/runtime files were edited.
## Usable Scooter geometry
Archive `omt/scooter.omt` SHA256
`8d4ffdafee5fd819c5220ee4f608c901a5988fe6b8b13316e15618f5eec75e81`.
| Original resource | Offset / bytes | Geometry / exact texture link |
| --- | --- | --- |
|3DSh0 `goddard01`|104 /19342|98 indexed vertices,176 triangles; material0|
|3DSh1 `wheel`|92304 /5814|32 indexed vertices,56 triangles; material1 plus null-material polygons|
|3DMa0 `goddard128`|19446 /52|Canv1|
|3DMa1 `scooterwheel2`|19498 /52|Canv0|
|Canv0 `scooterwheel2`|22568 /3966|32×32, RGBA SHA256 `92dfef71def8079db70ba4eaa47e973d45a0b3987418e87dbf65cc3cf0bf823b`|
|Canv1 `goddard128`|26534 /65770|128×128, RGBA SHA256 `b22651171a7b9f2c99831a1ff4fd8d01d11ccabfc276d71dd91bacd710cd1cba`|
This corrects the ambiguous material/canvas ordering in gadget-assets.md:
body material0 points to **canvas1**, wheel material1 to **canvas0**.
Each shape gets a separate `shape_ID/scene.json` compatible with the existing
OMT scene loader, expanded source positions, source normals/materials/UVs,
transitively referenced decoded canvas and provenance. Null wheel materials stay
null (`material:-1`), rather than receiving an invented visible material.
Neither shape is translated, scaled or instanced by this exporter. Runtime must
use the separately recovered original body/wheel attachment contract.
## Morph compatibility
| Original ASE | Indexed vertices / faces | Sample times | fps / ticks per frame | Available base |
| --- | --- | --- | --- | --- |
|jimscooter|426 /814|0,480|10 /480|jimstop426; base supplies original UV/topology|
|jimscooterstop|426 /814|0,480|10 /480|jimstop426; base supplies original UV/topology|
|godscooter|195 /370|0,161|30 /160|none recovered|
|godscooter2|195 /370|0,161|30 /160|none recovered|
|godrocket|222 /411|0,960,1920|5 /960|count-compatible godpoint222, binding separate|
|jimdrive|426 /814|0,480|10 /480|count-compatible jimstop426, binding separate|
Jimmy exports use the existing `export_ase` family format and exact original
`png/jimycarl.png` (SHA256
`55ed165aaffe177cb62558a08d13fc3b2210da6e353065b108849d46df9dacb6`).
Each animation is source-named, with relative `../jimycarl.rgba` texture and
two expanded geometry frames. No family action names or playback times are
assigned. Existing `prepare_actor` can express these Jimmy clips directly.
Flat reconstructed ASE normals remain the existing exporter limitation.
Both Scooter dog morphs have **no UV tables**. Their195 positions differ from
both OMT body98 and the existing Goddard godpoint222 base. Existing morph export
correctly rejects these combinations. `godscooter-unbound.json` and
`godscooter2-unbound.json` preserve all parsed positions/faces and exact sample
times, without fabricated UVs or rendering them as a valid actor. The second
sample's161 ticks is intentionally retained, not rounded to160. Material-list
filenames include many unrelated scene leftovers; these do not prove binding.
## Rocketship and Baseball boundary
`godrocket.ASE` lacks UVs but has222 vertices/411 faces, the same count as
`godpoint.ASE` (textured high-detail Goddard base). This permits existing actor
export mechanics *if* binary binding establishes that base. It does not justify
claiming the gadget renders that clip. `jimdrive.ASE` similarly has426 positions
and no UVs. `rocket.ASE` is a separate textured16-vertex/22-face mesh (one sample,
5fps/960 ticks), and `rocketfire.ASE` has4 vertices/3 faces at0/960/1920 with UVs.
The material texts mention rocket.bmp/fire.png; no Rocketship gadget attachment
is inferred. `objects.omt` contains3DSh26 `rocketship`135 vertices/236 polygons;
that name also does not close the gadget's resource binding.
No baseball-named ASE or PNG was found by bounded filename search. This does not
establish that the source lacks a ball asset. The separate Baseball investigation
has recovered constructor40FC50 using RetainedSprites.omt Canv2 at sprite size25;
25 is not a shape ID. Exact resources and TIME font are in `baseball-assets.md`
and `baseball-font.md`. Original HUD/control/sound identity
is already inventoried in `gadget-assets.md` and should not be duplicated.
Static asset extraction and the five Python checks are verified. Gadget rendering,
wheel motion, source animation timing, original execution comparison and native
Windows behavior remain unverified.
+32
View File
@@ -1,5 +1,37 @@
# Progress — 2026-11-02
## Baseball continuation
Continued gadgets after clean1ae5f42/50fcb87. Local REA investigations recovered
Baseball's20-slot pool, hold/release and delayed landing impulse, VR07 moving
targets/strict parent activation and exact TIME font. Original addresses/offsets,
fields, hashes, provider limitations and closed Evidence are in gameplay/baseball*,
with separate source guards and tests. Scooter recovery is saved in scooter.md
and vehicle-assets.md; its separate C3DJEEP/wheel body gates prohibit pretending
that a Jimmy mode implements it. All investigator file ownership has returned.
Implemented BaseballGadget/Projectile, explicit ball body response, SceneBaseballs,
original ball/aim/TIME rendering, VR07 source static registration and F1 grant/
diagnostics. Pending throws/flying balls survive unequip; source scalar/label and
sound/launch/cost order are separate. Six identical target tags preserve distinct
instances. Review corrected gadget-specific companion restoration and hidden
trophy contact/conditional activation;12 managed/6 visual and16 Baseball Python
groups pass. Bounded pair discovery and angular/world/Euler/helper retention
limits remain explicit; full enemy AI/combat is not claimed.
Headless and native GTX1070/private Xvfb1920×1080 pass all eight rendered phases,
including real SDL Ctrl/Left/Up/Tab, actual target hit, retained projectile and
respawn; enabled Vulkan validation reports zero errors. Fixture advances1010
extra ordinary player/target ticks, preserves tutorial energy20 and does not
relocate actors or directly modify timers. Captures were inspected. Complete
scripts/test.sh passes232 Python+2 HUD, all managed suites,32 main GPU completions
and17 isolated material checks with zero enabled validation errors. SDL dummy
lifecycle and539 original hashes pass. A final focused12-group Baseball run adds
source wall-reflection and.46 floor-friction numeric checks;16 Baseball Python
groups pass after adding the font-table guard. Clean package validation follows. Logs:
artifacts/baseball-implementation/. No new native Windows/original whole-game
runtime claim is made.
## Bubble continuation
User continued gadgets after clean1897dd2/9ea5784. Bubble mode2 motion, body,
+13 -2
View File
@@ -80,10 +80,21 @@ the resume backlog, not prerequisites imposed on this user-directed gadget work.
SDL Bubble checks;539 original hashes unchanged.
- [x] Commit clean1ae5f42 Bubble milestone, rebuild Linux/Windows packages, verify
exact Canv1 pixels in both and standalone Linux gameplay/debug view from /tmp.
- [ ] Rocketship, Scooter, Remote, Baseball and Grappler; full enemy AI and
- [x] Recover Baseball equip/hold/release, owned20-slot pool, queued landing
impulse, exact original TIME font and VR07 moving-target/parent contracts.
- [x] Implement Baseball, original ball/aim rendering, F1 grant, bounded VR07
source body/targets, eleven integration/six visual groups; independent review.
- [x] Headless and native1920×1080 actual SDL aim/release/target-hit/respawn pass;
1010 extra complete player/target ticks are an explicit accelerated port fixture.
- [x] Complete232 Python+2 HUD/all managed/32 GPU+17 material regression; final
12-group Baseball callbacks and16 source groups pass;539 original hashes verify.
- [ ] Clean Baseball Linux/Windows package validation.
- [x] Save Scooter separate actor/mount/vehicle and original asset contracts;
wheel body/support lifecycle remains a gate before faithful live integration.
- [ ] Rocketship, Scooter, Remote and Grappler; full enemy AI and
original/native Windows comparison. Retain collision/camera/retained-helper gates.
Details: [first gadget slice](gameplay/gadgets-implementation.md). Investigators
Details: [Baseball continuation](gameplay/baseball-implementation.md). Investigators
have returned all file ownership to primary. Complete final regression, native
Linux input and release checks pass; the remaining gadget effects are the next
gameplay backlog. Native Windows gadget verification remains open.