appearance.swapMaterials

Batch-assign one material across entity hierarchies in a single call — one root, a list of roots, or the whole scene. Targets are discovered from component schemas: every public field declared to hold a material reference receives the material, so Model, SkinnedModel, and every user-authored component carrying a material field participate. Name the material as a word (an exact identity match wins, then an exact leaf name, then the first case-insensitive substring match) or pass a material reference directly. Options let you take only the first assignment or restrict to entities matching a name pattern; each affected entity flashes a blue outline for visual confirmation, and the result lists exactly which fields changed.