Expand debug system pages and add noclip exploration
This commit is contained in:
1 parent
b915a2c2e4
commit
d7838980fd
20 files changed
+628
-47
No files matched your search
@@ -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
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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
|
||||
|
||||
@@ -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.**
|
||||
|
||||
Reference in new issue
Block a user