Tested with: KSA Version 2026.10.19.5638
Colliders are the shapes the physics engine uses for a part: for touching the ground, other parts and other vessels. They are separate from the visible mesh, and much simpler.
Since the 2026.9 builds colliders matter more than before: parts break when contact pressure exceeds their crash tolerance, and a part's collider volume feeds into that tolerance (see Parts).
<Collider> is a module. Stock puts it either in the <Part> or <SubPart> of an assets file, next to <PartModel>, or in the matching GameData block; both work. It holds one or more shapes, and the part's collision is all of them together:
<Collider Id="Collider1">
<Cylinder Id="CylinderCollider1">
<LocationAsmb X="0.6" Y="0" Z="0" />
<Collider2Asmb X="0" Y="0" Z="1.57" />
<LengthY M="1.1728" />
<Radius M="0.5" />
</Cylinder>
<Sphere Id="SphereCollider1">
<LocationAsmb X="-0.6" Y="0" Z="0" />
<Collider2Asmb X="0" Y="0" Z="0" />
<Radius M="0.6" />
</Sphere>
</Collider>
Every shape takes:
| Element | What it does |
|---|---|
<LocationAsmb X Y Z> |
Centre of the shape, in metres, in the part's assembly frame. |
<Collider2Asmb X Y Z> |
Rotation of the shape, as X, Y, Z angles in radians. |
| Shape | Elements | Notes |
|---|---|---|
<Box> |
<LengthX>, <LengthY>, <LengthZ> |
Full side lengths, not half. |
<Sphere> |
<Radius> |
|
<Capsule> |
<LengthY>, <Radius> |
Along its own Y axis. |
<Cylinder> |
<LengthY>, <Radius> |
Along its own Y axis. Rotate by Z="1.5708" to lay it along X, which is the thrust axis of most stock parts. |
<ConvexHull> |
<Mesh Id>, optional <Scale X Y Z> |
The convex hull of a mesh's vertices. New in 2026.8.19.5261. |
All lengths take any distance unit (see Units).
For a shape the primitives cannot match, such as a capsule or a nose cone, use a hull built from a simple collision mesh. Stock's command pod:
<Collider Id="Collider1">
<ConvexHull Id="ConvexHullCollider1">
<LocationAsmb X="0" Y="0" Z="0" />
<Collider2Asmb X="0" Y="0" Z="-1.5708" />
<Mesh Id="_ColMesh_CoreCommandA_Prefab_MediumCapsuleVariantA_1" />
</ConvexHull>
</Collider>
The mesh comes from a mesh atlas loaded with HostOnly="true", which keeps the vertices in memory for physics and does not upload them for drawing. Stock keeps collision meshes in their own atlas next to the visual one:
<MeshAtlas Path="Meshes/CoreCommandA_MeshAtlas.glb" />
<MeshAtlas Path="Meshes/CoreCommandA_CollisionAtlas.glb" HostOnly="true" />
Each mesh in the .glb is registered under its mesh name (not its node name), and that name is the Id you give <Mesh>.
<Scale> stretches the hull per axis, so one unit mesh can serve several sizes. Stock's nose cones do that.
The game takes the convex hull of every vertex, so concave parts of your mesh are filled in. For a concave part use several hulls, each from its own mesh, in the same <Collider>.
Collider2Asmb in degrees. It is radians.<Box> half-lengths.<Cylinder> left along Y on a part whose axis is X.<ConvexHull> mesh from an atlas without HostOnly="true". Stock always loads collision meshes that way.