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.

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.

  • 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

  1. Apply scale and rotation, so the mesh you repair is the mesh you export.
  2. Select by loose parts and delete fragments that float away from the model.
  3. Merge vertices by distance with a small threshold, such as 0.0001 m, to weld duplicates without collapsing real detail.
  4. Delete faces hidden inside the model, such as the inner walls where two parts were pushed together.
  5. Select non-manifold edges, fill the holes that remain, and delete or split edges shared by more than two faces.
  6. Delete zero-area faces (degenerate triangles with no surface), then recalculate normals to point outside and flip any that still point in.
  7. 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.

06 // FAQ

Mesh repair questions

All questions →

README.REPAIR
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.

All effects, guides and explainers →