meshfx // REPAIR
How to repair a broken mesh before it goes into your game
You repair a broken mesh by fixing its defects in an order where each fix makes the next one easier: delete loose parts, merge duplicate vertices, remove faces hidden inside the model, close holes, then recalculate normals so every face points out. Run your editor's non-manifold selection once more before you export.
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.
- Weld first and fix normals last
- Check with Select Non-Manifold
- Any 3D editor can do every step
01 // WHAT BREAKS
How a broken mesh shows up in the engine
- Faces that vanish or turn black usually have flipped normals, so their front side points into the model and the engine culls them. See fix flipped normals.
- Dark streaks or pinched shading along a line often come from duplicate vertices that split the surface where it should be smooth.
- Physics that snags, LOD tools that fail and baked (precomputed) maps with black spots usually trace back to non-manifold geometry (an edge shared by more than two faces, faces that touch at a single vertex, or open holes).
- Patches that flicker where two surfaces overlap come from interior or duplicate faces drawing at the same depth.
02 // BY HAND
Repair the mesh in this order
- Apply scale and rotation, so the mesh you repair is the mesh you export.
- Select by loose parts and delete fragments that float away from the model.
- Merge vertices by distance with a small threshold, such as 0.0001 m, to weld duplicates without collapsing real detail.
- Delete faces hidden inside the model, such as the inner walls where two parts were pushed together.
- Select non-manifold edges, fill the holes that remain, and delete or split edges shared by more than two faces.
- Delete zero-area faces (degenerate triangles with no surface), then recalculate normals to point outside and flip any that still point in.
- Turn on face orientation display, check the whole model from every side, and export.
03 // WHY THIS ORDER
Why the order matters
Normals recalculate from connected faces, so they come out wrong across a seam that still has duplicate vertices. Hole filling needs a clean boundary, and a boundary full of stray vertices gives you fans of thin triangles. Welding first and recalculating normals last saves you from repeating work.
04 // meshfx
meshfx for mesh repair
meshfx measures holes, flipped faces and non-manifold edges. Each repair is checked against the source and undone with a warning if it moves the surface too far. Hosted meshfx runs are available in the Playground.
How do I fix nonmanifold geometry in a game mesh?
Run your editor nonmanifold selection, merge duplicate vertices, delete interior faces and fill holes, repeating until no broken edges remain.
How do I fix loose geometry and floating vertices in a 3D model?
Select by loose parts to delete unwanted pieces, then remove stray vertices and edges that are not connected to any face.
How do I remove internal faces from a 3D model?
Hide the outer shell or use an interior face selection tool, delete the hidden faces inside and fill any resulting surface holes.
Why does my mesh look black or inside out in a game engine?
Its face normals point inward or it was exported with a negative scale, so recalculate normals outside before exporting.
How do I remove duplicate or overlapping faces?
Merge vertices by distance so overlapping faces share vertices, then select and delete the duplicate faces to stop depth flickering.
What does Spatial Compiler meshfx repair check on a model?
meshfx measures holes, flipped faces and nonmanifold edges, checking every repair against the source and undoing changes that shift the surface.
Explore meshfx outputs
Inspect compiled meshfx outputs and their reports. Hosted meshfx runs are available in the Playground.