LEARN // meshfx

What is a collision mesh

A collision mesh is a simple, invisible shape your physics engine uses in place of the detailed model you see. A 20,000-triangle crate collides as one box and a statue as a few convex pieces, so your physics stays fast and stable and players do not snag on tiny details they cannot see.

pyrofx effects work today, and new accounts start with $5 of usage.

MODULE // meshfx AVAILABLE

meshfx measures faults, checks repairs and makes LODs for a triangle budget. meshfx runs on the hosted API: try it in the Playground.

  • Invisible, much simpler than the render mesh
  • Boxes, spheres, capsules, convex hulls, trimesh
  • Trimesh shapes suit static objects
  • meshfx: measured outputs; hosted availability shown separately

01 // WHAT IT MEANS

Why physics uses a different shape

Collision tests run for every moving body against everything near it, many times a second. Testing against every triangle of a detailed model is slow and catches characters on small bumps, while a simple shape that follows the rough outline is cheaper and feels better to move against.

From cheapest to most exact, the choices are primitives (box, sphere, capsule), one convex hull, several convex hulls, and a triangle mesh (trimesh) that copies the model. Trimesh shapes belong on static objects such as level geometry; moving bodies need primitives or convex shapes.

02 // IN YOUR ENGINE

Collision in each engine

  • Godot 4: Mesh > Create Collision Shape (trimesh or convex) in the editor, or the -col and -colonly suffixes on node names at import.
  • Unity: primitive colliders, or a Mesh Collider with Convex ticked for a moving Rigidbody.
  • Unreal Engine: simple collision in the Static Mesh Editor (Auto Convex Collision), or UCX_ prefixed meshes in the FBX.
  • Roblox Studio: CollisionFidelity on a MeshPart (Box, Hull, Default, PreciseConvexDecomposition).
  • three.js: no physics built in; use a physics library with simple shapes.

03 // SPATIAL COMPILER

meshfx and collision mesh

meshfx measures faults, checks repairs and makes LODs. Build physics shapes in your engine or editor. Hosted meshfx runs are available in the Playground.

05 // FAQ

Collision mesh questions

All questions →

README.COLLISION_MESH
Why should a collision mesh be separate from the render mesh?

Physics can use a much simpler shape than the visible model, keeping simulation fast and stable while render meshes change with LODs.

How simple should a collision mesh be?

Keep it as simple as gameplay allows, such as one box for a crate or a capsule for a character.

What is a Mesh Collider in Unity?

A Mesh Collider uses mesh triangles for physics. Disable Convex for static geometry or enable Convex to build a hull for moving bodies.

How does Spatial Compiler handle collision meshes?

meshfx measures faults, checks repairs and builds LODs for rendering. You build physics collision shapes inside your game engine or 3D editor.

How do I import a collision mesh into Godot?

Name your collision node using Godot collision suffixes in the source file so Godot generates physics shapes automatically on scene import.

Explore meshfx outputs

Inspect compiled meshfx outputs and their reports. Hosted meshfx runs are available in the Playground.

All effects, guides and explainers →