Files
Neutron/docs/analysis/underground-route.md
T

4.6 KiB

Lab underground passage replay

2026-10-25. Deterministic managed integration using original LV1B source geometry, STRT, switches and bars. This is a port navigation check; no original executable was run and no original files were modified. Full collision/cadence fidelity and progression into this fixture are not established by this replay.

Fixture and original records

The player begins at the original STRT riverlab at approximately (3785.4702,-1040.4089,-2597.4324), yaw0. SCENE65 is an explicit initial task fixture, assigned before constructing the director. It is not a recovered task award or a claim that the preceding port story already reaches65. NewGame supplies all other save values. The separate underground LOAD remains untouched; its SCENE65 gate and level1.gam/riverlab destination are recorded in lab-progression.md.

Original bar root is (3810.1970,-1076.0883,-1180.4956), duration5 seconds, OpenAmount500 and OpenTime3. Both distinct C3DBUTTON actors target these bars with Toggle-1. The higher/near-door switch is approximately (3401.5176,-987.4839,-1198.4617); the lower/river switch is (4059.9485,-1195.6429,-1921.8291). Source state machine addresses, sound lifetime, strict contact/timeout and duplicate-tag handling are in buttons-doors.md.

Input route and assertions

tests/GamePort.UndergroundRouteTests uses the same live player/director/contact, mechanism, NPC patrol and dynamic-door collision consumers as the existing lab route. Only the initial authored STRT supplies the player position. Subsequent movement comes from PlayerInput; every step checks finite, continuous movement, control ownership and the absence of a positional warp.

The modern test follower walks to the lower switch, centers before the arched masonry, crosses the raised bars, approaches the upper switch, recenters and returns through the doorway. Heading tolerance6 degrees, waypoint arrival30 units and90 release ticks between legs are test input choices, not original AI. A naive diagonal approach catches the actual arched entrance edge, so approaching the center before advancing is material to this navigation test.

Both switches must enter DOWN through real player contacts. The original bars must reach their full500-unit opening. At each of the two gate-plane crossings, the current source box's minimumY must exceed the live capsule's head, so the test cannot pass merely by walking through a still-obstructing moving gate. The live source-gated dynamic resolver runs on every player step. After returning,1200 released ticks establish cooldown reset and timed closure. SCENE, score and transition destination must remain unchanged by this button route.

A separate negative query tests the reclosed gate using the replay's actual standing root height, with an80-unit sphere sweep from gateZ-100 to gateZ-20. It must enter the recovered dynamic broadphase and be blocked at gateZ-76 or farther away. This query never assigns or repositions the live player and is not represented as an extra input-navigation leg. The narrowphase remains the explicit modern adapter documented in dynamic-collision.md.

Water collision defect exposed and corrected

Before the NC shape exclusion was implemented, the first simulation step raised the riverlab actor85.89 units from its real floor to the ncwater plane at Y-1006.045. Actor root then stood at about-930.095. Its146-unit vertical difference from the reclosed bar root exceeded the original normal-body broadphase limit140 (2*doorRadius40 + JimmyRadius60), silently skipping closed-bar tests.

The original level loader excludes shapes whose names begin NC from terrain registration; it is not a generic water-material guess. The recovered rule is now consumed by both capsule terrain and source body support. See water-collision.md for binary addresses and direct source regressions. The route's first-step guard rejects that former rise. Corrected live root height stays near-1016, allowing the closed-gate negative query to exercise both source broadphase and provisional narrowphase. Full water/swimming gameplay remains a separate system.

Verification

From GamePort:

source scripts/env.sh
dotnet run --project tests/GamePort.UndergroundRouteTests -- ../Original

Pass recorded in artifacts/underground-route.log:2763 steps,4153.21 horizontal travel,0 jumps,3 small support landings,1.79 maximum rise,14 masonry wall hits, grounded final feet (3814.5361,-1092.0243,-2058.7490). Both gate crossings have clearance, both switches reset UP and the bars reclose. This establishes the managed port route from its explicit fixture, not a native-platform GPU test, whole-game progression or source-identical movement/response.