Skip to content

ColliderShape

ColliderShape = { height: number; type: "box"; width: number; } | { radius: number; type: "circle"; } | { axis?: "x" | "y"; halfHeight: number; radius: number; type: "capsule"; } | { type: "polygon"; vertices: Vec2Like[]; } | { type: "polyline"; vertices: Vec2Like[]; }

Defined in: physics/src/types.ts:71

Discriminated union for collider shapes. All dimensions in pixels.

{ height: number; type: "box"; width: number; }


{ radius: number; type: "circle"; }


{ axis?: "x" | "y"; halfHeight: number; radius: number; type: "capsule"; }

optional axis?: "x" | "y"

Orientation of the long axis. Default: "y" (vertical).

halfHeight: number

radius: number

type: "capsule"


{ type: "polygon"; vertices: Vec2Like[]; }

Closed convex shape. Rapier silently widens concave input to its convex hull; use polyline for non-convex outlines.


{ type: "polyline"; vertices: Vec2Like[]; }

Chain of line segments. Supports non-convex shapes but is static-only (no mass/inertia computed). Best for world boundaries.