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

8.0 KiB
Raw Blame History

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.

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 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:

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.