Render original lab and Jimmy with native Vulkan and SDL3 on .NET 10
This commit is contained in:
1 parent
3df20ac19a
commit
008c0e16da
41 files changed
+2125
-68
No files matched your search
@@ -70,5 +70,33 @@ meaning depends on each property.
|
||||
|
||||
Save data has a fixed-looking region followed by Pascal task names and big endian
|
||||
values (NewGame.tsk tail includes SCENE = 30). Save writing is not yet recovered.
|
||||
Physics, jumping, collision, AI, RNG, combat, progression and cutscene execution
|
||||
remain under investigation. No original gameplay session has been captured yet.
|
||||
## Recovered arithmetic fragments
|
||||
|
||||
Binary analysis has now resolved actual game gravity, jump impulse and basic
|
||||
integration order. `src/GamePort/Game/RecoveredMotion.cs` implements those narrow
|
||||
fragments independently of the still-unrecovered full controller/collision system.
|
||||
|
||||
- CJimmyGame setup `0x44D414` overrides generic engine gravity to (0,-800,0).
|
||||
- Jump branch `0x4383B3` queues a one-frame (0,550,0) impulse.
|
||||
- Player airborne logic additionally changes acceleration: state<3 at `0x438148`
|
||||
uses `gravity*1.33-gravity`, producing roughly -1064 effective vertical
|
||||
acceleration. Other states/jetpack gates remain unresolved. Therefore the
|
||||
tested -800 free-motion fragment is **not** a complete normal-jump controller.
|
||||
- Physics `0x479EBB..0x479FC0` consumes/clears impulse, adds acceleration*dt and
|
||||
gravity*dt, then computes displacement from the updated velocity (semi-implicit
|
||||
Euler). Subsequent collision resolution and activation flags remain unresolved.
|
||||
- Player speed increment 30, idle decay 35 and maximum 600 are per invocation,
|
||||
without dt. Constructor fields and branch addresses are in binary.md. Rendering
|
||||
frame rate must not silently become the simulation invocation rate.
|
||||
- The original uint32 RNG at `0x438D52` wraps `state*1664525+32767` and returns
|
||||
`state>>16`. A System.Random replacement would produce different sequences.
|
||||
- The -350 value originally suspected during investigation is a camera offset,
|
||||
**not** gravity. Follow offset (0,200,-350), look target offset (0,80,0).
|
||||
|
||||
C# regressions exercise impulse consumption/order, limits, initial original data,
|
||||
and RNG overflow. These establish the reconstructed arithmetic, without claiming
|
||||
bit-identical x87 behavior or a complete faithful controller.
|
||||
|
||||
Physics gating, collisions, AI, combat, progression, cutscene execution and
|
||||
simulation cadence remain under investigation. No original gameplay session has
|
||||
been captured yet.
|
||||
@@ -23,6 +23,18 @@ verification possible without a desktop; this is distinct from SDL presentation.
|
||||
Simulation implementation must follow recovered algorithms and timing. A generic
|
||||
fly camera or rendered model alone does not satisfy the playable-scene requirement.
|
||||
|
||||
The completed foundation includes a single synchronous Vulkan renderer supporting
|
||||
offscreen and SDL surface presentation, an independent SDL WAV stream, bounded
|
||||
GAM/PNG/scene readers, and a retained-topology morph sampler. Prepared scene JSON
|
||||
avoids a Python runtime dependency in native packages. Mesh draw ranges omit null
|
||||
materials following the original renderer, while retaining their geometry. Default
|
||||
normal atlas and morph transforms are supported by binary/duplicate-asset evidence.
|
||||
|
||||
Physics arithmetic fragments are independent of a full controller; no invented
|
||||
collision/task system has been silently inserted. The main program remains a
|
||||
scene investigation runtime; future simulation must be a separate stateful module
|
||||
with recovered timing, input, collision, triggers and progression.
|
||||
|
||||
Subsystem implementation and validated ownership are documented in
|
||||
`infrastructure.md`, `analysis/graphics.md` and `rendering.md` as they become
|
||||
available. Persistent docs distinguish planned architecture from verified behavior.
|
||||
+34
-17
@@ -1,21 +1,38 @@
|
||||
# Compatibility and validation
|
||||
|
||||
Status is evidence-based; compilation alone is not runtime verification.
|
||||
Compilation, native runtime, original behavior and full feature completion are
|
||||
separate evidence categories. **The game is not fully reconstructed/playable yet.**
|
||||
|
||||
| Feature | Implemented | Tested | Evidence / limits |
|
||||
|---|---|---|---|
|
||||
| Original preservation | Hash baseline | Initial corpus | 539 files in original-manifest.json |
|
||||
| GAM reader/encoder Python | Yes | Linux, all 35 levels | Byte-for-byte round trip, six tests |
|
||||
| GAM C# loader | Yes | Pending compilation | Original scene/player/camera exposed |
|
||||
| OMT geometry recovery | In progress | Original level1 meshes | Asset agent integration pending |
|
||||
| .NET 10 Linux build | In progress | Pending | Project-local SDK installed |
|
||||
| Windows x64 build/package | Pending | Unverified | Cross-build will not prove execution |
|
||||
| Vulkan frame | In progress | Pending | Headless Mesa available; no initial display |
|
||||
| SDL3 window/input/audio | In progress | Pending | Native dependencies being built locally |
|
||||
| Playable scene / original fidelity | No | No | Rendering foundation does not establish gameplay |
|
||||
| Original execution/reference capture | No | No | Wine absent initially; originals not executed |
|
||||
| Animation/AI/combat/progression/save | No | No | Reverse engineering ongoing |
|
||||
| Feature | Implemented / tested | Evidence and limits |
|
||||
|---|---|---|
|
||||
| Original preservation | Verified after extraction/runtime tests | All539 original SHA-256 hashes unchanged |
|
||||
| GAM Python / C# | All35 files,3299 entities | Exact Python round-trip; C# corpus/start/corruption checks |
|
||||
| OMT recovery | All100 archives audited | 2155meshes,2183materials,1614textures,875RIFF, zero failures |
|
||||
| C# original loaders | Linux runtime | All128 PNG /254 ASE base meshes; morph/base UV tests |
|
||||
| .NET10 Linux build | Pass, zero warnings/errors | Local SDK10.0.402/runtime10.0.13 |
|
||||
| Windows x64 publish | Pass | Correct PE32+ app and SDL3.dll; native execution untested |
|
||||
| Linux self-contained package | Native run verified | Two headless frames without SDK/source/originals mounted |
|
||||
| Vulkan1.3 lab | llvmpipe + GTX1070 | Real indexed/textured/depth frame/readback; validation enabled, zero errors |
|
||||
| Original camera/projection | Data/math integrated | GAM camera, recovered FOV/clips; startup/follow behavior not compared |
|
||||
| Jimmy normal texture / morph | Native preview verified | Correct atlas slot0, base topology/UV retained; state speed/loop unverified |
|
||||
| Null-material visibility | Binary rule implemented/tested | Original DX renderer skips null pointers; proxy geometry retained |
|
||||
| SDL3 presentation/input | Linux Xvfb + GTX1070 | Six frames; injected keyboard event received |
|
||||
| Swapchain resize | Linux tested | 960x720 ->800x600, zero validation errors |
|
||||
| Focus / fullscreen | Code present, partial/unverified | Focus clears keys; fullscreen toggle not dynamically tested |
|
||||
| Mouse/relative input/controller | Incomplete | SDL entry point declaration alone is not behavior |
|
||||
| Audio stream | Linux dummy device | Original11025Hz mono WAV consumed10752bytes/500ms; speakers untested |
|
||||
| Physics fragments/RNG | Standalone C# tests | Recovered arithmetic; controller/jump/collision state incomplete |
|
||||
| Intro/task/entity/gameplay loop | Incomplete | GAM data recovery is not task execution or gameplay |
|
||||
| Menus/AI/combat/progression/saves | Incomplete | Required future work |
|
||||
| Original execution | Attempted under isolated Wine11 | Window created, GL/Vulkan rendering unusable; no reference comparison |
|
||||
| Native Windows functionality | Unverified | Requires local Windows installation or VM |
|
||||
|
||||
Current known limitations: no reconstructed complete gameplay loop yet; no native
|
||||
Windows testing or reference captures. Exact camera, physics, fixed-function
|
||||
lighting/blending/fog and task behavior need binary/observational validation.
|
||||
Generated evidence: artifacts/final-tests.log, test-level1b.ppm, test-player.ppm,
|
||||
resize-input.ppm, package-linux.ppm, extracted/audit.json and reference*/ logs.
|
||||
The lab/player images have been visually inspected; they do not establish original
|
||||
visual equivalence. Windows cross-publishing must not be represented as Windows
|
||||
runtime validation. Package scope and prerequisites are in infrastructure.md.
|
||||
|
||||
Known visual/behavior limits include incomplete lighting/fog/blend/culling/material
|
||||
mapping, inferred initial look-at, preview animation loop/speed, no reconstructed
|
||||
intro/controller/collision/trigger execution and no original comparison captures.
|
||||
@@ -0,0 +1,19 @@
|
||||
# Local dependencies
|
||||
|
||||
| Component | Version used | Source / license metadata |
|
||||
|---|---|---|
|
||||
| .NET SDK | 10.0.402 | Official builds.dotnet.microsoft.com archive; pinned SHA-256 in bootstrap.sh |
|
||||
| .NET runtime | 10.0.13 | Self-contained publish runtime pack; bundled LICENSE and THIRD-PARTY-NOTICES |
|
||||
| Silk.NET.Vulkan / KHR / EXT | 2.23.0 | NuGet packages, locked transitive versions in packages.lock.json; MIT license expression |
|
||||
| SDL3 Linux / Windows | 3.4.2 | Official libsdl.org archives; zlib license, copied to packages/licenses/SDL3.txt |
|
||||
| glslang/SPIR-V tools | Ubuntu local packages | Development shader compilation/validation only |
|
||||
| Vulkan loader/ICD | Host platform | Runtime Vulkan 1.3 driver/loader prerequisite |
|
||||
| Khronos validation layer | 1.3.275 | Local Ubuntu package; development verification only |
|
||||
| Python | 3.12 | Existing host interpreter; analysis/preparation only, stdlib extractors |
|
||||
| Wine | 11.0 | Official WineHQ stable Ubuntu amd64/i386 packages; original-reference testing only |
|
||||
|
||||
The .NET runtime pack version must be checked against the generated publish
|
||||
runtimeconfig; the SDK and runtime have distinct version numbers. Library license
|
||||
metadata is recorded for continuity; original game assets retain their original
|
||||
ownership. Packages are local artifacts, not public distribution authorization.
|
||||
No project files or assets were uploaded to dependency sources.
|
||||
@@ -0,0 +1,61 @@
|
||||
# Native infrastructure and package scope
|
||||
|
||||
Verified environment: Ubuntu 24.04 x86-64; project-local .NET SDK 10.0.402,
|
||||
Silk.NET 2.23.0, SDL 3.4.2 built from official source (Linux) and official x64
|
||||
SDL3.dll (Windows). GLSL compiled to Vulkan 1.3 SPIR-V and checked by spirv-val.
|
||||
Khronos validation layers are installed locally. No root installation is required.
|
||||
|
||||
`scripts/env.sh` selects local SDK, NuGet cache, native tools and validation layer;
|
||||
it also disables .NET CLI telemetry. `bootstrap.sh` reproduces dependency setup
|
||||
on the tested Ubuntu host using official pinned SDK/SDL archives and apt packages.
|
||||
Downloaded archive SHA-256 values are checked before extraction. Tool/dependency
|
||||
downloads are permitted by the specification; no project material is uploaded.
|
||||
|
||||
## Implemented
|
||||
|
||||
- C# .NET 10 shared executable and local-only solution/build scripts.
|
||||
- Vulkan 1.3 instance/device/graphics queue, descriptors, buffers, texture uploads,
|
||||
sampler, indexed graphics pipeline, depth attachment, offscreen target/readback.
|
||||
- SDL3 Vulkan surface, swapchain/presentation, resize/recreation, synchronization,
|
||||
cleanup, keyboard, focus handling and fullscreen toggle.
|
||||
- SDL3 WAV streams with conversion, optional looping and lifecycle cleanup.
|
||||
- Original OMT-derived world geometry/materials/textures; original ASE model and
|
||||
retained-base vertex morph animation samples; original GAM entities/camera.
|
||||
- Self-contained Linux/Windows publishing with matching native SDL3 libraries.
|
||||
|
||||
The renderer completes submissions synchronously. This deliberately simple early
|
||||
implementation is maintainable but does not target final performance. It currently
|
||||
has a texture-times-color pipeline, nearest mip level/linear sampling, alpha
|
||||
discard and depth. Original per-material culling/blending, lighting, fog and
|
||||
animation state/render sorting are incomplete. See rendering.md for evidence.
|
||||
|
||||
## Verified checks
|
||||
|
||||
- `scripts/test.sh`: Python extraction/GAM tests, C# data/morph/arithmetic tests,
|
||||
all 128 PNG and 254 ASE base meshes, actual original lab and player rendering.
|
||||
- Offscreen Mesa llvmpipe: lab 2,869 source triangles / 33 recovered textures;
|
||||
combined Jimmy preview 3,683 triangles / 34 textures; zero Vulkan validation
|
||||
errors. Readback is saved locally, visually reviewed and compared before/after
|
||||
material/texture fixes. This is not original-game visual equivalence proof.
|
||||
- SDL3 window on NVIDIA GeForce GTX 1070 under Xvfb: six frames, injected keyboard
|
||||
received, resize 960x720 -> 800x600, zero validation errors. Tested with scoped
|
||||
escalation because the restricted tool sandbox blocks display-socket access.
|
||||
- Recovered 11,025 Hz mono WAV: dummy-device SDL3 stream consumed 10,752 bytes
|
||||
in 500 ms. Physical speaker output, positional mixing and original timing are
|
||||
unverified.
|
||||
- Linux/Windows self-contained cross-publishing succeeds. Native Windows execution
|
||||
remains unverified; Wine reference testing is a separate investigation path.
|
||||
|
||||
## Scope limits
|
||||
|
||||
This is an investigation/runtime foundation, not complete reconstructed gameplay.
|
||||
Original collisions, task/trigger execution, introductory cutscene, inventory,
|
||||
combat, enemies, progression, save/load, original mouse/control behavior and
|
||||
remaining scenes are incomplete. Player rendering at the original startpoint is
|
||||
an animated preview; its interpolation loop/speed are not a recovered state machine.
|
||||
|
||||
Packages include local copies of asset directories (ASE/png/gam/omt), original
|
||||
font PNGs/NewGame/readme, lab/Jimmy scene resources, recovered music, .NET runtime,
|
||||
SDL3, SPIR-V and these limitations. Legacy EXEs/DLLs, old user save slots, tool
|
||||
caches and analysis databases are not runtime dependencies. Vulkan drivers remain
|
||||
platform prerequisites. No claim of native Windows runtime validation is made.
|
||||
+67
-21
@@ -1,25 +1,71 @@
|
||||
# Progress
|
||||
# Progress — current checkpoint
|
||||
|
||||
## Verified so far
|
||||
- Read complete primary specification, inspected originals, established ownership.
|
||||
- Created local-only Git repository under GamePort and persistent project guidance.
|
||||
- Recorded all 539 original-file SHA-256 hashes (224,601,234 bytes).
|
||||
- Identified PE32 x86 MSVC C++ game and Open Media Toolkit 2.0 DR4 engine.
|
||||
- Fully decoded 35 GAM levels, 3,299 entities, 93 class codes, 84,044 properties.
|
||||
- Python GAM reader/encoder round-trips every original byte; six targeted tests pass.
|
||||
- C# GAM reader added with explicit endian handling and original startpoint/camera.
|
||||
- OMT resource index and meshes recovered by asset investigation; integration ongoing.
|
||||
- Scoped dependency download approved; local .NET 10 SDK/Silk/SDL setup ongoing.
|
||||
**Full reconstruction is incomplete.** The current milestone is an evidence-backed
|
||||
asset recovery toolchain and a native original-scene/animation investigation
|
||||
runtime with local Linux/Windows packages. No completed playable-scene claim.
|
||||
|
||||
## Current work
|
||||
Binary/rendering investigation, exact material/texture/audio recovery, C# runtime,
|
||||
Vulkan offscreen verification, SDL3 presentation, cross-platform packaging.
|
||||
No claim of full playable reconstruction, original behavior comparison, or Windows
|
||||
runtime validation. See `tasks.md` and `compatibility.md` for remaining work.
|
||||
## Verified
|
||||
|
||||
- Full `../prompt.MD` specification read; originals preserved and local Git initialized.
|
||||
- All 539 original files (224,601,234 bytes) still match recorded SHA-256 hashes.
|
||||
- Native PE32 x86 MSVC C++ game, Open Media Toolkit 2.0 DR4, Direct3D7/DirectDraw7,
|
||||
DirectInput8 and DirectSound identified with addresses in analysis reports.
|
||||
- 35 GAM files: 3,299 entities, 93 class codes, 84,044 properties, byte-for-byte
|
||||
round-trip in Python and full corpus decoding in native C#.
|
||||
- 100 OMT files / 7,027 indexed resources audited: 2,155 meshes, 2,183 materials,
|
||||
1,614 textures, 875 bounded RIFF resources; zero decode failures.
|
||||
- ASE/OMT coordinate and UV conversion proven with duplicate assets. Jimmy morph
|
||||
sample vectors retain original base UV/topology; normal texture corrected to
|
||||
jimycarl.png via actual InitObject code, with shock atlas kept separate.
|
||||
- .NET SDK10.0.402/runtime10.0.13, Silk.NET2.23.0, SDL3.4.2 provisioned locally.
|
||||
- C# builds without warnings/errors; 20 Python tests plus native C# corpus,
|
||||
malformed-data, arithmetic, visibility, case lookup, morph and merge tests pass.
|
||||
- Native Vulkan lab rendering: 2,869 triangles / 33 textures; combined Jimmy
|
||||
preview: 3,683 triangles / 34 textures. Real GPU readback, zero validation errors
|
||||
under llvmpipe; scene/player screenshots visually reviewed.
|
||||
- Fixed original null-material skipping removes false white collision-proxy
|
||||
surfaces. Original startpoint/camera and recovered projection are available.
|
||||
- SDL3 hardware window/presentation on GTX1070 under Xvfb: six frames, injected
|
||||
keyboard received, resize to800x600, zero validation errors.
|
||||
- SDL3 recovered WAV stream consumes bytes on dummy device. Speaker output untested.
|
||||
- Self-contained linux-x64/win-x64 packages built under dist/. Linux package also
|
||||
renders inside a separate filesystem namespace with no SDK/project/original
|
||||
directory mounted. Windows native execution remains unverified.
|
||||
- Official Wine11 original-copy runs attempted in isolated filesystem/network
|
||||
namespaces. Both GL and Vulkan backends produce unusable frames; details below.
|
||||
|
||||
## Build and run
|
||||
|
||||
From GamePort: `source scripts/env.sh`, `dotnet build`, then `dotnet run -- --with-player`.
|
||||
Asset preparation: `python3 tools/extractors/prepare.py --audio sounds musicsecretlab`.
|
||||
Tests: `scripts/test.sh`; packages: `scripts/package.sh`. See README for exact options.
|
||||
Generated outputs and dependencies are ignored, and everything remains local.
|
||||
|
||||
## Remaining and current constraints
|
||||
|
||||
No original gameplay reference has been captured. Wine GL cannot obtain a suitable
|
||||
pixel format/3D surface; Wine Vulkan logs unsupported fixed-function state and a
|
||||
swapchain image count mismatch. Native Windows/VM access has been requested for
|
||||
reference/fidelity and native port validation. These failures do not establish
|
||||
original behavior. Static reverse engineering can continue independently.
|
||||
|
||||
Original controller, collision resolution, introductory LABEXP cutscene, entity
|
||||
activation/task/trigger execution, interactions, combat, AI, progression, menus,
|
||||
mouse behavior and saves remain incomplete. Gravity/impulse integration fragments
|
||||
are tested, but the player jump state machine adds extra acceleration and is not
|
||||
implemented as a complete controller. Animation looping/speed are explicit preview
|
||||
policies. Rendering material/lighting/fog/blend state mapping also remains incomplete.
|
||||
|
||||
Three subagents contributed independent investigation/infrastructure work and then
|
||||
hit a usage limit. Primary reviewed/integrated their work, corrected texture and
|
||||
visibility assumptions, finished scripts/tests/packages, and owns the current files.
|
||||
Do not assume their final reports imply completed gameplay.
|
||||
|
||||
## Continuation
|
||||
Read AGENTS, this file, tasks, architecture and analysis reports. Check local Git
|
||||
status and active agents before editing. Avoid repeating completed inventory/GAM
|
||||
analysis. Original initial-scene evidence points to LV1B / STARTEXP, with VR01 as
|
||||
a smaller resource-validation scene. Exact movement defaults now recovered in
|
||||
binary investigation; do not substitute unverified gameplay guesses.
|
||||
|
||||
Read AGENTS, tasks, architecture, compatibility, reverse-engineering index, and
|
||||
analysis reports. Check Git status before editing. Avoid repeating solved inventory,
|
||||
GAM decoding or OMT extraction. LV1B/STARTEXP is initial scene evidence; its LABEXP
|
||||
trigger still needs reconstruction. VR01 provides a smaller, 16-entity test scene.
|
||||
Next actionable addresses/tasks are in tasks.md; original execution procedure and
|
||||
errors are in reference-testing.md. Commit history preserves local milestones.
|
||||
@@ -0,0 +1,38 @@
|
||||
# Original reference testing
|
||||
|
||||
Originals are never executed in place. `tools/recon/reference_capture.py` copies
|
||||
Original to ignored `artifacts/reference/game`, then launches official Wine 11.0
|
||||
in bubblewrap with all namespaces unshared, no network, a minimal read-only host
|
||||
filesystem, and writable generated work/prefix only. Original paths and home are
|
||||
not mounted. Xvfb runs inside the namespace; ImageMagick captures its root window.
|
||||
Return key injection is optional. The new port has no Wine dependency.
|
||||
|
||||
Local WineHQ Ubuntu noble stable amd64/i386 packages were downloaded separately,
|
||||
verified against official index SHA-256 and extracted under `.tools/wine`. The
|
||||
wrapper also needs `.tools/native/usr/bin/Xvfb`, bubblewrap, xkbcomp, ImageMagick,
|
||||
32-bit Wine runtime libraries and an appropriate Wine graphics backend. Mesa
|
||||
software-driver dependencies are kept project-local. Network namespace creation
|
||||
needs scoped tool escalation in this environment; no host installation is used.
|
||||
|
||||
Reproduce (Linux host with those tools):
|
||||
|
||||
```sh
|
||||
python3 tools/recon/reference_capture.py --seconds 24 --enter --debug
|
||||
```
|
||||
|
||||
The supplied NeutronNoCD.exe was launched in the isolated copy and created its
|
||||
1024x768 'Jimmy Neutron' window. Initial captures were uniform white. Debug logs
|
||||
show Wine DirectDraw/Direct3D initialization failing to find a suitable GL pixel
|
||||
format, then failing to allocate a 3D-capable surface (0x8876086a). These captures
|
||||
are **not usable gameplay references**. Original timing, startup, cutscene,
|
||||
lighting, camera, collision and audio have therefore not yet been compared.
|
||||
The wrapper records screenshots, Wine/Xvfb logs, window tree and isolated process
|
||||
list, all locally under artifacts/reference. An alternate Wine Vulkan backend is
|
||||
also tested with `--wine-renderer vulkan --output artifacts/reference-vulkan`.
|
||||
It created a Vulkan device/window but logged unsupported fixed-function states
|
||||
and a requested swapchain image count1 outside the driver's supported3..16 range.
|
||||
Those frames are also unusable. Failures must not be treated as original behavior.
|
||||
|
||||
No native Windows installation/VM or Windows 98 image was available in the initial
|
||||
environment/tool inventory. A local reference machine remains necessary if Wine
|
||||
cannot render correctly. Native Windows port execution remains separately untested.
|
||||
@@ -0,0 +1,46 @@
|
||||
# Current Vulkan rendering and evidence
|
||||
|
||||
Original API and state maps: `analysis/graphics.md`. Mesh/material/texture formats:
|
||||
`file-formats.md`. Vulkan code: `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`.
|
||||
|
||||
Default prepared LV1B view uses the GAM STARTEXP camera; positive-Z projection
|
||||
uses recovered FOV `0xAAA/16384*360` degrees, near 20, far 10000. Generic engine
|
||||
far default is 3200; other scene-specific overrides remain to be mapped. Camera
|
||||
target offset (0,80,0) is recovered, but startup look-at and follow interpolation
|
||||
have not been dynamically compared. Vulkan viewport Y is handled in projection.
|
||||
|
||||
World OMT coordinates and per-corner UVs are unchanged. ASE conversion (x,z,y)
|
||||
and (u,-v) is verified using duplicate gate/yokianpart assets; no invented light
|
||||
is applied to Jimmy. The original normal texture is jimycarl.png (InitObject
|
||||
0x422C96), while jimyshock.png is texture slot 1, a separate effect (0x422CA7).
|
||||
The normal atlas and scene/player captures have been visually inspected locally.
|
||||
|
||||
## Null-material visibility correction
|
||||
|
||||
LV1B references material 18 from 45 draw ranges but that material does not exist
|
||||
in its original resource index. Names include phoneblock, blockfan and Box/Plane
|
||||
objects. Rendering them with white fallback surfaces incorrectly obscured the
|
||||
actual lab. Disassembly of OMT2.dll DX draw_shape at `0x1003756C` loads the
|
||||
polygon material pointer, tests it at `0x1003756F`, and jumps directly to polygon
|
||||
advance at `0x10037A7F` when null. Therefore the modern scene loader retains this
|
||||
geometry but excludes unresolved-material draw ranges, matching the original
|
||||
render path. It does not assign collision semantics solely from names.
|
||||
|
||||
The original also tests in-memory polygon flag 4 (0x10037577). For v2 resources,
|
||||
the first serialized bool sets flag 2 at 0x10003F83 (DX disables culling for that
|
||||
bit at 0x10037731); the second bool sets flag 1 at 0x10003F9B. Other legacy
|
||||
fields and per-material pipeline states still need full mapping.
|
||||
|
||||
## Animation preview
|
||||
|
||||
MorphAnimation reads prepared base topology/UV and sample vertex positions, with
|
||||
linear interpolation following DLL 0x10002F9A. It can append a player draw with
|
||||
independent texture to original scene geometry and updates the mapped coherent
|
||||
vertex buffer after synchronous frame completion. Source frame sample timing is
|
||||
used for preview. Loop closure, state selection, state-specific playback speed,
|
||||
normal interpolation, clothing variants and gameplay pose transforms remain
|
||||
unverified. This is not a complete animation/gameplay reconstruction.
|
||||
|
||||
GPU readback evidence: `artifacts/test-level1b.ppm`, `artifacts/test-player.ppm`,
|
||||
`artifacts/jimmy-normal.ppm`, `artifacts/resize-input.ppm` (generated/ignored).
|
||||
No original reference image equivalence or pixel-perfect claim is made.
|
||||
@@ -19,7 +19,11 @@ C3DJimmy update 0x424600, input 0x426030; player input 0x438A60, walking branch
|
||||
0x438BC0. Player defaults ctor region 0x4372A0 sets acceleration 30, deceleration
|
||||
35, maximum speed 600; increments occur per simulation invocation, while movement
|
||||
uses elapsed time. A future simulation must recover update cadence before calling
|
||||
these coefficients timestep-independent. Jump/gravity values remain provisional.
|
||||
these coefficients timestep-independent. Gravity and jump have since been
|
||||
resolved: game setup 0x44D414 sets gravity Y=-800; jump branch 0x4383B3 queues
|
||||
Y=550 impulse, consumed/cleared at 0x479EBB..0x479EF2. Semi-implicit free-motion
|
||||
fragment implemented in Game/RecoveredMotion.cs and regression tested; collision
|
||||
and activation gating remain unresolved. See analysis/gameplay.md.
|
||||
|
||||
## Unresolved
|
||||
|
||||
|
||||
+59
-26
@@ -1,30 +1,63 @@
|
||||
# Tasks
|
||||
|
||||
## Completed
|
||||
- [x] Full specification read; original inventory, hashes and local Git established.
|
||||
- [x] Capabilities/tool reconnaissance; independent investigators with file ownership.
|
||||
- [x] Executable format and engine identification.
|
||||
- [x] Decode/round-trip all 35 GAM files; reader corruption and original-data tests.
|
||||
- [x] Implement C# GAM asset reader (compilation/runtime checks pending).
|
||||
## Completed milestones
|
||||
|
||||
## Active
|
||||
- [ ] Complete binary/graphics report with addresses, rendering state and camera.
|
||||
- [ ] Recover player timing, movement, gravity, collision and input algorithms.
|
||||
- [ ] Extract OMT meshes, textures, materials, animations, sound and music robustly.
|
||||
- [ ] Verify asset schema and integration into native Vulkan renderer.
|
||||
- [ ] Compile .NET 10 runtime and verify real offscreen rendering/readback.
|
||||
- [ ] Integrate SDL3 window/input/audio; exercise local display where possible.
|
||||
- [ ] Local Linux and Windows self-contained builds and dependency packaging.
|
||||
- [ ] Test original preservation after tools; checkpoint stable work locally.
|
||||
- [x] Entire specification; original inventory/hashes; local-only Git and guidance.
|
||||
- [x] Binary/compiler/API identification and address-based reports.
|
||||
- [x] All GAM entities decoded and byte-round-tripped; C# corpus reader tested.
|
||||
- [x] All indexed OMT meshes/materials/textures/RIFF resources decoded and audited.
|
||||
- [x] ASE transform/morph-base UV/topology recovery and regression tests.
|
||||
- [x] .NET10 + SDL3 + Vulkan1.3 shared source; real scene/model/texture rendering.
|
||||
- [x] Original LV1B lab plus original Jimmy morph preview at GAM startpoint.
|
||||
- [x] Correct normal atlas and null-material visibility from binary evidence.
|
||||
- [x] Recovered impulse/gravity/speed/RNG arithmetic fragments with tests.
|
||||
- [x] Native Linux Vulkan offscreen and SDL3 window/input/resize verification.
|
||||
- [x] SDL3 recovered WAV stream consumption test (dummy device).
|
||||
- [x] Self-contained Linux and Windows local packages, matching SDL3 libraries.
|
||||
- [x] Packaged Linux runtime isolated from SDK/source/originals; renders successfully.
|
||||
- [x] Isolated copied-original Wine attempts; actual failures documented.
|
||||
|
||||
## Required after foundation
|
||||
- [ ] Run original in isolated copied-data Wine prefix or local Windows VM.
|
||||
- [ ] Capture original startup, controls, camera, animation, audio and gameplay.
|
||||
- [ ] Reconstruct LV1B opening sequence and one complete playable scene.
|
||||
- [ ] Implement/verify collision, interactions, trigger/task system and progression.
|
||||
- [ ] Implement original animation playback and correct rendering states.
|
||||
- [ ] Implement menus, inventory, gadgets, combat/AI and all remaining scenes.
|
||||
- [ ] Recover save/load behavior, configuration, audio mixing and transitions.
|
||||
- [ ] Compare reconstruction to original references; resolve fidelity differences.
|
||||
- [ ] Run native Windows tests; distinguish cross-publishing from runtime evidence.
|
||||
- [ ] Produce verified local release packages and accurate known limitations.
|
||||
## Next implementation priorities
|
||||
|
||||
1. Recover full player physics/collision and controller before calling any preview
|
||||
playable. Trace `0x479D20` past displacement integration, shared collision call
|
||||
via interface slot0x130 in `0x462520`, and object collision caches. Retain
|
||||
invisible/null-material geometry; its exact collision masks remain unresolved.
|
||||
2. Finish airborne state table at `0x437F90` (jump at `0x4383B3`, extra acceleration
|
||||
`0x438148`, held predicate `0x42A730`, mode dispatch `0x437A8C`). Gravity is -800,
|
||||
queued impulse550, but normal jump states add gravity*1.33-gravity; avoid the
|
||||
incomplete '-800 only' jump model. Map landing, retrigger and jetpack gates.
|
||||
3. Finish walking friction/input/cadence: `0x438BC0`, `0x437C40`, destination yaw
|
||||
`0x472660`, yaw interpolation `0x43A430`. Resolve mixed per-call acceleration
|
||||
with timed integration; rendering refresh rate must not accelerate movement.
|
||||
4. Execute LV1B STARTEXP/LABEXP intro. GAM parsing supplies records; implement task
|
||||
prerequisites, object activation/visibility, camera triggers and progression
|
||||
from code/observations. Then build a complete small scene (VR01 if useful).
|
||||
5. Recover original morph state selection, playback speed, smooth normals and
|
||||
transitions. Current interpolation is original; loop/speed are preview policy.
|
||||
6. Continue material/fog/light/blend/culling and render sorting mapping, then
|
||||
compare visuals to original; current unlit modulation is only a foundation.
|
||||
|
||||
## Required validation and expansion
|
||||
|
||||
- [ ] Usable original reference captures under local Windows/VM or working Wine.
|
||||
- [ ] Original walking/jump/collision/camera/input comparisons and first complete scene.
|
||||
- [ ] Physical audio output and original SFX/music timing, mixing/panning/positional audio.
|
||||
- [ ] Fullscreen, minimized-window, mouse/relative capture, display scaling and controller behavior.
|
||||
- [ ] Pickups, score/health, gadgets/inventory, combat/AI, all levels and transitions.
|
||||
- [ ] Original menus, cutscenes, dialogue/voice and state-dependent rendering.
|
||||
- [ ] Save/load schema and configuration persistence; NewGame reference is not save support.
|
||||
- [ ] Native Windows execution/input/audio/resize/driver testing (cross-build already passes).
|
||||
- [ ] Fidelity regression references, remaining discrepancies and actual release candidate.
|
||||
|
||||
## Repeatable commands
|
||||
|
||||
- `source scripts/env.sh; dotnet build`
|
||||
- `scripts/test.sh` (20 Python tests, C# checks, native offscreen/audio, original hashes)
|
||||
- `python3 tools/extractors/audit.py ../Original --report artifacts/extracted/audit.json`
|
||||
- `NEUTRON_WINDOW_TEST=1 scripts/test.sh` with DISPLAY for input/resize smoke
|
||||
- `scripts/package.sh` for local investigation packages (not a finished game release)
|
||||
|
||||
Keep runtime, tests and docs coherent. No remotes/uploads/cloud CI. Do not modify
|
||||
originals or claim unobserved fidelity. All prior agent ownership has returned to
|
||||
primary; use explicit file ownership if further parallel work is started.
|
||||
Reference in new issue
Block a user