Material Replacer

Material Replacer

Module: Tech · Category: Workflow · Tool ID: MaterialReplacer

Batch-find and replace materials across actors in the current level. Scans Static Meshes, Skeletal Meshes, Decals, and other placed actors. Pick source material, pick target material, click Scan, review the per-actor list, optionally narrow with checkboxes, click Replace Selected. Fully undoable.

---

When to use it

• Migrating from one master material to another across an existing level
• Replacing placeholder materials with finals
• Bulk-cleaning levels of legacy materials before deletion
• Swapping a deprecated material for a new replacement

When not to use it

• Don’t expect parameter remapping — assignment is a straight material swap; parameter values come from the new MI’s defaults
• Don’t use this for asset-side replacement — it operates on placed actors, not asset references

---

Opening the tool

1. Open the EQLabs Hub and search for Material Replacer (or browse to Tech → Workflow)
2. Click the tool card
3. Pick source + target materials, scan, replace

---

Interface tour

Field	What it does
Source Material picker	Material to replace (find usages)
Target Material picker	Material to substitute in
Scan Level	Walks the active level for actors using Source
Search box	Filter usages by actor name
Select All / Deselect All	Bulk toggle on the per-row checkboxes
Replace Selected	Performs the swap on every checked usage
Copy Results	Plain-text dump
Usages list	Per-row: actor name, component name, material slot, current material, selected flag

---

Workflow

1. Drop source material into the Source picker
2. Drop target material into the Target picker
3. Click Scan Level — usages list populates
4. Use Select All or per-row checkboxes to narrow
5. Click Replace Selected — swap is wrapped in a single transaction
6. Save the level

---

Settings reference

No persisted settings beyond the standard tool framework.

---

Output

• Material assignment changes on selected actor components — undoable
• Clipboard — Copy Results

---

Tips & gotchas

• Replacement is per-component-slot — Static Mesh + Skeletal Mesh + Decal components all replaced
• Target material’s parameter values are used — not the source’s. If you want to migrate parameter values, copy them via Material Preset Manager first
• Save the level afterward — replacement is in-memory until save

---

Related tools

• Material Preset Manager — capture/apply parameter sets across instances
• Material Property Diff — diff two MIs to verify migration completeness
• Batch Actor Replacer — broader actor-class-based replacement

---