Material Migration

Material Migration scans selected folders or selections for Standard, URP Lit, URP Simple Lit, HDRP Lit, and other supported source shaders, then converts the materials to Genesis equivalents while remapping properties (albedo, normal, metallic, smoothness, emission, and so on). Originals are backed up before being touched.

When to use it

Adopting Genesis on an existing project — convert your library in one pass.
Upgrading older Genesis materials when a major version changes the property layout.
Switching art directions — convert URP Lit props to Toon-mode Genesis equivalents.

Opening the tool

Window → Genesis → Material Migration.

Screenshot

The Material Migration window showing a list of source materials with their detected source shaders, the property-by-property remap table (e.g. _BaseMap to _Albedo) with warning icons on unmapped properties, and the Target Mode selector.

tools/material-migration/material-migration-window.png

Workflow

Pick a source — drag a folder, drag a selection, or right-click a material in the project window and choose Genesis → Migrate to Genesis.
Review the remap table. For each material, the tool shows the property-by-property mapping (e.g. _BaseMap → _Albedo, _Smoothness → _Smoothness). Warnings flag properties without a clean equivalent.
Choose a target mode — Lit (default for PBR), Unlit (flat color materials), or Toon (cel-shaded conversions).
Migrate. Originals are renamed to *_original.mat and the migrated material reuses the original name and GUID, so every reference in scenes and prefabs continues to resolve.
(Optional) Use the Compare button to A/B the migrated material against its backup; the tool spawns two side-by-side preview spheres.

Settings

Inspector label	Shader property	Type	Default	Description
Target Mode	Target Mode	Enum	Lit	Genesis Rendering Mode applied to all conversions.
Backup Originals	Backup Originals	Bool	true	Rename originals to *_original.mat before overwriting. Strongly recommended.
Preserve GUIDs	Preserve GUIDs	Bool	true	Migrated materials reuse the original GUID — scene references stay intact.
Skip Unsupported	Skip Unsupported	Bool	true	If the source shader is not recognized, leave the material alone and log a warning.
Auto-Detect Toon	Auto-Detect Toon	Bool	false	Suggest Toon mode when a source material has low smoothness and high base-color saturation.

Tips & gotchas

Custom Shader Graphs are never auto-migrated. The tool reports them as unsupported so you can hand-convert.
The Compare view is your friend — visually verify a handful of conversions before committing to the rest of the library.
Migration is non-destructive thanks to backups, but commit your project to source control first anyway.

Most Standard and URP Lit materials migrate cleanly. The exceptions are usually custom shaders or materials that relied on quirks of the source shader.