Correct preview ground placement and expose original animation clips

This commit is contained in:
UnixNight committed 2026-10-23 18:12:54 -04:00
1 parent 670adb4795
commit 37fa18094f
22 files changed
+398 -33

No files matched your search

+4 -1
View File
@@ -39,7 +39,7 @@ Preparation produces ignored local files below `artifacts/extracted/`:
- `VR01/scene.json`: 240 expanded vertices, 80 triangles, 7 textures.
- Texture `.rgba` files plus PNG previews, preserving material ID links.
- `sounds/`, `musicjimmyshouse/`, `musicneighborhood/`: exact embedded WAV bytes.
- `animations/{jimstop,jimrun,jimjump}/`: original morph samples and manifests.
- `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:
@@ -103,6 +103,9 @@ 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
+7
View File
@@ -35,6 +35,13 @@ 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.
Application/PreviewCharacterPlacement and PreviewAnimationLibrary keep inspection
policies separate from gameplay fragments. Ground contact is a model-only offset
derived once from visible surfaces and the standing bind pose, with raw source
placement preserved. Clip selection displays actual still/moving state and does
not simulate walking/jumping actions. These policies need replacement/integration
as original controller, actor transforms and state behavior are recovered.
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.
+5 -2
View File
@@ -10,12 +10,15 @@ separate evidence categories. **The game is not fully reconstructed/playable yet
| 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 |
| Windows x64 publish | Pass | Correct PE32+ app and SDL3.dll; initial native rendering user-reported |
| Windows package under Wine64 | Preliminary headless pass | Two frames, exit0; fixed-time readback identical to Linux on lavapipe; validation disabled |
| Corrected Windows preview under Wine64 | Preliminary window pass | Six frames, key2 animation switch, resize800x600, exit0; validation disabled |
| 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 |
| Standing preview placement | Corrected / Linux tested | +38.503Y from actual visible floor/base soles; exact original actor transform unresolved |
| Idle/run/jump/scratch preview | Linux keyboard + GPU tests | Default idle samples identical; 1/2/3/4 select clips; run image changes across frames |
| 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 |
@@ -26,7 +29,7 @@ separate evidence categories. **The game is not fully reconstructed/playable yet
| 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 |
| Native Windows functionality | Partially user-reported | Initial window/3D frame displayed; corrected build/input/audio/resize still unverified natively |
Generated evidence: artifacts/final-tests.log, test-level1b.ppm, test-player.ppm,
resize-input.ppm, package-linux.ppm, extracted/audit.json and reference*/ logs.
+7
View File
@@ -17,3 +17,10 @@
Shared runtime/format changes must be coordinated. No external coordination.
7. **Honest compatibility.** Build, headless Vulkan frame, SDL presentation,
gameplay fidelity and native Windows execution are separate evidence categories.
8. **Preview ground contact and idle clarity.** User testing exposed floor overlap
and a misleading animated-default description. Original idle vertices are
identical; do not invent idle motion. Expose moving source clips explicitly.
Until original actor transforms/collision settling are recovered, apply one
model-only floor correction derived from standing soles and visible geometry,
with explicit preview labeling and regression tests. Preserve GAM/ASE data and
per-frame morph displacement; this is not the original collision algorithm.
+10 -4
View File
@@ -43,12 +43,15 @@ animation state/render sorting are incomplete. See rendering.md for evidence.
- 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.
- Linux/Windows self-contained cross-publishing succeeds. Initial Windows rendering
is user-reported; broader native functionality remains unverified. Wine reference
testing is a separate investigation path.
- Preliminary Windows-package Wine64 check: standalone .NET10 executable rendered
two frames, exit0, with byte-identical PPM to Linux on the same software driver.
Validation was disabled for this Wine test; SDL window/input/audio and native
Windows drivers remain untested. See reference-testing.md for exact scope.
- Corrected Windows preview also passes a six-frame Wine64 window/input/animation
selection/resize smoke (validation disabled). Native Windows retest is pending.
## Scope limits
@@ -56,10 +59,13 @@ 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.
an animation inspection preview; default idle samples are identical. Keys1/2/3/4
select original clips. Preview floor correction is separate from original physics;
its transform and 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.
platform prerequisites. Initial native Windows rendering is user-reported; the
corrected preview and broader native Windows functionality remain unverified.
+26 -2
View File
@@ -4,6 +4,30 @@
asset recovery toolchain and a native original-scene/animation investigation
runtime with local Linux/Windows packages. No completed playable-scene claim.
## Latest user-reported preview fix
The user ran the Windows build and observed a static Jimmy partially inside the
lab floor. This verifies initial Windows startup/rendering by user report, with
OS/GPU/version/input/audio details unspecified. Updated native Windows testing
remains pending.
Both issues were reproduced from actual assets: jimstop has two byte-identical
vertex poses, and its minimum local Y=-64.6165 plus GAM Y=26.6619 places the soles
at -37.9546 while the original visible floor is near Y=0.5486. Calling the default
an animated idle was inaccurate. The idle stays faithful to its still source pose;
1/2/3/4 now explicitly select idle/run/jump/scratch previews and the window title
states the mode/controls. A source-data-based preview correction of +38.503 Y
places the standing model on visible floor triangles, leaving GAM data unchanged.
This is an explicit preview policy, not the recovered game collision solver.
Tests verify real lab grounding, ceiling/invisible-proxy rejection, still idle and
moving clips, automatic animation advance in actual GPU readbacks, and SDL keyboard
switching to a run cycle. Khronos validation reports zero errors on llvmpipe and
GTX1070. Source assets remain unchanged. See rendering.md for evidence/scope.
The rebuilt Windows package additionally passed an isolated Wine64 window test:
six frames, animation key2 selected moving source samples, resize800x600, exit0.
Validation was disabled in that Wine test; corrected native Windows retest is pending.
## Verified
- Full `../prompt.MD` specification read; originals preserved and local Git initialized.
@@ -30,10 +54,10 @@ runtime with local Linux/Windows packages. No completed playable-scene claim.
- 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.
directory mounted. Initial Windows rendering is now user-reported as noted above.
- Windows x64 package also renders two headless frames under isolated Wine64,
exit0, without source/SDK/originals mounted. Its fixed-time PPM is byte-identical
to the Linux package on the same lavapipe driver. Native Windows remains untested;
to the Linux package on the same lavapipe driver (checkpoint670adb4). Broader native Windows remains untested;
Wine test did not enable validation or exercise SDL window/audio/input.
- Official Wine11 original-copy runs attempted in isolated filesystem/network
namespaces. Both GL and Vulkan backends produce unusable frames; details below.
+9 -1
View File
@@ -50,7 +50,7 @@ resources and rendered two offscreen frames through lavapipe, exiting0. This tes
disabled Vulkan validation and **does not** establish Windows-driver validation,
SDL window/audio/input functionality or native Windows compatibility.
At fixed morph time0.05, its PPM GPU readback is byte-identical to the native Linux
At checkpoint670adb4 and fixed morph time0.05, its PPM GPU readback was byte-identical to the native Linux
package readback (SHA-256 `c30bcbc95d00ce104b146cc46c84e9a9d50849bf0b0bf33c027a402bb46e47c4`).
Both use the same software Vulkan driver. This establishes consistency between
those two package executions, not fidelity to the original game.
@@ -59,3 +59,11 @@ An initial harness configuration disabled mscoree for the legacy game and thereb
prevented Wine from loading the port's IL-only System.Runtime.dll. Port mode now
uses Wine's built-in mscoree, correcting the test environment; no app workaround
or Mono runtime is required. Logs/readback are in artifacts/windows-smoke/.
After the user-reported floor/idle issue, the rebuilt Windows package also passed
`python3 tools/recon/reference_capture.py --port-window --seconds 12`: six windowed
frames, preview correction+38.503Y, injected key2 switched to Run cycle, and
960x720->800x600 resize succeeded, exit0. This Wine test disabled validation; Linux
tests separately enabled Khronos validation and reported zero errors. The latest
artifacts/windows-smoke contains that updated window test, superseding the earlier
headless capture. Native Windows retesting is still pending.
+43
View File
@@ -44,3 +44,46 @@ 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.
## Standing preview floor overlap and static idle
User report: Windows displays Jimmy partly inside the floor and no apparent motion.
The default jimstop source samples (TIMEVALUE0/480) contain identical vertex
positions. The earlier description of an animated default was incorrect. They
remain a still idle pose; explicit keys1/2/3/4 select idle/run/jump/scratch previews,
with clip identity and controls shown in the SDL window title. Playback is an
inspection feature; movement/controller/state-machine gameplay is still missing.
The original standing base minimum Y is -64.6165. Simply adding GAM STARTEXP Y
26.6619 puts the lowest soles at -37.9546, below the visible lab floor near0.5486.
The previous screenshot review missed that intersection. PreviewCharacterPlacement
now derives one upward model-only offset from standing-base vertices and visible
floor triangles beneath the original root. It excludes overhead/steep surfaces and
unrendered proxies. The original GAM root, raw ASE vertices, scale, camera and
animation deformation remain unchanged. The resulting LV1B correction is +38.503Y.
This is a documented preview placement policy pending original actor transform and
collision settling recovery; it is not evidence that the original game uses it.
It is computed once from the standing base, so animated jumps are not resnapped
to the floor on every frame.
C# regressions cover the actual lab, flat-floor contact, ceilings, excluded proxy
draws, missing floors and clip selection. Native GPU run captures at0 and0.1 seconds
differ; a seven-frame automatic advance matches the fixed0.1-second capture byte
for byte. SDL6-frame smoke switches to Run cycle by injected key2 and resizes,
with zero validation errors. Generated evidence: artifacts/placement-*.ppm and
placement-tests.log. Native Windows user retesting of this update remains pending.
Read-only original-DLL probe: tools/binary/omt_shape_probe.c, built with local
i686-w64-mingw32-gcc, calls the supplied OMT ASE converter in a copied installation
inside the reference sandbox. In non-animation conversion mode0 it emits426
vertices and identical base coordinate bounds, confirming the raw data diagnosis
for that mode. The game uses conversion mode2, so the probe does not establish
the original actor origin/scale. Reproduce:
```sh
i686-w64-mingw32-gcc -O0 tools/binary/omt_shape_probe.c -o artifacts/binary/omt_shape_probe.exe -static-libgcc
python3 tools/recon/reference_capture.py --asset-probe --seconds 12
```
Output is under artifacts/asset-probe; no original directory is mounted/writable
in the probe namespace. The converter operates only on copied bytes/in-memory objects.
+5 -1
View File
@@ -17,6 +17,8 @@
- [x] Packaged Linux runtime isolated from SDK/source/originals; renders successfully.
- [x] Preliminary Wine64 Windows-package render; exact fixed-time readback matches Linux.
- [x] Isolated copied-original Wine attempts; actual failures documented.
- [x] Correct preview floor overlap, identify still idle, add explicit animation inspection controls/tests.
- [ ] Retest corrected Windows build natively; initial rendering is user-reported.
## Next implementation priorities
@@ -24,6 +26,8 @@
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.
Recover original actor/model pivot, scale and spawn settling: the preview now
uses a floor-derived model offset, which must be replaced with proven behavior.
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
@@ -48,7 +52,7 @@
- [ ] 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).
- [ ] Full native Windows input/audio/resize/driver testing (initial rendering is user-reported).
- [ ] Fidelity regression references, remaining discrepancies and actual release candidate.
## Repeatable commands