98 lines
5.0 KiB
Markdown
98 lines
5.0 KiB
Markdown
# Level3B / Level3E resource evidence
|
|
|
|
Static investigation, 2026-10-24. Source: unmodified `Original/Neutron.exe`, SHA-256
|
|
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
|
Addresses are preferred-base EXE virtual addresses. File offsets for the addresses
|
|
below equal VA minus `0x400000` in this PE. No original code was executed.
|
|
|
|
## Findings and scope
|
|
|
|
The user is correct that **`gam/Level3B.gam` and `gam/Level3E.gam` exist**.
|
|
Both parse successfully as 1,777-byte entity files with four entities:
|
|
`3JIM`, `STRT`, `LOAD`, `3SBU`. Their bytes after the four-byte level header
|
|
are identical; headers are `LV3B` and `LV3E`. GAMs contain entity properties,
|
|
not replacement scene mesh/material/texture payloads.
|
|
|
|
The original executable also has explicit, separate archive-opening paths for
|
|
**`omt/level3B.omt` and `omt/level3E.omt`**. Those files are absent from the
|
|
supplied original tree. This is verified loader behavior, rather than an inferred
|
|
same-stem pairing or merely an unused string reference. No shared-map alias is
|
|
present on the traced initialization paths.
|
|
|
|
However, whether these scenes occur in normal shipped gameplay is **unverified**.
|
|
Small identical entity bodies suggest possible stubs/development leftovers; that
|
|
is an inference, not established intent. The primary's corpus check found no
|
|
serialized GAM string references to either scene name/code and no source TSK
|
|
starting in `LV3B`/`LV3E`. This does not exclude hardcoded transitions or other
|
|
entry routes. Do not describe the archives as confirmed required files for the
|
|
normal game, or tell the user their GAM files are missing.
|
|
|
|
## Class and archive dispatch
|
|
|
|
| Evidence | Level3B | Level3E |
|
|
|---|---|---|
|
|
| Complete class | `CLevel03BGame` | `CLevel03EGame` |
|
|
| Constructor | `0x451AF0` | `0x452690` |
|
|
| Constructor sets level code | `0x451BA8`: push `LV3B` | `0x452748`: push `LV3E` |
|
|
| Factory calls constructor for code | `0x45D635` | `0x45D78B` |
|
|
| Complete vtable | `0x4C7830` | `0x4C8A00` |
|
|
| Initialization slot `+0xB4` | `0x451C50` | `0x4527F0` |
|
|
| Literal archive string | `0x4F1F24`: `level3B.omt` | `0x4F1FFC`: `level3E.omt` |
|
|
| Archive string length/copy | `0x451C99` / `0x451CC5` | `0x452839` / `0x452865` |
|
|
| Dispatch archive loader slot `+0xE4` | `0x451CE8` | `0x452888` |
|
|
|
|
Both vtable `+0xE4` entries are `0x44E7B0`. This function copies the supplied
|
|
archive filename, invokes slot `+0x16C` with the directory string `omt` at
|
|
`0x4F1B1C` (`0x44E7FF..0x44E81E`), builds the string argument, calls the file
|
|
stream helper `0x476170` at `0x44E8B4`, then calls database helper `0x476000`
|
|
at `0x44E8CE`. It stores the file stream/database in globals
|
|
`0x5099D8` / `0x5099C0`. There is no fallback archive name in this routine.
|
|
|
|
File helper `0x476170` imports `OMediaFilePath` and `OMediaFileStream`
|
|
constructors (`0x48D188`, `0x48D184`). Database helper `0x476000` imports
|
|
`OMediaDataBase(OMediaStream*)` at `0x48D19C`. This confirms the archive string
|
|
goes to the real file/database path rather than to a debug label.
|
|
|
|
The level-code-to-GAM path is separate: the switch at `0x4607F1` selects
|
|
`level3b.gam` (`0x4F49C4`) at `0x46083E`; the `LV3E` branch selects
|
|
`level3e.gam` (`0x4F49A0`) at `0x46088E`. The level registry also contains
|
|
code/GAM records at `0x4F3BE0` and `0x4F3C4C`. Existence in the factory and
|
|
registries proves registration, not a normal-gameplay route.
|
|
|
|
## Missing-file handling
|
|
|
|
The traced archive-opening path does **not** directly abort, choose a shared map,
|
|
or produce procedural replacement geometry when the map archive cannot open:
|
|
|
|
- `0x476000` initializes its result to null, checks the stream pointer and its
|
|
open byte `+0x24` (`0x47602A..0x476033`), and returns null without constructing
|
|
a database when either condition fails.
|
|
- `0x44E7B0` retains the resulting null database and returns. It does not itself
|
|
throw or dispatch an explicit missing-map error in the examined path.
|
|
- Base geometry/entity-resource enumeration `0x44D4F0` checks `0x5099C0` at
|
|
`0x44D513`; null skips enumeration to `0x44D7F2`.
|
|
- The child initialization then continues and separately constructs `3SKY` through
|
|
the factory `0x459CB0`. Its sky resource is `omt\nightsky.omt` at `0x4F1DA4`,
|
|
passed at `0x451D35` / `0x4528D5`.
|
|
|
|
Thus these archives' absence means the port has no recovered scene geometry for
|
|
the registered entries. It does **not** prove an original startup crash, and this
|
|
static trace cannot establish whether the shipped game ever tries to enter them.
|
|
|
|
## Reproducible checks
|
|
|
|
Run from `GamePort`:
|
|
|
|
```sh
|
|
python3 tools/binary/level_resource_evidence.py
|
|
```
|
|
|
|
The read-only script passes **13 decisive instruction byte assertions**, resolves
|
|
both class vtables, verifies the archive directory/names, parses both GAMs, reports
|
|
their SHA-256 hashes, confirms their identical bodies and checks archive presence
|
|
case-insensitively. It reports normal-gameplay reachability as unverified.
|
|
|
|
Confidence: high for supplied-file presence, original loader mapping and null-map
|
|
enumeration handling; unverified for gameplay reachability, intended stub status,
|
|
and original runtime outcome.
|