Materials

Roblox's materials are unlike materials on other platforms, in that their visual appearance and their physical properties reflect those of materials in the real world. For example, concrete is heavier than plastic and sinks faster in water. When you set the material of a part or terrain, Roblox simulates its physical material properties to make this behavior just work.

The Roblox Engine offers a range of base materials suitable to build many games, including various categories of metal, rock, and organic materials.

You can also create your own custom materials and apply them to parts or terrain. Custom materials have an additional adaptive materials behavior that lets you adapt any model to use your art style and custom materials, even if someone else created the model.

Apply materials#

You can quickly apply materials to parts through the Material widget. The Material Manager offers the same functionality and an additional "paint tool" application mode.

Material widget#

The Material widget is accessible from the Home or Model tab toolbars. Click‑holding over the small corner arrow on the button reveals a material picker. See Parts for more information.

Material Manager#

The Material Manager is accessible through Window ⟩ 3D ⟩ Material or from the Material widget's picker popup. From the manager window, you can apply materials to parts through the following workflows.

Custom materials#

The Material Manager provides a user interface to interact with various aspects of MaterialService, including creating new custom materials and applying them to parts and terrain. Custom materials are represented by MaterialVariant instances within MaterialService.

You can apply custom materials per-part or globally to both parts and terrain, and you can fine-tune how custom materials apply to faces of terrain with TerrainDetail instances.

Create custom materials#

You can edit all properties of a custom material in the Material Manager or through the properties of a MaterialVariant instance. You can also generate custom materials through the prompt‑based Material Generator.

To create a custom material in the Material Manager:

1. Click the base material from which your custom material will inherit physical properties. If you skip this step, the base material will be Plastic, but you can change it later.

   

2. In the top-left corner, click Create Material Variant.

   

   A new variant appears in the palette with an icon in the bottom-right corner, indicating it's a custom material.

   

3. In the inspector, rename your custom material to describe its purpose. You can change the name later, but if you do so after applying the material to parts, you'll need to re-apply it to those parts.

4. For each texture map option such as Color or Normal, paste an asset ID or import a new texture from your computer. Square textures work best. If you don't specify an asset for a texture map, that texture remains blank.

5. If desired, adjust the Studs Per Tile and Pattern values to change how the material looks.

Apply custom materials#

For parts, you can use a custom material just like any other material, applying it to selected parts through the Material widget or the Material Manager.¹

You can also apply the new material to a part by setting its MaterialVariant property in the Properties window. In this case, Studio automatically sets its Material property to the base material you chose when creating the material.

Material overrides#

You can set a custom material as a material override to make its base material serve as a reference to the custom material. When you do so, Studio will use the custom material for both the textures and physical properties of any part or terrain that uses the custom material.

Set overrides#

To set a custom material as a material override in the Material Manager:

1. Click the custom material that you want to set as an override.

2. In the inspector, scroll down to Overrides and enable Set as Override.

   

   The new override appears as a property of MaterialService in the Properties window.

   

Terrain details#

By default, applying a custom material to parts or as an override applies that custom material as tiles across each face. For terrain, you can optionally configure TerrainDetail instances to customize the top, side, and bottom of terrain voxels using that custom material.

To customize the faces of terrain using a custom material:

1. In the palette of the Material Manager, click the custom material.

2. In the inspector, confirm that its Set as Override toggle is enabled.

   

3. In the Terrain Details section, click Create for each face you want to customize.

   

4. For each face you enable, expand the arrow to access and edit details such as its name, texture maps, studs per tile, and pattern.

   

Disable overrides#

You can disable an entire material override and all base materials that it's currently overriding, or you can disable the override for a specific base material.

Physical properties#

All materials have built-in physical properties such as density, elasticity, and friction. Through the application of custom materials with unique physical properties, you can affect global material behavior for all parts and terrain which use the custom material, such as creating an extremely slippery variant of the Ice material.

When factoring physical properties, the engine prioritizes more granular per-part settings over material behaviors to determine the effective physical properties of a surface:

Adaptive materials#

When you apply a custom material to a part, the part's Part.MaterialVariant property becomes the name of its MaterialVariant rather than its specific instance. This means that when you reuse the part in the same or a different place, as in a model or package, it's easier for you to adapt different custom materials to adjust the part's look. The adaptive behavior of custom materials has the following effects:

• If you create collections of custom materials with the same name but different textures, then you can quickly change the style of a place by changing which collection is a child of MaterialService.
• If you insert a model with parts that use a custom material, then you can modify its look by creating an instance of MaterialVariant in MaterialService and renaming it to the same name as the previous custom material, rather than applying the new material to the parts in the model.

When you reuse custom materials in models and packages, each MaterialVariant instance must be in MaterialService for it to work.

• If you distribute a model to the Creator Store with a custom material, include the MaterialVariant instance in the model. For more information about distributing models to the Creator Store, see Distributing Assets.
• If you insert a model from the Creator Store, look for any MaterialVariant instances and copy them to MaterialService. For more information about importing models from the Creator Store, see Creator Store.
• If you want to use custom materials with packages, put the package in MaterialService. For more information on packages, see Packages.

The Creator Store has a category called Materials for "material packs", models that contain only MaterialVariant, TerrainDetail, Folder, and Model instances. The Materials category is a way to promote and discover custom materials by other creators.

Asset and property reference#

Base materials#

Shaders generate the look and feel of materials. The base material shaders work differently than the shader which MaterialVariant instances use, so you can't create custom materials that look exactly like base materials, but you can still create custom materials that use their textures. The following tables list the asset IDs for material details such as ColorMap and RoughnessMap.

Pre-2022 Base

Material	Color	Normal	Metalness	Roughness
Brick	7546648254	7546649654		7546650017
Cobblestone	7546651802	7546652689		7546652892
Concrete	7546653328	7546653707		7546653868
CorrodedMetal	7547183598	7547181182	7547184321	7547184588
DiamondPlate	7546654401	7546654536	7547162002	7547162137
Fabric	7547100606	7547100915		7547101072
Foil	7546644642	7546644903	7546644642	7546644963
Glass	7547304577	7547304785		7547304892
Granite	7547164400	7546654648		7547164660
Grass	7547167347	7547168653		7547169207
Ice	7546644642	7547171198		7547171276
Marble	7547174345	7547176060		7547177213
Metal	7547178395	7547287997	7547288112	7547179082
Pebble	7547291174	7546645052		7547291306
Sand	7547294684	7547294810		7547295087
Slate	7547297050	7547297808		7547298051
Wood	7547190453	7547190548	7547190619	7547303147
WoodPlanks	7547301709	7547188159	7547188891	7547332869