Reconstruct lab story, interactions, patrol and jet pack practice flow

This commit is contained in:
UnixNight committed 2026-10-24 20:33:03 -04:00
1 parent 58424120bb
commit c929f942e1
84 files changed
+7957 -305

No files matched your search

+75
View File
@@ -0,0 +1,75 @@
# Player-contact buttons and vertical doors
Static recovery and managed integration, 2026-10-24. Original executable SHA-256:
f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8.
EXE text file offsets are VA minus0x400000. Originals were only read.
## Button contact
C3DButton interface+C0 vtable493B60, enter slot40=411BB0, update slot3C4=411DE0,
activation slot28=4118B0, PostLoad slot404=411EF0. InitObject411B82 sets radius300;
PostLoad411EF8/411F09 sets authored/current radius300 again. Activation4119A7
sets150; runtime resizing after subsequent task reactivation remains to be matched.
The current player contact subset uses normal PostLoad radius300 plus Jimmy60,
strict overlap and source offsets to distinguish duplicate C3DBUTTON tags.
Enter411BC1 accepts the active player or a C3DBASEBALL. The port currently handles
only player contact. Availability at interface608 must be nonzero, cooldown7B0
must be<=0. Current definition HIUP (literal4ED9C0) selects the press branch:
set cooldown4.0 at411C35, optionally play AvailSound at411C92..A2, select DOWN
at411CAE..B5 and set material RGB(.2,.2,.2) at411CBB..FC. Existing DOWN selects
UP and original authored RGB at411D59..B1. Material pulse/tint is not yet ported.
Resolve ActivateButton through first case-insensitive tag lookup474070. If found,
call its interface428 with source Toggle (411D18..23). A button target additionally
becomes available while the caller becomes unavailable (411D29..47). Complete
generic button-to-button toggle activation is still unresolved by this consumer;
the lab targets bars, a vertical door. NewTaskState/NASound are serialized but the
traced ordinary contact path does not consume them. No task award was invented.
The special LV4B branch411C3F..8F is outside this lab implementation.
Update411E24 subtracts dt only for positive cooldown and reactivates/resets at
<=0, then stores0. Continuous contact does not generate another enter callback.
SceneMechanisms retains contact membership across cooldown reset.
## Vertical door state
C3DDoorUpDown interface+C0 vtable4993AC: activation417760, contact4178C0,
update417930, toggle428=417AC0. Source fields are ItemClosed at5FC, current
closed flag600, Next604, remaining668, DoorSpeed66C, OpenTime670, elapsed674,
OpenAmount680. DoorSpeed is used as the movement **duration**, not units/second.
Initial open state adds OpenAmount to the stored source origin at41777B..AE.
Origin getter interface164=471600 returns the saved vector atEC..F8.
Toggle ignores requests equal to current closed state. During movement it replaces
remaining with duration-minus-remaining (417AE9..F5); from rest it copies duration
and starts loop sound59 when no movement sound is active (417B11..43). Next is
dispatched before assigning closed state (417B49..C01). The current consumer
handles Next targeting3AIT; other original subclasses remain explicit unsupported.
Requested0 opens,1 closes; other values toggle (417C01..34).
Update first consumes positive remaining by dt and clamps to0. Completion stops
the movement loop and emits sound58 (417974..AE). Set vertical root to:
```text
fraction = remaining / DoorSpeed
closed: sourceY + OpenAmount*fraction
open: sourceY + OpenAmount*(1-fraction), reset open elapsed0
```
There is no leftover-dt integration. Once stationary/open, add dt to elapsed and
close only when elapsed is **strictly greater** than OpenTime (417A77..AA).
Lab bars: originY-1076.0883, duration5sec, distance500, open hold3sec, touch-disabled.
Its two authored buttons use Toggle-1. TouchActivated doors' own contact and
baseball contact paths remain outside the player-button subset.
## Runtime verification and limits
Game/SceneMechanisms runs in the same fixed-step scene loop as the director.
Application/StaticSceneVisuals displays UP/DOWN variants and door root movement.
Two source-data regression groups cover strict360 contact, four-second reset,
duplicate tags, contact persistence, five-second opening, continuous reversal,
sound-loop lifetime, exact endpoints and strict three-second hold expiration.
These checks establish port behavior from static evidence. Moving-object physics,
material pulse, sound-bank resolution, full task/reactivation behavior and original
runtime comparison are not established by these tests.
+130
View File
@@ -0,0 +1,130 @@
# Moving vertical-door collision
Read-only static recovery and bounded managed component,2026-10-24. Original
Neutron.exe SHA-256 f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8.
EXE text file offsets below are VA minus0x400000. No original code was executed
for this investigation. Source geometry/defaults are recovered; full response is
still injected and must not be called the original collision solver.
## Door defaults and activation
C3DDoorUpDown complete constructor4174F0 installs interface+C0 vtable4993AC.
| Evidence | Result |
| --- | --- |
|4175B0 ->4710C0 ->iface224/471A40|Entity pair collision enabled; current byte+140=true|
|4175C6/4175CA ->471730|Collision mode178/field124=2|
|4175CF/4175D2 ->471030 ->iface214/471A00|Own physics integration disabled; byte13E=false|
|417CAB/417CB2 ->iface110|PostLoad radius40, overriding automatically copied shape radius|
|40E410/40E413|HasCollision-1 retains constructor flags|
|40E427/40E433|Explicit HasCollision nonzero enables pairs and own integration|
|40E44B/40E457|Explicit HasCollision0 disables pairs and own integration|
Do not interpret own integration=false as a noncolliding door. Its entity pairs
remain enabled. Render visibility, current pair permission, world geometry checks,
own integration and authored CanMove are different flags. On HasCollision-1,
task visibility changes do not themselves execute the explicit pair-disable path;
the caller must track source activation flags without equating visible and solid.
CanMove is read at base40E0F0. After physical update462520, zero restores the
serialized origin through position/Euler setters40E103..40E15C. Nonzero permits
the current position to remain, allowing the door state machine's vertical motion.
It does not replace collision mode2 with a static world mesh.
## What the box actually uses
Shape-change hook462270 reads the current OMT shape's find_cube method through
complete slot44 at4622D4. This is the min/max of its local source vertex positions,
not a world-aligned bound of an already transformed rendered model. It forwards
min to iface2E8 at4622FB (storage1D4..1E0), max to iface2E0 at462325
(storage1C4..1D0). OMT find_cube1000AA80 computes all six values from shape vectors.
This justifies original local shape bounds; unrelated editor icons or a guessed
full-model world AABB are not substitutes.
47A776/47A7A5 retrieve these bounds.47A7EC..47A99B transforms all eight corners
through iface384=472980, using current Euler angles and root position. The point
method quantizes angles through the original trigonometric table. The bounded
component accepts a supplied local-to-world matrix; correctness of that matrix
for every nonzero authored Euler rotation remains the caller's responsibility.
The actual lab bars have zero rotation, so translation is unambiguous.
Corner bits:4 selects maxX,2 maxY,1 maxZ. The switch at47B3AC then emits these
twelve triangles, with the original diagonal choice/order preserved:
```text
0,1,2 1,3,2 0,2,4 2,6,4
4,6,5 6,7,5 5,7,3 5,3,1
0,4,1 4,5,1 2,3,7 7,6,2
```
The pure component rebuilds these triangles from the current door transform.
There is no persistent collider left at its closed root and no invented relative
door-motion sweep. Original47A5E0 similarly constructs the box at its current
pose, then obtains the other body's previous/current roots47AAD4/47AB0D.
## Dispatch, gates and response boundary
Global entity-pair loop47A430 requires both slot220 flags and mutual slot3A0
class/permission gates. At47A4CF/47A4E7 it checks collision mode178. If either
actor has mode2, it calls47A5E0 with that actor first; otherwise it calls the
ordinary root-sphere path47B3E0. Exclusions/class gates are inputs to the bounded
component; their complete class-specific behavior is not silently invented.
47A5F5 additionally requires the **other** actor's world-geometry flag1D0.
Root broadphase then uses quick_magnitude and these inclusive comparisons:
- Other actor mode2: distance<=boxRadius+otherRadius, then return contact directly
at47A712..47A72C/47B39F without the twelve-triangle response.
- Other modes: distance<=2*boxRadius+otherRadius, at47A73F..47A75B. Only candidates
passing this gate construct/sweep the oriented cube.
The second rule is a source quirk. Normal Jimmy radius60 and door radius40 give
**140 units**, despite the bars' much larger shape bounds. Do not enlarge it to
the graphic cube's bounding sphere while calling the result recovered behavior.
For every cube triangle,47B277 invokes shared sphere/triangle kernel47BD80 and
can invoke the other actor's normal response callback374 at47B29B. After all
twelve, box iface1E0 inhibits ordinary position response when true47B2EF..47B2F7.
Otherwise the candidate displacement is clipped against static world through
47B4B0 at47B364 before assigning the sphere root via314 at47B399. Thus a generic
sphere-vs-AABB overlap/push is not an exact translation of the original response.
## Implemented interface and tests
Game/DynamicSceneCollision.cs is deliberately bounded: source defaults and
HasCollision sentinel handling; pair/world-geometry gates; exact broadphase;
current oriented corners; exact twelve-triangle order; injected narrowphase;
contact-preserving response inhibition and second-mode2 shortcut.
DynamicBoxCollider takes identity, source root, local min/max, local-to-world
matrix, current radius, pair flag and response-inhibition flag. DynamicSphereMotion
takes previous/current root, radius and the relevant flags/mode. Resolve invokes
a supplied Func<DynamicBoxSweep,DynamicCollisionResponse>, or returns unchanged
when a recovered gate rejects it. The sweep contains all twelve SupportTriangles.
The callback must provide the still-unrecovered47BD80/static clipping response.
Source lab fixture: bars GAM offsetA29C, root(3810.1970,-1076.0883,-1180.4956),
HasCollision-1,CanMove1,OpenAmount500,rotation0. Its42 ASE source points convert
to local min(-223.8069,-18.7273,-16.8051),max(228.7926,391.2706,16.8051).
All raw points, including any nonvisible faces, contribute to these shape bounds.
Run from GamePort:
```sh
python3 tools/binary/dynamic_collision_evidence.py
source scripts/env.sh
dotnet run --project tests/GamePort.DynamicCollisionTests
```
The script checks26 original instruction sequences, all12 jump targets and all36
corner indices extracted directly from the bounded switch-case machine bytes.
It verifies the source class table, lab entity flags and ASE bound facts.
JSON evidence is artifacts/binary/dynamic-collision-evidence.json.
All10 managed groups pass: defaults/sentinel; inclusive140 broadphase and its
large-cube quirk; permission/geometry gates; oriented corners; source cube topology;
injected response/inhibition; mode2 shortcut; moving geometry; invalid inputs;
actual lab bars closed/open passage using the existing provisional swept-sphere
SceneCollision adapter. The latter verifies port integration, not original47BD80
or original runtime behavior. Full edge/vertex sphere response, static reclipping,
door pushing/crushing and native original comparison remain unresolved.
+99
View File
@@ -0,0 +1,99 @@
# Laboratory jet pack and powered jump
Read-only static recovery plus managed implementation,2026-10-24. EXE text file
offsets are VA minus0x400000. Neutron.exe SHA-256 is
f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8.
Original DLL/frame and original game comparisons are separate evidence categories.
## Identity
The lab pickup's GAM tag SHRINKRAY/PickupIndex301 is a prototype/internal name.
Original screens.omt Canv120 says GET JET PACK; its effect grants inventory
group0/item3. That exact inventory slot gates the powered-jump code43848E/4385C9.
It must not be presented as a shrink-ray weapon. The original readme describes
Shift/Insert/right mouse as Jump - Jet Pack Burst. The actual C3DShrinkRay class
has separate ray.ase/ray0000..2.png bindings440035..A6, outside this implementation.
## Controller and state order
Game/JetpackBurst.cs translates the vertical state/action subset of437F90.
Grounded/released outer update437B9E resets jump state0 before air application.
States below3 set extra acceleration to gravity*1.33f-gravity at438148..18D.
With gravity-800 this yields-264 extra/-1064 net. The initial jump queues550
at4383B3 and clears the effect timer; the hold timer starts0.
State1 adds dt and starts a burst only after hold is strictly>.4f
(4383FD..418). State2 renewed hold attempts immediately (438559). Both enter
state3 even when disabled. Allowed start sets effect time8 (field884, ctor437640),
current radius100 when the effect exists (4384DE..F3), requests FLY and sets
vertical velocity10 (4384F9..546). Slot138(2) invokes a gadget/sound callback;
it is not a proven movement-mode assignment and the component does not invent one.
Start is disallowed in LEV6,LV4B,LV6A,LEV3,LV3A/B/C/D; gadget modes2/6/7;
nonpositive global4F83D4; or inventory item3 state0/4. VR04 bypasses those guards
(43841E..4384D4,438559..633). Other nonzero inventory states remain accepted.
Before state dispatch, states>=3 inspect the effect timer. An existing effect
with time<=0 resets states3/4 to0, requests FALL, stops the gadget and returns
before replacing acceleration (438192..20D). The previous extra acceleration
therefore survives that invocation. This is also why unavailable gadgets can
repeat ordinary jumps on landing while jump remains held.
With positive burn time, distance-controlled extra acceleration is:
| Condition | Extra Y | Net Y including gravity |
| --- | --- | --- |
| Shadow distance<500, velocityY>=-1 |880|80|
| Shadow distance<500, velocityY<-1 |1040|240|
| Shadow distance>=500 |720|-80|
Near-branch .1/.3 are stored doubles; far .1 is float (438210..30D).
Source distance86C comes from Jimmy to his shadow425450..47C. Shadow query
4252E0 uses a vertical segment2500 downward and places its root hitY+13 for
default height30. Current integration approximates this query with the port's
walkable floor query; failed queries retain prior distance.
Held state3 landing stops the effect, restores radius60 and enters4
(438693..6EF). Airborne release stops the timer, requests FALL and enters4
without a radius restore (438745..780). Jimmy's next ordinary grounded update
42469B restores60. Source released table state4 goes directly to reset43879A;
state5 checks grounding. The component's tests preserve these distinct branches.
## Effect, energy and visual assets
C3DJetpackFire update421FB0 obtains its owner. Grounded owner sets remaining0;
then it subtracts dt, including when inactive (421FDD..422009). A nonpositive
result hides it. A positive result shows it and adjusts global4F83D4 by-dt*.5
(42202B..3B). Timer values are not clamped to0. Empty owner/effect leaves fields
unchanged. Running burn is not cancelled merely because energy reaches0.
Energy helper42A920 skips adjustments for numeric FourCC VR01..VR08, otherwise
adds the requested amount and clamps0..100 (42A975..9C1). Low/empty-energy sounds
and other energy/damage consumers are not yet mapped. The original TSK float
PlayerValue retains this global. SceneInteractions now preserves live energy
when producing a checkpoint snapshot.
Effect bindings421F30..96 are DEFAULT fire.ase, HINONE fire2.ase and fire.png.
The active effect follows owner root/Euler directly at42204C..B6. Preparation
exports the original two-triangle morph; JetpackVisuals samples it into the final
combined GPU buffer and controls its draw from the effect phase. Exact effect
translucency and global morph cadence remain open. Jimmy HIFLY->jimfly.ase is
registered at422B1A..26; its426 point vectors reuse the original Jimmy base UVs.
## Integration and verification boundary
LabSimulation uses controller -> movement/static/dynamic collision -> effect
update at fixed60Hz. Original global object iteration/phase order is unresolved;
the pure APIs expose controller and effect phases separately rather than hiding
that choice. Normal logical actor-root clearance is now75.9 from recovered
PostLoad/support constants; player capsule radius24, full wall solver and sole
placement remain provisional. Burst100/landing60 radius changes currently affect
contacts and moving-door broadphase; they do not make the modern capsule exact.
Fourteen JetpackTests groups pass: takeoff/release/refire, strict .4 threshold,
disabled repeat, all source start gates/VR04 exception, acceleration thresholds,
transition acceleration/radius semantics, timer/energy order, negative inactive
timer, energy clamp/VR immunity, depletion, explicit phase differences, absent
effect and bounded malformed input. The existing13 movement groups still pass.
These are static/data/port algorithm checks. Original gameplay/native Windows
comparison remains required before a fidelity claim.
+216
View File
@@ -0,0 +1,216 @@
# Original lab trigger and camera sequence
Static executable/GAM investigation, 2026-10-24. VAs are preferred-base
Neutron.exe addresses (these text offsets are VA-0x400000). Port runtime
verification is separate; no original gameplay comparison has succeeded.
## Recovered sequence
LV1B STRT STARTEXP at GAM0x5B0E starts LABEXP. AITrigger labexp at0x18FAD
selects labexp1 when SCENE30; original NewGame starts with SCENE30. Chain:
LABEXP1 -> SITGODDARD -> LABEXP2a -> LABEXP2 -> labexp2b -> LABEXP3A ->
LABEXP3 -> labexp3b -> GOCARL -> GOGODDARD -> WATCHGODDARD -> TELGODDARD ->
GODDARDDIS -> TELFX1OFF -> TELGODDARD2 -> end -> jimend -> default.
CAM/MCA nodes supply16 speech cues in this sequence. Speech end, not a guessed
fixed cutscene duration, advances the nodes.
STRT deferred dispatch0x4426A7 validates a C3DTriggerType target, then clears
player control through game slot0x118 before dispatch0x4426B7..C1. CAM activation
0x4165E2 PlayerControlled='none' preserves control, 'NULL' clears it, named existing
objects receive control. DEFAULT0x447CF0 restores Jimmy, enables inventory, and
clears the global skip flag at0x447F89. SCENE30 calls Jimmy help/inventory callback
0x42AB60; it does not unlock the exit or simply advance the task to60.
AI trigger actions0x40C300 execute synchronously: actor animation/state/speed,
patrol, hide/show, named-marker teleport, yaw; then conditional child selection
0x40C230 exact-matches current TaskName state to ActivateStateN and selects first
existing ActivateObjectN. 0x40C9BF/0x40CA26/58 dispatch child or NextTrigger.
SITGODDARD does not wait for SIT animation. GOGODDARD sets actor state3/speed260/
patrolGODDARDPAT1 and starts WATCHGODDARD immediately. Patrol movement is concurrent
and is now consumed by ActorPatrol with recovered support and provisional wall response.
## Camera formulas and timing
CAM0x415FC2 checks sound handle through0x47D890; finished sound deactivates target
animation then dispatches NextTrigger0x4160A4..E2. MCA0x430DD2 waits similarly,
advances to next non-none target, then finisher0x4311F0 dispatches NextTrigger.
Port uses exact prepared PCM sample duration for deterministic stepping; actual
hardware playback latency/end state is not yet matched to the original handle.
CAM0x4161CD..585: CameraType2 eye=authored camera position, look=target root.
Otherwise D=clamp(InitialDist-ZoomSpeed*t,MinDist,MaxDist). ViewFromCamera0 uses
eye=targetLocalToWorld(TargOffsetX,TargOffsetY,D), look=root+(0,LookVoffset,0).
Nonzero ViewFromCamera (including1/3) uses A=targetLocalToWorld(TargOffsetXYZ),
eye=A+normalize(cameraPosition-A)*D, look=A; LookVoffset unused in that branch.
MCA0x431027..11C1 resets per-shot elapsed time0x43190F. Local eyes:
|Type|Local eye|
|---|---|
|0|(0,40,200)|
|1|(0,140,max(100,300-15t))|
|2|(0,240,max(100,500-35t))|
|3|(200,240,max(100,700-55t))|
|4|(-200,190,max(100,700-55t))|
Transform eye by target Euler/root; look=root+(0,LookatVOffsetN-60,0), constant60
at0x49D5B4/handler0x43116A. Both handlers write exact eye/look via0x431670.
Port uses quantized modern trigonometry; x87 table/rotation-bit identity unverified.
CAM skip0x4160F1 and MCA0x430EED accept Escape/Space/controller/global flag, set
0x4F83E4, stop speech, preserve deactivation/actions and fast-forward the remaining
chain until DEFAULT. Port suppresses newly queued speech while skipping.
## Progression after intro
Teleport explanation AI special0x40CB43..6B changes SCENE30/31->35. Pickup special
0x4365D0..639 changes SCENE35->50 for shrinkray, with additional inventory effects.
Carl callback0x413E50..9D changes50->60,65->70,270->280 after base0x41B810.
The follow-up below recovers and implements the actual contact/talk dispatcher
and the internally named shrinkray jet pack checkpoint/inventory/practice/gadget effects. General AI sensing,
weapon behavior and all special pickups remain incomplete.
LOAD LABTONEIGH GAM0xA43 goes tolevel1.gam/startlevel1, SCENE60/radius200.
Underground LOAD0x8360 requires scene65, start riverlab. Binary0x457F32..7F5F:
none requiredtask bypasses; taskvalue-1 bypasses; otherwise >=RequiredLevel and
ExactLevel!=-1 additionally requires equality to that numeric ExactLevel.
Original LOAD contact uses the independent RequiredTask gate. Its interface+C8
vtable0x4D025C has task callback+0x424=0x458880, which only stores the supplied
TaskState at interface+0x494; it does not apply animated-entity activation rules.
Applying generic Animated.RequiredLevel to LABTONEIGH incorrectly disables it
because its TaskName is none while its RequiredTask is SCENE. The director now
leaves LOAD activation alone and SceneInteractions checks its real task gate.
## Implementation and remaining limits
Game/SceneDirector is bounded synchronous dispatch plus stateful CAM/MCA timing.
It preserves original GAM values, task gates, skip actions and reports unknown
classes/cycles/missing targets. Source-authored actor states are mutable copies.
Jimmy creates Goddard at0x423C98->0x41C810 (tag at0x41C88C); initial port position
uses gstart as a placement inference, then the authored SITGODDARD action positions
him before his first shot. Source visibility/collision masks are not fully ported.
Carl/Goddard rendering, speech/music and camera integration run in default lab play;
--story-time N gives a headless comparison point, --skip-intro executes skip actions.
Sprite/OMT props, common patrol, lab interactions and the practice modal are integrated.
Fades, complete collision/sensing, animation timing and full inventory remain incomplete. Model pivot/grounding remains provisional. Tests exercise original
sequence/control restoration, all five MCA formulas, CAM modes, task gates,
bounded cycles and actual decoded sound durations; GPU story12s render is verified
under Linux llvmpipe with zero validation errors. This does not prove original fidelity.
## Lab jet pack (internal tag SHRINKRAY) and Carl interaction follow-up
Read-only static source investigation plus managed regression execution. Original
source EXE SHA-256 is f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8.
Source GAM level1b SHA remains recorded in original-manifest.json. No original
binary was executed for this follow-up.
### Lab jet pack: ordinary collection and the exact special gate
GAM0x1799 is3PIC tagshrinkray, PickupIndex301, PointValue50, Radius125,
SoundIndex116, noPIC_NUMBER/RequiredPicNum/PickedUpIndex. Its generic contact
0x435CE0 accepts the active player, rejects an already acquired index, runs the
prerequisite virtual complete+0xD8, marks ordinary acquired state1 at0x435E11,
hides and disables contact. It invokes special hook0x4365D0 at0x435FCB before
positive score0x435FED.
The special hook compares ObjectTag to SHRINKRAY at0x4365D7..E7 (literal0x4F050C)
and SCENE exactly35 at0x4365ED..FD. Only that gate performs:
1. Active Jimmy complete+0x1E8 at0x43662C, resolved through complete vtable
0x4A3BDC to0x42AF00: capture current level code and physics root at complete
+0x1E48/+0x1E38. The port emits CheckpointCaptured(root); it does not guess
that this is the unidentified TSK StoredVector or change a STRT checkpoint.
2. SCENE50 assignment0x436632..639.
3. Inventory setter0x4038C0(group0,item3,state1) at0x43663E..644.
4. Help/item-information page0 via0x406F90(0), call0x43664B.
5. Jimmy complete+0x174(3) at0x43667C..67E, resolved to0x428D50 gadget selection.
Collecting this tag outside SCENE35 still performs ordinary acquired/score behavior,
but does not receive these special side effects. The port preserves this boundary
rather than adding a minimum-level restriction. It emits HelpRequested(0) and
Inventory.GadgetSelected(3); presentation, modal pause and the jetpack motion/effect
consumer are separate integration work.
### Carl: entering talk precedes dialogue, rather than following its end
Carl interface is complete+0xC0, vtable0x495364; complete vtable0x495804.
InitObject0x413D60 sets radius100 through interface+0x110 at0x413E2F..36 and
support factor0.75 via+0x100 at0x413E3E..45. This supports a100-unit root
contact radius, not a model-sized capsule assumption.
Inherited contact-enter0x40A3C0 first handles base collision.0x40A44C..45C checks
that the contacted entity is the actor's resolved TargetName (complete+0x6C0,
interface+0x600; resolved at0x40948B..49A). If actor AIState6,
0x40A676..68D calls complete+0x124(0). C3DFriend update0x41B950 runs general
AI0x408000 first and, whenever resulting AIState0, calls complete+0x140 at
0x41B972..988. Carl's complete+0x140 is0x41B7B0.
That dispatcher obtains complete+0x17C=0x41BB20. This searches five TalkTriggerN
names in source order, requiring an existing target, TalkState!=-1 and either
exact actor TaskState or wildcard-2. It retains the selected object before any
task mutation. With a match, it invokes complete+0x180=0x413E50 FIRST, then
dispatches the chosen object's interface+0x5C with that object itself as caller
at0x41B7D3..D8. It increments the conversation counter, sets AIState9 at
0x41B7F0..F7, and invokes desired-facing hook+0x148=0x4093E0. Without a match,
it leaves state0 and retries on later updates without awarding points.
Carl0x413E50 calls base0x41B810 (+100 score, zero velocity through interface+0x410)
and then maps SCENE50->60,65->70 or270->280. Thus the normal lab route changes
to60 BEFORE starting neutron1a, and the exit may pass its gate while the dialogue
is running. The port does not award or advance on conversation end. General
state6 visibility/FOV sensing0x409CC0 and desired-facing smoothing are not yet
implemented by this contact subset; entering the recovered100+60 root-sphere
contact path is supported. Other friend classes do not reuse Carl's derived hook.
Carl TaskState override0x413F30 invokes generic activation, then LV1B branch
0x414068..118: SCENE outside0..60 deactivates;31..60 resolves CARLESC3 and sets
state6/position; states below60 activate;60 leaves generic activation unchanged.
This runs on every assignment, including repeated values. On scene initialization
or reset, call SceneInteractions.Reset AFTER SceneDirector.Begin to restore the
class callback and acquired-item visibility after actor reset.
### Inventory and objective persistence
SceneInventory preserves the19 signed TSK inventory values (9 group0,10 group1)
with owned arrays and bounded indices. Source0x4038C0 writes an item state at
group pointer0x4F8164[group]+40*item+0x24;0x403950 reads a signed short from
the same location. Unknown existing wire values remain unchanged unless the port
performs a recovered assignment. The separate29-item consumable group/counts are
not silently conflated with these two groups.
The TSK OtherCounter global0x4F8194 is now identified as the current objective
selector. SCENE setter0x45F990 uses byte/target jump tables0x45FC48/0x45FBF0 and
0x45FD98/0x45FD40 to call0x406F50(objective,1). That helper clears44 transient
flags at0x4F7D00, stores the selector0x4F8194 and sets flag[objective]=1. Relevant
lab milestones35/50/60 select1/2/3;65 does not replace the selector. The port
maps all44 supplied milestone states (including140/141 selecting8), exposes
CurrentObjective/ObjectiveChanged, and saves the selector in OtherCounter.
The lab stationary objective panel and practice modal are integrated; timed UI
slides/highlights and remaining objective consumers are separate work.
### Verification and boundaries
Run source scripts/env.sh, then dotnet run --project tests/GamePort.InteractionTests
-- ../Original. Managed checks cover the actual authored intro/skip/explanation,
task35->50 shrinkray with exact event order and+50, Carl task-position/contact/
talk with pre-dialogue60/+100, original LABTONEIGH destination, TSK write/reload,
no repeated acquisition or talk, outside35 behavior, first-existing/wildcard talk
selection, no-match/no-award, strict160 contact threshold, controlled-player gate,
inventory bounds/array ownership and every objective mapping against the original
EXE dispatch tables. Eleven exact instruction sequences support the decisive
call sites/constants. These are implementation/data checks, not original gameplay
comparison or native Windows validation.
Contacts now call OriginalBodySupport.QuickMagnitude, which translates the original
lookup algorithm with generated sine/acos tables; eight float-bit outputs now
match isolated original DLL probes. Full table bit identity, exclusion lists,
specialized contacts, body resolution and general AI sensing remain incomplete. Other special pickups remain reported unsupported.
## Corrected pickup identity and modal
The source tag SHRINKRAY is a prototype name. screens.omt Canv120 explicitly
says GET JET PACK; inventorygroup0/item3 also gates powered jumping. User-facing
notes must call this the lab jetpack.406F90(0) opens PracticeYesNo169 and pauses
the game; it is not a generic help page. Yes enters VR04/PHONEBOOTH with current
level/current STRT return context, while No resumes. See ui.md and jetpack.md.
+97
View File
@@ -0,0 +1,97 @@
# Level3B / Level3E resource evidence
Static investigation, 2026-10-24. Source: unmodified `Original/Neutron.exe`, SHA-256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Addresses are preferred-base EXE virtual addresses. File offsets for the addresses
below equal VA minus `0x400000` in this PE. No original code was executed.
## Findings and scope
The user is correct that **`gam/Level3B.gam` and `gam/Level3E.gam` exist**.
Both parse successfully as 1,777-byte entity files with four entities:
`3JIM`, `STRT`, `LOAD`, `3SBU`. Their bytes after the four-byte level header
are identical; headers are `LV3B` and `LV3E`. GAMs contain entity properties,
not replacement scene mesh/material/texture payloads.
The original executable also has explicit, separate archive-opening paths for
**`omt/level3B.omt` and `omt/level3E.omt`**. Those files are absent from the
supplied original tree. This is verified loader behavior, rather than an inferred
same-stem pairing or merely an unused string reference. No shared-map alias is
present on the traced initialization paths.
However, whether these scenes occur in normal shipped gameplay is **unverified**.
Small identical entity bodies suggest possible stubs/development leftovers; that
is an inference, not established intent. The primary's corpus check found no
serialized GAM string references to either scene name/code and no source TSK
starting in `LV3B`/`LV3E`. This does not exclude hardcoded transitions or other
entry routes. Do not describe the archives as confirmed required files for the
normal game, or tell the user their GAM files are missing.
## Class and archive dispatch
| Evidence | Level3B | Level3E |
|---|---|---|
| Complete class | `CLevel03BGame` | `CLevel03EGame` |
| Constructor | `0x451AF0` | `0x452690` |
| Constructor sets level code | `0x451BA8`: push `LV3B` | `0x452748`: push `LV3E` |
| Factory calls constructor for code | `0x45D635` | `0x45D78B` |
| Complete vtable | `0x4C7830` | `0x4C8A00` |
| Initialization slot `+0xB4` | `0x451C50` | `0x4527F0` |
| Literal archive string | `0x4F1F24`: `level3B.omt` | `0x4F1FFC`: `level3E.omt` |
| Archive string length/copy | `0x451C99` / `0x451CC5` | `0x452839` / `0x452865` |
| Dispatch archive loader slot `+0xE4` | `0x451CE8` | `0x452888` |
Both vtable `+0xE4` entries are `0x44E7B0`. This function copies the supplied
archive filename, invokes slot `+0x16C` with the directory string `omt` at
`0x4F1B1C` (`0x44E7FF..0x44E81E`), builds the string argument, calls the file
stream helper `0x476170` at `0x44E8B4`, then calls database helper `0x476000`
at `0x44E8CE`. It stores the file stream/database in globals
`0x5099D8` / `0x5099C0`. There is no fallback archive name in this routine.
File helper `0x476170` imports `OMediaFilePath` and `OMediaFileStream`
constructors (`0x48D188`, `0x48D184`). Database helper `0x476000` imports
`OMediaDataBase(OMediaStream*)` at `0x48D19C`. This confirms the archive string
goes to the real file/database path rather than to a debug label.
The level-code-to-GAM path is separate: the switch at `0x4607F1` selects
`level3b.gam` (`0x4F49C4`) at `0x46083E`; the `LV3E` branch selects
`level3e.gam` (`0x4F49A0`) at `0x46088E`. The level registry also contains
code/GAM records at `0x4F3BE0` and `0x4F3C4C`. Existence in the factory and
registries proves registration, not a normal-gameplay route.
## Missing-file handling
The traced archive-opening path does **not** directly abort, choose a shared map,
or produce procedural replacement geometry when the map archive cannot open:
- `0x476000` initializes its result to null, checks the stream pointer and its
open byte `+0x24` (`0x47602A..0x476033`), and returns null without constructing
a database when either condition fails.
- `0x44E7B0` retains the resulting null database and returns. It does not itself
throw or dispatch an explicit missing-map error in the examined path.
- Base geometry/entity-resource enumeration `0x44D4F0` checks `0x5099C0` at
`0x44D513`; null skips enumeration to `0x44D7F2`.
- The child initialization then continues and separately constructs `3SKY` through
the factory `0x459CB0`. Its sky resource is `omt\nightsky.omt` at `0x4F1DA4`,
passed at `0x451D35` / `0x4528D5`.
Thus these archives' absence means the port has no recovered scene geometry for
the registered entries. It does **not** prove an original startup crash, and this
static trace cannot establish whether the shipped game ever tries to enter them.
## Reproducible checks
Run from `GamePort`:
```sh
python3 tools/binary/level_resource_evidence.py
```
The read-only script passes **13 decisive instruction byte assertions**, resolves
both class vtables, verifies the archive directory/names, parses both GAMs, reports
their SHA-256 hashes, confirms their identical bodies and checks archive presence
case-insensitively. It reports normal-gameplay reachability as unverified.
Confidence: high for supplied-file presence, original loader mapping and null-map
enumeration handling; unverified for gameplay reachability, intended stub status,
and original runtime outcome.
+309
View File
@@ -0,0 +1,309 @@
# Follow-up original collision evidence
Static investigation and isolated copied-DLL probes,2026-10-24. The bounded
OriginalBodySupport module now translates the vertical support/segment path.
This does not supersede the complete provisional SceneCollision solver or prove
original gameplay fidelity; full body collision/pivot/cadence remain unresolved.
HasCollision is serialized type6 at EXE40D423 into interface+584. LV1B includes
-1defaults, explicit1Carl, explicit0plant/teleport/OMT props. Per-object collision
exclusions DisableCollisionID4730F0/EnableCollisionID473170 maintain separate lists;
visibility/material alone cannot choose collision masks.
Jimmy grounded update42469B..4246E3 sets physical-radius slot264 to60 when WORD
4F0588!=0, versus160 otherwise. Shape/animation reset42369A..4236AA sets authored
radius60 through interface slot110, forwarding the radius. Gate semantics/root and
vertical support differ from the preview feet capsule: do not blindly replace its
radius24 with60 and call that original collision. Static resolver47B4B0 ->47BBB0 ->
47BD80 reads interface+15C radius; recovered vertical support47B890 is below.
ASE mode2 conversion of standing Jimmy was executed against a copied DLL in the
isolated harness: its raw bounds remain unchanged and both frame offsets are zero.
No hidden scale/pivot correction was found. The remaining sole/root discrepancy
must not be replaced with a guessed scale or translation.
## Reproducible source evidence
All addresses below are preferred virtual addresses. Neutron `.text` addresses
map to file offsets VA minus `0x400000`; OMT2 addresses should be mapped through
their PE section table. Original files are only read, never executed or modified
by this investigation. Bounded `objdump -d -M intel --start-address=...
--stop-address=...` reads were used for instruction interpretation.
Run `python3 tools/binary/collision_evidence.py` from GamePort. This read-only
script checks27 decisive EXE/DLL instruction-byte sequences, resolves interface and
game vtable slots from original PE bytes, and derives source mesh/GAM facts. It
uses the existing bounded PE, OMT and GAM readers and adds no dependencies.
Neutron.exe SHA-256 is
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
The script does not execute original instructions; its calculated values are
static consequences, not observed original gameplay.
## Jimmy PostLoad: radius and vertical clearance
Jimmy's game interface is complete object plus `0xC0`, vtable `0x4A373C`.
The **interface** slots below must not be looked up in the complete-object OMT
vtable `0x4A3BDC`.
| Interface slot | Implementation | Field/behavior |
| --- | --- | --- |
| `0x100` | `0x4711E0` | Authored support factor at interface `+0x2C`; forwards to slot `0x254` |
| `0x110` | `0x471240` | Authored radius at `+0x34`; forwards to slot `0x264` |
| `0x250` | `0x471AF0` | Current support factor getter, `+0x154` |
| `0x254` | `0x471B00` | Current support factor setter, `+0x154` |
| `0x260` | `0x471B30` | Current radius getter, `+0x15C` |
| `0x264` | `0x471B40` | Current radius setter, `+0x15C` |
| `0x310` | `0x472300` | Current physics position, `+0x214..+0x220` |
| `0x318` | `0x472330` | Physics position setter and changed hook |
| `0x40C` | `0x423610` | Jimmy PostLoad |
`0x423631` passes the string `Calling PostLoad for C3DJimmy()` (VA `0x4EF3B4`).
After restoring the base shape through complete-object slot `0xAC`, PostLoad
pushes `0x42700000 = 60.0f` at `0x4236A3` and calls interface slot `0x110` at
`0x4236AA`. It then pushes `0x3FA1EB85 = 1.2649999856948853f` at `0x4236B3`
and calls interface slot `0x100` at `0x4236BA`.
The earlier player constructor factor `0.7` at `0x4373C2..0x4373C9` is therefore
superseded by Jimmy PostLoad. It is not friction: constructor friction `0.8`
goes through `0x4711B0` and interface slot `0x24C`. The factor's original source
name is not recovered; "support factor" describes its verified use below.
Grounded update `0x42469B..0x4246E9` sets the current radius again. It uses 160
when WORD current gadget selector `0x4F0588` equals zero and 60 otherwise. The
selector is initialized to `-1` by Jimmy constructor `0x42225F`, so no-gadget
grounded behavior takes the 60 branch. Grounded gadget-specific changes are
distinct from a uniform player body dimension and must remain state-dependent.
This establishes original radius 60 for the ordinary path; it does **not**
establish a vertical capsule of height 209.4361. The current provisional capsule
radius 24 cannot be described as recovered, and simply replacing that radius
without recovering root/solver conventions would mix two different models.
## Vertical support handler `0x47B890`
This handler queries source geometry separately from the horizontal/ceiling
triangle resolver. It exits immediately if geometry collision byte `0x4F69E5`
is zero. Its active path reads radius through slot `0x260` and support factor
through `0x250` at `0x47B8B0` / `0x47B8BE`. The multiplication at `0x47B8C8`
stores `radius * factor` (the subsequent `push` means the store at `0x47B8D5`
is local offset `+0x08`, not `+0x0C`; tracking that stack shift matters).
Recovered active-path outline, omitting callback bookkeeping:
```text
r = currentRadius
h = currentSupportFactor
clearance = (h == 1 or h < 0.1) ? r : r*h
P = currentPhysicsPosition
Q = previous/resolverPosition (slot 0x2F8)
top = max(P.y, Q.y)
if segmentQuery(Q, P, 0) hits H:
top += length(P-Q) - length(H-Q)
start = (P.x, top + clearance, P.z)
end = (P.x, P.y - 2*r, P.z)
if segmentQuery(start, end, 0) hits F:
resolvedY = F.y + r*h
if preventLowering(slot0x208) and P.y > resolvedY: return
setPosition(P.x, resolvedY, P.z)
zero acceleration.Y and velocity.Y, preserving X/Z
setGrounded(true)
preserve hit polygon and shape for callbacks
```
The ray span uses the conditional `clearance`; the final support height adds
the stored product `r*h`. The distinction matters for factors below0.1, although
ordinary Jimmy's1.265 branch uses the same product in both places. Ray assembly
is `0x47BA33..0x47BAD1`, hit Y plus product `0x47BAE1..0x47BAEF`, position write
`0x47BB23..0x47BB32`, grounded write `0x47BB7C..0x47BB80`. The handler invokes
an optional interface landing hook only when prior grounded byte `0x695D49`
was false (`0x47BB51..0x47BB5E`).
For radius60 and PostLoad factor1.265, float32 clearance is **75.9000015** world
units. At the actual lab spawn XZ, the only source polygon below GAM root26.6619
is Box06/shape71/polygon497/material17 at Y=0.5486332333; its stored normal is
approximately `(−0.00002292,1,−0.00002965)`. The next vertical hits are overhead
surfaces at473.6309 and491.0861. Thus the ordinary successful flat support branch
predicts physics root Y about **76.448635**, not a permanent root-to-floor offset
of26.1133 inferred from serialized GAM placement.
That is a conditional static prediction, not an original frame capture. Initial
GAM placement can be corrected by physics after loading. With raw standing
minimum local Y=-64.6165, the predicted root would put its lowest raw vertex
11.2835 units above that floor. This remaining discrepancy must not be turned
into an invented scale factor. The port's present sole-based render transform
and floor-derived actor offset remain separate approximations.
## Shape bounds and render transform
Complete-object shape-change hook `0x462270` reads current shape pointer `+0x8C`,
copies shape bounding-sphere radius `shape+0x4C` into interface slot `0x110`,
then asks shape virtual `0x44` for six cube bounds. It forwards two four-float
records through interface slots `0x2E8` / `0x2E0`, stored at `+0x1D4` /
`+0x1C4` by `0x472120` / `0x4720C0`. These are bound records, not a recovered
capsule radius/height constructor. Jimmy's explicit PostLoad radius60 follows
the base-shape restore and therefore overrides the automatically copied radius.
OMT shape `prepare` at DLL `0x100062A0` computes sphere center and maximum
vertex distance (`0x100062EE..0x10006389`) using the bounding-box center finder
`0x10005470`. This computes bounds and does not itself move the vertices.
Physics-to-render position hook `0x4624B0` reads interface slot `0x310` and copies
XYZ directly to complete-object offsets `+0x44,+0x48,+0x4C` (interface-relative
`-0x7C,-0x78,-0x74`) at `0x4624CA..0x4624E8`. No extra vertical translation
or scalar multiplier occurs in this hook.
Jimmy complete-object slot `0x7C` targets import thunk `0x47EDB4`, which jumps
through IAT `0x48D36C` to OMT `get_dynamic_offset@OMedia3DMorphAnim`, DLL
`0x100033F0`. It reads current animation frame `+0x98` and returns that frame's
XYZ offsets `+0x08,+0x0C,+0x10`; without a frame it returns zero. Base frame
constructor DLL `0x10021180` initializes those offsets to zero. Therefore this
hook has no hardcoded Jimmy floor/pivot adjustment. Full converter/frame writes
still need controlled probing before asserting every relevant offset stays zero.
## ASE object mode2 does not imply a scale correction
The DLL object-mode global `0x1013D6CC` has five absolute-address references in
the inspected binary (the script lists their operand addresses). ASE-specific
reads at `0x1001396E` and `0x10013CBF` control GROUP/GEOMOBJECT separation. ASE
constructor `0x10012DF1` sets its "first object" flag1 and `0x10012DF7` sets
group depth0. In object mode2, the first ungrouped GEOMOBJECT clears that flag
and does not request a new shape (`0x10013CD2..0x10013D15`).
`jimstop.ase` contains one GEOMOBJECT, no GROUP and no TM_ANIMATION. Its ordinary
vertex-list handler `0x10014EE0` parses each XYZ, swaps Y/Z and appends the
four-float vector to either base-shape vectors or the current morph frame
(`0x10014F59..0x10014FA8`). There is no multiplication by NODE_TM scale or a
constant0.4 in that handler. NODE_TM parsing `0x10014130` stores matrix rows
and an inverse matrix in converter state; this is not evidence that the baked
mesh vertices should be transformed a second time.
The earlier mode0 probe matched raw standing bounds (rendering.md). The follow-up
mode2 animated probe now also matches them; its two jimstop frames both have
offset(0,0,0). Do not apply an unproven0.4 scale or call the actor pivot solved.
## Static scene inclusion versus entity activation
Static grid registration is `0x479140`, called by scene-object InitPhysics
`0x464B00`. It visits every shape polygon and makes these exclusions:
1. `0x4794C0` handles checkpoint materials named exactly `cstart` or
`ccheck1`..`ccheck9`, marking their polygon word at `+0x1C` as4 and calling
the game checkpoint hook.
2. `0x4797A0` asks game virtual slot `0x134` whether to consume a polygon.
For CJimmyGame and CLevel01BGame this slot is `0x475CD0`, which returns false.
3. Otherwise it computes polygon centroid/radius and XZ bounds, then registers
it in a260×260 grid with cell index `trunc(world*0.002+130)`.
The checkpoint filter immediately returns false when polygon material is null
(`0x4794E8..0x4794ED`). **Null material is therefore retained for static collision**,
even though it is skipped by drawing. This directly supports retaining the lab's
325 unresolved-material triangles. The actual LV1B materials contain no
`cstart`/`ccheck*` names, so all2,869 source triangles reach this registration
path. No general "decorative" name filter was found in it.
Two grids are populated: all polygons at base `0x5CFC7C` and a wall/ceiling grid
at `0x509B24` when stored polygon normal.Y is strictly below0.7
(`0x47987D` captures normal.Y; `0x4798B3..0x4798CF` performs the comparison).
The vertical segment query `0x47C6E0` uses the all-polygon grid, retaining the
nearest hit along the input segment. The static sweep `0x47B4B0` uses the
wall/ceiling grid. Its radius comes from interface slot `0x260`; closest-hit
state feeds recursive sliding and callbacks. Its full narrow-phase behavior
`0x47BBB0 ->0x47BD80` remains incompletely translated, so the current port's
two-sided capsule and0.65 slope threshold are still provisional.
Entity collision is a different layer. HasCollision registration at `0x40D423`
binds a type6 property to interface `+0x584` (complete object `+0x644`). During
activation, `0x40E40A..0x40E45D` treats-1 as "retain default", zero as disable
(slot `0x3A4` plus slot `0x214=false`), and nonzero as enable (slot `0x3AC` plus
`0x214=true`). This is separate from visibility and the all-polygon static grid.
Actual LV1B values are nine default-1, one explicit1 and seven explicit0.
Carl is explicitly enabled; plant/teleport/OMT props provide explicit exclusions.
`DisableCollisionID` `0x4730F0` searches global entities by ObjectID at interface
`+0x404` and adds matches to the caller's exclusion list `+0x254` if absent;
`EnableCollisionID` `0x473170` removes matching entries. Parent/entity analysis
also recovered the ordinary pair test at `0x47B3E0`: strict actor-root Euclidean
distance less than the sum of current radii, followed by exclusions. Mode2 pair
geometry follows another path and must not be replaced with that metric blindly.
## Recovered guard, ray kernel and frame phase
Support slot208 is4719D0, reading interface+13A. Guard47BAFD..47BB0A rejects
currentRoot.Y strictly greater than hitY+r*h. It does not inspect velocity; it
prevents lowering a body above support even while that body is descending.
C3DAI constructor407B4D..51 enables the authored flag through470F70, which
forwards to current flag setter4719E0. The earlier label "upward guard" was
imprecise. Clearance comparison48D920 is float0.10000000149, not0.5.
Goddard inherits support factor0.30000001192 at407B2B/407B30; PostLoad41E64A/
41E651 overrides radius to130, so ordinary flat clearance is39.0. No corresponding
factor override was found in the traced Goddard constructor/PostLoad path.
EXE469B70 is a Moller-Trumbore-style segment test. It normalizes direction using
quick_magnitude, retains source winding, and accepts determinant<=-epsilon when
twoSided=false, or absolute determinant>=epsilon when true. Epsilon4D5E40/44 is
±1.1920928955078125e-7. Barycentric u/v boundaries are inclusive; t>=0 is accepted
but t>=segmentLength is rejected (469DDD/469DEE). Hit XYZ is correct: the pop edi
at469DF6 shifts subsequent stack operands, so apparently repeated offsets do not
mean repeated direction components.47C6E0 retains strictly nearer hits; equal ties
follow original grid traversal. No slope-normal cutoff is applied by this query.
Physics479D20 captures prior grounded via218 at479D2E, saves695D49, and clears
current grounded through21C at479D4E when geometry-support flag1C8 is set.
Impulse/acceleration/gravity integration precedes wall/ceiling resolution47B4B0;
support47B890 is called at47A235 after the resulting position is assigned, then
friction47A330 and small-velocity clearing follow. The new support module preserves
this phase boundary; it is not the entire479D20 implementation.
## quick_magnitude lookup recovery and actual DLL comparison
OMT1001FF70 keeps largest absolute component m and other components a,b, computes
index=trunc((a²+b²)*16384/(a²+b²+m²))&16383, then returns m/sine[halfAcos[index]].
Initializer100EDC00 uses these stored doubles:
- sine[i]=float(sin(i*0.0003834951969604492)), with exact quadrant overrides;
- halfAcos[i]=trunc(acos(i/8192.0-1)*2607.5945876921437*0.5).
This is a sine table, not the cosine table initially suspected. The isolated
copied-DLL probe observed FNV1a32 fingerprints431383b5 for all16384 sine floats
and4f800433 for all16384 half-acos words. Modern Python regeneration matches both
whole-table fingerprints. The C# function also matches eight actual original-DLL
float-bit outputs, including3/4/0 ->40a0001e,1/1/1 ->3fddb16e and500/100/300 ->
4413eb31. Zero is handled directly in the port; the observed DLL also returns0.
This verifies these math references on the tested environment; it is not a full
x87 arithmetic or native Windows gameplay equivalence claim.
## Implemented boundary and validation
src/GamePort/Game/OriginalBodySupport.cs provides QuickMagnitude, a source-winding
Trace over supplied SupportTriangle records, and Resolve for SupportBody input.
Resolve returns root/velocity/acceleration, supported/landing flags, source hit
identity and the support anchor written via2F4. The caller owns prior/current
grounded phase, geometry-registration masks, landing callback and hit bookkeeping.
Trace scans linearly instead of260x260 grid traversal; tie identities can differ.
Double/single arithmetic does not reproduce every x87 temporary rounding boundary.
This is a separate root-support component, not a replacement feet capsule.
Run source scripts/env.sh then dotnet run --project tests/GamePort.SupportTests.
All13 groups pass: original-DLL math bit references; source winding/two-sided
override; strict endpoint/start; nearest/tie identity; root/velocity/acceleration;
height guard independent of velocity;0.1 factor boundary; crossed-geometry query
lift; disabled geometry; invalid input; ten-second gravity stability/jump; actual
2869 lab triangles including invisible proxies and predicted root76.448635.
tools/binary/collision_mode2_probe.c builds with local i686-w64-mingw32-gcc and
runs only via tools/recon/reference_capture.py --asset-probe --probe-executable
artifacts/binary/collision_mode2_probe.exe in a copied installation. Original and
network paths are absent from that namespace. Artifacts/binary/mode2-jimstop.log
records successful conversion:426 points, matching raw bounds, one sequence/two
frames and zero offsets. An initial probe-reader error treated sequence pointers
as frames; the corrected bounded vector-of-sequences/list-of-frames traversal
was verified against100203C0/10020870. No original assets were written.
The follow-up jimjump animation-only conversion also succeeds after allowing its
legitimate empty base shape: one sequence, three frames of426 points, all offsets
zero. See artifacts/binary/mode2-jimjump.log. Empty base center/bounds are not
initialized geometry and must not be interpreted as a transform. The final probe
suppresses that center output when the base is empty.
Full horizontal/ceiling narrow-phase sliding, dynamic collider activation/boxes,
exact body/render pivot and original gameplay/native Windows comparison remain.
+252
View File
@@ -0,0 +1,252 @@
# Original patrol and Goddard lab route
Static evidence from the immutable `Original/Neutron.exe`, `OMT2.dll` and
`gam/level1b.gam`, investigated 2026-10-24. Addresses below are preferred-base VAs;
the executable text file offsets are VA minus `0x400000`. No successful original
runtime comparison verifies the resulting motion. The follow-up at the end records
the bounded runtime AI implementation and its separate test/physics limits.
## Relevant dispatch and fields
Goddard's interface pointer is complete object plus `0xC0`. His interface vtable
is `0x49F480`, complete-object vtable `0x49F920`. His update `0x41DEE0` reaches
the general AI update `0x408000` at `0x41E520` for the ordinary patrol state,
after clearing interface `+0x8A8` (complete `+0x968`, animation override).
|Complete offset|Interface offset|Meaning/evidence|
|---|---|---|
|`0x6C4`|`0x604`|Movement speed, float; AI trigger integer AISpeed converted to float|
|`0x6C8`|`0x608`|Current AI state; `3` is patrol, `1` is waiting, `7` is timed waypoint wait|
|`0x6CC`|`0x60C`|Previous AI state, assigned by setter `0x4089B0`|
|`0x6E4..6EC`|`0x624..62C`|Destination minus current root position|
|`0x6F4`|`0x634`|Within arrival distance flag|
|`0x6FC`|`0x63C`|Exact square-root 3D destination distance|
|`0x708`|`0x648`|Initial PatrolPoint tag|
|`0x820`|`0x760`|Patrol/run animation alias|
|`0x870`|`0x7B0`|Waiting animation alias|
|`0x8C0`|`0x800`|Current waypoint interface pointer, initially null|
|`0x8C8`|`0x808`|Previous waypoint pointer|
|`0x8D0/8D4/8D8`|`0x810/814/818`|Euler smoothing factors X/Y/Z|
|`0x8E8..8F0`|`0x828..830`|Current destination root position|
|`0x90C`|`0x84C`|Timed waypoint wait remaining seconds|
|`0x944`|`0x884`|Arrival threshold, default `110.0f` at `0x407D9A`|
|`0x948`|`0x888`|Alternate movement mode flag, default zero; nonzero uses facing vector and threshold440|
|`0x968`|`0x8A8`|Suppress automatic animation selection while nonzero|
The normal lab Goddard path uses default arrival threshold110 and mode flag0;
the inspected Goddard constructor does not replace those defaults. His Euler
smoothing factors are explicitly overridden to `(0.3,3.2,0.3)` at
`0x41C8DB..0x41C90C`.
## State3 movement, arrival and update order
The general AI state dispatch table at `0x408980` maps state3 to `0x408518`.
Before that dispatch, `0x408000` calls animated/base update `0x40E050(dt)`.
That calls shared physical integration `0x462520`, which reaches game physics
through slot `0x130`, and then `0x458930 -> 0x473240`. The latter calls the
AI interface slot `0x3D8 -> 0x4096E0` for orientation smoothing. Thus previous
velocity and previous desired Euler angles are consumed before this update
computes the next patrol velocity and angle target. A port that immediately
integrates the newly selected velocity differs by one simulation tick.
Patrol performs the following operations in source order:
1. Complete slot `0x12C -> 0x408C90`: when current waypoint pointer is null,
resolve PatrolPoint tag (`complete+0x708`) with first case-insensitive tag
lookup `0x474070`. If still missing, set state1 and clear horizontal velocity,
preserving its Y component. Otherwise call complete slot `0x130`.
2. Slot `0x130 -> 0x408D40`: normally copy waypoint root to destination and compute
`delta = waypoint.Position - actor.Position`. Store full 3D Euclidean distance
(`sqrt(dx*dx + dy*dy + dz*dz)`) at complete `+0x6FC`. A separate movement
special flag can retain a previous destination; its nonordinary behavior is
outside this lab route.
3. Ensure the patrol/run animation is active (`0x408549..0x40856A`), looping,
unless animation override is nonzero.
4. Unless an independent temporary-target timer is positive, complete slot
`0x134 -> 0x408E40` computes `velocity = delta / quick_magnitude(delta) * speed`.
State3 has multiplier1. Full XYZ velocity is assigned, rather than retaining
old vertical velocity. If already marked arrived, assign zero XYZ instead.
5. Complete slot `0x128 -> 0x408BC0` compares exact stored distance with threshold.
**Strictly less than110** sets arrived true and calls an arrival virtual
method. Distance greater than110 clears an existing arrival flag for state3;
exactly110 leaves it unchanged. The arrival method is `0x41E580 -> 0x409890`
for Goddard and does nothing in state3 (its special branch is state10).
6. If arrived and the current pointer is a PAT, process wait/next below.
7. At `0x408958..0x40896C`, complete slot `0x138 -> 0x409140(dt)` computes new
destination Euler angles from the final destination-minus-root vector.
The velocity assignment therefore precedes the arrival comparison: on the first
update entering the arrival radius, it may retain a nonzero newly selected
velocity for the next physical step while already selecting the next waypoint.
There is no normal exact-position snapping, remaining-distance speed clamp, or
multiple-waypoint traversal loop in this branch.
When a new waypoint is selected, arrival is not immediately cleared or distance
recomputed. On the next update the old arrived flag can therefore select zero
velocity/WAG before the newly computed distance clears that flag; subsequent
update selects RUN and movement again. Avoid replacing this order with a
smooth continuous multi-segment walker while describing it as recovered.
`quick_magnitude` is the OMT export at `OMT2.dll:0x1001FF70`, imported through
`0x48D104`. It uses absolute components, largest-component selection and lookup
tables rather than a direct sqrt. The follow-up `OriginalBodySupport.QuickMagnitude`
now reconstructs those tables from their recovered initializer constants; modern
trig versus original x87 table equality remains unverified. Arrival itself uses
sqrt, not this helper. Zero delta is handled defensively by the port instead of
depending on the original invalid float-to-integer conversion behavior.
## WaitTime and NextPatrolPoint
PAT property loader `0x434DE0` operates on the PAT interface (complete plus
`0xC8`):
|Property|PAT interface offset|PAT complete offset|
|---|---|---|
|CallObjectTag|`0x520`|`0x5E8`|
|ActivateAnim|`0x584`|`0x64C`|
|SoundDatabase|`0x64C`|`0x714`|
|SoundIndex|`0x714`|`0x7DC`|
|NextPatrolPoint|`0x5E8`|`0x6B0`|
|WaitAnim|`0x6B0`|`0x778`|
|WaitTime|`0x718`|`0x7E0`|
At `0x40861F..0x408698`, **WaitTime>0** enters state7, starts PAT.WaitAnim loop1
unless animation override is active, copies WaitTime to actor wait timer and
sets XYZ velocity zero. State7 `0x408370..0x408414` subtracts dt only while the
timer was positive at entry; if the result is **less than or equal to zero** it
restores the previous state, clears arrival and resolves this waypoint's
NextPatrolPoint. It does not consume leftover time to move through the next
segment in the same update. The exact-zero case corrects an earlier report
reading: `0x40838C` uses `test ah,0x41 / jne` to skip an initially nonpositive
timer, whereas `0x4083B0` uses `test ah,0x41 / je` to keep waiting only after a
positive result. On equality x87 C3 makes `ah&0x41=0x40`, so expiry occurs.
The comparison constant at `0x48D914` is float0. A timer already zero at entry
remains in state7. The timed-wait next-point lookup at `0x408406` does not
interpret missing `WAIT`/`SCAN` names specially; the immediate branch below does.
For WaitTime<=0, `0x40869D..0x408757` immediately saves the current pointer as
previous and resolves NextPatrolPoint. If the lookup fails, the literal `WAIT`
sets state1 and literal `SCAN` sets state6. A nonexistent ordinary name, including
`none`, compares unequal to both special literals and leaves state3 until the
next `0x408C90` lookup of initial PatrolPoint; this detail is easy to miss.
`none` is not equal to `WAIT`. Consequently this path can restart a route on the
next update instead of necessarily becoming idle. Any port choosing to stop at
`NextPatrolPoint=none` is making a terminal-route policy approximation, not an
exact translation of these instructions. For the lab cutscene, a later authored
GODDARDDIS action interrupts patrol and explicitly sets state1/SIT/phone2.
CallObjectTag/ActivateAnim/SoundIndex are serialized and loaded, but their generic
execution is **not** recovered from this normal Goddard branch. PAT touch handler
`0x434EA0` calls base touch then only logs when a C3DAI is in state2. All lab PATs
have CallObjectTag=`none`; no invented callback is necessary for Goddard's route.
## Goddard animation and authored route
Goddard constructor (`0x41C9A3..0x41CA79`) sets aliases:
complete `+0x7F8=WAG`, `+0x820=RUN`, `+0x848=FLY`, `+0x870=WAG`,
`+0x7D0=WAG`, `+0x898=RUN`. Literal RUN is at `0x4ECA64`; WAG at `0x4ECA68`.
State3 update therefore replaces the trigger's AIAnim=`walk` with RUN on the
next update, without requiring an invented WALK-to-RUN asset alias. State1
setter starts WAG unless animation override is nonzero; state1's steady update
does not itself force a new alias. A trigger can therefore preserve an explicit
SIT in state1 when its animation override suppresses the setter default.
|Tag / GAM offset|Position|Next / wait|
|---|---|---|
|gstart / `0x960A`|`(4801.444336,38.160038,669.824158)`|none, wait0, WaitAnim sit|
|GODDARDPAT1 / `0x3D5F`|`(5011.098633,16.988688,716.637146)`|GODDARDPAT2, wait0|
|GODDARDPAT2 / `0x3F69`|`(5244.313477,26.268572,-249.976944)`|none, wait-1, WaitAnim sit|
GOGODDARD AIT at GAM`0x3918` sets target C3DGODDARD, AIState3, AISpeed260,
AIPatrol GODDARDPAT1 and AIAnim walk, then immediately begins WATCHGODDARD.
SITGODDARD previously positions Goddard at gstart with yaw180. GODDARDDIS at
GAM`0x48D4` later interrupts by setting AIState1, AIAnim sit, AINewPos phone2,
AINewRotY10. None of these AI triggers waits for patrol completion.
## Heading smoothing and remaining limits
Desired orientation `0x409140` calls OMT vector.angles through `0x48D108`
(`OMT2.dll:0x1001FDA0`), scales the returned integer angular units by
`360/16384 = 0.02197265625f` (`0x48E5B4`) and writes destination Euler angles
through `0x472660`. In the ordinary flat yaw case, the equivalent heading is
`atan2(-delta.X, delta.Z)` in degrees. This mathematical atan2 equivalence is an
approximation to the original table quantization.
The following frame's `0x4096E0` wraps each destination-minus-current Euler delta
at180 degrees, then adds `wrappedDelta * axisFactor * dt`; Goddard Y factor3.2
is recovered above. Factor clamping is absent in this routine. The routine first
checks enabled/dirty flags; collision/arrival conditions can skip updating desired
heading. Full pitch/table equality and actor-floor contact matching remain open.
Shared world gravity/collision also applies during the base update; replacing
the full body solver by direct waypoint interpolation or floor clamping must be
recorded as a port approximation. General stuck recovery `0x40A250`, temporary
targets and AI states other than the normal state3/7 path are not covered here.
Read-only verification checked 17 executable dispatcher/vtable/string and GAM
route assertions: state3 dispatch, patrol virtual targets, WAIT/SCAN/RUN/WAG
literals, both route links, speed260, final WaitTime-1, and absence of actors
named none/WAIT/SCAN. This establishes consistency of the static evidence, not
runtime or visual fidelity. No original files or C# source were changed.
## Runtime follow-up
`Game/ActorPatrol.cs` implements ordinary states1/3/7 plus the common base phase
for state9. Carl state6 also receives that phase; its general FOV/visibility
sensor409CC0 remains unimplemented, while SceneInteractions handles source contact
dispatch. Other states are outside the supported subset. It exchanges root position/velocity
through the injected `PatrolBodyState -> PatrolBodyState` body step. Its own
algorithm does not invent a body radius, support factor, collision solver or
floor clamp. It consumes the prior velocity, smooths the prior yaw target by3.2,
selects RUN, computes the next fullXYZ velocity, compares exact distance and then
processes one waypoint/wait transition. The recovered table magnitude helper is
the default normalizer; a separate injected metric remains available for tests.
Follow-up disassembly also verifies ordinary state1 zeroes XYZ at`0x40835D`
**after** the base physics update. The missing-initial-point transition preserves
Y at`0x408D1E..26`; its enclosing state3 branch still passes through RUN selection
after the resolver returns. States1/6/7 skip new destination-angle selection at
`0x409186..19B`. The port keeps their authored animations rather than forcing
WAG every idle tick. The subsequent TELGODDARD2 camera explicitly requests TALK
after GODDARDDIS requests SIT;40DF18..22 proves this unregistered TALK request
leaves the selected SIT clip/name unchanged. SceneActorVisuals retains that no-op.
The runtime's authored teleport synchronization resets its velocity/route cache
and preserves the authored yaw/animation. This is an explicit port reset policy;
full original teleport bookkeeping is not recovered. Camera-only animation
events do not reset the route. Heading currently changes yaw only using atan2;
full pitch, original angle quantization, dirty flags, temporary targets and stuck
recovery are not implemented here. Physics and original runtime comparison remain
separate integration/validation work.
Verification from `GamePort`:
```sh
source scripts/env.sh
dotnet run --project tests/GamePort.PatrolTests/GamePort.PatrolTests.csproj
```
All9 deterministic groups pass: prior velocity/yaw phase; velocity-before-arrival
and waypoint pause; strict110/equality behavior; wait expiry at exact zero and
discarded remainder; WAIT/SCAN/none and lookup precedence; missing initial Y
preservation and fullXYZ velocity; authored teleport/cache handling; injectable
normalization separate from sqrt arrival; and the actual GAM Goddard route plus
GODDARDDIS interruption. Free-body/held-body fixtures validate AI ordering, not
original body physics, rendering or original gameplay fidelity.
## Carl profile and live integration
Carl constructor413BCB sets speed200. It installs WALK at complete820/898 through
413BFC..1D (literal4ECA54), STOP at7F8/870 through413C22..43 (literal4ED040).
Its yaw smoothing factor remains inherited3.0 from407CF8; Goddard overrides3.2.
The shared state3/7 code is therefore reused with class-specific aliases/factors.
State9 dispatch table408980 jumps directly to408911, adding no new velocity or
animation command. State6 calls the still-unported sensor409CC0 before this
common finisher. No arbitrary proximity-to-dialogue-end task rule was added.
Live runtime bodies now use recovered Goddard130/.3 and Carl100/.75 root support,
source-winding floor queries and the exact source normal.Y<.7 wall-grid mask.
The wall response is still the port's swept sphere, not the original47BD80 solver.
Visuals use those actor roots without an additional sole-based correction.
The remaining raw-sole/root clearance difference is documented in collision notes.
Primary added a tenth test group for Carl's profile, speed, yaw factor and state9.
+104
View File
@@ -0,0 +1,104 @@
# Source entity resources and contact investigation
Read-only 2026-10-24. tools/extractors/entities.py prepares exact GAM typed fields,
sourceSHA/offsets/raw bytes, transforms, duplicate tags, object-link candidate
ordinals, and explicit database/type/id references. It does not decide gameplay
visibility or turn editor SpriteDatabase icons into game actors. --decode preserves
referenced PCM WAV, Canv RGBA/PNG and3DSh decoded JSON. Tests check preservation,
case lookup/ambiguity, path boundaries and actual lab/VR01 resources.
LV1B has129 entities:19 PIC,20AIT,13CAM,12MCA,16PAT,4OMT,2LOAD,2buttons and a bars
object, plus actors/effects. Its62 explicit resources resolve. VR01 has16 entities,
4star pickups IDs3001..3004 (sprites.omt Canv135 star, PointValue5,radius100),
2RETURN gates,2phone booths, trophy and a3-shot voicepractice intro24/23/22;
10 unique explicit resources resolve. Static level geometry omits dynamic actors.
## Verified visual mappings
- Carl STOP carlstop.ase0x4EDBC0 registered413DDC; texturecarl.png0x4EDBB4 at413DF2.
TALK/WALK/INHALE/CHEER/TELE registrations413D8C..413DE8; actual strings have HI
quality prefixes. Raw morph animation timing/quality dispatch remains incomplete.
- Goddard godsit.ASE0x4EEA0C registered41CDDE, goddard02.png0x4EE980 at41CE58.
HI-prefixed registrations41CDA0..41CE5F include FLY/EAT/RUN/SIT/SCOOT/WAG/GROWL/
ROCK/POINT. Godpoint has complete UVs; godsit/run/growl have none. Current actor
preparation retains godpoint UVs for the common222-point/411-face topology;
this base choice is an inference. Godwag has30 different expanded corner UVs.
Follow-up40DF18..22 proves unregistered STOP/TALK/WALK requests preserve the
current clip/name. The consumer retains that source no-op; it invents no aliases.
- Trophy trophy.ase0x4F16E4 at448E1F; trophy.png0x4F16D8 at448E3A. Update448EC0 spins
Y90deg/sec (constant0x4A7388). Contact448F20 accepts active player, hides, adds300
score, plays effect230, disables contact. No task/level completion in that callback.
- Phone class43579D opens phone.omt0x4F0314, shape3DSh0 via477BA0 at4357C9. Do not
substitute similarly named phone.ASE/phone.png without evidence.
- Buttons explicit down/up ASEbuttondown/buttonup and switch.png bind411695/
4116C3/411722. Bars explicit GAM ASEFilebars.ase/PNGFilechain.png.
- SpriteSize is actual world width/height: EXE4645F0 sets complete+AC/B0, C4 bit1;
OMTget_canv_wordsize10029930 reads them. Align values3/3 center offsets by half
size via10029890. Exact billboard flag248 handling remains under investigation.
## Contact and pickup rules
PIC interface+C8 vtable4AE548 contactslot40->435CE0. LOAD interface+C8 vtable4D025C
contactslot40->457EC0. Shared0x47A430 uses sphere path0x47B3E0 unless collisionmode
slot178 returns2, which uses specialized box path47A5E0. Sphere overlap obtains
roots via slot310, quick_magnitude, compares STRICT distance <radiusA+radiusB
(slot260), applies exclusion lists47CA90, invokes enter40 once, stay48 while
recorded, leave44 on separation. It is not a per-frame pickup callback.
quick_magnitude (OMT1001FF70..10020059, imported48D104) uses abs components, squared
ratio and original acos/cos lookup tables; Vector3.Distance is an approximation.
Jimmy normal interaction radius60 (different state160) is established in original
collision notes; this is not evidence to resize the provisional physical capsule.
PIC accepts only global active player5099E4. Acquired flag table4F8438 indexed by
PickupIndex prevents repeat. RequiredPicNum gate436830 requires group2 inventory
state nonzero and count>=ReqPicNumAmount, then consumes that amount and clears
inventory if depleted. This is a consuming prerequisite, not only a check.
PointValue>0 adds global score through42ADC0, lower-clamped0; repeat count gates it.
Normal collected flag1 hides/disables; PickedUpIndex!=-1 path uses flag2/effect.
Inventory/special pickup effects remain to be completed before broad collection.
These data/executable findings are not full runtime entity or interaction support.
Only Carl/Goddard and Jimmy morph consumers are currently integrated into --story;
source sprites/OMT props/phones/trophy/buttons/bars still require runtime consumers.
## Implemented sprite/contact subset (primary follow-up)
Source3ANI update40ED40 adds dt to a float timer and advances only when timer is
strictly greater than1/FPS; resets timer0, advances one frame per invocation,
discarding remainder. Loop0 stops on last visible frame,1 repeats,2 hides/stops
(40EF02..41). Toggle40F160 resets index/timer and shows/starts on1, hides/stops
on0, -1 toggles subject to its one-second debounce. Port implements explicit0/1
from the director; debounced-1 sprite toggles remain pending. Task activation is
separate from the AnimatedSprite Activated field: a visible apple can be idle.
SourceSprite1..9 resources are now exported, and source-sized centered quads
render3PIC/3ANI from their explicit Canv resources. Camera-facing orientation is
still an approximation. Color modulation is retained; translucent alpha/blending
and all billboard flags remain to be recovered. Editor icons are not rendered.
SceneInteractions currently accepts the ordinary3000..3999,PointValue5, no-inventory
star subset and trophy; broader pickup inventory/special effects report unsupported.
Normal acquired flag1 at435E11 hides/disables; score path435FC3..436002 adds positive
PointValue under repeat gating. Special tags4365D0..436829 are intentionally not
silently treated as plain score pickups. Original VR01 fixture tests collect4stars
for20, trophy for300, prevent repeat, serialize/reload acquired flags, and emit a
single stored RETURN request per contact entry. Original quick_magnitude and
exclusion/box contact rules remain unresolved; modern root-sphere distance is used.
The executable's RETURN branch457F92..4580BE reads Jimmy complete+88C (saved third
string) and+8F0 (fourth string), supporting stored ReturnLevel/ReturnStart semantics.
Headless VR01->LV1B renderer/window-lifetime integration passes. Fades are not yet
implemented. Acquisition is serialized in TSK; full game-state/UI saving remains
unfinished. Trophy disable is per scene; no invented permanent trophy flag is added.
All35 GAM files are present, including Level3B.gam and Level3E.gam. Their matching
OMT geometry archives are absent and named by the executable at4F1F24/4F1FFC.
Both1777-byte GAMs have identical bytes after the level identifier and four entities;
no serialized incoming GAM transition or supplied save selects them. Original
class registration/loading paths do not establish use in normal progression.
Their absence is not a proven required-content blocker.33 available pairs are
generated; scene-catalog.json records unavailable geometry without substitution.
See level-resource-mapping.md for loader and corpus evidence.
Additional unresolved explicit references: LEV1 icons.omt Canv45 (editor icon),
LV5A musicrocketmaze.omt Wave2, LV2A musicschool.omt Wave2. No substitutions.
+120
View File
@@ -0,0 +1,120 @@
# Source-backed static scene models
Implemented 2026-10-24 in `tools/extractors/models.py` and
`Application/StaticSceneVisuals.cs`. This adds the original model consumers for
OMT props, phone booths and explicit ASE/PNG entities. It does not establish
complete interaction, door collision, animation playback or visual fidelity.
## Evidence and prepared fixtures
LV1B has nine relevant model instances, sharing six source models:
| Source entities | Original model | Triangles per instance | Texture binding |
|---|---|---:|---|
| PHONE1 / PHONE2 | `phone.omt`, `3DSh:0` | 90 | Three original material/canvas links |
| bars | GAM `ASEFile=bars.ase` | 54 | GAM `PNGFile=chain.png` |
| Two `C3DBUTTON` records | GAM `Up.ase` / `Down.ase` | 16 each variant | GAM `UpDown.Png=switch.png` |
| dino | GAM `objects.omt`, `3DSh:27` | 256 | Original material27 -> canvas26 |
| plant1 / plant2 / plant3 | GAM `objects.omt`, `3DSh:28` | 168 | Original material28 -> canvas27 |
VR01 has two phone booths, using the same verified `phone.omt:3DSh:0` source
binding. Both booth instances remain separate even though their GAM tags match.
The phone class opens `phone.omt` at EXE `0x43579d` and selects shape0 at
`0x4357c9`. The similarly named `phone.ASE` and standalone `phone.png` are other
assets and are not substituted. Its three material links are `{0:Canv1,
1:Canv0,2:Canv2}`. The 90 triangles span **five** source material draw ranges,
with index counts `[120,6,12,6,126]`; retaining only a single final draw would omit
parts of the booth.
Button resource registrations are recovered at EXE `0x411695`, `0x4116c3`,
`0x411722`. InitObject at `0x411b93` selects literal `UP` (`0x4ed9bc`), so the
default static variant is source-backed. The consumer recognizes `UP` / `HIUP`
and `DOWN` / `HIDOWN`. It displays the first authored pose of the selected
variant; it does not imply that button morph transition timing is reconstructed.
Bars and other explicit ASEFile/PNGFile pairs retain the first authored sample
and the proven ASE-to-OMT axis/UV conversion. No additional node transform or
floor correction is introduced.
## Preparation interface
```python
prepare_models(original: Path, level_file: str, output: Path) -> dict
```
From `GamePort/`:
```sh
python3 tools/extractors/models.py --level level1b.gam --output artifacts/extracted/level1b/models
python3 tools/extractors/models.py --level VR01.gam --output artifacts/extracted/VR01/models
python3 -m unittest discover -s tests -p test_models.py -v
```
`models.json` schema1 contains:
- Source GAM path/hash and level code.
- `models`: unique keys, relative scene JSON paths, source hashes/resource
identities and geometry counts.
- `actors`: original ordinal/byte offset/tag/class, default variant, variant-to-
model-key references, and mapping evidence.
- `unresolved`: incomplete explicit mappings; no class default is invented.
Each OMT model exports only its selected `3DSh` and transitively referenced
`3DMa` / `Canv` resources. Source material/texture IDs remain local inside each
model scene file. No unrelated archive geometry is copied. Existing ASE and PNG
assets are decoded locally, without modifying originals.
The source corpus contains one Level3C button at GAM offset33909 whose explicit
`UpDown.Png` is `none`. It is recorded unresolved and omitted from model actors
until its actual constructor/fallback binding is recovered. LV1B/VR01 have no
unresolved entries in this subset. Other classes without explicit bindings are
outside this consumer and are not presumed invisible or complete.
## Runtime interface and invariants
```csharp
new StaticSceneVisuals(Mesh combined, SceneDirector director,
string assetsRoot, string preparedRoot);
Mesh Mesh { get; }
void Update(Mesh destination);
```
`preparedRoot` is the scene's `models` directory containing `models.json`.
All required geometry/texture bytes are prepared; no speculative runtime fallback
uses `assetsRoot`. Actor lookup uses original source GAM byte offsets rather than
tags, preserving duplicate tags. The integration can append later consumers and
pass the resulting combined mesh to `Update`.
All source model vertex/index/draw ranges are retained. Each instance/variant
gets distinct texture IDs starting at `int.MinValue+20000`; preexisting identity
collisions are rejected. The actual lab consumer adds19 original draw ranges
and15 texture identities. Every phone material draw follows actor visibility.
Button inactive variants keep allocated ranges but do not draw.
Director position/rotation updates transform original local vertices directly.
The current shared actor rotation convention is X, negative yaw Y, then Z,
followed by the director position. Exact general Euler composition still requires
original comparison; tests establish the implemented translation and yaw behavior.
No character grounding/floor correction is applied to these props. Bars movement
is visible only when a separate recovered gameplay consumer changes its actor
root; this visual consumer itself does not invent opening motion.
Null material handling matches the existing original DX rule: preserve geometry
but skip draws whose original material is null or unresolved. The original LV1B
invisible proxies reference absent material18; selective extraction preserves
those links and reports `nullMaterialIds` rather than fabricating a white material.
An explicit empty draw list stays empty on mesh integration.
## Verification
Eight Python test groups include a locally compiled .NET10 consumer harness.
They verify actual phone geometry and all five material ranges, explicit model
bindings, OMT subset export, duplicate tags, source hashes/output boundaries,
missing mapping reporting, distinct texture IDs, translation/yaw/no floor
correction, hide/show, independent button variants, retained combined buffers,
reserved-ID conflict rejection, and null-material geometry without invented draws.
The main C# project builds with zero warnings/errors after adding the consumer.
Prepared asset and managed harness checks are not GPU or original-runtime fidelity
verification. Primary integration must verify scene rendering, updating the final
combined buffers, source entity transitions, packaging, and native platform behavior.
+45
View File
@@ -0,0 +1,45 @@
# Original default effects bank
Read-only EXE/OMT recovery and port SDL stream checks,2026-10-24. Text offsets
are VA minus0x400000. This is not original-game audio comparison or speaker testing.
Jimmy PostLoad423642 pushes string4EE08C=`SoundEffects.omt`, calls46A910,
and stores its database pointer to current sound database696008 at423656.
The separate sounds.omt has only4 waves and is not the numeric gameplay SFX bank.
SoundEffects.omt supplies251 Wave identities, including58=`door closing`,
59=`Door opening loop`,230=`winning prize2`.
458980 forwards three arguments to47D390;4589C0 forwards four to47D640 after
checking global4F8434. Both set volume through47DC80 from4F6B38.47D390 checks
current database696008 and tests/loads FourCC Wave/id via interface slots20/14
at47D3B6..DA. Contextual voice/music paths may temporarily switch the current
bank; the consumer currently uses the proven default for pickup/mechanism events.
This does not recover the entire original bank-switching/channel system.
Vertical-door417B28..43 calls4589C0(actor,-1,59,1), retaining its returned handle
while moving.41797E..4179AE stops that handle through458A00(handle,0), clears it
to-1 and calls4589C0(actor,-1,58,0). Reversing while the handle exists does not
start a second loop. Button411Cxx uses serialized AvailSound. Pickup435Fxx uses
serialized SoundIndex; trophy's230 identity is retained by the interaction path.
`tools/extractors/sound_bank.py` preserves each bounded source RIFF byte sequence,
archive/id/name/offset/hash and PCM duration in effects/effects.json. One resource,
162 bird1, contains format55 (MPEG Layer3) in RIFF. Its explicit fact sample count
is25344 at11025Hz; the encoded payload is retained unchanged. SDL3.4.2 local
src/audio/SDL_wave.c1755..57 explicitly rejects MPEG formats. Playback of162
therefore requires a separate decoder/conversion and remains unsupported; it is
not silently substituted. The currently connected lab effects use PCM resources.
PreparedEntityResources merges the bank with per-scene explicit references;
duplicate identities require equal duration and identical payload bytes. SceneAudio
uses independent one-shot streams and owner-keyed loops, stops door loops on
completion/reset, and disposes all voices on scene rebuild. Music and speech remain
independent. Original attenuation/pan/volume/channel limits and full jetpack sound
callbacks are incomplete, so current SDL mixing is an implementation policy.
Verification:2 Python tests compare all251 emitted RIFFs to exact original slices,
check original bank/call/FourCC instruction bytes, preserve source hash and reject
output in Original. Managed merge tests reject conflicting identities. The SDL
dummy-device --effects-audio-smoke consumes original58/59 streams, retains a
one-shot while stopping the loop, adds230 independently and clears all streams.
No physical speaker, original timing/position or native Windows audio claim follows.
+133
View File
@@ -0,0 +1,133 @@
# Original laboratory objectives and practice modal
Evidence: read-only Neutron.exe disassembly (`artifacts/binary/neutron.asm`),
original `omt/screens.omt`, and `alpha.omt`. EXE VAs below equal file offsets
plus `0x400000` for these sections. Static evidence and decoded original art
are verified; original modal/HUD runtime comparison remains outstanding.
## Recovered screen resources and coordinates
`402687..4026E8` registers slot0=`screens:Canv156` objectivePad,
slot1=120 labobjective0A, slot2=121 labobjective0B, slot3=122 labobjective0C.
Their original pixels say **GET JET PACK.**, **TALK TO CARL.**, and
**FOLLOW CARL OUTSIDE.** respectively. GAM pickup tag `shrinkray` is the
prototype/internal name of the lab jetpack (inventory group0/item3); the art
does not describe it as a shrink-ray weapon.
| Element | Original identity | Native dimensions | Reference top-left |
| --- | --- | --- | --- |
| Objective pad | screens Canv156 | 320x173 | (384,380+offset) |
| Current objective | screens Canv120/121/122 | 256x29 | (384,448+offset) |
| Objective selector digit | alpha Canv83/84/85 | 8x8 | (393,450+offset) |
| PracticeYesNo | screens Canv169 | 207x100 | (210,210) |
`402C40` positions visible flagged objectives at x384,
y=`448 + self[4EC] + visibleRow*15`. `407070` renders the pad at x384,
y=`380+self[4EC]` during its stationary phase and prints selector `%d`
(`4EC794`) at (393,450+offset), font tag SMAL (`534D414C`). `401F9D`
initializes offset=-69; `406590` changes -69 to0, while `406650` changes0 to-69.
These source paths toggle vertical layout and other gadget UI, not a simple
objective visibility bit. The pad extends beyond the640x480 reference viewport;
retain clipping rather than repositioning it to fit.
`406F50(index,flag)` only accepts index>0: it clears44 dword flags at4F7D00,
sets selector4F8194, resets animation timer4F8188, then enables the selected
entry. It does not map selector0 to objective1. The source has sliding/timed
objective presentation; the consumer currently renders its stationary geometry
under caller-controlled visibility. Animation and exact source visibility timing
are not yet implemented.
`402D70/402CC0` convert positions using windowWidth/640 and windowHeight/480;
constants at file8D40C=1/640 and8D408=1/480. The port quads use NDC
`(2*x/640-1,2*y/480-1,0)` with an identity overlay transform. Original bitmap
UV orientation is top-down, retained as(0,0) at top-left.
Gameplay text uses individual `alpha.omt` canvases, not editor
`fontsmall.png`: `4683E0` loads `alpha.omt` (string4F51D8), copies6x64
Canv pointer sets from table4F4ED8, and `468B80` maps uppercase ASCII-32.
SMAL selects set1; table entries for '1'/'2'/'3' are83/84/85. The separate
fontsmall CanvasFont is created in editor initialization46B280..46B3C7 and
must not silently substitute for gameplay digits.
## Practice request, input and dispatch
`402243..402273` binds Canv169 at(210,210). `406F90(type)` guards against
an existing modal (4F8198), shows the matching canvas, enables cursor,
pauses the main game through virtual168, then stores type at4F8048. Type0
uses169, whose pixels explicitly ask **DO YOU WANT TO PRACTICE? YES / NO**.
`46A360/46A380` set/clear keyboard bytes at509838+virtualKey;
46A3A0/46A3B0 track left mouse at509834. Consequently modal code reads
Y=509891, N=509886, Enter=509845. Source404523..404586 defines strict
Yes hit bounds225<x<305,240<y<300; No404BD0..404C40 is315<x<395 with
the same y bounds. Y accepts regardless of pointer; N dismisses. Enter
accepts Yes while hovering its region and otherwise follows No. Mouse
click accepts the corresponding hovered region; no blanket click dismissal.
Controller state paths also exist but remain unmapped. Escape handling is
not established by this modal branch.
Type0 Yes dispatch is `40469E` jump table4=404DA8 ->4046AF. It hides the
modal/highlight, clears4F8198, disables cursor, invokes4063E0 for screen155,
and calls Jimmy virtual168 (`43B5A0`) with:
```
targetLevel = "VR04.gam" (4EC77C)
targetStart = "PHONEBOOTH" (4EC788)
returnLevel = Jimmy+955
returnStart = Jimmy+724
```
The latter field names follow how43B5A0 stages requested/current strings;
the argument addresses and literal targets are certain. Modal1/2/3 dispatch
VR03/VR02/VR01 respectively, so type0 must not be routed toVR01.
Runtime checkpoint42AF00 captures the current level code and a16-byte
actor root into Jimmy+1E48/+1E38 separately. This does not prove the
meaning of the saved TSK StoredVector or justify overwriting it.
No path404D1E hides practice elements, clears4F8198, disables cursor and
unpauses main game virtual168(0); yes continues into the level transition.
## Implementation and verification
- `tools/extractors/ui.py` exports only the8 proven canvases, retaining original
identity, database, offset, source size, whole-input hashes and decoded RGBA
hashes. It validates every requested identity/dimension before writing and
rejects destinations overlapping source directories.
- `Application/SceneHud.cs` bounds manifest/depth/count, exact canvas dimensions,
paths and decoded byte counts; appends screen-space indexed quads to the scene,
preserves world draws/textures, and updates the final merged vertex buffer.
Selector0 produces no invented objective image. Input/modal state belongs to
the caller.
- `python3 tests/GamePort.HudTests/test_ui.py` verifies exact original RGBA,
output roundtrip, missing-resource rejection and input hash preservation.
- `dotnet run --project tests/GamePort.HudTests -- artifacts/prepared/ui/ui.json`
verifies final-buffer writes, original coordinates, digit/objective/modal
visibility, retained implicit world draw, and malformed-resource rejection.
Both targeted commands passed24Oct2026. Integrated headless overlays/VR04 entry
and GTX1070/Xvfb modal pause/N/resume/resize pass with zero validation errors.
The packaged Windows Wine64 modal check also passes with validation disabled;
native Windows/original-game comparison remain outstanding.
## Return-context field confirmation
Follow-up field tracing confirms the meaning of the two staged return arguments:
- Literal4EF524 is `level1b.gam`. Jimmy constructor437656..437684 copies it
to complete-object+955, initializing the current/requested GAM filename.
- Constructor437589..4375B5 initializes+724 from4ECA6C=`none`, not PHONEBOOTH.
- PlayerLoadLevel43B5A0 copies its second argument (requested start tag) to+724
at43B6A7..43B6E0, first argument (requested GAM) to+955 at43B764..43B78C,
third argument (return GAM) to+88C, and fourth argument (return start) to+8F0.
- TSK load460A83..460AE5 reads the saved StartPoint string and copies it to
+724 and+774. The supplied NewGame StartPoint is STARTEXP, so a lab practice
transition after loading NewGame should carry ReturnStart=STARTEXP, rather
than copying NewGame's preexisting ReturnStart=`none`.
-40B70A..40B770 looks up+724 with actor lookup474070 and assigns that actor's
root transform to Jimmy, independently confirming that this buffer is a
start entity tag. Runtime checkpoint42AF00 does not alter it.
Therefore source modal0 Yes preserves current `level1b.gam`/`STARTEXP` as the
return pair for the normal NewGame route, while entering VR04/PHONEBOOTH.
Its separately captured checkpoint root and unknown TSK StoredVector remain
distinct evidence; a new PHONEBOOTH return marker must not be invented.