Implement Bubble controller, sprite and VR01 body behavior
This commit is contained in:
1 parent
9ea578492d
commit
1ae5f4251c
51 files changed
+2811
-54
No files matched your search
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user