8.8 KiB
Gadget resource inventory
2026-10-27. Read-only asset investigation; no original file was modified or executed. This report describes serialized resources and inspected pixels. It does not infer gadget timing, collision, selection policy or model attachment from filenames. Binary/input contracts belong in gadget-controls.md.
Selection screen and original labels
All following Canv IDs are from Original/omt/screens.omt, SHA256
e8e95231f5d302b41f4fbf33df1c5a08ce4645370f9f519527ff1727b73b7a5e.
Canvas20 (menu) is640×480 and already contains the dim gadget tiles and Return/
Practice labels. Unsuffixed, suffix-b and suffix-c tile art are141×141. Their inspected
appearances are green, white and blue respectively; which state selects a variant
must come from the dispatcher, not the colour. The independent controls investigation
reports constructor404E97..404F8B's inventory0..7-to-tile association; the displayed
labels below are independently visible in the original pixels.
| Group0 item | Original tile label | Unsuffixed / b / c Canv | HUD Canv/name | Control strip |
|---|---|---|---|---|
| 0 | BUBBLE | 11 /52 /178 | 94 1bubble |
109 BmenuLBubble |
| 1 | ROCKETSHIP | 12 /46 /171 | 87 2rocket |
115 BmenuLRocketship |
| 2 | INVISIBLE | 13 /47 /172 | 88 3invisible |
111 BmenuLInvisible |
| 3 | SHRINK RAY | 14 /48 /173 | 89 4raygun |
113 BmenuLRayGun |
| 4 | SCOOTER | 15 /49 /174 | 90 5scooter |
116 BmenuLScooter |
| 5 | REMOTE | 16 /50 /175 | 91 6remote |
114 BmenuLRemote |
| 6 | BASEBALL | 17 /51 /176 | 92 7baseball |
118 BmenuLBaseball |
| 7 | GRAPPLER | 18 /45 /177 | 93 8grappler |
110 BmenuLGrappler |
Do not rename tile3 to Jetpack. The separate jetpack HUD canvas119 is named
9jetpack, and control strip112 is BmenuLJetPack; strip113 visibly describes
both SHRINK firing and JUMP/JETPACK. This agrees with the port's recovered
item3-powered-jump association, but the art itself does not establish firing logic.
The rendered selection background places bubble/rocket/scooter/remote across its
first row and invisible/shrink/baseball/grappler across its second. Exact hit
rectangles and hover/selected state are source-controller evidence, separate
from this visual layout observation.
The controls investigator specifically recovers white suffix-b as owned idle and
green unsuffixed as mouseover; group0 state0/4 hide both to expose the dim background.
The blue suffix-c resources are available assets but are not part of those current
group0 bindings. Their existence does not justify inventing an unavailable overlay.
Other useful screens.omt resources:
| IDs / names | Dimensions | Asset role |
|---|---|---|
109..116 plus118 BmenuL* |
393×69 | Nine left-side gadget control strips. |
108 BmenuR2,117 BmenuR1 |
247×69 | Right-side instructions with SELECT/DESELECT INVENTIONS text. |
24/181/182 return/return2/return3 |
141×78 | Return button variants. |
170/179/180 practice/practice2/practice3 |
141×78 | Practice button variants. |
| 87..94 plus119 | 80×70 | Eight gadget HUD icons and separate jetpack icon. |
84/85 backpack/backpack2 |
141×141 | Backpack variants. |
253 CrossHairs |
15×210 | Vertical strip;14 square15×15 frames arithmetically fit. Frame meaning/timing is not inferred. |
Export and integration
tools/extractors/gadget_resources.py exports54 exact decoded canvases into a separate directory. It checks original IDs/names/dimensions before writing, uses the existing bounded OMT/RGB555/colour-key decoder, preserves alpha and records archive/payload/RGBA SHA256 plus source offsets/sizes. It protects the entire source asset root, including sibling ASE/png/gam directories when the archive is under omt/. No image generation or replacement art is used.
python3 tools/extractors/gadget_resources.py ../Original/omt/screens.omt --output artifacts/extracted/gadgets
The generated gadgets.json uses schema1, referenceWidth640/referenceHeight480 and
textures with id/name/role/width/height/path/png/sourceOffset/sourceBytes/
sourceSha256/rgbaSha256. File paths are local canvas_ID.rgba and .png.
tiles records artItem1..8, literal labels and normal/b/c IDs; suffix roles remain
neutral so the source controller owns availability/highlight interpretation.
This separate manifest leaves the existing eight HUD/practice resources unchanged.
Primary owns prepare.py/package/runtime integration; this investigator did not
edit those files. Runtime should reuse UiViewport scaling and pointer conversion.
Generated inspection images are in artifacts/gadget-assets/: selection-sheet.png and canvas_20.png. ase-inventory.json records exact hashes/counts for the model files below. The fixture exporter wrote artifacts/extracted/gadgets/gadgets.json. Three regression groups pass in artifacts/gadget-assets/tests.log: exact original resource/pixel/dimension round-trip, rejection of all original asset subtrees, and rejecting changed dimensions before producing partial output.
Shipped model and animation candidates
These are file/content observations, not proof that a given runtime action uses
every candidate. The ASE parser maps original coordinates using the existing
verified (x,z,y) conversion. Jimmy clips share426 vertices/814 faces with the
prepared standing mesh, so existing morph preparation can preserve its topology.
| Source ASE | Samples / fps | Geometry and bounded use |
|---|---|---|
| jimshoot.ASE | 2 /10 | 426 vertices/814 faces; original shooting pose candidate. Not in current default prepared animation list. |
| jimfly.ASE | 2 /10 | 426/814; already prepared for powered jumping. |
| jimswing.ASE | 2 /10 | 426/814; swing pose candidate. |
| jimscooter.ASE, jimscooterstop.ASE | 2 each /10 | 426/814; scooter poses. |
| jimdrive.ASE | 2 /10 | 426/814; driving pose. |
| jimheadshrink.ASE | 7 /5 | 426/814; distinct authored morph sequence, not an inferred uniform scale. |
| godscooter.ASE, godscooter2.ASE | 2 each /30 | 195 vertices/370 faces; reference goddard02.png. |
| godrocket.ASE | 3 /5 | 222 vertices/411 faces; rocket-form candidate. |
| ray.ASE | 2 /10 | 5 vertices/3 faces. Material text references ray0002.ifl; supplied PNGs ray0000..ray0003 exist. Sequence binding/cadence remains source work. |
| hook.ASE | 1 /10 | 40 vertices/68 faces; material references hook.bmp, supplied hook.png exists. |
| rope01.ASE,rope02.ASE | 1 each /30 | 6 vertices/6 faces and4 vertices/2 faces. |
| laser02.ASE,missile.ASE | 1 each /30 | 8 vertices/8 faces and7 vertices/10 faces; missile's goo.bmp reference is not a verified gadget attachment. |
scooter.omt contains shape0 goddard01, shape1 wheel; material0 goddard128
links Canv1 goddard128, material1 scooterwheel2 links Canv0 scooterwheel2.
This corrects the earlier ambiguous material/canvas association; archive SHA256
8d4ffdafee5fd819c5220ee4f608c901a5988fe6b8b13316e15618f5eec75e81.
inventory.omt is an older-looking icon set with BUBBLE/GODJEEP/SCOOTER/jetpack etc;
its names alone do not justify replacing screens.omt menu art or IDs.
No explicit bubble-named ASE exists in the supplied directory; that bounded
filename search does not prove the original bubble geometry was absent/generated.
Already prepared sounds
artifacts/extracted/effects/effects.json already preserves original SoundEffects.omt
waves, paths and source byte ranges. Bank SHA256 is
c71e06d93b8a5ef4f4522a5c40220bc8aeaecb889b5de69445db44817fb9acb1.
Useful identities are0 shrinkray,1 jetpack,2 gravitybubble,3 gravitybubbleoff,
10 goddard baseballs,18 pickupbaseball,45 rocketship,46 Scooter,106
bubble boing and117 click shrink ray. These are archive identity/name facts;
actual activation, repeat, ownership, volume and cancellation still need callers.
The existing resource export is sufficient; no duplicate sound extraction is needed.
Practical next addition and limits
Original selection art and control labels are complete enough to implement a source-driven gadget screen without invented icons. For a usable gadget beyond the current powered jump, shrink firing has original pose, beam geometry/PNG frames and both successful-fire/click sounds available; it still needs recovered target, range, timing, energy and interruption policy. The selection3 naming overlap is an explicit reason to implement the combined shrink/jetpack controls coherently. Other gadget assets are candidates for later behavior recovery, not evidence that all eight gadget behaviors are currently implemented.
2026-11-04 Scooter continuation: export_scooter now prepares exact OMT shape0/1, Canv0/1 pixels and HISCOOT/HISCOOTSTOP rider morphs, with source aliases and PE spans in its manifest. Runtime body/wheels/rider preserve source pivots/unit scale; null-material wheel faces remain undrawn. The Goddard HISCOOT alias is separately recovered and is not substituted for the active Jeep mesh. Eight resource groups check exact geometry/UVs/normals/materials/radii/pixels, morph samples/topology, binding instructions, determinism, identity and output isolation. Live status and remaining render/lifetime limits: scooter-live.md.