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

7.1 KiB
Raw Blame History

Invisible gameplay continuation

2026-11-02. Implements original item2/raw mode2 and shared energy warnings. Collision recovery remains parked at35a2a66/0272f7b; the preceding gadget source/packages7b5230c remain a separate verified milestone.

Coverage and evidence

System Original contract Port / remaining boundary
Selection428E51 Display2 precedes actual equip;9F8 tutorial override Failed equip can retain display2/raw−1; successful equip starts both clocks0
Wrapper424E80 After base movement; any controlled pointer Separate from Jimmy input identity; raw NULL freezes/hides meter
Activation Recharge exactly7, energy>2/override, fixed−2 Initial7-second recharge;7-second active timer; held reactivation; jump blocks activation only
Material114/FC/target55D Alpha.7, indexed blend flash; target eligibility Existing Jimmy draw; targetability retained, full enemy AI consumers absent
Meter4037F0 Canv21/22, full gradient stretch, size/tint Exact original pixels; logical placement/uniform scale is declared modern policy
Companion/cleanup427FF0 Immediate hide, D0/214 flags,9E8 restore guard Separate movement/body flags; body integration gated without blanket AI pause
CAM4165B7/MCA43129A Default DeactivateInv1, named Jimmy lookup Prelude separate from raw438 preparation; AI-null retains effect
Energy42A920 Scalar4F83D4 and warning latch4F83DC Shared owner and80/182 callback order/hysteresis across ordinary loads
Bubble follow-up Equip/visual/drain/cleanup recovered Runtime pending full movementmode2/jump/body contract

Static reports retain hashes, VAs/file offsets, guarded bodies/sites, complete REA Evidence, exports/snapshots and provider errors: Invisible, assets/meter, shared energy, independent review and Bubble. No new whole original-game execution was performed. The retained complete42A920 REA record was reused rather than repeating that investigation.

Implementation and ownership

LabSimulation owns InvisibleGadget and invokes it after controlled movement, before its existing owned jetpack-effect phase. PlayerSceneBinding supplies both Jimmy input permission and raw-any-control. Another controlled actor permits this wrapper without granting Jimmy movement. Raw NULL freezes both timers and hides the meter without ending the material effect. The pure recovered suppressor branch is tested, but source globals4F8182/4F83E0 have no complete lifecycle provider yet. Existing modal/focus/debug capture remains a broader port policy.

Successful equip hides Goddard immediately, starts both timers0 and colors/shows the meter red. Initial recharge must reach exactly7 before a later tick can activate. Held primary without jump requires energy strictly>2 or the tutorial override, spends fixed2, sets remaining7/targetablefalse/alpha.7, then decrements remaining in the same invocation. No continuous Invisible drain, invented sound or edge latch is added. Ordinary jumping remains possible.

At remaining<=3, trunc(remaining×5)%2 selects conventional versus additive blend on material0. Expiry<=0 restores opaque/targetable/red; recharge begins next tick. The additive initial branch follows the existing chosen source graphics-option path; its original option predicate remains open. Blended world depth writes remain disabled as an explicit renderer policy. Captures verify port output, not original visual parity or self-occlusion equivalence.

PlayerGadgetMaterial changes the existing atlas draw without changing pose, geometry or authored visibility. InvisibleMeterOverlay uses exact Canv21/22 RGBA, source width27/height percent×1.04, white/red vertex tint and full texture stretch. Percentage is published before recharge clamps7, preserving its small ready overshoot. Source local positions become centered640×480 logical rectangles with uniform widescreen scale. Cached engine autoalignment scheduling is still open; original pixel-placement fidelity is not claimed.

SceneDirector emits named-Jimmy GadgetReleaseRequested at initial CAM/MCA activation when DeactivateInv is absent/true, before first MCA target/skip checks. This differs from ordered raw-owner438/410/flatten callbacks. Explicit0 can bypass the named prelude; raw-owner preparation can still clean. AI-null stops motion and clears control without invented cleanup. Release stores remaining7/recharge0 and restores local state. Modern reset clears timers/diagnostics explicitly.

Companion movement/body-enable fields are distinct from AI Active. Equip disables both and hides Goddard; cleanup restores them outside the six proven PostLoad9E8 blocked levels. ActorPatrol skips disabled body integration while retaining its bounded AI subset. Independent future writes to movement/body flags, full companion lifecycle and other AI modes remain separate work.

PlayerEnergy retains scalar and warning latch across ordinary scene rebuilds. Ray, active jetpack and Invisible share tutorial bypass, empty-crossing80 before write, low182 after scalar/before latch, strict<19 warning and>20 rearm. Raw saved scalar/debug refill does not invent a latch reset. TSK retains its original scalar only; complete damage/energy/pickup consumers remain unported.

Controls and verification

Select owned Invisible in Tab/Space, wait for recharge, then hold Enter/Ctrl/left mouse without jump. F1→Player adds Give/Select Invisible, Unequip and timer/ targetability diagnostics. F1 retains the existing gameplay/audio pause policy; Tab while a special gadget is equipped unequips first.

Fifteen managed groups cover numeric/sound order, retained energy ownership, strict gates, same-tick decrement, held activation, flash/expiry, raw-null/other owner distinctions, named cleanup, companion restoration, failed display/raw equip separation and original meter/widescreen geometry. Source coverage grows to182 Python checks plus separate HUD tests. Independent review ran the earlier 12 groups before the final three binding/meter groups were added.

The eight-frame --smoke-invisible fixture explicitly advances836 additional normal player ticks between rendered phases. It grants owned item2 and skips the intro without relocating actors or directly mutating timers/materials. Headless and native1920×1080 GTX1070/private Xvfb pass charged, activated, alpha flash, additive flash, expired and unequipped checks; native uses real SDL Ctrl/Tab. Tutorial energy stays20. Both report zero enabled Vulkan validation errors. Six-phase captures were inspected. Logs/captures: artifacts/gadget-followup/.

These accelerated observations do not establish real-time original cadence, manual navigation, enemy immunity, tutorial completion or native Windows runtime. Complete scripts/test.sh passes182 Python+2 HUD checks, all managed suites, 30 main GPU completions and17 isolated Vulkan material checks, with zero enabled validation errors. SDL dummy lifecycle and539 unchanged originals pass. Package results follow the clean source milestone in progress.md. Full enemy sensing/ combat, graphics-option selection, cached canvas alignment, exact scheduler/x87 boundaries and the other gadgets remain open.