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

101 lines
7.5 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.
# 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](bubble.md), [motion](bubble-motion.md), [body](bubble-body.md) and
[rendering](bubble-rendering.md). 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 integration, native input and package results are recorded in progress.md
when verified. Next gadget work must retain the documented body, camera, material,
input and helper-lifetime boundaries rather than assuming universal immunity.