Smart UV Generator

Procedural meshes, ZBrush exports, and old FBX files often ship with no second UV or with overlapping UVs. The Smart UV Generator projects fresh UVs from a chosen geometric primitive — planar, box, cylindrical, or spherical — and exports the result as a new mesh asset. The new UV channel is written to whichever slot you pick (UV1 for lightmap, UV2 for detail, UV3 for outline normals).

When to use it

Sculpted meshes that arrive without UVs.
Procedural mesh pipelines that emit fresh geometry at runtime or in editor scripts.
Detail UV generation when the imported UV layout is fine for albedo but poor for tiled detail textures.

Opening the tool

Window → Genesis → Smart UV Generator.

Screenshot

The Smart UV Generator window with a checkerboard-textured mesh preview, the projection-mode selector (Planar, Box, Cylindrical, Spherical), scale and orientation sliders, and the target UV channel dropdown.

tools/smart-uv-generator/smart-uv-generator-window.png

Workflow

Set the source mesh. The preview shows a checkerboard sampled by the current UVs (or solid pink if none).
Pick a projection mode — Planar, Box, Cylindrical, or Spherical. Each mode exposes its own controls (axis, scale, blend angle for Box).
Tune scale and orientation with the sliders. The checkerboard preview updates live, so iteration is immediate.
Pick a target UV channel — UV0 (replace albedo UVs), UV1 (lightmap), UV2 (detail), or UV3 (outline smooth normals).
Save. A new mesh asset is written next to the source with the suffix _uv<mode>. The renderer can optionally be auto-swapped.

Settings

Inspector label	Shader property	Type	Default	Description
Projection	Projection	Enum	Box	Planar, Box, Cylindrical, or Spherical.
Target UV Channel	Target UV Channel	Int (0–3)	1	Which UV channel to write. 0 replaces albedo UVs; 1 is the lightmap channel; 2 is typical for detail textures.
Scale	Scale	Vector3	(1, 1, 1)	Tile frequency per axis.
Axis	Axis	Enum	Y	Primary axis for Cylindrical and Planar modes.
Box Blend Angle	Box Blend Angle	Float (deg)	30	Degrees of blending between adjacent faces in Box mode.
Rotation	Rotation	Vector3	(0, 0, 0)	Euler rotation applied to the projection volume.

Tips & gotchas

For organic shapes, Spherical produces poor poles — try Box with a wide blend angle instead.
The new UV channel does not replace your original UVs unless you write to UV0. Use UV2 for safe additive workflows.
Combine with Triplanar Mapping for meshes that even procedural UVs cannot save — Triplanar projects from world axes per-pixel and avoids the UV step entirely.

Smart UV Generator writes deterministic output. Re-generating with the same settings on the same mesh always produces the same UVs — safe for source control.