Expand debug system pages and add noclip exploration

This commit is contained in:
UnixNight committed 2026-10-25 20:34:27 -04:00
1 parent b915a2c2e4
commit d7838980fd
20 files changed
+628 -47

No files matched your search

+10
View File
@@ -3,6 +3,16 @@
Compilation, native runtime, original behavior and full feature completion are
separate evidence categories. **The game is not fully reconstructed/playable yet.**
Debug expansion (2026-10-25): full scripts/test.sh passes, with70 Python checks,
21 movement groups, debug page/overlay groups, real SDL dummy pause/mute timing,
remaining managed/GPU routes and539 unchanged original hashes. Native Linux
GTX1070 at1920x1080 passes F1/Tab/F3, flight during a source cutscene, input capture,
camera/audio controls, checkpoint save/load and same-window rebuild. Enabled Vulkan
validation reports zero errors. Headless Player1920x1080 and Systems2560x1080
screenshots fit; see artifacts/debug-expansion/. SDL_SetAudioStreamGain is present
in the packaged Windows SDL3 DLL export table. Cross-build/export evidence does
not add native Windows runtime or original-game behavior verification.
Latest implementation continuation: controlled player phase ordering, route static
camera query and PostLoad gadget availability pass the full `scripts/test.sh`.
Evidence: artifacts/implementation/integration-final.log;70 Python regressions,
+70 -2
View File
@@ -9,8 +9,10 @@ audio. Closing resumes the previous mode. No new assets or dependencies are need
| --- | --- |
| F1 | Open/close |
| F2 | Toggle live diagnostics without pausing |
| F3 | Toggle noclip |
| Tab | Cycle General, Player and Systems pages |
| Up/Down | Select a row |
| Left/Right | Change selected level, startpoint or staged SCENE task value |
| Left/Right | Change selected level, startpoint, staged SCENE, flight speed or jetpack state |
| Page Up/Down | Change staged SCENE value by10 |
| Enter / numpad Enter | Apply the selected action |
| Escape | Close the menu |
@@ -22,6 +24,63 @@ the existing task system and its callbacks. Inventory/energy/task actions affect
current runtime state and its normal checkpoint snapshots; they do not write files
by themselves. Debug tools do not imply reconstructed progression or full gameplay.
## Player and Systems pages
The General page retains the existing actions. Player adds noclip, staged flight
speeds300/600/1200/2400 (Enter applies), clear motion/queued jump, reopen objective,
return to noclip entry, apply source level gadget availability, toggle input after
player, staged jetpack states0/1/4 with a separate Apply row, and energy refill.
State0 means unowned,1 enabled and4 disabled by the level. These controls expose
the current implementation; they are not proof of complete original behavior.
Systems adds the route static camera query toggle, independent music/speech/effects
mutes, restart selected music, stop all effects/loops, checkpoint save/load and the
practice prompt. Camera query control is available on LV1B/VR04/LEV1; elsewhere
it reports unavailable. Audio actions require scene audio (not headless/--mute).
Muting sets stream gain while playback clocks continue; new streams inherit mute.
F1 still pauses all stream clocks. Audio mute preferences reset with the scene.
Input-order override is for comparison; a new scene restores the continuation policy.
The practice action opens the existing prompt and closes F1.
Player diagnostics include velocity, pending impulse, movement mode/input order,
jump/hold/burst timers, jetpack state and objective time. Systems shows camera
polygon/query counts, category mute flags and queued audio bytes. Staged values
are separate from live values. `--debug-page general|player|systems` opens a page.
## Noclip (F3)
A modern investigation mode, enabled from F3 or Player/Noclip (`--noclip` at startup).
W/S or Up/Down move forward/back; A/D strafe; Left/Right turn. Space/E rises,
Ctrl/Q descends, Shift triples speed. Diagonal motion is normalized. Release stops
flight immediately. Gravity, body collision, camera obstruction, jetpack consumption
and contact-triggered script/pickup/mechanism/level actions are bypassed. Script,
actor and mechanism clocks still run; unrelated scripted transitions can still occur.
Flight uses the player camera during cutscenes without changing authored control
ownership. Space rises without skipping a cutscene while flying; Escape keeps its
normal skip action. F1 pauses flight. Toggle boundaries clear queued motion and
capture held input until release, so Space/Shift cannot become a jump on exit.
Reset and level changes clear noclip; it is never written into TSK saves.
Enabling remembers position/yaw. Return Noclip Entry restores them and clears
motion. Disabling retains the new position if the current static capsule adapter
accepts it, otherwise returns to entry. This checks static triangle proximity, not
full solid containment or moving objects; use Return Entry or reset if needed.
Normal gravity/collision resumes when disabled.
## Debug checkpoint
Save writes `debug-checkpoint.tsk` beside the executable using the existing original
TSK encoder and a temporary file replacement. It captures tasks, items, energy,
score, level/start and the existing RETURN departure vector; it does **not** capture
live Jimmy position, cutscene time, physics or debug preferences. Save errors appear
in the menu. Load validates the available prepared scene/start/support and uses the
normal scene rebuild, preserving the application window and renderer. Authored
start actions run normally. A load/reset clears force-control and noclip.
These are explicitly requested modern tools, a scoped exception to the gameplay
feature pause; no original debug-menu or noclip algorithm is claimed.
Force Control toggles a persistent debug override. Set it to TRUE and close the
menu to let Jimmy move even while a cutscene or scripted control lock is active.
Subsequent camera shots cannot clear the override. The cutscene, camera and audio
@@ -72,7 +131,7 @@ without changing their pause state. Visibility persists through resets and scene
loads within the process; it is not stored in TSK. `--debug-overlay` starts enabled.
Twelve bounded rows show measured FPS/frame milliseconds; level/start; root XYZ;
velocity XYZ; yaw/speed/turn rate; ground/pose/energy; control/force/pause; SCENE/
velocity XYZ; yaw/speed/turn rate; ground/pose/energy; control/force/pause/noclip; SCENE/
score/jetpack state and burst timer; actual camera mode/far plane; cutscene/shot/
blocked state; movement counters; and reported issue/Vulkan-error/frame counts.
STRT, orbit, gameplay and cutscene modes use the actual rendered view selection;
@@ -110,3 +169,12 @@ Windows verification. Full regression and package status is in progress.md.
Debug text scales uniformly with resolution. F1 uses a centered authored canvas
on widescreen; F2 stays top-left. The window/device survive level changes. See
presentation-and-ui.md for lifecycle, ultrawide and high-DPI pointer checks.
Expansion verification (2026-10-25): full `scripts/test.sh` passes, including70
Python checks,21 movement groups, debug pages and real SDL dummy pause/mute clocks;
539 originals remain unchanged. Native Linux GTX1070 at1920x1080 passes
`--smoke-debug-tools`: F1/Tab, cutscene flight without force-control, F3 repeats,
held-input capture, camera/audio actions, TSK save/load and retained window.
Validation enabled, zero errors. Headless Player1920x1080 and Systems2560x1080
captures fit the existing uniform canvas. Logs/captures: artifacts/debug-expansion/.
No new native Windows runtime verification is claimed.
+10
View File
@@ -128,3 +128,13 @@
group0 gadgets4→1, then disables owned1→4 in VR01..08. Preserve unknown states,
item8 and group1. This is availability, not acquisition or save normalization;
snapshots/constructors retain raw wire data. VR04's source jetpack bypass remains.
28. **Expose implemented systems through modern debug tools.** The user explicitly
requests expansion and noclip during the gameplay feature pause. Preserve
General-page controls; add Player/Systems pages and F3 flight. Keep authored
control ownership separate from flight and bypass player contact triggers.
Clear pending motion/held input at toggles, retain an entry escape position,
and reset transient overrides on scene rebuild. Mute by stream gain so clocks
continue. Debug checkpoint uses the existing TSK/start progression contract,
never pretends to save live physics/cutscene state. These are investigation
features with port verification, not recovered original behavior.
+19
View File
@@ -1,5 +1,24 @@
# Progress — 2026-10-25
## Requested debug expansion
F1 now has General/Player/Systems pages (Tab), preserving existing General actions.
Added F3 noclip with vertical/strafe/boost controls, entry restoration and static
exit-overlap fallback; queued motion and held inputs clear at toggles. Flight
bypasses collision/camera obstruction and contacts without changing script control
ownership. Added movement/input-order/availability, objective/practice, camera
query, category audio mutes and original-format checkpoint actions/diagnostics.
Mutes use SDL stream gain so playback clocks continue. Scene/reset lifetimes and
checkpoint limits are documented in debug-menu.md. This user-requested debug work
is a scoped exception; evidence-led gameplay continuation remains the direction.
Full scripts/test.sh passes:70 Python,21 movement groups, remaining managed/GPU/
SDL checks and539 unchanged originals. Native Linux GTX1070 debug-tools smoke
passes at1920x1080 with zero enabled Vulkan validation errors, including flight
during a source cutscene without force control and same-window checkpoint reload.
Widescreen/ultrawide captures fit. Logs: artifacts/debug-expansion/. Windows SDL3
exports the gain API; native Windows runtime remains unverified for these changes.
## Evidence-led implementation continuation
Old level-game removal is resolved by `checkpoint/level-game-lifetime.md`: class
+4
View File
@@ -40,6 +40,10 @@ compile, runtime and original-fidelity verification are separate.
- [x] Uniform widescreen game/debug UI with anchors and matched native pointer
mapping, strict boundaries and high-DPI rounding checks.
- [x] Requested F1 General/Player/Systems pages, F3 noclip with cutscene flight,
motion/input capture, entry restoration, movement/camera/audio/UI/TSK controls;
full suite plus native Linux1920x1080 SDL regression pass. See debug-menu.md.
## Immediate continuation
**Direction changed: pause feature expansion for the architecture checkpoint.**