Implement Bubble controller, sprite and VR01 body behavior

This commit is contained in:
UnixNight committed 2026-11-02 16:57:54 -05:00
1 parent 9ea578492d
commit 1ae5f4251c
51 files changed
+2811 -54

No files matched your search

+183
View File
@@ -0,0 +1,183 @@
# Bubble body, VR01 registration and support material
2026-11-02. Independent investigation; no modern runtime files changed. The
ordinary body can accept Bubble's radius/factor and actual VR01 static geometry,
provided the separate retained support-material callback is preserved. VR01 has
no special wall374 polygons; it does have a consequential lava floor111.
This does not reopen dynamic actors or all special-contact policies.
## Evidence and scope
EXE SHA256 `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
OMT DLL SHA256 `3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
`tools/binary/bubble_body.py` PE-maps eight bounded body hashes,27 fixed sites,
ten virtual targets and the DLL texture-pointer publication, then independently
decodes VR01/VR04. Text VA minus400000 gives EXE raw offset here; DLL source
100013B5 maps raw13B5. Full facts/hashes are in
`artifacts/bubble/body/source-contract.json`; raw disassemblies sit beside it.
Relevant reused REA Evidence, with complete reports already retained:
| Source | Evidence | Retained location |
| --- | --- | --- |
|479D20 integration|`ev_5439072b32ae9f9208795ad2b07bc524e2407b46da487072fb3dfd8c10e7c4b0`|artifacts/collision-response/rea-response/|
|40E050 animated base|`ev_03a109302788b85597e253293bbcb535c4080732e41cc828bb33d01d2b2da09a`|artifacts/uncontrolled-phases/rea/|
|462520 support/material bridge|`ev_f0a2e1fd465472295b272f2fdbfb6be4651aeb8c35d90dc2ca02a495ed359edd`|same|
|OMT material read10001490|`ev_f592b625a60ec683a17627d671c47d78d722eb39d5eb407744d53a283ee2586d`|artifacts/collision-integration/contacts/rea-material-identity/03.json|
|Bubble equip/cleanup|[Bubble source report](bubble.md)|artifacts/bubble/rea-effect/|
New REA/Ghidra factor-setter4711E0 Evidence
`ev_5d2495e741932d9eb7b5a687d31b4fcc7a398d890797247ddf262677f6cf490f`
is saved/exported/closed under `artifacts/bubble/body/rea-ipc/`.
It confirms authored2C is stored and forwarded through254 to live154; the
setter changes no root.424600/44E030/4252E0 were not recognized as procedures;
their VA queries fell through to unmapped file-offset errors. These are saved
provider gaps, not successful pseudocode. Their contracts use reviewed bounded
instructions and fixed guards. The first `rea/` attempt failed because the host
sandbox denied the Unix socket; the successful local IPC retry is separate.
## Body parameters and root alignment — recovered and probed
Equip429049/429058 sets authored/live radius160 and factorfloat32(.415).
Cleanup42809C/4280AB sets60/float32(1.265). Supported wrapper42469B..4246E9
restores **live** radius160 for raw mode0,60 otherwise; it does not set factor,
reposition root or add a landing callback. It is outside the controller raw-owner
gate. The existing OriginalBodyPhysics.Step already accepts radius and factor;
the live caller must pass the current factor instead of fixed1.265.
Support47B890 uses radius×factor for final root offset. Bubble's66.4 is lower
than ordinary75.9 despite the larger collision sphere. Prevent-lowering208=true
rejects downward root correction. Consequently equip must not immediately move
the root downward, and cleanup must not preserve Bubble66.4 as the ordinary floor
offset. Inherited Jimmy landing37C→472970 is a return. Support publishes shape34C
and polygon33C through plain setters4725C0/472580; these perform no special callback.
Six additional copied-original body fixtures ran atdtfloat32(1/60), gravity−800,
friction.8, suppression.5, ordinary integration/support/world flags, no dynamic
pass and a synthetic flat triangle. Source479D20/support instructions ran inside
a copied generated32bit process; synthetic virtual methods supplied body state,
no-op contacts and a landing observer. The game entry point, real Jimmy, source
input/audio/scripts and actual VR01 geometry did not execute.
| Fixture | Original observed rootY | Original observed Vy/support |
| --- | ---: | --- |
|160/.415 at66.4|66.4000015|0/true|
|160/.415 at26|66.4000015|0/true|
|Equip160/.415 from ordinary75.9|75.6777802|−13.333334/false; no forced lowering|
|Cleanup60/1.265 from66.4|75.9000015|0/true|
|160/.415 at66.4, priorVy300|71.1777802|286.666656/false|
|160/.415 at66.4, priorVy900|81.1777802|886.666687/false|
Data, binary/source/header hashes and scope are in
`artifacts/bubble/body/original-body-results.json`; full output is
`probe/wine.log`. `--probe-source` generates the fixture source from the existing
body harness. Compile with `i686-w64-mingw32-gcc -O0 -Wall -Wextra -Itools/binary
-Iartifacts/bubble/body artifacts/bubble/body/bubble-body-probe.c -o
artifacts/bubble/body/probe.exe -lm`; generate the guarded header through
body_step_evidence.py. Run only through reference_capture.py with its copied game
directory and no-network/no-original-mount namespace. Initial6second Wine prefix
setup did not complete; the next prefix failed kernel32 loading. Both logs remain.
A separate copy of the prior working prefix completed the probe with exit0.
The constant75.9 ActorRoot/feet/render bridge remains a **modern approximation**.
Changing that bridge to radius×factor on every equip would introduce an immediate
root/render movement not justified by either setters or this probe. Preserve the
documented visual boundary and test source physics roots independently.
## Actual VR01 static filter and material coverage — closed for this archive
455EF0 constructor binds complete game table4CD740 at455F5A and registers
FourCCVR01 at455FA8. Its134→475CD0 returnsfalse, so the shared loader imposes
no extra game polygon exclusion. Shared NC44DD64, checkpoint4791C7 and
game4791D9 filters match the existing route adapter. Source shape-ID enumeration
is valid here: the archive has only contiguous shapeID0, VRRoom. All polygons
have three corners. No NC shape or checkpoint material is used.
| Archive | Shapes | Registered/all | Wall grid | Used material IDs |
| --- | --- | ---: | ---: | --- |
|VR01.omt|0 VRRoom,60 vertices|80|60|0,1,2,3,4,111|
|VR04.omt|0 Box01,336 vertices|508|420|0,2,3,4,6|
VR01 polygons48..53 alone use111 (`112lava`), all stored normalY=.991954..1.
They never register in the wall grid (requiresY<.7), so cannot dispatch370/374
through static traversal. The other eligible wall374 IDs0..4 are ordinary.
VR01 source GAM contains16 entities including one3ROC, two3PHO and a3TRO, no3SOL;
absence of soldiers does not prove all actor pairs ineligible. Dynamic actor
collision remains excluded exactly as in the bounded VR04 body implementation.
## Retained support polygon and floor111 — distinct callback
Support's no-op landing does **not** prove the floor harmless. Current support
is cleared at the next body start, but stored polygon338 is not cleared there.
462520 checks gameplay475CA0, integration210 and nonnull stored polygon338.
It reads polygon+4 material and material+80 **texture pointer**, then calls game130
with actor/material/texture/dt.44E030 requires nonnull actor and texture, resolves
material+0C→chunk+8 signed resourceID, and checks actor FourCC3JIM.
There is no218-grounded test in the110..119 branch. Preserve the last successful
support polygon until a later successful support overwrites it, even in flight.
The actual VR01 used materials all link Canv resources;111 links Canv6. This
nonnull texture gate is not the material payload's trailing3. OMT's exported
set_texture100013A0 writes the texture at+80,100013BB.
Order:424C34 calls437940;43796A calls40E050;40E0EB calls462520;46258F invokes
VR01 game130→44E030. This is before controller ownership437A2B, before applying
mode2 bounce and after the wrapper ceiling/downward queries. It remains eligible
when Jimmy is uncontrolled, subject to the common gameplay/integration gates.
For actualVR01 IDs0..4/111, the bounded source policy is:
- Enter110..119 at44E170: if complete1E02 isfalse, invoke198→42AB00 then set1E02.
42AB00 requestsSFX39 unconditionally and190 only if raw mode!=0. Bubble keeps39.
- Invoke164→42A8D0 every eligible base tick. It returns immediately if complete
1DEC isalreadytrue or raw mode==0. Otherwise set1DEC=true, sharedtimer1DE8=0,
call42A920(−5),42ADC0(−5), then complete1E0→425120. Energy retains common VR01
exemption; score still clamps after−5.425120 cancels only movementmode1.
- Leaving110..119 clears1E02 through19C→472970(no-op). Leaving does not clear1DEC.
Cleanup while still over retained111 therefore starts damage on the next base
tick without replaying entrySFX39/190 if the entry latch is stilltrue.
-111 chooses game sound selector35; IDs0..4 choose5. Selector change invokes
complete1E4→42AEC0, which only retargets a pre-existing A44 loop handle, stops it
and starts the new resource repeating. Full movement-footstep ownership is open.
This policy justifies an explicit VR01 floor111 handler, not every special contact
on LV1B/LEV1. The source ordinary wall callback remains unchanged for Bubble;
do not add generic horizontal reflection. Controller bounce/held-jump/SFX106 is
recovered separately in [bubble-motion.md](bubble-motion.md).
## Lava flash phase and rendering boundary
Late wrapper424C88 invokes4255C0. With other damage states1DED/1E03 false,
4257D6 addsdt to shared1DE8 while1DEC=true.4257E8 compares the retained x87 sum
before4257EE stores thefloat timer; the later pulse also consumes the retained
sum. Strict sum>4 (49D5E8) clears1DEC and writeswhite; at exactly4 it still flashes.
A sum just above4 can clear1DEC while the persisted timer rounds to4. Otherwise
`pulse=(sin(timer*20)+1)*.5`. It directly writes complete5C0 material+4C..58 as
RGBA(pulse,1,pulse,1). Raw mode0 does not stop a previously active flash.
42A8D0 does not call114 or another linked-material alpha setter.
1DED has earlier priority/return;1E03 precedes lava and shares the timer, possibly
addingdt before lava addsdt again. Those other damage policies remain outside
this slice. Invisible114 writes all linked materials, while this late source
write targets the one5C0 material. A port must retain explicit material-write
ordering or document the bounded renderer approximation. A fresh per-frame
Invisible RGBA snapshot cannot silently erase a retained lava write.
## Validation and recommendation
Five Python groups pass in `artifacts/bubble/body/tests.log`: original guards,
actual archive registration/texture/material coverage, Bubble entry bypass,
cleanup damage/strict4second flash including compare-before-store, and base callback gates. Six copied original
numeric cases pass as above. No modern build, port gameplay or whole original
gameplay was run by this investigator. Confidence is high for guarded source
order, actual archive counts and the isolated flatfloor body outputs; whole actor
pair eligibility, all damage-state interactions and original visual equivalence
remain open.
Minimum bounded integration: admitVR01 in the source static factory after these
registration checks; pass radius160/factor.415 and restore60/1.265 without direct
root correction; retain support polygon/material independently ofcurrent support;
run the explicit111 phase before controlled movement plus its late flash clock.
Keep dynamic/special walls parked, and preserve the75.9 render bridge explicitly.
If the111 pipeline is omitted, limit claims to raw0 Bubble body and keep ordinary
VR01/postcleanup floor behavior marked incomplete. A mode0 radius alone never
establishes full Bubble support/collision fidelity.
@@ -0,0 +1,55 @@
# Bubble implementation review
2026-11-02. Independent source review of the current integration against
`bubble.md`, `bubble-motion.md`, `bubble-body.md`, `bubble-rendering.md` and
their recorded source contracts. Read-only inspection of runtime/test files;
this report is the reviewer's only edited file. No new binary recovery or
original-game execution was performed. No blocking implementation mismatch was
found within the declared bounded profile.
## Checked contracts
| Contract / source evidence | Current implementation |
| --- | --- |
| Equip429049..429085 and cleanup428037..4280BB | `LabSimulation.GadgetMode` sets raw0/movement2, radius160/factor.415/max1350, preserves root/queued body state, and rejects existing effect flags. Cleanup restores60/1.265/mode0 and source max650, calls Stop and separately clears expansion. |
| Input426084 then drain426264..42629F and placement4262A5..4263DA | `StepInput` updates steering/camera, adjusts shared energy, performs depletion cleanup, then captures BubbleRoot from the resulting camera eye even when that cleanup changed mode. Rendering consumes this stored root. |
| Input/Jimmy/Bubble partial order | Fresh `Step` schedules input before the player and owned effect afterward; retained-order policy places input after the effect. Effect time advances without raw input ownership. Retained helper lifetime is still an explicit inference. |
| Mode2 apply4387E0 and input439900 | Fire supplies throttle while ordinary beam/jetpack dispatch is suppressed. Supported input decay and later scalar halving remain separate. Bounce assigns liveY300/900 after XZ composition, publishes the post-half scalar, retains mode2 and requests106 only for held jump. |
| Supported wrapper42469B..4246E9 | Supported Bubble retains radius160 and STOP; equip/cleanup do not directly recenter the actor root. The fixed75.9 render bridge remains a stated modern boundary. |
| Body479D20/support47B890 | Current radius/factor reach `OriginalBodyPhysics`. Production admission remains VR01/VR04; lab/outside retain their prior capsule adapter. No dynamic actor or generic special wall policy is newly implied. |
| Retained polygon338 →462520→44E030 | Successful source support updates retained material independently of current support. Actual VR01 profile0..4/111 runs before the controller gate, including airborne/uncontrolled ticks; Bubble skips the specific damage callback but preserves entry39 and the latch. Cleanup permits damage on the retained111 without replaying entry sounds. |
| Late lava4257D6..4257EE | Float timer persistence is separated from the unrounded strict>4 comparison and pulse input. `Vr01FloorState.Step` runs after Invisible's material requests; stored `PlayerAppearance` prevents a fresh Invisible snapshot from erasing late RGBA. |
| Source practice428F61..428FCA | Bubble practice selection updates display selection and requests the scene without starting live body/effect setup. `GadgetScreen` and cleanup use raw mode separately from display selection, including rejected Invisible equip. |
| Sprite410AE0/410CA0/410D00 | Independent flags, active/expanding/collapsing priority, strict fade boundaries, full RGBA, retained dimensions and original Canv1 pixels remain intact in effect/visual components. |
## Verification
Reviewer reran from `GamePort/`, with the local SDK environment and
`--no-restore`:
- `dotnet run --project tests/GamePort.BubbleTests`:13 groups passed, including
six copied-original numeric body references and actual VR01 retained111.
- `dotnet run --project tests/GamePort.BubbleMotionTests`:11 groups passed.
- `dotnet run --project tests/GamePort.BubbleVisualTests`:8 groups passed.
These are managed source-projection/integration checks. They do not establish
whole original-game behavior, GPU appearance, sound audibility or native Windows
runtime compatibility. Full-suite, packaging and presentation results belong to
the primary integration report.
## Remaining boundaries and useful follow-up
The declared `TracksBubbleOrientation` profile preserves the prior yaw-only
baseline before first Bubble use. Its destination handoff follows the recovered
conditional ground/ordinary-air contracts; shared generic interpolation enable,
dirty flags and transform scheduling remain open. The source camera adapter,
mouse/analog extensions, complete retained-helper lifetime, other damage flags,
footstep-loop ownership, dynamic pairs and broader special contacts likewise
remain open. No universal hazard immunity or original visual parity follows from
this slice.
Optional future regression strengthening: assert the exact captured-root formula
against the post-input camera eye, and explicitly compare fresh versus retained
input scheduling at an effect start/cleanup boundary. Current code follows those
orders, but existing frozen-root/independent-clock assertions cover only part of
that contract. No extra runtime code or new tests were added during this review.
+100
View File
@@ -0,0 +1,100 @@
# 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.
+242
View File
@@ -0,0 +1,242 @@
# Bubble movement mode2
2026-11-02. Completes the static movement/input/bounce contract needed after
[Bubble equip/effect](bubble.md), with a pure C# arithmetic component. This
investigator ran no original gameplay. Source projections and component tests
remain separate from live port integration and original runtime comparison.
EXE SHA-256 `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
All VAs below PE-map to file offsets VA−400000 in these original ranges.
`tools/binary/bubble_motion.py` verifies identity,11 complete bounded span hashes,
17 decisive instruction sites,8 virtual bindings and11 constants. Generated
`artifacts/bubble-motion/source-contract.json` records bytes, offsets and hashes.
## REA and source coverage
Local REA6.8.0/Ghidra12.1.4 used generated
`artifacts/uncontrolled-phases/rea/Neutron.exe`. Complete replies, Evidence bundle
and closed snapshot are under `artifacts/bubble-motion/rea-native/`:
| Routine | Evidence |
| --- | --- |
|438A60 dispatch|`ev_e645423e5ad809add30e5c0c5893df7ffda0b885988f9cf438d2d2b117502c56`,02.json|
|437940 frame|`ev_de7097867d129a4232318e667e9496c6868cdb1da4b37a1f3304c94b0b101677`,03.json|
|429A00 refresh148|`ev_0028e3f28c5aed508fab954fe8da6170690efa742614dab2044408ddd0062180`,06.json|
4387E0,439900,42A720,4378D0 numeric VA queries did not return pseudocode: the
profile failed to match a procedure and then interpreted the number as an
unmapped file offset. Corrected file-offset selectors387E0,39900,2A720,378D0 and
72B10 are retained separately under `rea-offsets/`: all explicitly report that
no procedure matches the identifier. That session exported its complete empty
Evidence bundle and closed/snapshotted. These are provider coverage gaps.
The first sandboxed batch (`rea-movement/`) encountered the known Unix-socket
`Operation not permitted` host restriction. Its worker was interrupted and its
owned session closed/snapshotted; it contains zero successful Evidence. This was
not a target execution or analysis-completeness success. An explicitly allowed
local static invocation resolved IPC without configuration changes.
Supplementary fixed-range objdump source is saved as frame.asm,input.asm,
callback.asm,pose.asm,transform.asm. Unsupported decompiler routines are recovered
from these guarded instructions/virtual bindings, not invented REA successes.
Profile digest is `e1ad533d4cc0333c2136fe0894217de2d61feea098240326e78633f9e4ddcbf9`.
## Owners, dispatch and phases
Jimmy complete object has game interface+C0; complete vtable4A3BDC and game
vtable4A373C. Input438A60/frame437940 receive interface;439900/4387E0 receive
complete object. Relevant complete fields:
| Offset | Meaning |
| --- | --- |
|6BC/6C0/6C4/6C8|Per-input increment30 / decay35 / current maximum / scalar speed|
|6D4/6D8|Turn rate / copied apply turn rate|
|6E4/6E5/6E6|Forward/backward/keyboard turn flags|
|7C4|Movement mode, not equipped raw gadget|
|7EC/7F0|Forward/backward destination pitch; apply writes−10/+10 every call|
Game2BC→471F10 gets live body velocity,2C4→471F40 sets it; game38C→472B10
rotates a local vector by current Euler. These are separate from pending impulse
2CC and acceleration. Complete128→439900 input;13C→4387E0 Bubble apply;
154→42A720 landing hook;158→4378D0 jump held;15C→42A7A0 fire held.
437940 calls40E050 before control identity/suppression/menu checks. Only afterward
437A49..437A79 dispatches mode2 directly to13C. Mode2 bypasses every ordinary
ground/air mode0/1 landing reset and jetpack jump-state table. After13C returns,
437C22..437C2D publishes controller scalar to game26C body speed. Landing keeps
movementmode2. No new radius, jump state, pending impulse or acceleration write
occurs in4387E0; do not clear those on equip/apply without another source owner.
Prior queued impulse/acceleration may therefore survive equip until another body
phase replaces them. Generic gravity/support behavior belongs to the body report.
426030 input first checks407060 false,475CA0 true, nonnull controlled5099E4,
4F8430 false and interface1D2D false. Its order is:
1.426084 calls438A60; modes1/2 share439900 (438B60 fall-through438B6D).
This changes steering, destination Euler and camera eye before Bubble placement.
2.426098 calls complete188→429D00. Raw Bubble0 fails that handler's raw7 guard
at429DBB, returns false42A652 and does not consume the callback.
3.Unsupported Bubble skips jetpack input at4260D3; supported input passes the
existing grounded path (including any pre-existing fall-impact flag handling).
4.426264 tests movementmode2, drains−.5dt and calls cleanup178 if energy<=0.
5.Even if cleanup switched mode0,4262A5 still positions Bubble from **the current
camera eye after439900**, using the formula already recovered in bubble.md.
Shared later menu/fire phases follow. Beam suppression does not suppress the
steering use of the fire predicate.
## Input439900
Keyboard subset, in source order:
| Rule | Exact source behavior |
| --- | --- |
|Turn|Left precedes Right; ±100dt. Release moves toward0 by100dt, clamped crossing. Mode2 caps±50 at439CB2..439CFB, ordinary air caps±30. Turning adds no speed.|
|Throttle|Up **or held primary fire in mode2** sets6E4; adds30 per call when below max, capped at current6C4=1350. Fire predicate is15C, not jump158.|
|Coast|Without throttle, speed>max×float.909090936 subtracts17.5; otherwise retained.|
|Supported decay|439BA2..439BED: if grounded and speed>0 subtract17.5, with **no clamp crossing0**; if grounded and speed<=0 set0. Applies even with throttle.|
|Brake|Down sets6E5. Positive speed subtracts35 if supported,17.5 otherwise, clamped to0. Negative speed adds35, clamped to0. Does not start reverse.|
|Destination Euler|For mode2 set(−10,currentYaw,−.25×turn) with throttle;(+10,currentYaw,−.25×turn) with brake; otherwise(0,currentYaw,−.25×turn). Forward takes priority over backward.|
Example source composition while supported: speed100+Up→130−17.5=112.5 in input;
later released-jump apply computes XZ from112.5, then publishes56.25. These two
grounded reductions have distinct owners and must not be collapsed into one.
At small positive speed5 the supported input decay yields−12.5; next supported
input zeroes it. This intermediate sign is a source fact, not a clamp omission.
Mouse/analog extensions are also statically bounded:46A460 supplies signed16
mouse axes. Nonzero horizontal mouse overrides keyboard turn and adds mouseX×dt
to turn; absent mouse, analogX<−.5 selects left, analogX>.5 selects right. Vertical
rate is mouseY/dt. Up, analogY>.5, rate>40 or mode2 fire selects throttle; fixed30
is used for keyboard/analog/fire, otherwise the positive rate is added. Down,
analogY<−.5 or rate<−40 selects brake. Strict inequalities are at439A97..439AE6
and439BF5..439C1D. Projections deliberately accept only keyboard flags; no mouse
or analog runtime implementation is claimed here. Zero dt division is not modeled
as safe input; actual frame contract is0<dt<1.
## Apply4387E0 and supported bounces
Every apply writes7EC=−10 and7F0=+10. It reads **incoming live body velocity**.
Only when its magnitude is nonzero does it copy turn6D4→6D8, add yaw+=turn×dt
through game334, and compute the side term:
```
sideSpeed = turn * (1-friction) * speed * float(1/55)
```
Zero incoming velocity skips direct yaw and produces sideSpeed0, but still
constructs forward velocity. Friction getter game248 supplies the existing.8;
factor.415 is a different body property. Unlike ground apply there is no extra
dt in this side speed. Source yaw uses degree-to-index float45.5111122,
truncate47F940 and mask3FFF, then the16384-entry float sine/cosine tables.
472B10 transforms local(0,0,speed), producing
`(-sin(yaw)*cos(pitch)*speed, sin(pitch)*speed, cos(yaw)*cos(pitch)*speed)`.
Roll has no effect for this particular local vector.438950..438976 uses only
transformed X/Z plus the yaw-only side vector and preserves incoming velocityY.
Pitch therefore changes horizontal forward magnitude, **not** vertical velocity.
Full transform source is guarded; host continuous trig in the projection is an
explicit precision approximation. The existing destination Euler interpolator
43A420 uses4.5/sec for pitch/roll and3.7/sec for wrapped yaw; this investigation
does not re-claim all its enable/dirty/base-transform phase ownership.
After composing XZ,43899A calls grounded218. If false, return. If true:
-Call complete154→42A720, which loadsA14 and jumps472970.472970 is a single RET;
it has no landing-effect mutation in this shipped EXE.
-Call complete158→4378D0 current jump-held predicate. It reads the same five
source jump inputs (50993A,509865,509848,509898,509AC5). Its raw6 exception
requires fire+support; raw Bubble0 has no extra denial.
-Held jump: directly set live velocityY900, retaining freshly composed XZ;
play SFX106 (`bubble_boing`) at4389F8. No edge latch: each supported apply can
invoke this sound/velocity write. Scalar speed is retained.
-Released jump: **after XZ composition**, halve scalar6C8 and directly set live
velocityY300. There is no SFX106 in this path. The reduced scalar is then
published by437C22, while current live XZ still represents the pre-half scalar.
These are automatic repeated bounces, not ordinary550 queued jump impulses.
Movementmode2 persists after both branches; ordinary jetpack JumpState/held-clock
logic is not called. Unsupported apply preserves liveY and the mode.
The Jimmy wrapper separately tests support42469B. For raw Bubble0 it restores
live radius160 and directly requests completeE0("STOP",1) at4246CD..4246D4.
The string is4ED040. Unsupported wrapper makes no action request at this site.
4387E0 and439900 contain no JUMP/FLY/RUN selection. Equip's refresh148→429A00
only stops A44 sound; it does not reset Euler or select a flying animation. Retain
these proven boundaries instead of inventing a Bubble flight pose.
## Camera dependency and verification limits
439900 retains shared camera destination calls120/384 and scalar16C→43B820.
Mode2 branch439F4D..43A03A scales horizontal follow by1.8×dt×that scalar.
Vertical follow uses1.5 outside the close-height branch; when
abs(truncate(rootY−eyeY))<=800 and rootY+20<=eyeY, its scale is.8 when
abs(truncate(deltaY−eyeY))>550, else.2. That second expression uses the existing
target-minus-eye delta before subtracting eyeY; do not simplify it into a more
plausible height expression. Shared complete851 overrides all axes with.1dt.
Exact scalar16C, destination geometry and native camera clipping retain their
separate existing camera gates. Sprite placement order after this handler is
closed even when that modern camera adapter remains approximate.
Ten Python groups pass (`artifacts/bubble-motion/tests.log`): original span/
binding/constants guards; fire throttle; turn/pose priorities; supported input
reduction and negative crossing; coast/brake; pitch-forward/liveY preservation;
direct900/300 bounce, sound and scalar/XZ ordering; zero-velocity yaw gate and
bounded inputs. These are static/projection checks, not original runtime probes.
`src/GamePort/Game/BubbleMotion.cs` implements the keyboard input and apply
component using the port's quantized `LabSimulation.Trig` for current pitch/yaw.
Its public results are `BubbleSteering(Speed,TurnRate,TargetPitch,TargetRoll)` and
`BubbleApply(Velocity,Yaw,Speed,Boing)`; methods are `StepInput` and `StepApply`.
Eleven C# numeric/bounds groups pass in `artifacts/bubble-motion/csharp-tests.log`,
including112.5 XZ versus56.25 publication and quantized pitch cosine. Run with
`dotnet run --project tests/GamePort.BubbleMotionTests --no-restore` after local
restore. It changes no normal-air component and performs no body integration,
impulse, acceleration, gadget lifetime, sprite, sound playback or mode writes.
Primary owns live C# integration and its port checks. Remaining broader gates are
original/native Windows gameplay comparison, shared base/rotation/camera state,
full mouse/analog integration and dynamic/special collision coverage; source body
radius/factor/support is coordinated in bubble-body.md. No universal immunity or
entire-game completion is implied.
## Cleanup Euler handoff and A20 search boundary
Follow-up2026-11-02. Cleanup428037..4280CC writes Jimmy completeA20=.5 at428045;
it contains no Euler or destination-Euler setter. Do not interpret.5 as an
upright timer without a recovered consumer. Source constructor4226CF initializes
A20=0; another gadget cleanup42821A writes.5. A complete raw DWORD search of EXE
`.text` VA401000, raw length573440, finds six little-endian `200A0000` occurrences:
4226D1,428047,42821C are the displacements of those three MOV writes;45CFE3,
45D024,45D035 are unrelated PUSH immediates. A direct objdump operand search for
completeA20 and game960 found no read. This is a bounded negative search:
derived pointers, bulk access or other interface aliases have not been ruled out;
the consumer remains **unknown**, not proven absent or dead. The helper's
`handoff` block guards the complete search boundary and six supporting spans.
Normal ground438BC0 does provide a source destination handoff, conditional on
accepted steering. ESI initializes0 at438F66. Right4391BB, Left439239,
Forward4392BA and accepted backward4393D5/4393EE set it nonzero. At43951E, if ESI
remains0, execution skips **all** destination setters to4395CF. Thus no-input
ground behavior preserves the prior Bubble target, including pitch/roll.
For accepted steering, each destination setter43957C,439599,4395C9 passes
**pitch0 and roll0**, retaining its separately computed destination yaw.
Ordinary keyboard Left/Right/Forward/Backward all reach this handoff when their
direction is accepted. Backward specifically has the prior438F9A..438FBB gate:
raw−1 or3 with fire held rejects reverse, so Backward+Fire without another
accepted direction need not produce ESI. Raw6 and other special-gadget gates
must retain their own boundaries.
Normal air mode1 always reaches439D81..439E2B and requests destination
`(pitch0,currentYaw,roll−turn)`; Bubble mode2 instead requests its±10 pitch and
−.25turn roll described above. Normal air release eventually reduces turn to0,
so its requested roll also becomes0. This is an input destination update, not
an immediate Euler reset. Shared43A420's active branch interpolates pitch and
roll error×dt×double4.5, yaw error×dt×double3.7 (with angle wrap and dirty flags).
No cleanup-specific A20 ownership is visible in that routine. This follow-up
does not newly close all scheduling/enable/transform ownership for that shared
interpolator or require an invented blend during cleanup.
REA queries43A420 and438BC0 in `artifacts/bubble-motion/rea-upright/` did not
match recognized procedures; their numeric VA requests then returned the
provider's unmapped-file-offset fallback diagnostics. Complete failures, empty
Evidence export and closed snapshot are retained. Supporting conclusions use
the guarded disassembly `normal-input-tail.asm`, `normal-apply.asm` and
`rotation.asm`. Two added Python groups guard A20's bounded search and the
conditional ground/normal-air destination handoff; C# BubbleMotion was unchanged.
+140
View File
@@ -0,0 +1,140 @@
# Bubble sprite implementation and rendering boundary
2026-11-02. Implements the owned visual component and original resource export.
Equip/body/input integration belongs to the primary runtime change. This report
establishes source recovery, asset identity and managed checks; it does not claim
original Bubble execution, exact original sprite orientation or native Windows
runtime verification. Originals remain read only, with539 unchanged hashes.
## Source and additional REA evidence
[bubble.md](bubble.md) retains the authoritative410840/410AE0/410CA0/410D00
contract, source spans, virtual bindings and REA limitations. EXE SHA256 is
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Additional local Ghidra12.1.4 queries used the same generated copy, exported
complete Evidence and closed/snapshotted under
`artifacts/bubble/rea-rendering-ipc/`:
| Procedure | Evidence ID | Observation |
| --- | --- | --- |
|4352F0 sprite base |`ev_7ea79d719ffb701f10a497f5790384aa56801d970a34ea7ecd4152052ac8f8df` |Calls463F10; sets complete+C8 game interface; temporarily sets flagC4 bit1. |
|4645F0 InitSpriteProperties |`ev_ab13438ec345f10472d10965048c34d31654e6d9303d729df98b65aa92d37a1e` |Writes AC/B0 supplied size, WORDC4=1, alignmentBC/C0=3, blend6/7. Graphics flag true writes RGBA(.9,.9,.9,1). |
|464210 preparation |`ev_4d39cc1aaad564de60bb801c08dfeb740d52e507227e630de9b0570e3e1bc43d` |Calls458910, forwards root/Euler to virtual setters, calls479A40; does not recover camera-facing drawing. |
The initial sandbox attempt is retained in `rea-rendering/`; Ghidra imported
successfully but could not bind its local Unix socket (`Operation not permitted`).
The allowed local IPC retry above succeeded. That initial batch supplies no
successful decompilation Evidence; no original code was executed in either.
Supplementary objdump output and independently mapped source-span hashes are in
`artifacts/bubble/*-rendering.asm` and `rendering-spans.json`. End VAs are exclusive:
| VA range | File offset / bytes | SHA256 |
| --- | --- | --- |
|4352F0..4353BF |352F0 /207 |`ee18deb9d0492ee3d921e99d56edea9eb11fc4b28bdbc171ee398a6628a41834` |
|4645F0..4646B8 |645F0 /200 |`1e666182de97533be5e917b5763957ce148bceb831b05061df19ccd89d3bae28` |
|464210..46429F |64210 /143 |`a99be3694789b6b6284b7e171eec0f2f26b59eef6a366265646bf6c8cbd92000` |
Constructor410978 supplies200 to4645F0 before overriding blend to6/1. Start
changes destination to1 or7, with no color reset. The optional conventional
graphics branch therefore starts with(.9,.9,.9,1) before its first fade update;
the default additive branch retains white. Active conventional rendering writes
(1,1,1,.5), while default additive rendering retains the previous RGBA.
Assembly410AEC..410AF2 adds dt and stores a float timer without popping the x87
sum. The expansion comparison410B95 and collapse subtraction/comparison410C12..
410C1E use that unrounded sum. `BubbleEffect.Step` retains a double addition for
those boundaries while storing `Timer` as float. The active pulse reloads stored
Timer at410B4C. A managed test covers Timer rounding to1 while the strict source
comparison has already crossed1. `Math.Sin` is a numeric projection; x87 fsin
bit parity and whole-game timing remain unverified.
## Callback ordering
Jimmy42232C constructs Bubble410840; its410892 call enters4352F0, whose435341
call enters463F10. The independently established chain in
[lab-registry.md](../checkpoint/lab-registry.md) continues463F6C complete+C8 →
4586F0 →46FBE0 → tail insertion. Together with the owned effect slot3C4→410AE0,
this supports fresh-game **input → Jimmy → Bubble update** as a partial order,
with other registered helpers allowed between them. The owned fire registers
earlier during Jimmy's base construction. The source registry, not source60Hz,
establishes that relative order.
Retained Bubble survival, teardown flags and update eligibility have not been
independently traced here. Reusing the same owned component across ordinary
Jimmy retention, and scheduling Jimmy → Bubble → newly appended game input,
remains an integration inference until that helper lifecycle is closed. The
modern fixed-step cadence is a separate port policy. Do not gate visual time on
raw input ownership merely because placement/drain happen in controlled input.
## Assets and exported format
`tools/extractors/bubble_resources.py` resolves the archive case-insensitively,
validates its complete hash, unique Canv1 metadata, payload and decoded pixels
before writing. It rejects outputs in/above originals and preexisting output
file symlinks. Export contains no generated sphere or recolored image:
```bash
python3 tools/extractors/bubble_resources.py ../Original \
--output artifacts/extracted/bubble
```
`bubble.json` schema1 contains `source`, archive `sourceSha256` and exactly one
`textures` record with id/name/width/height/path/png/sourceOffset/sourceBytes/
sourceSha256/rgbaSha256. `canvas_1.rgba` and `canvas_1.png` retain the original
146×146 image, including5492 alpha0 and15824 alpha255 texels.
- Archive SHA256: `b584ffa4a38f4bc809b3ea8f4321e0c08f2719e22df41a3fb4cd143ed89b3bef`.
- Payload offset17FCE/66322 bytes, SHA256: `9b6cdce95bd408fa1dc806d30520df65971f25d1663ab8da4ca6bf41380805ec`.
- Decoded RGBA SHA256: `a3a678c47c1ce94946b1136560a84f3ef86c6884b981256a9fbff62fe8a988e4`.
## Implemented renderer and explicit policies
`BubbleEffect` owns independent Active/Expanding/Collapsing/Visible flags, Timer,
full Vector4 Color and dimensions. `Start()` only sets expansion/visibility and
resets Timer. `Stop()` is the original leaf and deliberately preserves expansion;
Jimmy cleanup must additionally call `ClearExpansion()`. Active beats expansion,
which beats collapse. Fade does not change size; the first active invocation
changes200×200 to240×(240+sin(timer*10)*30), retaining the last pulse size during
collapse. Exactly1 remains expanding; exactly zero fade remains collapsing and
visible. A subsequent negative fade hides it. `Reset()` reconstructs initial
owned visual state rather than pretending to be the original Stop leaf.
`BubbleVisuals(Mesh combined, string preparedRoot)` loads `bubble/bubble.json`,
bounds its manifest/pixel sizes, validates the original pixel hash and appends
four vertices/six indices. It preserves existing draws/textures and collision
metadata. `Update(destination,effect,root,eye,target)` receives the already
captured source BubbleRoot; it applies no extra Jimmy scale or root offset.
RGB multiplies all four vertex colors; alpha goes through MeshDraw.Opacity.
Default blend is SRC_ALPHA/ONE; optional graphics mode uses
SRC_ALPHA/ONE_MINUS_SRC_ALPHA. Current Vulkan blended world draws test existing
opaque depth without writing depth.
The quad is centered on root and uses the same camera-facing basis as the
existing scene sprite adapter: direction=normalize(target−eye), right from
worldUp×direction, up=direction×right, with deterministic degenerate-camera
fallbacks. Width/height are complete world-space edge lengths; UVs cover the
complete original image. **This basis, centered interpretation, modern UV0..1,
filtering/alpha-cutout behavior and depth-write policy remain modern rendering
boundaries.** Alignment3/3 is recovered, but complete original engine alignment
scheduling, local-axis orientation, camera roll, render-state ownership and
zero-length original placement normalization are not closed. The result must
not be described as original visual parity without comparison.
## Validation
- Five Python checks pass: exact archive/resource/decoded PNG identity, output
separation, child symlink protection and rejection before writing on bad
archive/dimensions/pixels.
- Eight managed effect/visual groups pass: strict boundaries and full RGBA,
pulse/graphics branches, Stop priority/cleanup, unrounded fade comparison,
independent clocks/reset, original quad/material/metadata, camera degeneracy
and malformed/path-traversing/altered resource rejection.
- Main `dotnet build --no-restore` passes with zero errors; cached NU1900
vulnerability-feed warning is unrelated to this change. All539 original hashes
verify unchanged. Logs: `artifacts/bubble/visual-validation/`.
Commands: `python3 -m unittest discover -s tests -p test_bubble_resources.py -v`
and `source scripts/env.sh; dotnet run --project tests/GamePort.BubbleVisualTests`.
Managed/asset checks and compilation do not establish GPU rendering, original
runtime comparison or Windows execution. Primary integration owns those results.