8.0 KiB
Asset recovery evidence
Verified against local originals on 2026-10-23. No original files were modified.
Original/ is outside the modern local Git repository. Analysis/extraction uses
Python standard library only; nothing is uploaded.
Verified corpus
python3 tools/extractors/audit.py ../Original --report artifacts/extracted/audit.json
successfully parsed all 100 .omt databases, 7,027 resource entries, with no
conversion failures:
| Resource | Count | Verification |
|---|---|---|
3DSh |
2,155 | Every shape v2 consumed exactly; positions finite; corner indices bounded |
3DMa |
2,183 | Every material v1 consumed exactly; original texture links recovered |
Canv |
1,614 | All RLE decoded to exact row lengths and all resource bytes consumed |
Wave |
875 | RIFF/WAVE header and bounded RIFF lengths present |
mCTy |
100 | Indexed metadata preserved; internal interpretation outstanding |
0HDR |
100 | Indexed allocation metadata preserved; not runtime geometry |
Texture counts are 866 RGB555, 736 32-bit RGB, and 12 indexed 8-bit. All 875 sound resources contain intact RIFF data: 874 PCM and one format-tag 85 (MP3 in WAVE). PCM rates/channels/sample widths vary; do not assume one audio format. Loop and cue behavior in the surrounding OMT metadata remains unverified.
Recovered scene outputs
Run from GamePort/:
python3 tools/extractors/prepare.py
python3 -m unittest discover -s tests -p test_extractors.py -v
Preparation produces ignored local files below artifacts/extracted/:
level1b/scene.json: 8,607 expanded vertices, 2,869 triangles, 33 textures.VR01/scene.json: 240 expanded vertices, 80 triangles, 7 textures.- Texture
.rgbafiles plus PNG previews, preserving material ID links. sounds/,musicjimmyshouse/,musicneighborhood/: exact embedded WAV bytes.animations/{jimstop,jimrun,jimjump,jimscratch}/: original morph samples and manifests.animations/jimycarl.rgba: original normal Jimmy atlas, 256 x 256 indexed PNG decoded to RGBA.
Individual archive recovery:
python3 tools/extractors/omt.py ../Original/omt/level1b.omt --scene --output artifacts/extracted/level1b
python3 tools/extractors/omt.py ../Original/omt/sounds.omt --output artifacts/extracted/sounds --raw
python3 tools/extractors/ase.py ../Original/ASE/jimrun.ASE --base ../Original/ASE/jimstop.ase --output artifacts/extracted/animations/jimrun
The static OMT scene is geometry/material recovery, not a complete level state. GAM entity transforms, object visibility, character meshes, lighting, camera, gameplay collision masks, triggers and task progression must be applied separately. All source scene polygons examined in these first scene exports are triangles; the exporter supports polygon fans and warns for any larger polygons whose concavity has not been validated.
Executable evidence used
Preferred virtual addresses in the supplied OMT2.dll (image base 0x10000000):
| Routine | Address | Supporting behavior |
|---|---|---|
OMedia3DShape::read_class |
0x10007b60 |
3DSP signature, version, vectors and polygon arrays |
OMedia3DPolygon::read_class |
0x10003e20 |
Version-dependent corners, UVs, normal indices, material links |
OMedia3DMaterial::read_class |
0x10001490 |
Compact v1 styles, color triplets and texture stream link |
OMediaCanvas::read_class |
0x10025b80 |
Dispatches OmCv through canvas converter |
OMediaOMTConverter::convert |
0x10027df0 |
OmGW dimensions, packing/key/palette header and row RLE |
| RLE unpack helper | 0x1006c230 |
Byte/word/dword PackBits variants; LE signed controls |
OMediaOMTConverter::create_canvas |
0x10028620 |
Pixel RGB and alpha/color-key conversion |
OMediaOMTConverter::read_palette |
0x10027b40 |
OmPa/OPa2 palette with 4,096-byte accelerator |
OMediaDBObjectStreamLink::read_class |
0x10030260 |
BE16 present + fourcc + BE32 ID |
| Bool stream operator | 0x10073a80 |
Booleans occupy two bytes on disk |
OMedia3DMorphAnim::render_draw_shape |
0x10002df0 |
Retains base shape while overriding per-index vectors |
RGB555 channels are expanded by << 3, not normalized to 255. Instructions
at 0x10028815 onward verify this; maximum channels therefore remain 248.
The 32-bit path at 0x100288ab selects RGB bits 16/8/0 and derives alpha from
color-key equality. Stored high-byte alpha is not copied by that converter.
Raw byte-exact resources remain available using --raw.
ASE geometry and animation
The supplied ASE assets include standard ASCII mesh vertex/face tables, per-corner
texture indices, scene timing and vertex morph samples. jimstop.ase differs in
filename case from most other ASE files. Resolve filenames case-insensitively.
Two matching assets provide independent coordinate evidence, covered by tests:
- All eight
gate1.ASEvertices and all eightyokianpart.ASEvertices match the correspondingobjects.omtresources after(x,y,z) -> (x,z,y). - Face index order remains identical; the reflection is not accompanied by an index swap in the stored original.
- Every corner UV matches
(u,v) -> (u,-v). - No additional
NODE_TMis applied to these already exported vertex positions.
Source ASE normal fields are not assumed authoritative; exported preview normals currently use flat triangle normals. Original smoothing must still be replicated.
Jimmy uses 426 source vertices and 814 faces. jimstop.ase has two samples,
jimrun.ASE five, and jimjump.ASE three, all with file scene speed 10 FPS and
480 ticks/frame. These establish asset sample timing, not state-specific playback
speed or loop policy in gameplay code.
The two jimstop vertex samples are identical: there is no idle motion to play.
The scratch file has three distinct samples at ticks0/960/1920. Preview clip keys
expose source motion explicitly instead of labeling the default idle as animated.
The EXE stores jimyshock.png at file offset 0xef0c8, followed by jimstop.ase
at 0xef0d8. Primary integration corrected an early inference from string
proximity: InitObject at 0x422C96..0x422CB0 binds jimycarl.png (VA
0x4EEAC4) to texture slot 0 and jimyshock.png to slot 1. The latter is the
shock/skeleton effect, not normal appearance. Prepared animation textures and
runtime defaults now use jimycarl.png; both have been visually inspected.
The ASE bitmap path D:\\Jimmy\\jimmy\\jimmylast.bmp is not a runtime dependency.
Run/jump filenames follow in the same initialization string cluster.
Morph topology retention
Run/jump/scratch ASE files omit UV tables. Zero UVs would show a single texel and
are rejected by the animation exporter. The original morph renderer validates
the sample vector count against the base shape and interpolates per-index vectors
(0x10002ed3, 0x10002eee, 0x10002f9a..0x10002fd9), then submits the base
shape plus override vectors (0x10003396..0x100033ab). Its topology/UV remain
on the base shape. Therefore the prepared Jimmy animations explicitly use the
textured jimstop.ase base and original sample vertex indices. This also matters
because 23 face records in run/jump differ from the later dated stop asset even
though all sample vertex counts remain 426. morphBase provenance in each
animation manifest records the source and hash of the retained shape.
Limits and next work
- Static asset decoding is verified, but visual fidelity needs comparison with an isolated original game run.
- Legacy material booleans and polygon flags remain numerically preserved rather than assigned unproven lighting/culling/collision meanings.
- Color triplet roles are conventional labels inferred from the legacy material layout; exact renderer use should be cross-checked against recovered DX states.
- Animation exporter supports all supplied mesh records, but character bundles prepared so far cover Jimmy stop/run/jump only. Original smooth normal and state-driven playback behavior remain incomplete.
- Native runtime renderer/audio integration and package validation belong to the primary/infrastructure work; successful extraction is not runtime verification.