Files
Neutron/docs/checkpoint/collision-body-implementation.md
T

5.5 KiB

Ordinary body implementation and tutorial bridge

2026-10-27 UTC. This chunk composes the recovered static dispatcher with ordinary Jimmy body integration and enables that bounded path in VR04. It does not close all collision, dynamic bodies, special contacts or original visual comparison.

Evidence and implementation

Source composition records the whole-body hash,81 guarded sites,12 virtual targets, callers, offsets, flags, source root publication condition and new REA radius Evidence. Original component results provide ten copied479D20/support numeric references. No original game entry point or full Jimmy instance was executed by this implementation chunk.

OriginalBodyPhysics implements the true210/1C8/220/1D0, false228/42C, prevent-lowering subset. It clears current support, consumes impulse once, adds acceleration and gravity separately, splits nonpositive-Y motion into horizontal response then fallingY, and preserves source callback/support/friction/suppression order.370 clears positive vertical velocity/acceleration independently. Ordinary 374 and inherited37C do not move the root; special-contact worlds are rejected. This justifies the fixed-W1/no-root-changing-contact publication subset. Future special callbacks must implement fresh previous/live Vec4 comparison before314.

Landing diagnostics observe new root/zero acceleration and old velocity/support. Published speed160 is separate from controller608, copied at the controlled tail. Script preparation clears controller speed/velocity while preserving published speed, pending impulse and acceleration. Friction reads the preserved body scalar; control ownership does not suspend physics. The generic scale0.5 suppression and unclamped friction0.8 follow source contracts. Nonzero angular component tests use the probe's substituted334 Euler-add contract; the live bridge passes angular0.

Program selects source body only for VR04. Lab/outside retain their prior capsule because they contain special contact materials and pending dynamic integration. The source body rejects attaching the provisional dynamic resolver; Program also asserts no prepared door colliders in this subset. This does not prove absence of every original dynamic class: VR04 has3SOL/3ROC/3TRO and other eligibility questions.

Live radius is the existing InteractionRadius, which source260/264 prove is the same body field15C. Burst60→100 changes both sphere response and support offset 75.9→126.5; later grounded wrapper restoration60 stays after physics and outside the input ownership gate. The replay now records two support landings rather than the previous capsule's one; radius/support transitions are retained, not flattened to preserve the old diagnostic count. Maximum rise changes418.98→418.93 because the source path removes the modern floor skin. Travel remains403.88 in this input fixture. These are port observations, not original whole-game trajectory metrics.

ActorRoot/feet conversion remains constant75.9 and sole-based rendering remains the existing modern bridge. Initial placement still uses the bounded floor query; this does not derive original visual pivot/height or generic transform semantics. Modern F3 noclip bypasses source physics and clears motion on exit; admission still uses the capsule24/render-height occupancy check. It is a debug policy, not a recovered radius60/100 overlap query. Full wrapper/registry remains open.

Verification

Twenty managed body groups pass, independently reviewed: all ten original-code numeric references; prior support/landing ownership; angular-before-suppression; published-speed cutoffs; special-scene rejection; positive/nonpositive split; ceiling370; radius100 support/unclamped friction; actual VR04 root/render bridge; pending jump while uncontrolled; preparation/publication; retained jetpack/steering/ landing and noclip return. These tests compile into GamePort.BodyPhysicsTests and are included in scripts/test.sh. Two existing explicit-source test projects now include the new dependencies; the initial suite compilation failure is retained in artifacts/body-composition/integration-initial.log, not reported as a pass.

Headless VR04300-frame replay and native Linux GTX1070/private Xvfb replay at 1920x1080 both pass with zero enabled Vulkan validation errors. Native SDL receives move/brake/turn/jump and resizes800x600. Both end supported with one burst, travel403.88, max rise418.93 and energy20 (VR04 exemption). Saved readback shows the modern standing-foot bridge remains above the visible floor at the final replay position; this is a port image check, not source pivot comparison.

Logs/readbacks: artifacts/body-composition/body-tests.log, tutorial-jetpack.log, tutorial-jetpack.png and native/jetpack.log. Independent review is in collision-body-implementation-review.md. Full-suite, package and preservation results are recorded in progress.md after their completion. No native Windows runtime result is inferred from cross-builds.

Next bounded work

Recover original physical-list and pair-collision eligibility for VR04 actor classes, plus dynamic nearest/last-polygon/reset order. Recover lab/outside's Player160/164/FENCE/LADDER policies, including control and root ownership, before using this body solver there. Keep the existing capsule baseline available for comparison. Shared camera eye/DEFAULT handoff remains the next independent C5 contract; audio clock/banks and later implementation chunks retain their gates.