243 lines
15 KiB
Markdown
243 lines
15 KiB
Markdown
# 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.
|