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

109 lines
7.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](invisible.md),
[assets/meter](gadget-followup-assets.md), [shared energy](player-energy.md),
[independent review](invisible-review.md) and [Bubble](bubble.md). 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.