Add persistent force-control toggle to F1 debug menu

This commit is contained in:
UnixNight committed 2026-10-25 02:00:55 -04:00
1 parent 3078b8afd0
commit 20aa1bc2b9
13 files changed
+96 -12

No files matched your search

+6
View File
@@ -156,3 +156,9 @@ all composers still update the final mesh and the renderer uploads the changed
vertices even in static inspection. F1 owns input before practice/gameplay, pauses
simulation and all audio streams, resets the clock at both boundaries and retains
captured keys until release. Audio streams created during pause inherit that state.
SceneDirector keeps authored controlledTag separate from DebugForceControl.
Effective control/tag queries expose Jimmy while forced; source shot assignments
still update the authored tag. DEFAULT uses authored ownership for its music
handoff. Disabling force reveals current script state; Begin clears the override.
The debug flag is never serialized into original saves.
+1
View File
@@ -24,6 +24,7 @@ separate evidence categories. **The game is not fully reconstructed/playable yet
| SDL3 presentation/input | Linux Xvfb + GTX1070 | Six frames; injected keyboard event received |
| Swapchain resize | Linux tested | 960x720 ->800x600, zero validation errors |
| F1 debug menu | Managed/SDL audio tests + native Linux GTX1070 window pass |Pause/actions/input capture/resume/800x600 resize, zero validation errors;33 prepared scene/start choices; intentional modern tools, no new Windows runtime claim |
| F1 Force Control | Menu/director/interaction checks + native Linux SDL pass |Persistent override through source shots; disable/reset restores normal ownership; actual movement with neutron1a active, zero Vulkan errors; music handoff regression passes |
| 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 |
+10
View File
@@ -21,6 +21,13 @@ 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.
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
continue normally; Skip Current Cutscene remains available separately. Toggling
back to FALSE exposes the current scripted ownership. Reset or loading another
scene clears the override; it is not written into original TSK saves.
The level picker offers only supplied GAMs with prepared geometry, a player and
original STRT records. It currently offers33 scenes; Level3B/E are absent because
their registered geometry is unavailable. No substitute geometry is supplied.
@@ -51,6 +58,9 @@ uses actual SDL dummy-device queues to verify freeze/resume for all stream types
`--debug-menu` opens the menu immediately, including headless captures.
`--smoke-debug-menu` runs a16-frame window test: open during a source MCA, pause,
skip/refill/grant/apply task, close with held/repeated input, resume and resize.
It also enables Force Control through the menu and verifies actual movement while
Carl's MCA is still playing. Director checks cover disabling the override, shot
changes, scene reset and the normal completion music handoff.
Native Linux GTX1070 window test passes with zero Vulkan validation errors:
artifacts/debug-window.log. GPU screenshots debug-menu.png and debug-window.open.ppm
+3
View File
@@ -84,3 +84,6 @@
and audio together, capture held input until release and stage SCENE edits until
Enter. Invoke existing source-state consumers for actions; offer only prepared
geometry and source startpoints. No debug behavior is attributed to the original.
Force Control is a persistent debug override over authored ownership, with
FALSE restoring the current scripted state. Reset/new scene clears it, and
source music handoff continues to use authored ownership.
+11
View File
@@ -6,6 +6,17 @@ jet pack tutorial flow. This is not a verified faithful complete scene or releas
## User-requested F1 debug menu
Follow-up: Force Control is now a persistent TRUE/FALSE menu toggle. It overrides
effective ownership while preserving authored control state; switching it off
restores that state. Reset/new scene clears it. Cutscene execution continues and
DEFAULT music restoration uses authored ownership, avoiding a debug-induced silent
return. Menu/director/interaction checks pass; the extended16-frame Linux SDL
test records actual forced movement during active neutron1a,14.00 total travel,
all menu checks true and zero Vulkan validation errors
(artifacts/force-control-window.log).539 original hashes remain unchanged.
Both executables are republished for this follow-up; no Windows runtime
check is claimed. The full-suite evidence below is from the preceding menu build.
F1 opens a modern debug overlay with live player/scene/task diagnostics. Keyboard
actions cover camera, cutscene skip, energy refill, jet-pack grant, staged SCENE
editing,33 prepared levels/original starts, reset and resume. Gameplay, cutscene
+2
View File
@@ -31,6 +31,8 @@ compile, runtime and original-fidelity verification are separate.
underground passage both ways from explicit riverlab/SCENE65 fixture.
- [x] User-requested F1 debug menu with diagnostics, paused audio/gameplay,
camera/cutscene/energy/jetpack/task/scene/start/reset controls and input capture.
- [x] Force Control TRUE/FALSE override in F1; persists through scripted shots,
restores authored ownership when disabled, clears on reset/new scene.
## Immediate continuation