LEARN // meshfx
What is a convex hull
A convex hull is the tightest shape with no dents or holes that wraps around every point of your model, like plastic film shrunk over it. Physics engines use convex hulls for collision because testing two convex shapes against each other is fast and stable, so they are the usual collider for moving objects a box cannot fit.
pyrofx effects work today, and new accounts start with $5 of usage.
meshfx measures faults, checks repairs and makes LODs for a triangle budget. meshfx runs on the hosted API: try it in the Playground.
- No dents: a line between inside points stays inside
- Fast, stable collision for moving bodies
- Concave models need several hulls
- meshfx: measured outputs; hosted availability shown separately
01 // WHAT IT MEANS
Convex shapes and concave ones
A shape is convex when a straight line between any two points inside it stays inside. A ball, a box and most rocks are close to convex, while a cup, a chair and an archway are concave. One hull over a cup fills the inside, so a ball dropped in bounces off the rim.
For concave models, convex decomposition splits the shape into several hulls that together follow the dents, so a chair might become a seat, a back and four legs. More hulls fit better and cost more. A few usually do for a prop, and level geometry uses a trimesh instead.
02 // IN YOUR ENGINE
Hulls in each engine
- Godot 4: Mesh > Create Collision Shape with single or multiple convex, which makes
ConvexPolygonShape3Dshapes. - Unity: a Mesh Collider with Convex ticked. Unity limits a convex mesh collider to 255 triangles.
- Unreal Engine: Auto Convex Collision in the Static Mesh Editor, with a hull count and vertex limit, or
UCX_meshes you model yourself. - Roblox Studio:
CollisionFidelityHull for one hull, or PreciseConvexDecomposition for several.
03 // SPATIAL COMPILER
meshfx and convex hull
meshfx measures faults, checks repairs and makes LODs. Build physics shapes in your engine or editor. Hosted meshfx runs are available in the Playground.
Should I use primitive colliders, convex hulls or a triangle mesh?
Use primitive boxes, spheres or capsules when they fit. Use convex hulls for irregular moving objects and triangle meshes only for static geometry.
What happens when you wrap a concave shape in one convex hull?
One convex hull fills in dents and openings, so a cup or archway becomes solid across its hollow space.
When should I use convex decomposition instead of a single hull?
Use convex decomposition for concave props like chairs so several smaller hulls follow the shape without blocking openings.
Why do moving physics bodies need convex colliders?
Testing two convex shapes against each other is fast and stable, whereas concave triangle meshes are reserved for static level geometry.
What is the difference between single and multiple convex collision in Godot?
Single convex wraps the whole mesh in one hull, while multiple convex splits concave parts into several hulls that both work on moving bodies.
Explore meshfx outputs
Inspect compiled meshfx outputs and their reports. Hosted meshfx runs are available in the Playground.