Vi3W
Skip to content

Guides

Roblox MaterialVariant and Material Manager: custom materials guide

Make custom materials in Roblox Studio with MaterialVariant: Material Manager steps, texture maps, Studs Per Tile, overrides, and SurfaceAppearance.

3 min read

A row of spheres showing different custom materials: mossy stone, brushed metal, cracked ice and painted wood
Illustration. Custom materials replace Roblox's built-in look.

Quick answer

What is a MaterialVariant in Roblox?

It's a custom version of a built-in material like Brick, Wood or Grass, with your own colour, normal, roughness and metalness maps. You make one in the Material Manager, and it lives in MaterialService. Apply it to selected parts, or set it as an override so it replaces that material everywhere in the place, terrain included.

MaterialVariant vs SurfaceAppearance

Roblox has two ways to put PBR textures on things, and they suit different jobs (materials):

  • Made for: MaterialVariant: Tiling surfaces: floors, walls, rock, terrain; SurfaceAppearance: One specific UV-mapped mesh
  • Works on: MaterialVariant: Parts, MeshParts, unions, terrain; SurfaceAppearance: MeshParts
  • Texture repeats?: MaterialVariant: Yes, every N studs; SurfaceAppearance: No, it follows the mesh's UVs
  • Physical properties: MaterialVariant: Yes: friction, density and more; SurfaceAppearance: No
  • Where it lives: MaterialVariant: MaterialService; SurfaceAppearance: As a child of the MeshPart

Rule of thumb: walls, floors and ground use MaterialVariant; a modelled prop with its own texture uses SurfaceAppearance.

Make a custom material

  1. Open Material Manager from the Home or Model tab.
  2. Pick the base material to build on, such as Slate.
  3. Click Create Material Variant, and rename it in the inspector, for example MossyStone.
  4. Add texture maps: Color, Normal, Roughness and Metalness. Paste an asset ID or import an image. Square textures work best, and maps you leave empty stay blank.
  5. Set Studs Per Tile to control how often the texture repeats.
  6. Set Pattern to control how the tiling is laid out.
A stone floor tiling across a large plane, with a sample sphere of the same material
Illustration. A tiling material repeats every few studs across big surfaces.

Apply it

  • To selected parts: select them and click Apply to Selected Parts, or set the part's MaterialVariant property. Studio sets the part's Material to your base material.
  • Everywhere: turn on Set as Override. Your variant now replaces every use of that base material in the place, terrain included. It's a fast way to restyle a whole map.

Gotchas

  • Names, not links. Parts store the variant's name. Rename the variant and parts stop finding it until you reapply it.
  • Models and packages need the variant too. If you share a model that uses a custom material, the MaterialVariant must be in MaterialService in the new place, or the parts fall back to the base look.
  • Physical properties stack. The engine uses the part's own custom physical properties first, then the variant's, then any override's, then the base material's.

Getting good tiling textures

  • Tileable edges. The left edge must match the right, and the top the bottom, or you'll see a grid of lines.
  • Size. 512 or 1024 is usually plenty, since the texture repeats. See Roblox texture size.
  • Normal maps in OpenGL format. Roblox expects OpenGL-style normal maps (surface appearance). If bumps look inverted, flip the green channel. More in normal map not working.
  • Roblox's generator. Studio's Assistant can generate materials from a prompt too. See Roblox Texture Generator.

Where meshes fit

MaterialVariants make walls and ground look rich, but props usually need their own UV-mapped textures with SurfaceAppearance. Vi3W generates props with their own texture, retopologised and exported as GLB, FBX or OBJ, to place on surfaces textured with your materials. Make a textured prop in Vi3W.

Last reviewed