Interface PhysicsConfig

Core physics simulation configuration. Controls global physics world parameters for accurate and stable simulation.

interface PhysicsConfig {
    allowedLinearError: number;
    erp: number;
    gravity: [number, number, number];
    maxStabilizationIterations: number;
    maxVelocityFrictionIterations: number;
    maxVelocityIterations: number;
    predictionDistance: number;
    timeStep: number;
}

Properties

allowedLinearError: number

Allowed linear error in meters before correction kicks in. Default: 0.001.

erp: number

Error reduction parameter (0-1). Controls how fast constraint violations are corrected. Default: 0.8.

gravity: [number, number, number]

Global gravity vector [x, y, z] in m/s². Default: [0, -9.81, 0].

maxStabilizationIterations: number

Iterations for stabilization constraints. Higher = more stable joints. Default: 4.

maxVelocityFrictionIterations: number

Iterations for velocity friction resolution. Higher = more realistic friction. Default: 8.

maxVelocityIterations: number

Iterations for velocity resolution. Higher = better penetration correction. Default: 1.

predictionDistance: number

Distance in meters for speculative contact prediction. Prevents tunneling. Default: 0.002.

timeStep: number

Simulation time step in seconds. Smaller values = more accurate but slower. Default: 1/60.