939 B
Scene Physics Composition
scene_physics is the 3D runtime composition satellite exposed as scenePhysics.
bindGeneratedColliders(world3D) routes later procgen collider publications into the
same caller-owned gameplay World3D used for stepping and queries. Scene and procgen
remain independent producers/consumers; the physics artifact provider owns only its
published bodies and shapes.
isGeneratedColliderWorldBound() reports whether the shared collider world is still
live. unbindGeneratedColliders() removes an empty live binding; it is a no-op when
already unbound and raises a script error when committed or staged publications still
exist.
Binding requires an empty collider provider. Unbinding also requires no committed or staged publications. Destroying the caller-owned world makes existing collider records observably stale rather than retaining a raw world pointer. Clear publications before an orderly unbind.