285 lines
19 KiB
Markdown
285 lines
19 KiB
Markdown
# Tasks
|
||
|
||
Full-game completion remains the objective. Original files are authoritative;
|
||
compile, runtime and original-fidelity verification are separate.
|
||
|
||
## Integrated milestones
|
||
|
||
- [x] Inventory/hashes, binary/API identification, full GAM round-trip and OMT audit.
|
||
- [x] .NET10/SDL3/Vulkan1.3 shared native code and self-contained platform packages.
|
||
- [x] Original lab geometry, corrected Jimmy atlas, original morphs and inspection.
|
||
- [x] Walking/jumping/chase camera and source-triangle provisional collision.
|
||
- [x] Linux headless/window/input/resize/audio-stream checks; initial native Windows
|
||
rendering user-confirmed; preliminary Wine64 movement package checks.
|
||
- [x] Original TSK/task gates/checkpoint CLI and independent music/speech streams.
|
||
- [x]16-cue lab camera/speech/actions/control restoration and skip execution.
|
||
- [x] Source actor/sprite/model preparation,9 lab props and all33 available scenes.
|
||
- [x] B/E GAM correction: both supplied; missing registered OMT geometry is not an
|
||
established progression blocker. No substitution or extra-file request.
|
||
- [x] Lab jet pack/Carl/exit task route and objective/inventory/score effects.
|
||
- [x] Original objective/practice art, strict input regions, modal pause and VR04 entry.
|
||
- [x] Shared Goddard/Carl patrol subset and recovered body support with DLL checks.
|
||
- [x] Button/vertical-door behavior and source dynamic broadphase/box triangle rules.
|
||
- [x] Powered-jump state/effect/energy arithmetic, original FLY/fire morphs and GPU replay.
|
||
- [x] Correct mode1 input dispatch and source airborne steering for jumps/bursts;
|
||
Up acceleration, Down braking, Left/Right turn and powered travel regressions.
|
||
- [x] Carl conversation control lock, grounded air-turn reset, original level far
|
||
planes and timed objective/O behavior. Full suite passes; both packages rebuilt;
|
||
user verifies their own Windows build works. Detailed evidence: progress.md.
|
||
- [x] Source RETURN departure-root/TSK identity, player/companion restoration and
|
||
one-time STRT suppression; source NC-shape terrain exclusion; input-only
|
||
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.
|
||
- [x] F2 live diagnostics plus F1 visibility toggle; non-pausing compact overlay,
|
||
measured frame timing and session-owned visibility across scene rebuilds.
|
||
- [x] Application-owned window/Vulkan renderer across loads; bounded scene
|
||
replacement and native fullscreen/bounds/focus retention checks.
|
||
- [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
|
||
|
||
- [x] Bounded liveVR08 Grappler: shared body context/full base callback, follow
|
||
camera, original rope/SWING/cursor/audio, ownership/RETURN/retained scalars,
|
||
normal/debug selection.13 managed groups/40 Python checks and9-phase native
|
||
Linux SDL replay pass. See gameplay/grappler-live.md for evidence and limits.
|
||
- [ ] Native Windows and whole-originalVR08 comparison; shared dynamic pairs,
|
||
special policies/other levels and non-RETURN attachment continuity remain open.
|
||
- [ ] Next gadget: Scooter source wheel/support/contact contracts before live
|
||
implementation. Preserve parked general collision continuation.
|
||
|
||
Historical Grappler gates below were closed for boundedVR08 by this checkpoint;
|
||
component reports remain evidence, not current live status.
|
||
|
||
|
||
- [x] Grappler aim/root-Euler ray/first-hit material, normalized constraint and
|
||
post-base contact:42 additional original cases,72 total/10 managed/18 Python;
|
||
actualVR08 query and existing camera/Rocketship/GPU regressions pass.
|
||
- [x] Grappler live gates: carry shared sphere/contact context through attached
|
||
47B4B0 and43AA40; complete follow camera and rope/cursor presentation/lifetime,
|
||
then actualVR08 attach/reel/swing/detach/control-loss/RETURN. See grappler-query.md.
|
||
|
||
- [x] User-clarified orbit Left/Right inversion: reverse horizontal azimuth
|
||
mapping while preserving correct Up/Down and gameplay controls.
|
||
- [x] Grappler isolated attachment/reel/damping component:30 copied-original
|
||
observations,5 managed/14 Python checks plus25 movement/15 gadget groups pass.
|
||
- [x] Grappler next: complete retained REA/source findings from
|
||
artifacts/grappler-{ray,motion,resources}/, close body/camera/helper contracts
|
||
and compare original components before enabling boundedVR08. Investigators
|
||
reached usage limits; all file ownership returned to primary.
|
||
|
||
- [x] Correct orbit inspection's mirrored world: share gameplay handedness,
|
||
verify36 angle/elevation/aspect cases, GPU reflection and unchanged gameplay.
|
||
|
||
- [x] Correct user-reported Rocketship wall scaling: recover material RGBA
|
||
consumer, replace geometry deformation with red damage flash, regress actual
|
||
wall contact/per-vertex geometry/color through repeated impacts and expiry.
|
||
|
||
- [x] Live boundedVR02 Rocketship: source aircraft callbacks/support, owned actor
|
||
control, fresh/retained input order, maneuvers/camera, exact passenger/fire art,
|
||
engine audio, F1, cutscene/force-control/reset/noclip and distinct pickup/LOAD callers.
|
||
- [x]96 isolated original observations;14 flight/12 final integration groups;
|
||
native GTX1070/private Xvfb1920×1080 ten-phase SDL replay; full268 Python+2 HUD/
|
||
managed/33 GPU+17 material suite and539 unchanged original hashes.
|
||
- [x] Clean e77add5 Linux/Windows packages,18 resource files/four exact RGBA hashes;
|
||
standalone Linux ten-phase native replay and1920×1080 F1 Player-page readback.
|
||
- [ ] Rocketship outside VR02, special hazard/mission/RNG effects, general original
|
||
pair scheduling and full original/native Windows comparison. See live report.
|
||
|
||
- [x] User-requested F1→Player Give All Gadgets: grant all eight without selecting,
|
||
preserve other inventory, keep the32-line layout; debug-menu checks/build pass.
|
||
|
||
**Gadget component checkpoint2026-11-03:**
|
||
[Rocketship arithmetic/resources](gameplay/rocketship-component.md).
|
||
|
||
- [x] Use supplied decompiler leads with independent REA/source guards for
|
||
Rocketship owner/control/body dimensions, flight input/apply and VR02 filter.
|
||
- [x] Implement isolated keyboard/vertical components;13 managed groups compare
|
||
14 input+14 vertical copied-original observations and explicit boundaries.
|
||
- [x] Export exact Rocketship resources/VR02 records with5 checks; recover
|
||
Grappler attachment/material/swing/lifetime source with12 checks. Rocket source
|
||
3 checks, existing Gadget15/Movement25 and .NET10 build pass;539 hashes verify.
|
||
- [x] Close ordinary VR02 Rocketship callbacks, Euler/maneuver/camera and
|
||
owned/GAM reset/attachment gates; integrate actual art/audio, F1 and live control
|
||
with source RETURN/cutscene ownership regressions. General pair/lifetime remains bounded.
|
||
- [ ] Close Grappler ray/material context, attached dispatcher/camera/Euler and
|
||
helper lifetime before live mode7. No substitute hook/pull behavior.
|
||
|
||
Historical component-only claims are superseded for liveVR02 Rocketship.
|
||
Grappler scalar checkpoint is gameplay/grappler-component.md; it remains isolated.
|
||
|
||
**Supplied friend's decomp assessment completed2026-11-03.**
|
||
See [assessment](reviews/jn-engine-survey.md), independent gameplay/capture
|
||
reviews and the prepared local evidence request. No source import or gameplay
|
||
change. Same EXE/shared corpus, different declared OMT2.dll;208 class specs and
|
||
saved helper bodies are useful leads, prototype C gameplay is not authoritative.
|
||
For subsequent gadget work, cross-check target6's429D00/426A70 and Rocketship
|
||
report with local REA. Raw original traces, analysed Ghidra project, capture DLL
|
||
identity and offered code permission remain open; do not treat proposals as
|
||
delivered runtime evidence. Preserved port/release validation is unchanged.
|
||
|
||
**Current direction: user-requested gameplay gadgets; collision work parked.**
|
||
Preserve35a2a66 body implementation,0272f7b release notes and baseline69d0187.
|
||
Recover/implement original gadget selection/use with local REA and original art;
|
||
extend the existing shrink-ray/jetpack device first where source contracts permit.
|
||
Current investigations own named files in docs/gameplay/, with runtime integration
|
||
owned by primary. Remaining special/dynamic collision and camera gates below are
|
||
the resume backlog, not prerequisites imposed on this user-directed gadget work.
|
||
|
||
- [x] Recover original gadget group0 selection, mode/display separation, ownership,
|
||
practice destinations and exact UI resources with local REA evidence.
|
||
- [x] Implement widescreen gadget screen, strict pointer regions, Tab/Space latch,
|
||
selection/input capture and direct Practice entry.
|
||
- [x] Implement owned default ray, original quantized target heading/obstruction,
|
||
texture phases, half opacity and tested alpha/additive Vulkan materials.
|
||
- [x] Render actual VR04 soldiers with original WALK/SHRINK morph, source timer,
|
||
authored-mode restoration and persistent ordinary10-point score callback.
|
||
- [x] Managed/source/GPU checks and native Linux menu/ray input fixtures.
|
||
- [x] Rebuild clean7b5230c Linux/Windows gadget packages, verify54 canvases/new
|
||
manifests in both, and run standalone Linux menu/ray fixtures from /tmp.
|
||
- [x] Invisible source, timed activation/recharge/flash, original meter, companion
|
||
body/visibility and named-Jimmy cutscene cleanup; shared energy warning lifecycle.
|
||
- [x] Independent review,182 Python/15 Invisible managed groups, native Linux SDL
|
||
six-phase render at1920×1080; complete integration30 GPU+17 material checks pass.
|
||
- [x] Build clean1897dd2 Invisible Linux/Windows packages, check exact meter pixels
|
||
in both and standalone Linux six-phase/F1 widescreen renders from /tmp.
|
||
- [x] Recover Bubble visual/equip/drain/cleanup source contracts with REA/guards.
|
||
- [x] Recover Bubble movementmode2 input/apply, direct300/900 bounce, actualVR01
|
||
static/floor111 coverage and six copied-original body numeric references.
|
||
- [x] Implement original Canv1/effect/motion and boundedVR01 body/floor state;
|
||
13 integration/11 motion/8 visual groups and independent review pass.
|
||
- [x] Complete202 Python+2 HUD, managed,31 GPU+17 material and native1920×1080
|
||
SDL Bubble checks;539 original hashes unchanged.
|
||
- [x] Commit clean1ae5f42 Bubble milestone, rebuild Linux/Windows packages, verify
|
||
exact Canv1 pixels in both and standalone Linux gameplay/debug view from /tmp.
|
||
- [x] Recover Baseball equip/hold/release, owned20-slot pool, queued landing
|
||
impulse, exact original TIME font and VR07 moving-target/parent contracts.
|
||
- [x] Implement Baseball, original ball/aim rendering, F1 grant, bounded VR07
|
||
source body/targets, eleven integration/six visual groups; independent review.
|
||
- [x] Headless and native1920×1080 actual SDL aim/release/target-hit/respawn pass;
|
||
1010 extra complete player/target ticks are an explicit accelerated port fixture.
|
||
- [x] Complete232 Python+2 HUD/all managed/32 GPU+17 material regression; final
|
||
12-group Baseball callbacks and16 source groups pass;539 original hashes verify.
|
||
- [x] Clean d6ca417 Linux/Windows packages, all16 source canvas hashes in both,
|
||
standalone Linux eight-phase gameplay and widescreen F1 Player view from /tmp;
|
||
539 originals verify after packaging. Native Windows comparison remains open.
|
||
- [x] Save Scooter separate actor/mount/vehicle and original asset contracts;
|
||
wheel body/support lifecycle remains a gate before faithful live integration.
|
||
- [ ] Rocketship other-level/special consumers, Scooter, Remote and live Grappler; full enemy AI and
|
||
original/native Windows comparison. Retain collision/camera/retained-helper gates.
|
||
|
||
Details: [Baseball continuation](gameplay/baseball-implementation.md). Investigators
|
||
have returned all file ownership to primary. Complete final regression, native
|
||
Linux input and release checks pass; the remaining gadget effects are the next
|
||
gameplay backlog. Native Windows gadget verification remains open.
|
||
|
||
**Prior direction: architecture checkpoint and evidence-led implementation.**
|
||
Read `checkpoint/README.md`, `coverage.md` and `implementation-plan.md`. Preserved
|
||
baseline69d0187 remains the testing tool. The loop/motion, script/state and
|
||
camera/audio/UI investigations document the original lab→VR04→lab→outside route.
|
||
Complete core owner/order/lifetime evidence and unknowns, then execute the gated
|
||
plan in verified chunks. Earlier priorities below are a backlog.
|
||
|
||
- [x] Preserve clean playable source tag and independent Linux/Windows package copies.
|
||
- [x] Verify539 unchanged originals at checkpoint entry.
|
||
- [x] Recover frame-before-controller physics and construction-order registry passes.
|
||
- [x] Record core-system coverage, state ownership, assumptions and bounded plan.
|
||
- [x] Integrate independent reports/original-byte regressions; architecture exit review.
|
||
- [x] C1 objective-before-records order; managed and full integration checks pass.
|
||
- [x] C2 per-actor Carl override; full integration and route checks pass.
|
||
- [x] C3 input/frame/fresh construction, C5 grid predicate, C6 software voice clock
|
||
and C7 ordinary selective-loader evidence follow-ups.
|
||
- [x] Old level-game lifetime resolved: normal Init restores stored+11→live+139;
|
||
ordinary destructor explicitly unlinks its registry node.
|
||
- [x] Controlled player phase split and retained input order; delayed impulses,
|
||
stored movement mode and same-frame landing reset. Full-scene scheduler open.
|
||
- [x] Static first-hit camera adapter integrated for LV1B/VR04/LEV1 with shared
|
||
segment kernel and source hit weighting/gain. Full camera handoff/state open.
|
||
- [x] Source PostLoad gadget availability through tutorial/normal level entry.
|
||
- [x] Bounded retained mode/hold/fire route fixture through property/Init/PostLoad/
|
||
cleanup/control; authored/live body provenance and isolated original routines.
|
||
- [x] Full tutorial gadget re-enable tails and LV1B item1/7 restrictions; replaces
|
||
previous prefix-only availability. Other level tails/selection remain open.
|
||
- [x] Companion/shadow reset trace and equal-state AI guard; no blanket AI carry.
|
||
- [x] Bounded uncontrolled body/fire versus controlled movement, ordered CAM/MCA/
|
||
AI preparation, no repeated later-shot reset, held input restoration and authored
|
||
player-transform synchronization; managed/GPU/native Linux checks.
|
||
- [x] Local REA6.8.0/Ghidra12.1.4/full JDK21 launcher, selected native pseudocode
|
||
Evidence/snapshot export; client MCP configuration unchanged. See rea.md.
|
||
- [x] C4 bounded sphere/triangle kernel recovered with REA and isolated original
|
||
component references; explicit managed kernel and regressions added. Live adapter
|
||
replacement remains gated on traversal, callbacks, support and friction.
|
||
- [x] Root+150 upward query/bounce/mode1 cancellation traced and integrated for
|
||
the three route scenes, independently of raw control and camera debug switch.
|
||
- [x] Retained physical re-registration/repeated Init chain and shared camera-eye
|
||
handoff documented with byte guards and retained REA successes/provider gaps.
|
||
- [x] C4 static grid/retry dispatcher recovered and isolated managed component
|
||
compared against seven original fixtures; route material IDs and metadata gate.
|
||
- [x] Contact/landing/published-speed/friction contracts and actual special material
|
||
coverage recovered with REA. Ten isolated original body fixtures completed.
|
||
- [x] C4 ordinary body composition matches ten numeric references; VR04 uses the
|
||
recovered static subset with source radius/support/friction and published speed.
|
||
Twenty managed groups and native/headless powered-flight replays pass.
|
||
- [ ] Next: C4 original dynamic actor/pair eligibility and shared reclip context;
|
||
special160/164/FENCE/LADDER contact policies before lab/outside replacement;
|
||
full Jimmy/base wrapper/helper traversal and shared viewport/DEFAULT handoff.
|
||
Physical re-registration chain is recovered; full implementation/order remains.
|
||
C6 source channel allocation/
|
||
clock/banks remains separate. Fire's missing Ghidra procedure definition is an
|
||
analysis limitation; its immutable source-byte contract is already guarded.
|
||
|
||
1. Lab regressions are corrected and republished, with user verification of their
|
||
own Windows build. Keep comprehensive native Windows driver/audio/input
|
||
coverage separate from that report and preliminary Wine checks. Continue
|
||
original physics/audio/UI recovery and progression beyond the outside checkpoint.
|
||
2. Managed input-only lab navigation now reaches the outside LOAD with live source
|
||
contacts and NPC updates. Keep the direct-contact smoke distinguished from this
|
||
replay. User confirms lab/tutorial/lab/outside is reachable. Underground passage
|
||
now passes from explicit riverlab/SCENE65 fixture; recover actual progression
|
||
into that task state and extend input coverage to later scenes. RETURN uses
|
||
the recovered TSK departure root. Find consumers of independent42AF00
|
||
+1E38/+1E48 checkpoint separately; do not conflate the two again.
|
||
3. Recover47BD80 collision response/479D20 movement phase and source object exclusions.
|
||
Support trace/magnitude/radii/factors and dynamic broadphase are recovered;
|
||
wall response, Jimmy capsule/visual pivot, stairs and camera obstruction remain
|
||
modern approximations. Preserve source normals and invisible proxy geometry.
|
||
4. Complete contextual SFX bank switching, source volume/pan/attenuation/channel
|
||
policies, jetpack sound callbacks and MPEG-in-RIFF bird1/id162 decoding. Default
|
||
SoundEffects.omt identity and pickup/button/door stream lifecycle are integrated;
|
||
physical/native Windows output and original timing remain unverified.
|
||
5. Complete practice highlights/cursor/controller handling and energy/gadget UI.
|
||
Objective slide/timeout/O behavior is now recovered and integrated.
|
||
6. Recover Carl sensing409CC0, Goddard follow-state4, actor class defaults and full
|
||
morph state/playback-end synchronization. Generic patrol states alone are not AI.
|
||
7. Recover original global cadence/object phase order, mouse steering/relative input,
|
||
exact clipping/fullscreen/focus/scaling behavior and material/fog/light/blend states.
|
||
|
||
## Full reconstruction and verification
|
||
|
||
- [ ] Working original gameplay captures and physics/input/render/audio comparisons.
|
||
- [ ] One complete, source-faithful playable scene including navigation and transitions.
|
||
- [ ] All inventory/gadgets, health/damage, enemies/combat, scoring and win/loss behavior.
|
||
- [ ] All levels, class-specific triggers/AI and full original progression.
|
||
- [ ] Menus, cutscenes, configuration and complete runtime save/load.
|
||
- [ ] Original render-state, animation, lighting/fog/alpha and camera fidelity.
|
||
- [ ] Speaker output, positional mixing, original timing and native Windows audio.
|
||
- [ ] Native Windows input/resize/story/driver validation of the current build.
|
||
- [ ] Verified Linux/Windows release packages and documented remaining discrepancies.
|
||
|
||
## Commands
|
||
|
||
From GamePort: `source scripts/env.sh`, `dotnet build`, `scripts/test.sh`.
|
||
`scripts/package.sh` rebuilds local packages. `NEUTRON_WINDOW_TEST=1 scripts/test.sh`
|
||
adds window checks with a working DISPLAY. `tools/recon/reference_capture.py`
|
||
executes copied originals/generated probes in an isolated local harness.
|
||
Verify preservation using `python3 tools/recon/inventory.py ../Original --verify
|
||
docs/original-manifest.json`. No remotes/uploads/cloud work. Check Git status and
|
||
exclusive file ownership before edits; all prior agent ownership returned to primary.
|