PhysicsSystem
Defined in: physics/src/PhysicsSystem.ts:34
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
scene.timeScale. Paused scenes are simply not stepped — no sleep/wake needed.
NOTE: entity.timeScale is 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. entity.timeScale only affects 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:1597
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:1595
Whether this system is active.
Inherited from
Section titled “Inherited from”System.enabled
readonlyphase:FixedUpdate=Phase.FixedUpdate
Defined in: physics/src/PhysicsSystem.ts:35
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:36
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:1603
Internal
Set the engine context. Called by Engine during startup.
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:1607
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:1611
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:41
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:1605
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