Skip to main content

Type Alias: RigidBody

type RigidBody = {
  mass: Float;
  centerOfMass: Vec3;
  linearDamping: Float;
  angularDamping: Float;
  maxLinearVelocity: Float;
  maxAngularVelocity: Float;
  collisionDetection: UInt8;
  lockedAxis: UInt8;
  useGravity: boolean;
  isKinematic: boolean;
};

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:761

Rigid body parameters for dynamic simulation (mass, damping, limits, CCD, and kinematic/gravity behavior).

Properties​

mass​

mass: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:766

Mass (kg). A value of 0 is treated as infinite mass (static).

Default Value​

1;

centerOfMass​

centerOfMass: Vec3;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:771

Center of mass relative to the entity's local transform (meters).

Default Value​

(0, 0, 0);

linearDamping​

linearDamping: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:776

Linear damping coefficient (s^-1). 0 = no damping; must be non-negative.

Default Value​

0;

angularDamping​

angularDamping: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:781

Angular damping coefficient (s^-1). 0 = no damping; must be non-negative.

Default Value​

0.05;

maxLinearVelocity​

maxLinearVelocity: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:786

Maximum linear velocity (m/s). Must be non-negative.

Default Value​

10000000000000000;

maxAngularVelocity​

maxAngularVelocity: Float;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:791

Maximum angular velocity (rad/s). Must be non-negative.

Default Value​

100;

collisionDetection​

collisionDetection: UInt8;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:796

Collision detection mode (CCD). Kinematic bodies do not support Linear/Continuous CCD.

Default Value​

0;

lockedAxis​

lockedAxis: UInt8;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:801

Lock motion along/around the specified axes.

Default Value​

0;

useGravity​

useGravity: boolean;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:806

Whether the rigid body is affected by gravity.

Default Value​

true;

isKinematic​

isKinematic: boolean;

Defined in: node_modules/@3dverse/livelink.core/dist/_prebuild/engine_types/components.d.ts:811

Treat the rigid body as kinematic (unaffected by forces; driven by animation/app logic).

Default Value​

false;