Physics
Static Bodies
Creates a static physics body
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Cylinder Geometry cylinder_geometry
Cylinder geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylinder (meters).
Height of the cylinder (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the cylinder (meters).
Radius of the cylinder (meters).
Plane Geometry plane_geometry
Infinite plane geometry.
distance
Float(m)
Default:0
Signed distance from the origin along the plane normal (meters).
Signed distance from the origin along the plane normal (meters).
normal
Vector3
Default:[0,1,0]
Unit normal vector of the plane (in local space).
Unit normal vector of the plane (in local space).
Sphere Geometry sphere_geometry
Sphere geometry.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the sphere (meters).
Radius of the sphere (meters).
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Trigger Zones
Creates a static trigger physics body
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Cylinder Geometry cylinder_geometry
Cylinder geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylinder (meters).
Height of the cylinder (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the cylinder (meters).
Radius of the cylinder (meters).
Plane Geometry plane_geometry
Infinite plane geometry.
distance
Float(m)
Default:0
Signed distance from the origin along the plane normal (meters).
Signed distance from the origin along the plane normal (meters).
normal
Vector3
Default:[0,1,0]
Unit normal vector of the plane (in local space).
Unit normal vector of the plane (in local space).
Sphere Geometry sphere_geometry
Sphere geometry.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the sphere (meters).
Radius of the sphere (meters).
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Contact Modifiers
Makes other physics dynamic bodies that contact this geometry be affected by the contactVelocity.
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Cylinder Geometry cylinder_geometry
Cylinder geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylinder (meters).
Height of the cylinder (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the cylinder (meters).
Radius of the cylinder (meters).
Plane Geometry plane_geometry
Infinite plane geometry.
distance
Float(m)
Default:0
Signed distance from the origin along the plane normal (meters).
Signed distance from the origin along the plane normal (meters).
normal
Vector3
Default:[0,1,0]
Unit normal vector of the plane (in local space).
Unit normal vector of the plane (in local space).
Sphere Geometry sphere_geometry
Sphere geometry.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the sphere (meters).
Radius of the sphere (meters).
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Dynamic Bodies
Creates a dynamic physics body. If the
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Rigid Body rigid_body
Rigid body parameters for dynamic simulation (mass, damping, limits, CCD, and kinematic/gravity behavior).
angularDamping
Float(s-1)
Default:0.05
Min:0
Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.
Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.
centerOfMass
Vector3(m)
Default:[0,0,0]
Center of mass relative to the entity's local transform (meters).
Center of mass relative to the entity's local transform (meters).
collisionDetection
Unsigned Byte
Default:0(Discrete)
Min:0
Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.
0Discrete1LinearContinuous2AngularContinuous3Continuous
Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.
isKinematic
Boolean
Default:false
Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).
Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).
linearDamping
Float(s-1)
Default:0
Min:0
Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.
Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.
lockedAxis
Unsigned Byte
Default:0
Min:0
Lock motion along/around the specified axes.
1Locks motion along the X axis.
2Locks motion along the Y axis.
4Locks motion along the Z axis.
8Locks motion around the X axis.
16Locks motion around the Y axis.
32Locks motion around the Z axis.
Lock motion along/around the specified axes.
mass
Float(kg)
Default:1
Mass (kg). A value of 0 is treated as infinite mass (static).
Mass (kg). A value of 0 is treated as infinite mass (static).
maxAngularVelocity
Float(rad/s)
Default:100
Min:0
Maximum angular velocity (rad/s). Must be non-negative.
Maximum angular velocity (rad/s). Must be non-negative.
maxLinearVelocity
Float(m/s)
Default:10000000000000000
Min:0
Maximum linear velocity (m/s). Must be non-negative.
Maximum linear velocity (m/s). Must be non-negative.
useGravity
Boolean
Default:true
Whether the rigid body is affected by gravity.
Whether the rigid body is affected by gravity.
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Cylinder Geometry cylinder_geometry
Cylinder geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylinder (meters).
Height of the cylinder (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the cylinder (meters).
Radius of the cylinder (meters).
Plane Geometry plane_geometry
Infinite plane geometry.
distance
Float(m)
Default:0
Signed distance from the origin along the plane normal (meters).
Signed distance from the origin along the plane normal (meters).
normal
Vector3
Default:[0,1,0]
Unit normal vector of the plane (in local space).
Unit normal vector of the plane (in local space).
Sphere Geometry sphere_geometry
Sphere geometry.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the sphere (meters).
Radius of the sphere (meters).
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Creates a dynamic physics body that can be driven externally, and internals can be queried (e.g. angularVelocity, linearVelocity, etc).
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Rigid Body rigid_body
Rigid body parameters for dynamic simulation (mass, damping, limits, CCD, and kinematic/gravity behavior).
angularDamping
Float(s-1)
Default:0.05
Min:0
Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.
Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.
centerOfMass
Vector3(m)
Default:[0,0,0]
Center of mass relative to the entity's local transform (meters).
Center of mass relative to the entity's local transform (meters).
collisionDetection
Unsigned Byte
Default:0(Discrete)
Min:0
Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.
0Discrete1LinearContinuous2AngularContinuous3Continuous
Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.
isKinematic
Boolean
Default:false
Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).
Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).
linearDamping
Float(s-1)
Default:0
Min:0
Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.
Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.
lockedAxis
Unsigned Byte
Default:0
Min:0
Lock motion along/around the specified axes.
1Locks motion along the X axis.
2Locks motion along the Y axis.
4Locks motion along the Z axis.
8Locks motion around the X axis.
16Locks motion around the Y axis.
32Locks motion around the Z axis.
Lock motion along/around the specified axes.
mass
Float(kg)
Default:1
Mass (kg). A value of 0 is treated as infinite mass (static).
Mass (kg). A value of 0 is treated as infinite mass (static).
maxAngularVelocity
Float(rad/s)
Default:100
Min:0
Maximum angular velocity (rad/s). Must be non-negative.
Maximum angular velocity (rad/s). Must be non-negative.
maxLinearVelocity
Float(m/s)
Default:10000000000000000
Min:0
Maximum linear velocity (m/s). Must be non-negative.
Maximum linear velocity (m/s). Must be non-negative.
useGravity
Boolean
Default:true
Whether the rigid body is affected by gravity.
Whether the rigid body is affected by gravity.
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Cylinder Geometry cylinder_geometry
Cylinder geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylinder (meters).
Height of the cylinder (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the cylinder (meters).
Radius of the cylinder (meters).
Plane Geometry plane_geometry
Infinite plane geometry.
distance
Float(m)
Default:0
Signed distance from the origin along the plane normal (meters).
Signed distance from the origin along the plane normal (meters).
normal
Vector3
Default:[0,1,0]
Unit normal vector of the plane (in local space).
Unit normal vector of the plane (in local space).
Sphere Geometry sphere_geometry
Sphere geometry.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the sphere (meters).
Radius of the sphere (meters).
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Kinematic Bodies
Creates a kinematic physics body.
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Rigid Body rigid_body
Rigid body parameters for dynamic simulation (mass, damping, limits, CCD, and kinematic/gravity behavior).
angularDamping
Float(s-1)
Default:0.05
Min:0
Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.
Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.
centerOfMass
Vector3(m)
Default:[0,0,0]
Center of mass relative to the entity's local transform (meters).
Center of mass relative to the entity's local transform (meters).
collisionDetection
Unsigned Byte
Default:0(Discrete)
Min:0
Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.
0Discrete1LinearContinuous2AngularContinuous3Continuous
Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.
isKinematic
Boolean
Default:false
Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).
Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).
linearDamping
Float(s-1)
Default:0
Min:0
Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.
Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.
lockedAxis
Unsigned Byte
Default:0
Min:0
Lock motion along/around the specified axes.
1Locks motion along the X axis.
2Locks motion along the Y axis.
4Locks motion along the Z axis.
8Locks motion around the X axis.
16Locks motion around the Y axis.
32Locks motion around the Z axis.
Lock motion along/around the specified axes.
mass
Float(kg)
Default:1
Mass (kg). A value of 0 is treated as infinite mass (static).
Mass (kg). A value of 0 is treated as infinite mass (static).
maxAngularVelocity
Float(rad/s)
Default:100
Min:0
Maximum angular velocity (rad/s). Must be non-negative.
Maximum angular velocity (rad/s). Must be non-negative.
maxLinearVelocity
Float(m/s)
Default:10000000000000000
Min:0
Maximum linear velocity (m/s). Must be non-negative.
Maximum linear velocity (m/s). Must be non-negative.
useGravity
Boolean
Default:true
Whether the rigid body is affected by gravity.
Whether the rigid body is affected by gravity.
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Cylinder Geometry cylinder_geometry
Cylinder geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the cylinder: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylinder (meters).
Height of the cylinder (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the cylinder (meters).
Radius of the cylinder (meters).
Plane Geometry plane_geometry
Infinite plane geometry.
distance
Float(m)
Default:0
Signed distance from the origin along the plane normal (meters).
Signed distance from the origin along the plane normal (meters).
normal
Vector3
Default:[0,1,0]
Unit normal vector of the plane (in local space).
Unit normal vector of the plane (in local space).
Sphere Geometry sphere_geometry
Sphere geometry.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the sphere (meters).
Radius of the sphere (meters).
Collision Geometry Reference collision_geometry_ref
Reference to a collision geometry asset used by physics.
collisionGeometryRef
Referenced collision geometry (UUID).
Referenced collision geometry (UUID).
Constraints
Joint joint
Base joint connecting two bodies. By default locks relative position and orientation between constrainer and constrainee.
breakForce
Float(N)
Default:10000000000000000
Break force threshold (Newtons).
Break force threshold (Newtons).
breakTorque
Float(N·m)
Default:10000000000000000
Break torque threshold (N·m).
Break torque threshold (N·m).
constrainee
Entity Reference
Entity with a Rigid Body to be constrained.
Entity with a Rigid Body to be constrained.
constrainer
Entity Reference
Entity acting as constrainer (rigid/static) or null to constrain to world origin.
Entity acting as constrainer (rigid/static) or null to constrain to world origin.
enableCollision
Boolean
Default:false
Enable collision between constrainer and constrainee bodies.
Enable collision between constrainer and constrainee bodies.
Creates a customizable joint between two physics bodies (all degrees of freedom are customizable).
Joint joint
Base joint connecting two bodies. By default locks relative position and orientation between constrainer and constrainee.
breakForce
Float(N)
Default:10000000000000000
Break force threshold (Newtons).
Break force threshold (Newtons).
breakTorque
Float(N·m)
Default:10000000000000000
Break torque threshold (N·m).
Break torque threshold (N·m).
constrainee
Entity Reference
Entity with a Rigid Body to be constrained.
Entity with a Rigid Body to be constrained.
constrainer
Entity Reference
Entity acting as constrainer (rigid/static) or null to constrain to world origin.
Entity acting as constrainer (rigid/static) or null to constrain to world origin.
enableCollision
Boolean
Default:false
Enable collision between constrainer and constrainee bodies.
Enable collision between constrainer and constrainee bodies.
Constraint constraint
6-DoF constraint built on a Joint. Defaults to fixed; selectively unlock translation and rotation on X/Y/Z and configure limits and springs.
motionLimitSpringDamping
Vector3(N·s/m)
Default:[0,0,0]
Linear limit spring damping per axis (N·s/m).
Linear limit spring damping per axis (N·s/m).
motionLimitSpringStiffness
Vector3(N/m)
Default:[0,0,0]
Linear limit spring stiffness per axis (N/m). >0 makes the limit soft (spring-like).
Linear limit spring stiffness per axis (N/m). >0 makes the limit soft (spring-like).
motionLowerLimit
Vector3(m)
Default:[0,0,0]
Lower linear limit per axis (meters).
Lower linear limit per axis (meters).
motionUpperLimit
Vector3(m)
Default:[0,0,0]
Upper linear limit per axis (meters).
Upper linear limit per axis (meters).
swingLimitAngle
Vector2(deg)
Default:[0,0]
Swing cone half-angles about Y and Z of the constraint frame (degrees). 0 does not restrict rotation; max 180. Used if either swing axis is limited.
Swing cone half-angles about Y and Z of the constraint frame (degrees). 0 does not restrict rotation; max 180. Used if either swing axis is limited.
swingSpringDamping
Float(N·m·s/rad)
Default:0
Swing limit spring damping (N·m·s/rad).
Swing limit spring damping (N·m·s/rad).
swingSpringStiffness
Float(N·m/rad)
Default:0
Swing limit spring stiffness (N·m/rad). >0 makes the limit soft.
Swing limit spring stiffness (N·m/rad). >0 makes the limit soft.
twistLimitAngle
Vector2(deg)
Default:[0,0]
Twist angle limits (min,max) around the twist axis (degrees). Range (−360, 360).
Twist angle limits (min,max) around the twist axis (degrees). Range (−360, 360).
twistSpringDamping
Float(N·m·s/rad)
Default:0
Twist limit spring damping (N·m·s/rad).
Twist limit spring damping (N·m·s/rad).
twistSpringStiffness
Float(N·m/rad)
Default:0
Twist limit spring stiffness (N·m/rad). >0 makes the limit soft.
Twist limit spring stiffness (N·m/rad). >0 makes the limit soft.
unlockedMotion
Unsigned Integer
Default:0
Min:0
Unlock motion along/around the specified axes.
1Unlock motion along the X axis.
2Unlock motion along the Y axis.
4Unlock motion along the Z axis.
8Unlock motion around the X axis.
16Unlock motion around the Y axis.
32Unlock motion around the Z axis.
Unlock motion along/around the specified axes.
Creates a customizable joint that can be driven externally (by force, velocity, drive, etc.).
Joint joint
Base joint connecting two bodies. By default locks relative position and orientation between constrainer and constrainee.
breakForce
Float(N)
Default:10000000000000000
Break force threshold (Newtons).
Break force threshold (Newtons).
breakTorque
Float(N·m)
Default:10000000000000000
Break torque threshold (N·m).
Break torque threshold (N·m).
constrainee
Entity Reference
Entity with a Rigid Body to be constrained.
Entity with a Rigid Body to be constrained.
constrainer
Entity Reference
Entity acting as constrainer (rigid/static) or null to constrain to world origin.
Entity acting as constrainer (rigid/static) or null to constrain to world origin.
enableCollision
Boolean
Default:false
Enable collision between constrainer and constrainee bodies.
Enable collision between constrainer and constrainee bodies.
Constraint constraint
6-DoF constraint built on a Joint. Defaults to fixed; selectively unlock translation and rotation on X/Y/Z and configure limits and springs.
motionLimitSpringDamping
Vector3(N·s/m)
Default:[0,0,0]
Linear limit spring damping per axis (N·s/m).
Linear limit spring damping per axis (N·s/m).
motionLimitSpringStiffness
Vector3(N/m)
Default:[0,0,0]
Linear limit spring stiffness per axis (N/m). >0 makes the limit soft (spring-like).
Linear limit spring stiffness per axis (N/m). >0 makes the limit soft (spring-like).
motionLowerLimit
Vector3(m)
Default:[0,0,0]
Lower linear limit per axis (meters).
Lower linear limit per axis (meters).
motionUpperLimit
Vector3(m)
Default:[0,0,0]
Upper linear limit per axis (meters).
Upper linear limit per axis (meters).
swingLimitAngle
Vector2(deg)
Default:[0,0]
Swing cone half-angles about Y and Z of the constraint frame (degrees). 0 does not restrict rotation; max 180. Used if either swing axis is limited.
Swing cone half-angles about Y and Z of the constraint frame (degrees). 0 does not restrict rotation; max 180. Used if either swing axis is limited.
swingSpringDamping
Float(N·m·s/rad)
Default:0
Swing limit spring damping (N·m·s/rad).
Swing limit spring damping (N·m·s/rad).
swingSpringStiffness
Float(N·m/rad)
Default:0
Swing limit spring stiffness (N·m/rad). >0 makes the limit soft.
Swing limit spring stiffness (N·m/rad). >0 makes the limit soft.
twistLimitAngle
Vector2(deg)
Default:[0,0]
Twist angle limits (min,max) around the twist axis (degrees). Range (−360, 360).
Twist angle limits (min,max) around the twist axis (degrees). Range (−360, 360).
twistSpringDamping
Float(N·m·s/rad)
Default:0
Twist limit spring damping (N·m·s/rad).
Twist limit spring damping (N·m·s/rad).
twistSpringStiffness
Float(N·m/rad)
Default:0
Twist limit spring stiffness (N·m/rad). >0 makes the limit soft.
Twist limit spring stiffness (N·m/rad). >0 makes the limit soft.
unlockedMotion
Unsigned Integer
Default:0
Min:0
Unlock motion along/around the specified axes.
1Unlock motion along the X axis.
2Unlock motion along the Y axis.
4Unlock motion along the Z axis.
8Unlock motion around the X axis.
16Unlock motion around the Y axis.
32Unlock motion around the Z axis.
Unlock motion along/around the specified axes.
Constraint Actuator constraint_actuator
Drives a Constraint toward target position/orientation and velocities using configurable stiffness, damping, and force limits.
angularDamping
Vector3(N·m·s/rad)
Default:[0,0,0]
Angular drive damping per axis (N·m·s/rad).
Angular drive damping per axis (N·m·s/rad).
angularForceLimit
Vector3(N·m)
Default:[-1,-1,-1]
Max angular drive torque/impulse per axis (N·m). −1 = unlimited.
Max angular drive torque/impulse per axis (N·m). −1 = unlimited.
angularStiffness
Vector3(N·m/rad)
Default:[0,0,0]
Angular drive stiffness per axis (N·m/rad). >0 applies spring torque toward the goal.
Angular drive stiffness per axis (N·m/rad). >0 applies spring torque toward the goal.
angularVelocity
Vector3(rad/s)
Default:[0,0,0]
Target angular velocity (rad/s).
Target angular velocity (rad/s).
goalOrientation
Quaternion
Default:[0,0,0,1]
Target angular orientation.
Target angular orientation.
goalPosition
Vector3(m)
Default:[0,0,0]
Target linear position offset (meters).
Target linear position offset (meters).
linearDamping
Vector3(N·s/m)
Default:[0,0,0]
Linear drive damping per axis (N·s/m).
Linear drive damping per axis (N·s/m).
linearForceLimit
Vector3(N)
Default:[-1,-1,-1]
Max linear drive force/impulse per axis (N). −1 = unlimited.
Max linear drive force/impulse per axis (N). −1 = unlimited.
linearStiffness
Vector3(N/m)
Default:[0,0,0]
Linear drive stiffness per axis (N/m). >0 applies spring force toward the goal.
Linear drive stiffness per axis (N/m). >0 applies spring force toward the goal.
linearVelocity
Vector3(m/s)
Default:[0,0,0]
Target linear velocity (m/s).
Target linear velocity (m/s).
type
Integer
Default:1(ACCELERATION)
Drive type: apply as force or as acceleration.
0FORCE1ACCELERATION
Drive type: apply as force or as acceleration.
Character Controllers
Creates a kinematic character controller.
Physics Material physics_material
Physical surface properties used for contact: friction, restitution, optional contact modification, and trigger mode.
contactVelocity
Vector3(m/s)
Default:[0,0,0]
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
Applied contact velocity offset when colliding (m/s). Only used if modifyContact is true.
dynamicFriction
Float
Default:0.5
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
Dynamic (kinetic) friction coefficient (typically 0..1). If greater than staticFriction, staticFriction is clamped up to match. Effective value is averaged with the other surface.
isTrigger
Boolean
Default:false
Treat associated geometry as a trigger (generates events but no physical response).
Treat associated geometry as a trigger (generates events but no physical response).
modifyContact
Boolean
Default:false
Enable contact modification (applies contactVelocity on collisions).
Enable contact modification (applies contactVelocity on collisions).
restitution
Float
Default:0
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
Restitution (bounciness) in [0,1]. 0 = no bounce; 1 = perfectly elastic. Effective value is averaged with the other surface.
staticFriction
Float
Default:0.5
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Static friction coefficient (typically 0..1). 0 feels like ice; higher resists start of motion. Effective value is averaged with the other surface.
Character Controller character_controller
Kinematic character controller for collision-constrained movement without a rigid body. Uses tuned collision handling for responsive control.
skinWidth
Float(m)
Default:0
Collision skin width (meters).
Collision skin width (meters).
slopeLimit
Float(deg)
Default:45
Maximum walkable slope (degrees). Slopes steeper than this are not walkable.
Maximum walkable slope (degrees). Slopes steeper than this are not walkable.
stepOffset
Float(m)
Default:0
Maximum climbable step height. Steps higher than this cannot be climbed automatically.
Maximum climbable step height. Steps higher than this cannot be climbed automatically.
Capsule Geometry capsule_geometry
Capsule geometry.
axis
Integer
Default:1(Y-Axis)
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
0X-Axis1Y-Axis2Z-Axis
Alignment axis of the capsule: 0=X, 1=Y, 2=Z.
height
Float(m)
Default:1
Height of the cylindrical mid-section (meters).
Height of the cylindrical mid-section (meters).
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).
radius
Float(m)
Default:0.5
Radius of the hemispherical ends (meters).
Radius of the hemispherical ends (meters).
Box Geometry box_geometry
Box geometry.
dimension
Vector3(m)
Default:[1,1,1]
Box dimensions (width, height, depth) in meters.
Box dimensions (width, height, depth) in meters.
offset
Vector3(m)
Default:[0,0,0]
Local offset of the geometry origin (meters).
Local offset of the geometry origin (meters).