Repository navigation
Export Nodes SourceIOPropCollisionNode
REDxEYE edited this page Nov 20, 2026
·
1 revision
Defines the physics (collision) mesh of the model, written as a $collisionmodel or $collisionjoints block.

Category: Geometry. Node ID: SourceIOPropCollisionNode.
| Socket | Type | Multi | Meaning |
|---|---|---|---|
| Geometry | Object socket | no | The collision geometry. Required. Link a Geometry node. |
| Socket | Type | Meaning |
|---|---|---|
| Collision | Collision socket | Link to Collision on the Source 1 model output (single link). |
| Property | Shown | Meaning |
|---|---|---|
| Mode | always |
$collisionmodel: static collision geometry. $collisionjoints: per-bone convex hulls for a skinned model. |
| Mass | always | Written as $mass (default 1, minimum 0). |
| Concave |
$collisionmodel only |
Writes $concave inside the block. |
| Joint QC text block / Joint QC directives |
$collisionjoints only |
Optional caller-authored directives (for example $jointconstrain …) written inside the block. A Text block takes priority; the inline field is shown while no Text is set. Every non-empty line must be a single-line $directive with no braces. |
- Create a Geometry node whose Source is a Collection that contains one hull mesh per bone, and set its Rig.
- Add a Collision node, set Mode to
$collisionjoints, Mass to40. - Link the Geometry to Geometry, and Collision to the output's Collision socket.
For a simple static prop, use $collisionmodel with an ordinary mesh object and enable Concave if the hull is not convex.
-
$collisionjointsneeds a Collection source and an Armature (Rig). Every vertex of each hull mesh must be weighted to exactly one bone group, and each hull must belong to one bone. The rig must be the rig used by a$model/$bodyentry. - Joint QC text is not allowed in
$collisionmodelmode. - Direct export cannot use non-empty joint QC directives; they are reported as errors by Check direct export. Use the Built-in studiomdl backend or remove the directives.
- Collision geometry takes no shape keys in direct export.
- Hull meshes are exported with the same basename rules as any geometry; the collision job may reuse a Geometry node that is also used elsewhere.
Back to Export Nodes.