Skip to content

Collision Shape

Collision Shape attaches simple physics shapes to your mesh without changing its visible geometry. Add it after shaping a static prop and before Unity Engine Output.

Mesh

The mesh to fit.

Mesh

The unchanged mesh with collision appended.

New shapes append to existing collision. Chain nodes to give different selections different fits. Use Apply to for named selections or attribute matches. Pieces from groups connected pieces, imported parts or face attribute values; Fit chooses each piece or all as one.

  • Box fits a rotated box. Fitted searches for a tight orientation; Upright rotates around Y; Axis-aligned stays on world axes.
  • Convex Hull encloses the mesh within the chosen 4–32 vertex budget. Simplification expands outward so it does not cut into the mesh. Flat groups become thin boxes.
  • Extruded Profile projects and unions the faces, keeps holes, splits the outline into convex parts, then extrudes through the mesh. Rectangles become boxes. Auto compares world and fitted axes by total volume; X, Y and Z override it.

Padding grows collision outward. Padding and notch filling display centimeters; saved coordinates remain meters. Green translucent shapes and wire edges show the result. Overlays → Show collision toggles them; the viewport reports shape and triangle counts.

For a plank floor surrounding a stairwell, choose Extruded Profile, All as one, and a notch limit larger than the plank cracks but smaller than the opening. A rectangular ring becomes four boxes, with the opening still clear. Increase the limit carefully: it intentionally fills shallow gaps.

Choose Extruded Profile and All as one. Steps uses a 2 cm notch limit, producing one prism per step. Ramp measures the sawtooth notches and fills to the outer tread support line, producing one convex ramp for an ordinary staircase. The info line reports its axis, measured fill and slope. Above 45° an amber warning flags the default walkable slope limit. Editing Fill notches up to selects Custom. Auto normally chooses the stair width as the extrusion axis.

Whole-mesh Transform moves the shapes with the mesh, converting sheared boxes into convex hulls. Merge concatenates them. Selections and subnet boundaries preserve them; geometry operations that cannot update collision drop it with an amber warning. Add Collision Shape after those operations. A partial Transform also drops collision. On rigged inputs collision fits the rest pose only.

Unity Engine Output requires Forge Bridge for Unity 0.2.0 or newer. The prefab receives an owned Collision child containing BoxColliders and convex MeshColliders. Re-pushing refreshes it; sending no collision removes it. Ordinary file Export omits collision and reports that omission.

Parameter What it does Default
Apply to Faces to fit collision around. Everywhere
Pieces from What makes one piece. Options: Connected, Imported part, By attribute Connected
Attribute The face attribute defining pieces. Picked from the input mesh. Shown when Pieces from is By attribute. None
Fit Fit separately or together. Options: Each piece, All as one Each piece
Padding Outward clearance. 0 cm
Mode Collision fitting method. Options: Box, Convex Hull, Extruded Profile Box
Max vertices Hull vertex budget. Shown when Mode is Convex Hull. 16
Axis Profile extrusion axis. Options: Auto, X, Y, Z Shown when Mode is Extruded Profile. Auto
Stairs Notch filling preset. Options: Steps, Ramp, Custom Shown when Mode is Extruded Profile. Custom
Fill notches up to Close shallow gaps and dents. Shown when Mode is Extruded Profile. 2 cm
Orientation How boxes rotate. Options: Fitted, Upright, Axis-aligned Shown when Mode is Box. Fitted