Documentation
    Preparing search index...

    Interface ForceFieldAddOptions

    Options for one ForceFieldSystem.addField call.

    interface ForceFieldAddOptions {
        wakesSleepingBodies?: boolean;
    }
    Index
    wakesSleepingBodies?: boolean

    When true, this entry also samples sleeping dynamic bodies and calls RigidBody.wake when its linear or torque contribution is non-zero. Default false.

    Policy when two entries disagree (2026-09-06): per-entry OR. A field without the flag never sees a sleeper, even if a sibling has it. Persistent gravity therefore cannot defeat §32 just because an explosion field is also registered. A waking field that samples zero still leaves the body asleep — zero is not an alarm clock.