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

145 lines
8.8 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.
# 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](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](scooter-live.md).