PhysicsSystem
Defined in: physics/src/PhysicsSystem.ts:38
Steps per-scene physics worlds and synchronises Rapier ↔ Transform.
Runs in FixedUpdate at priority 0, before ComponentFixedUpdateSystem (priority 1000).
Each active scene with physics gets its own sub-accumulator scaled by the
scene’s effective time scale (SceneTime.effectiveScale — the persistent
scene.timeScale composed with active freeze/slow-mo requests). Paused
scenes are simply not stepped — no sleep/wake needed.
NOTE: entity.timeScale and SceneTime excludeUpdates exclusions are
intentionally NOT applied here. The whole scene shares one Rapier world
stepped once per (scaled) fixed tick, so there is no per-body notion of
time — a single entity cannot be individually slowed or sped up. They only
affect component update/fixedUpdate, the entity’s ProcessComponent,
and its particle emitters. For per-body time control, use a kinematic body
or scale velocities manually.
Extends
Section titled “Extends”System
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new PhysicsSystem():
PhysicsSystem
Returns
Section titled “Returns”PhysicsSystem
Inherited from
Section titled “Inherited from”System.constructor
Properties
Section titled “Properties”context
Section titled “context”
protectedcontext:EngineContext
Defined in: core/dist/index.d.ts:1086
Reference to the engine context, set on registration.
Inherited from
Section titled “Inherited from”System.context
enabled
Section titled “enabled”enabled:
boolean
Defined in: core/dist/index.d.ts:1084
Whether this system is active.
Inherited from
Section titled “Inherited from”System.enabled
readonlyphase:FixedUpdate=Phase.FixedUpdate
Defined in: physics/src/PhysicsSystem.ts:39
The phase this system runs in.
Overrides
Section titled “Overrides”System.phase
priority
Section titled “priority”
readonlypriority:0=0
Defined in: physics/src/PhysicsSystem.ts:40
Execution priority within the phase. Lower = earlier. Default: 0.
Overrides
Section titled “Overrides”System.priority
Methods
Section titled “Methods”_setContext()
Section titled “_setContext()”_setContext(
context):void
Defined in: core/dist/index.d.ts:1093
Internal
Set the engine context. Called by SystemScheduler when the system is registered.
Parameters
Section titled “Parameters”context
Section titled “context”EngineContext
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”System._setContext
onRegister()?
Section titled “onRegister()?”
optionalonRegister(context):void
Defined in: core/dist/index.d.ts:1097
Called once when the system is registered with the engine.
Parameters
Section titled “Parameters”context
Section titled “context”EngineContext
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”System.onRegister
onUnregister()?
Section titled “onUnregister()?”
optionalonUnregister():void
Defined in: core/dist/index.d.ts:1101
Called when the system is removed.
Returns
Section titled “Returns”void
Inherited from
Section titled “Inherited from”System.onUnregister
update()
Section titled “update()”update(
dt):void
Defined in: physics/src/PhysicsSystem.ts:45
Called every frame (or every fixed step for FixedUpdate).
Parameters
Section titled “Parameters”number
Returns
Section titled “Returns”void
Overrides
Section titled “Overrides”System.update
protecteduse<T>(key):T
Defined in: core/dist/index.d.ts:1095
Resolve a service by key, cached after first lookup.
Type Parameters
Section titled “Type Parameters”T
Parameters
Section titled “Parameters”ServiceKey<T>
Returns
Section titled “Returns”T
Inherited from
Section titled “Inherited from”System.use