Materials | Documentation - Roblox Creator Hub (2024)

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 experiences, 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.

Applying Materials

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

Material Widget

The Material widget is accessible from either the Home or Model tabs.

Clicking the small dropdown arrow reveals a material picker and, by default, applies the chosen material to all selected parts. Once you've selected a material, you can quickly apply it to other parts by selecting those parts and clicking the Material button itself.

Material Manager

If you've enabled the Material Picker beta, access the Material Manager from the picker window. If you have not enabled the beta, locate its dedicated button to the left of the Color button in the Home or Model tab.

From the manager window, you can apply materials to parts through the following workflows.

The default Enum.Material property for new Part instances is Plastic. To apply a different material to parts:

1. In the 3D viewport or Explorer, select one or more parts.

2. In the Material Manager palette, hover your mouse over the desired material (you don't need to select it) and click the Apply to Selected Parts button.

   

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.

Creating 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.

   See Also

   Texture Generator | Documentation - Roblox Creator Hub

   

   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 assetID 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.

Applying 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.

Setting 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.

   

Disabling 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.

1. In the palette of the Material Manager, click a custom material that's being used as an override.

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

   

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:

Custom physical properties of the specific part.

Custom physical properties of the part's custom material.

Custom physical properties of the material override of the part's material.

The default physical properties of the part's material.

To set unique physical properties for any custom material and automatically apply them to all parts and terrain which use the material:

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

2. In the inspector, scroll down to the Physics section and set custom physical properties as detailed in the PhysicalProperties reference.

   

   For any part that uses the custom material and does not have part-specific overrides, the CurrentPhysicalProperties branch in the Properties window reveals that its default physical properties are overridden by the custom material's properties.

   

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 assetIDs for material details such as ColorMap and RoughnessMap.

Default Colors

The following table lists the default RGB values for each base material. For information on how to color parts and terrain, see Parts and Environmental Terrain.

Default Physical Properties

The following table lists each material's default physical properties as detailed in the PhysicalProperties reference. For information on customizing physical properties, see Physical Properties.