Mesh Utility

Many Genesis features — especially inverted-hull Outline, vertex animation, and smooth shading — need clean mesh data. The Mesh Utility window patches what FBX importers leave broken: split smooth normals on hard-edge meshes, duplicate vertices on UV seams, and missing tangents. The patched mesh is saved as a new asset so reimports do not lose your changes.

When to use it

Outline seams on hard-edged stylized meshes (the most common case).
Meshes that lack tangents, which causes vertex-animation and normal-mapping artifacts.
Cleanup before vertex animation so wind sway is continuous across seams.

Inverted-hull outline opens up at every UV seam and hard edge.

Hard shading preserved for lighting, smooth normals used only for outline extrusion. Clean silhouette.

Raw FBX import

Smooth normals in UV3

Storing smooth normals in a UV channel gives you both crisp shading and clean outlines.

Opening the tool

Window → Genesis → Mesh Utility.

Screenshot

The Mesh Utility window showing the mesh source slot, the ordered list of action toggles (Recompute Smooth Normals, Weld Vertices, Recompute Tangents), the Store Smooth In channel dropdown, and a live wireframe preview with the weld-tolerance sphere.

tools/mesh-utility/mesh-utility-window.png

Workflow

Set the source mesh — drop a mesh or select a MeshFilter / SkinnedMeshRenderer in the scene.
Pick the actions you want to run, in order. Multiple actions can run in one click.
Preview the result with the live wireframe. Weld tolerance is shown as a numeric distance and a visual sphere on the mesh.
Apply to save the patched mesh as a new asset next to the original. The renderer can optionally be auto-swapped to the new mesh.

Settings

Inspector label	Shader property	Type	Default	Description
Recompute Smooth Normals	Recompute Smooth Normals	Bool	true	Average normals across vertices that share a position.
Store Smooth In	Store Smooth In	Enum	UV3	Channel for the smooth-normal copy. UV3 is recommended; some setups use vertex color.
Weld Vertices	Weld Vertices	Bool	false	Merge duplicate vertices within the tolerance.
Weld Tolerance	Weld Tolerance	Float (m)	0.0001	Distance threshold in meters.
Recompute Tangents	Recompute Tangents	Bool	true	Generate MikkTSpace tangents — required for normal mapping.
Save Path	Save Path	String	<auto>	Where the patched mesh is written. Defaults to the source path + _genesis.asset.

Tips & gotchas

Never overwrite the imported FBX — Unity will discard your changes on the next reimport. Always save as a new asset.
For skinned meshes, run on the shared mesh asset, not on the instance. The patched mesh is reused across all renderers that reference it.
If outlines still seam after running, check that the Outline feature on the material is set to Use Smooth Normals From: UV3.

A ScriptableObject preset can store an action set (e.g. “Outline-ready”) and be applied to a folder of meshes in one batch — useful when adopting Genesis on an existing library.