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

85 lines
4.6 KiB
Markdown

# 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.