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

87 lines
5.5 KiB
Markdown

# 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](collision-body-composition-source.md) 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](collision-body-probe.md)
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](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.