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

89 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.