Files
Neutron/docs/gameplay/baseball-implementation.md

7.6 KiB
Raw Permalink Blame History

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, targets, resources, TIME font and review. 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.

Live ball bodies/contacts are bounded to LV1B,VR01,VR04,VR07 andLEV1. Other levels do not yet run this consumer. 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: both Linux/Windows packages identify clean d6ca417 (source_dirty=no). All16 referenced Baseball/aim canvases match their original pixel hashes in both. Standalone Linux from /tmp passes all eight gameplay phases and the1920×1080 expanded F1 Player view. Release validation layers are unavailable; enabled source/native results remain separate. Both publishes succeed despite NU1900 metadata warnings;539 original hashes verify after packaging. Logs: package.log, package-baseball.log, package-debug-player.log, originals-after-package.log. Native Windows, whole-original runtime/visual comparison, retained helper lifetime and complete combat remain open.