meshfx
Fix 3D models for your game
You can inspect meshfx outputs and use these guides to measure, repair and reduce a model. meshfx checks each repair against the source and reports distance and faults for every level of detail. Hosted availability is separate from these compiled examples; your editor can still perform the by-hand steps.
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.
- Every fix in these guides works by hand today
- meshfx: measured outputs; hosted availability shown separately
- Effects work today
01 // ALL PAGES
meshfx and mesh
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.
Repair
- meshfx repair AvailableRepair a broken mesh in order (loose parts, duplicate vertices, interior faces, holes, then normals) by hand in any 3D editor.
- Non-manifold edges AvailableFind non-manifold edges, merge duplicates, delete interior faces and fill holes by hand in any 3D editor before export.
- Flipped normals AvailableRecalculate normals outside, flip the faces left over and apply mirrored scale so a model draws correctly in any engine.
- Fill mesh holes AvailableClose mesh holes by hand with a single face, a grid fill or a bridge between edge loops, then fix normals and UVs.
- Duplicate vertices AvailableWeld duplicate vertices with Merge by Distance at a small threshold, then restore sharp edges so shading stays crisp.
- Fix n-gons AvailableFind faces with more than four sides and cut them into quads or triangles yourself before an engine splits them badly.
- Zero-area faces AvailableCollapse degenerate triangles with a cleanup command and a small distance so they stop causing black specks and physics errors.
- Fix model scale AvailableSize a model in real units, apply the scale, export in the right unit and set the engine import scale only when needed.
- Fix pivot point AvailableMove a model's origin to its base, hinge or axle before export, or offset it inside a parent node in the engine.
By file format
- GLB scale AvailableglTF is always meters, so fix a wrong-size GLB by applying node scales and correcting the geometry before you export again.
- FBX scale AvailableFBX stores a unit per file, so match the export unit to the engine import scale to stop the factor of 100.
- OBJ scale AvailableOBJ has no unit, so read its vertex values, scale the model to real size and set the export or import scale yourself.
- STL scale AvailableSTL numbers are millimeters by convention, so import at 0.001, apply the scale and export GLB or FBX for a game engine.
- USD scale AvailableCheck a USD stage's metersPerUnit and upAxis, match them to the geometry or scale the root prim, then import again.
- GLB pivot AvailableA GLB pivot is the node origin, so move the origin in your 3D editor or offset the model inside a parent node.
- FBX pivot AvailableSet the FBX origin, clear pivot offsets and untick Transform Vertex to Absolute in Unreal Engine to keep each pivot.
- OBJ pivot AvailableAn OBJ pivot is always the file origin, so move the model to 0, 0, 0 before export or switch to GLB.
- USD pivot AvailableUSD stores pivots as translate:pivot operations, so apply the pivot into the prim origin before export for consistent rotation.
- GLB normals AvailableglTF culls clockwise faces and mirrored nodes flip winding, so fix orientation and scale before exporting the GLB again.
- FBX normals AvailableApply mirrored scale, recalculate normals, export the FBX with normals, and set the Unity or Unreal Engine normal import option.
- OBJ normals AvailableMake OBJ face order and vn normals agree by recalculating normals and exporting with normals, or let the engine rebuild them.
- STL normals AvailableWeld the loose STL triangles, recalculate normals outside and export so facet normals and vertex order agree again.
- USD normals AvailableCheck a USD mesh's orientation, doubleSided and subdivisionScheme attributes, then fix face direction in your 3D editor.
- GLB n-gons AvailableglTF holds triangles only, so triangulate n-gons yourself before exporting a GLB and keep the quad version as source.
- FBX n-gons AvailableFBX keeps n-gons and lets the engine split them, so triangulate in your 3D editor or on export to choose the cuts.
- OBJ n-gons AvailableOBJ face lines can hold any number of corners, so triangulate before export and stop each importer splitting them differently.
- USD n-gons AvailableSplit USD n-gons in your 3D editor and set subdivisionScheme to none so previews and your engine show the same faces.
- GLB duplicate vertices AvailableGLB files split vertices at seams on purpose, so merge only real duplicates in your 3D editor and export again.
- OBJ duplicate vertices AvailableOBJ needs only one v line per position, so merge by distance in your 3D editor and export to drop repeated vertices.
- STL duplicate vertices AvailableSTL repeats every corner per triangle, so weld it with Merge by Distance right after import before any repair or smoothing.
In your engine
- Wrong size in Godot AvailableGodot counts meters, so export in meters or set Root Scale in the Import dock and reimport to fix a model's size.
- Wrong size in Unity AvailableUnity counts meters, so check Convert Units and Scale Factor in the Model tab and keep the root Transform at scale 1.
- Wrong size in Unreal AvailableUnreal Engine counts centimeters, so use Convert Scene Unit, Import Uniform Scale or Build Scale to fix a model's size.
- Wrong size in Roblox AvailableRoblox Studio measures in studs, so set Scale Unit in the 3D Importer and compare with a default part before placing the model.
- Wrong size in three.js Availablethree.js has no fixed unit, so measure a loaded model with Box3 and fix the GLB or scale the loaded scene once.
- Invisible in Godot AvailableCheck flipped normals, scale, Camera3D Near and Far, the material and the node position when a model is invisible in Godot.
- Invisible in Unity AvailableCheck flipped normals, import scale, camera clipping planes, Culling Mask and the material when a model is invisible in Unity.
- Invisible in Unreal AvailableCheck flipped normals, a 100 times too small import, the near clip plane and applied vertex positions when a model is invisible in Unreal.
- Invisible in Roblox AvailableCheck flipped normals, scale, Transparency, position and Anchored when an imported model is invisible in Roblox Studio.
Polycount, LOD and collision
- Mobile polycount AvailableStarting triangle budgets for mobile characters, props and whole frames, plus how to measure them on a real phone.
- Web polycount AvailableTriangle and file size budgets for browser scenes and three.js games, and how to count what each frame draws.
- VR polycount AvailableStarting triangle budgets for standalone VR headsets, why VR is stricter than a flat screen, and how to measure in the headset.
- Roblox polycount AvailableThe 20,000-triangle MeshPart cap in Roblox Studio, starting budgets for props and builds, and how to bring a model under it.
- Godot polycount AvailableStarting triangle budgets for Godot 4, how the three renderers change them, and how to read the primitive count while the game runs.
- Unity polycount AvailableUnity's 65,535-vertex index limit, when to switch to 32-bit indices, starting budgets, and where to read the polycount.
- Unreal polycount AvailableHow Nanite changes polycount in Unreal Engine 5, starting budgets for characters and other meshes without it, and how to measure.
- Reduce polycount AvailableDecimate a model to a lower triangle count without losing its outline or texture, then fix the shading and bake (precompute) back the detail.
- LOD in Godot 4 AvailableHow Godot 4's automatic import LODs work, how to tune them with lod_bias, and when to use visibility ranges instead.
- LOD in Unity AvailableSet up a LOD Group in Unity by hand or from _LOD suffixes in an FBX, pick switch points, and cross-fade between levels.
- LOD in Unreal AvailableGenerate and tune LODs in Unreal Engine 5's Static Mesh Editor, import your own levels, and know when Nanite replaces them.
- LOD in Roblox AvailableHow Roblox picks mesh detail with RenderFidelity and streaming, and how to swap your own low-detail version from a LocalScript.
- LOD in three.js AvailableBuild LOD in three.js with THREE.LOD and addLevel, stop flicker with hysteresis, and keep the extra levels light for the download.
- Collision in Godot 4 AvailableAdd collision in Godot 4 with Create Collision Shape or -col and -colonly import suffixes, and pick trimesh or convex shapes.
- Collision in Unity AvailableAdd collision in Unity with primitive colliders or a Mesh Collider that uses its own simple mesh, and when to tick Convex.
- Collision in Unreal AvailableAdd collision in Unreal Engine 5 with simple shapes, Auto Convex Collision or UCX_ meshes, and set simple and complex collision.
- Collision in Roblox AvailablePick a CollisionFidelity for each Roblox MeshPart, or build custom collision from an invisible simple part.
- Collision in three.js AvailableCollision in three.js with a hidden low-poly mesh in your GLB, the Octree and Capsule addons, or a physics library with simple shapes.
Generated and scanned models
- Clean up a generated model AvailableTurn a model from an AI 3D generator into a game asset: remove junk geometry, weld, reduce, rebuild UVs, bake (precompute) again, set scale and pivot.
- Generated model to Godot AvailableBring a model from an AI 3D generator into Godot 4 as GLB, then set scale, LODs and collision in the import settings.
- Generated model to Unity AvailableBring a model from an AI 3D generator into Unity as FBX, set the import options that matter, and rebuild its URP material.
- Generated model to Roblox AvailableBring a model from an AI 3D generator into Roblox Studio under the triangle cap, with SurfaceAppearance textures and simple collision.
- Clean up a 3D scan AvailableTurn a dense photogrammetry scan into a light game model: cut, fill, rebuild the mesh, bake (precompute) the detail and remove the shoot's lighting.
- Splat to mesh AvailableWhy a Gaussian splat capture has no surface, how to rebuild a game mesh from it by hand, and when to keep the splat instead.
- Retopology for generated models AvailableWhy models from AI 3D generators have grid-like topology, when to decimate instead, and how to retopologize a generated character.
- Retopology AvailableRebuild a dense or messy model as clean quads that keep its shape, then unwrap it and bake (precompute) the detail back, by hand in any 3D editor.
UVs, textures and conversion
- Fix missing UVs AvailableSpot missing or broken UVs, unwrap and pack them again by hand, and know when your engine needs a second UV set for lightmaps.
- Bake (precompute) high to low poly AvailableBake (precompute) a high-poly model's surface onto a low-poly game mesh as normal, color and occlusion maps, and fix the usual bake (precompute) errors.
- Pack an ORM texture AvailablePack ambient occlusion, roughness and metallic into one ORM texture, and where it goes in glTF, Godot, Unreal, Unity and Roblox.
- FBX to GLB AvailableConvert an FBX file to GLB by hand, and what changes on the way: units, axes, materials, n-gons and animation.
- OBJ to GLB AvailableConvert an OBJ file and its .mtl materials to GLB by hand, and fill in what OBJ leaves out: units, pivots, PBR materials and normals.
- GLB to FBX AvailableConvert a GLB file to FBX by hand for Unity or other FBX tools, and set units, axes, textures and animation on purpose.
- USD to GLB AvailableConvert a USD stage to GLB by hand, and handle what changes: metersPerUnit, upAxis, winding, n-gons, materials and variants.
How do I fix a broken mesh?
Find the problem first by checking face orientation, non manifold geometry, scale and triangle count, then fix each issue with its matching step.
How do I clean up an AI generated 3D model for a game?
Remove floating parts, weld duplicate vertices, fix normals, reduce the triangle count, then redo UVs and add collision for your engine.
What is a good polygon budget for a game prop?
It depends on the platform and how close the camera gets. Smaller budgets suit mobile and web, while desktop props can carry more triangles.
What does the meshfx module check and repair?
meshfx measures holes, flipped faces and non manifold edges. Each repair is checked against the source and undone if it moves the surface too far.
Explore meshfx outputs
Inspect compiled meshfx outputs and their reports. Hosted meshfx runs are available in the Playground.