101 lines
7.5 KiB
Markdown
101 lines
7.5 KiB
Markdown
# 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.
|