Files
Neutron/docs/gameplay/gadget-followup-assets.md

11 KiB
Raw Permalink Blame History

Bubble / Invisible resource and tutorial follow-up

2026-11-01. Original asset parsing, decoded-pixel inspection and local REA static analysis. Originals remain untouched. This report does not establish original gameplay execution, enemy detection, tutorial completion or native Windows runtime. Primary selected Invisible as the next bounded gameplay implementation; Bubble resource observations are retained for the later effect.

Evidence and reusable output

tools/extractors/gadget_followup_assets.py inventories exact original resources, seven current Jimmy clips and both authored tutorials. It retains archive/payload hashes, resource byte offsets, GAM property offsets/raw bytes and duplicate tags. It also guards the source image identities and eight bounded meter code spans. No game code is executed by this utility. Generated report and inspected images: artifacts/gadget-followup-assets/resources.json, orangebubble.png, controls_109.png, controls_111.png, canvas_21.png, canvas_22.png.

python3 tools/extractors/gadget_followup_assets.py ../Original \
  --output artifacts/gadget-followup-assets/resources.json \
  --meter-output artifacts/extracted/invisible-meter
python3 -m unittest discover -s tests -p test_gadget_followup_assets.py -v

export_meter(original, output) writes meter.json schema1, reference640×480, exactly two texture records and original decoded RGBA/PNG files. Records contain id/name/width/height/path/png/sourceOffset/sourceBytes/sourceSha256/rgbaSha256. Both names/dimensions are checked before any files are written. Original root, its subtrees and ancestor outputs are rejected. Pixel files are neither recolored nor resized; state/tint/geometry belong to the caller. Six checks pass in artifacts/gadget-followup-assets/tests.log: exact assets, tutorial source offsets, duplicate identity, output protection, pixel export and guarded meter spans.

Invisible uses the existing Jimmy family — asset facts

png/jimycarl.png is256×256; all65,536 texels have alpha255. The existing prepared Jimmy atlas therefore has no translucent source pixels to replace for this effect. Source jimstop.ASE has426 vertices/814 faces, two samples at10fps, 480 ticks/frame, and supplies3,551 UV entries/814 UV faces. jimrun, jimbackpedal, jimjump, jimfall, jimfly and jimshoot have the same vertex/face counts and no UV tables; existing preparation uses the standing UV topology. This report verifies counts and resource identity, not every morph's original interpolation phase.

No additional ASE or PNG is required for the recovered Invisible material path. Invisible source owns the activation/timer/state interpretation; material report already traces complete slot114→40E4A0 positive RGBA/material alpha and source blend enums. Existing port fragment cutout occurs before multiplying material opacity, so alpha0.7 does not discard this fully opaque source atlas. Original fixed-function alpha-test interaction and full material-state parity remain separate renderer questions.

The original control strip Canv111 BmenuLInvisible visibly labels primary mouse and Ctrl as INVISIBLE. Bubble strip109 separately labels mouse movement/forward, jump and Ctrl/Insert keyboard equivalents. These inspected pixels corroborate the input descriptions; they do not establish a held/edge policy, timers or power consumption. Menu/HUD resources already exported for both items are in gadget assets; no invented icons are needed.

Recharge-meter resources and source chain

Original screens.omt SHA256: e8e95231f5d302b41f4fbf33df1c5a08ce4645370f9f519527ff1727b73b7a5e.

Canvas Source offset / bytes Exact decoded dimensions
21 meter 0x88E18 /8118 30×110, border/backplate
22 metercolor 0x8C5D8 /9138 30×110, original multicolor fill

REA inspected private hashed copies. EXE identity is f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8; DLL identity is 3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943. Complete replies, exports and closed snapshots are in artifacts/gadget-followup-assets/rea-meter/ and rea-meter-dll/. The renderer/alignment follow-up is exported/closed in rea-meter-surface/.

Source function REA Evidence
401430 menu construction ev_e7355ffccf1c4066e58d93e229e4a89662e01045e555d178cb2c11b1ddb5b42b
402D70 canvas placement ev_37b8296fe0ea52d6b1d36ba096c60700a7dca3986cb7966b8d6d2884253bf4f0
4037F0 meter percent ev_525ca303ce70c16f524063053ebdd9fecd82054cf480d8f2f30f1ec0d7e08333
DLL10029430 canvas render ev_f133d0c29cd7b2969814c4b89df37e369776d954543980c93dc69bc3ccb7e579
DLL10029180 canvas construction ev_856445a19d924cf5ec157575da27686731caca9a1a611895a98d269fe31c4b03
DLL10037AC0 draw_surface ev_143b978a715b32486294f27aa987c926c0cf8f52e09a2116b81ec34803d9962b
DLL10029870 update_logic ev_5021f9ff80b9087cafdf449976e363921d6159833f003efe15870f24932d8343
DLL10029890 compute_auto_align ev_b963c3e443054b1425af94a27efd37cc157f6dd2070d2d87cbb2a78f72dc083e
DLL10029930 get_canv_wordsize ev_d766e30f3466351eaea497f58546f564563849cf9fdc269c42b131c01ac542a5

Constructor401430 opens omt/screens.omt and binds global4F7CB0 to canvas21 at 4017CB, global4F8028 to canvas22 at401865 through402D70→menu454/402E30. Literal coordinate arguments are(320,7) and(322,4). Constructor sets sprite source blend6, destination1 or7 according to graphics509A13; RGBA initiallywhite. Runtime menu484/488 show/hide both;48C/490 change fill tint to red(1,.2,.2,1)/white. Those latter caller/state branches are guarded by Invisible.

4037F0 (raw0x37F0) clamps only negative percent to0, writes fill width screenWidth/640*27, and height screenHeight/480*percent*1.04. Global4F6560 is screen width,4F655E height. The multiplier at48D908/raw8D908 is a stored double 1.04, not0.01. At100 percent the logical height is104. Width/height are fields AC/B0; source sprite placement44/48 stays separate. No forced100 clamp is proven in this leaf. Caller supplies the actual timer/recharge conversion.

Texture resize is full-image stretch, not percentage UV cropping. Canvas render10029430 obtains custom AC/B0 dimensions when flagC4 bit0 is set, then forwards the original canvas, cached offsets, dimensions and RGBA90 to renderer slotB0.402D70 sets flagC4 to1. DX draw_surface10037AC0 builds a rectangle using the supplied width/height, with source UV0..0.9999 for the single-texture path; the tiled path distributes the complete source canvas across those dimensions. Percentage does not enter UV selection. The modern texture uses0..1 over the exact decoded image; legacy edge epsilon/texture padding remain renderer details. The tint multiplies this original gradient once; no replacement solid fill or partial-source gradient crop is evidenced. Source48C/490 tint leaves are already in the guarded192-byte meter_tint span0x3730..37F0.

Modern layout policy: interpret the source coordinates using a640×480 logical viewport with uniform widescreen scale, background rectangle(320,7,30,110), fill width27 and bottom114/top 114−1.04*percent. This preserves source initial bottom placement while changing height. It is explicitly not a fully closed original pixel-position recovery:402D70 writes alignment modesBC/C0=3; constructor initializes cached offsetsA0/A4=0, while engine update_logic10029870 can recompute−half-size offsets through10029890. Canvas render forwards cached offsets and dimensions. Whether these menu sprites enter that engine logic pass, and the exact frame of recomputation, remain unresolved. Pseudocode for402D70 has incorrectly recovered parameters; its arguments/formulas above are checked against the guarded instructions, not copied from its prototype.

Original tutorial fixtures

Data VR01 Bubble VR03 Invisible
GAM SHA256 7938214fb62784fcb34245491342a5f33e3615bdc178e4883a9e285e6869904f 8acc4d3b8c416c41c1900ac0b1f895ab5819781e5dd87d19a1f177414660d5b2
Entity count 16 67
Scene shape VRRoom,60 vertices/80 triangles Box01,280 vertices/424 triangles
PHONEBOOTH STRT offset 0x45C 0x406
Authored root (−2678.0381,87.3322,−2783.4011) (−292.9982,160.3451,−2467.5544)
Yaw 290 290
Intro bu,3MCA0xA61 inv,3MCA0x8EEE
Voicepractice IDs 24/23/22 21/20/37
Return LOAD offsets 0x83C radius400;0x1631 radius300 0x94DE radius300

Both intros serialize PlayerControlled=NULL and NextTrigger=default. VR01 has DeactivateInv=1; VR03 omits that property. Absence is not evidence forfalse; the constructor/default binding is documented separately by the Invisible investigator. VR03 source SoundIndex0/1/2 properties occur at0x90F7/0x9176/0x91F5. The voice bank also contains invisibility4/ID38, but this intro does not use it.

VR03 contains eight actual3SOL at source offsets0x7BA,14B0,1EB7,342B,4828,4D2F, 5736,633B. All share ObjectTag C3DYOKIANSOLDIER; keep actor identity by instance/ source offset, never collapse them into one dictionary/tag lookup. Each serializes AIState2, VisibleRange2500,FOV359,TargetNameJIM1. These data values do not recover the target-detection algorithm or prove combat/AI is implemented. Literal patrol links contain two missing names: yok3→tok4, and soldier0x5736 starts at fyoy1; supplied patrols contain yok4/fyok1. Preserve these original strings rather than silently repairing them. VR01 contains no3SOL.

A meaningful bounded Invisible fixture can load actualVR03/PHONEBOOTH, skip or complete its source intro, and exercise equipped/ready/activation/expiry/recharge/ cleanup against the current player, atlas and meter. It must establish item2 availability through the existing inventory/PostLoad contract. No fake enemy or invented vision/combat response is needed to verify this first effect. Tutorial navigation, stealth detection and trophy/RETURN completion remain separate tests.

Bubble assets retained for later

RetainedSprites.omt Canv1 orangebubble at0x17FCE/66322 bytes decodes146×146, with15,824 opaque and5,492 transparent pixels. RGBA SHA256: a3a678c47c1ce94946b1136560a84f3ef86c6884b981256a9fbff62fe8a988e4. This is confirmed by the Bubble constructor's explicit archive/ID binding, not just its name: Bubble report, constructor410840 REA ev_a0c9ee6d5757a741190f3dfcc093bdc7d7b802bcdcd2cbc029422550d34e7cb2, saved/exported/closed in artifacts/bubble/rea-effect/. No new ASE is indicated. SoundEffects Wave2/3/106 are gravitybubble/gravitybubbleoff/bubble boing; serialized resource identities alone do not establish repeat/stop ownership. Bubble pulse, growth/fade/collision and billboard orientation belong to that system report.