Skip to content

Export Nodes SourceIOPropCollisionNode

REDxEYE edited this page Nov 20, 2026 · 1 revision

Collision

Defines the physics (collision) mesh of the model, written as a $collisionmodel or $collisionjoints block.

Collision node

Category: Geometry. Node ID: SourceIOPropCollisionNode.

Inputs

Socket Type Multi Meaning
Geometry Object socket no The collision geometry. Required. Link a Geometry node.

Outputs

Socket Type Meaning
Collision Collision socket Link to Collision on the Source 1 model output (single link).

Properties

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.

Example workflow

  1. Create a Geometry node whose Source is a Collection that contains one hull mesh per bone, and set its Rig.
  2. Add a Collision node, set Mode to $collisionjoints, Mass to 40.
  3. 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.

Caveats

  • $collisionjoints needs 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 / $body entry.
  • Joint QC text is not allowed in $collisionmodel mode.
  • 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.

Clone this wiki locally