Collision mesh

From Valve Developer Community
Revision as of 20:10, 8 July 2017 by Gordon Walkedby (talk | contribs) (Smoothing)
Jump to: navigation, search
A static collision mesh (red wireframe)
A jointed collision mesh (yellow wireframes)

A collision mesh is a cheap 3D mesh used by VPhysics. It is sometimes called a collision model, after the C++ object that loads it into the engine, but as far as creating models is concerned, it is a vertex mesh more or less like any other.

Collision meshes are invisible, and should be extremely low-detail compared to the model's visible components (see the images to the right for two examples). The lack of precision will not be noticed, except in that it doesn't grind the simulation to a halt!


Collision meshes consist of convex elements only
To create a concave mesh build separate convex objects, intersecting each other if necessary, and compile with $concave. Every convex piece adds to the simulation cost so be sparing.
All collision elements must be sealed
There can be no holes anywhere. This condition is calculated by examining vertex normals, so all edges must be smooth as well. If studiomdl says "Model has 2-dimensional geometry" you've made a mistake (or at least need to thicken your mesh).


This section covers how to make a smoothed collision mesh in various modelling packages. Remember that you also need to eliminate any holes in each convex shape.


  1. In (Icon) Object Mode, run the "Shade Smooth" operator on your mesh.
  2. Remove the (Icon) Edge Split modifier if you've added it for some odd reason.


  1. Use the Combine command to combine every part into a single editable mesh.
  2. Do NOT append edges or merge verticies after using the Combine command.
  3. Set selection mode to Edges, then select all edges in your collision mesh, then click on the Normals menu and click Soften Edge.
  4. Set up a very basic UVW map, such as an Automatic unwrap.


A collision mesh created in XSI 6.01. The reference mesh has been moved aside for visibility.
  1. Select every part of the collision mesh and use Model -> Create -> Polymesh -> Merge to combine them into one object.
  2. Use Render -> Get-> Property-> Geometry Approximation. In the Polygon Mesh tab, uncheck Discontinuity: Automatic. All hard edges on the model will disappear.
  3. Apply a texture and a projection to the collision mesh. Anything will do.

3DS Max

  1. Use the Attach function to combine every part into a single editable mesh. (optional)
  2. Do NOT weld vertices together after using the Attach function. All objects within the mesh should be individually selectable using the "Select Element" option within the Edit Mesh modifier.
  3. Select every element (in the mesh) individually and set them all to a different smoothing groups. If you work on a very complex model that requires more than 32 smoothing groups, you can create "additional smoothing groups" by combining them. For instance, an element set to smoothing groups 1 and 3 will be properly differentiated from elements set to smoothing groups 1 or 3.
  4. Apply your model's material to the collision mesh with at least a basic UWV map.


  1. Build a collision mesh out of one or more groups of faces. Each group must form a solid convex shape.
  2. Smooth each edge in the group by selecting all the faces inside and then right clicking and selecting "Smooth/Unsmooth edges". Set the slider to the 180 degrees to smooth all edges.
  3. Apply the same material to each face of the collision model. Note you must apply the material to each face, not the group as a whole.
  4. Combine multiple groups of faces into a single component.
  5. Set the axis of the component to the same as your reference model.


  1. Build a collision mesh out of primitives such as boxes and cylinders. As noted above, make sure each primitive is entirely solid and a separate object.
  2. Hit Q to add the mesh to a new surface, and give it a name.
  3. In the Surface Editor (F5), select the new surface, and check the smoothing checkbox. Give it a smoothing threshold of 180.

Cinema 4D

  1. Build a collision mesh out of primitives. Each group must form a solid convex shape.
  2. Create a new Connect Object and drag every primitive into it.
  3. Remove all tags from the primitives (Phong, Textures..) except the UVW tag.
  4. Apply your model's material to the Connect Object and export as SMD.

Milkshape 3D

  1. Build your collision mesh. Each group must form a solid convex shape.
  2. Clear all smoothing groups and assign all your meshes into smoothing gourp 1.
  3. Export your smd.

See also