Interface BodyOptions

true (default) → dynamic, simulated. false → immovable static body. Ignored when motion is set.

Motion type. Defaults to dynamic (or static when dynamic: false). kinematic bodies are moved by script (velocity/position) and push dynamics but are not pushed back.

Collision layer(s) this body belongs to (bit flags, see CollisionLayer). Default: World for static bodies, Prop for moving bodies.

Collision layer(s) this body collides with. Default: All.

When true the body is a sensor (trigger): it reports overlaps via a SensorCallbacks but generates no collision response.

Bounciness 0..1. Default 0.2.

Surface friction 0..1. Default Jolt default (~0.2).

Initial linear velocity (world units/sec).

Multiplier on gravity (1 = normal, 0 = floats).

Override the body mass (kg). 0/undefined → derive from shape volume × Jolt's default density (~1000 kg/m³), which makes a 1 m cube ~1000 kg.

Continuous collision detection mode. 'discrete' (default) is the cheap per-step check; 'linear-cast' sweeps the body along its motion each step so a fast body can't tunnel through thin colliders (e.g. one-sided terrain mesh). Use it for small/fast dynamics over thin static geometry.

For mesh colliders only: build the triangle mesh double-sided by also emitting each triangle with reversed winding. Jolt's MeshShape collides one-sided (front/CCW face only), so a level whose triangles aren't all wound toward the player has fall-through gaps. Godot's trimesh collider is double-sided, so set this for faithfully-ported level geometry. Doubles the collision triangle count (per unique mesh — still cheap vs. a merged soup).

Sensor overlap callbacks. Implies isSensor when present.