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

8.5 KiB
Raw Permalink Blame History

Bubble gameplay integration

2026-11-02. User-directed gadget continuation after1897dd2/9ea5784. The broader collision checkpoint remains parked. This adds Bubble's original sprite/controller and a bounded source static-body/floor profile in its actual VR01 tutorial.

Coverage map

Original system Current implementation Evidence / remaining boundary
Item0/raw0, movement2 Separate inventory/display/body/controller state; failed transitions retain raw−1 bubble.md, bubble-motion.md; full inventory/equip policies for other gadgets remain open
Radius160/factor.415, cleanup60/1.265 Source body parameters; no direct root recenter; cleanup maximum650 bubble-body.md; six isolated copied-original body references match managed results
439900 input/4387E0 apply Fire/Up throttle, turn±50, supported input decay, XZ before scalar halving, direct300/900 bounce Keyboard subset; mouse/analog and full scheduler remain open
Action/orientation Supported STOP, retained unsupported pose, recovered tilt targets/math Bubble orientation bridge; complete generic Euler/dirty/camera ownership remains open
Bubble410AE0/410CA0/410D00 Independent visual clock; exact flag priority/strict fade;240 pulse; full RGBA bubble-rendering.md; default additive branch, modern world-billboard basis/depth policy
RetainedSprites.omt Canv1 Exact146×146 pixels, bounded exporter/manifest/runtime hash check No invented sphere or Jimmy scaling; original renderer orientation/UV padding remains open
Controlled drain/sound −.5dt via shared energy owner; loop2; held supported106; cleanup stops loop Tutorial helper immunity; raw-null input can stop drain without stopping visual clock
VR01 floor111 Retained support identity, entry39/optional190, raw0 damage bypass,−5 score/energy and strict4-second flash Other damage flags and full footstep-loop ownership remain open
Material write order Stored PlayerAppearance receives Invisible alpha/blend requests and later lava RGBA Current single-atlas material; complete linked models/material/render states remain open
Practice/cutscene/debug Bubble practice precedes live equip; actual raw-mode menu gate; named Jimmy cleanup; F1 grant and diagnostics Owned helper lifetime across ordinary loads and native Windows/original whole-game comparison remain open

Source hashes, VAs/file offsets, structures, byte guards and REA Evidence are in bubble.md, motion, body and rendering. Complete exports and closed snapshots stay in artifacts/bubble*/. Copied-original execution is limited to the isolated body routine with synthetic virtuals, not the game entry point or original gameplay.

Runtime ownership and boundaries

LabSimulation owns BubbleEffect, its captured world root, radius/factor/current maximum and mode2 motion. Input uses source steering/camera before drain/placement; depletion cleans the mode but still captures the final sprite root. Fresh input precedes Jimmy; the effect clock runs after Jimmy before retained-input policy. Fresh callback partial order is source-supported. Complete retained helper survival/initialization remains unresolved, so retained-helper parity is not claimed.

The supported wrapper selects STOP and radius160. Mode2 bypasses normal550 jump/ jetpack state changes and remains2 through landing. Apply preserves incoming liveY when unsupported. On support, held jump sets liveY900 and requests106; released jump composes XZ, then halves the published scalar and sets liveY300 without sound. Acceleration and pending impulse are not cleared on equip/apply. Cleanup restores radius60/factor1.265/movement0/current maximum650 and begins the independent fade. SourceA20=.5 cleanup write has no closed consumer; no guessed countdown is added.

Source static response is enabled for VR01 in addition to VR04. Actual VR01's 80 polygons/60 wall entries have only ordinary wall materials; its six111 polygons are support surfaces, not wall374. All used original materials have linked textures. The base callback consumes retained support material even while currently airborne or uncontrolled, before controller movement. Ordinary floors clear entry state; Bubble raw0 prevents new lava damage but does not erase an existing flash. Tutorial exemption skips energy loss, not score loss. The late flash writes RGBA and preserves blend-enable/factors, correctly retaining its interaction with Invisible's material requests. Other damage flags and dynamic pairs remain out of this bounded profile. Missing material is skipped; texture-link eligibility is source-verified for these actual VR01 IDs, not a general textureless-material implementation for other scenes.

The existing fixed75.9 root-to-feet/render bridge remains explicit: Bubble physical support is66.4 and equip does not force a downward root correction. Lab/outside continue using their provisional capsule/dynamic adapter; this is not a claim of source Bubble collision in those scenes. Shared camera targets/smoothing/clipping retain existing approximation gates, including known Bubble follow differences.

TracksBubbleOrientation preserves the earlier yaw-only baseline until Bubble first needs pitch/roll. It then uses recovered target/easing/full-forward math and retains normal cleanup handoff: accepted ground direction restores target pitch/roll0, no input does not invent a reset, and normal air targets0/−turn. Exact generic Euler update enable/phase remains separate. Modern reset clears this bridge. Source logical root and original visual pivot are not conflated.

Bubble practice selection records the display item but skips live equip before requesting VR01, matching the source early practice branch. Failed live selection can leave a display item with raw−1; GadgetScreen now reads the actual raw mode. Named-Jimmy CAM/MCA cleanup uses the earlier recovered DeactivateInv path. Modern F3/Stop Motion releases Bubble and lets its owned fade finish; noclip still bypasses body/contact/energy actions. Reset/new scene clears the port-owned effect; exact retained original helper fade across loads remains open.

Verification and continuation

Thirteen focused integration groups cover six copied-body numeric references, queued work/root preservation,300/900 bounces and mode persistence, independent clock/drain, depletion/selection/audio, transition rejection, ray suppression, actual111 retained-floor behavior, strict flash, stored material order, practice and raw/display gates, cutscene cleanup and modern flight fade. Eleven motion and eight effect/visual groups are separate. Source projection checks do not claim original execution. The initial synthetic test floor had visible winding; corrected to source winding before matching the original references.

The eight-frame smoke uses actual VR01/PHONEBOOTH, source input/body/effect paths and extra ordinary player ticks between rendered phases. It does not relocate actors or directly mutate timers/velocities. Ctrl/Left and Shift exercise throttle, steering and an actual supported900 bounce/SFX106; Tab cleans, then full RGBA fade and hidden state are captured. Extra ticks and verification results are logged explicitly in artifacts/bubble-implementation/. This is an accelerated port fixture, not original cadence, manual tutorial completion or full-game comparison.

Complete scripts/test.sh passes202 Python+2 HUD, all managed suites,31 main GPU completions and17 isolated Vulkan material checks, with zero enabled validation errors. SDL dummy lifecycle and539 original hashes pass. Independent review reruns13 integration/11 motion/8 visual groups and finds no blocker in this scope. Native GTX1070/private Xvfb1920×1080 passes all eight SDL phases with zero enabled validation errors,306 accelerated player ticks and tutorial energy20. Active/fade readbacks were inspected.

Both self-contained packages identify clean1ae5f42 (source_dirty=no). Publication succeeds for both platforms despite NU1900 metadata warnings. Exact original Canv1 RGBA hashes match in both. Standalone Linux from /tmp passes all eight Bubble phases and the expanded F1 Player view at1920×1080; release validation layers are unavailable. All539 originals verify after packaging. Logs are in artifacts/bubble-implementation/. Preserved baseline packages remain untouched. Windows is cross-built; native gadget verification remains open.

Next gadget work must retain the documented body, camera, material, input and helper-lifetime boundaries rather than assuming universal immunity.