MaterialService

MaterialService : Instance

Overview

The MaterialService class is a game service that allows developers to manage and customize materials used in their games. It serves as the container for MaterialVariant instances, which are custom versions of built-in materials. Using MaterialService, developers can globally override default materials or apply custom materials to specific parts or terrain, enabling unique visual styles and enhanced realism.

Description

The MaterialService class provides a centralized system for managing materials. By leveraging MaterialVariants, creators can redefine the appearance of base materials.

Properties

BasicName

string

Name of the MaterialVariant to replace the built-in Basic material

Code Samples

BrickName

string

Name of the MaterialVariant to replace the built-in Brick material

Code Samples

MetalName

string

Name of the MaterialVariant to replace the built-in Basic material

Code Samples

PlasticName

string

Name of the MaterialVariant to replace the built-in Metal material

Code Samples

RockName

string

Name of the MaterialVariant to replace the built-in Rock material

Code Samples

UnlitName

string

Name of the MaterialVariant to replace the built-in Unli material

Code Samples

BarkName

string

Name of the MaterialVariant to replace the built-in Bark material

Code Samples

SmallBrickName

string

Name of the MaterialVariant to replace the built-in SmallBrick material

Code Samples

LeafyGroundName

string

Name of the MaterialVariant to replace the built-in LeafyGround material

Code Samples

MossyGroundName

string

Name of the MaterialVariant to replace the built-in MossyGround material

Code Samples

GroundName

string

Name of the MaterialVariant to replace the built-in Ground material

Code Samples

GlassName

string

Name of the MaterialVariant to replace the built-in Glass material

Code Samples

PavementName

string

Name of the MaterialVariant to replace the built-in Pavement material

Code Samples

MossyRockName

string

Name of the MaterialVariant to replace the built-in MossyRock material

Code Samples

WoodPlanksName

string

Name of the MaterialVariant to replace the built-in WoodPlanks material

Code Samples

WoodName

string

Name of the MaterialVariant to replace the built-in Woodmaterial

Code Samples

AsphaltName

string

Name of the MaterialVariant to replace the built-in Asphalt material

Code Samples

ConcreteName

string

Name of the MaterialVariant to replace the built-in Concrete material

Code Samples

MarbleName

string

Name of the MaterialVariant to replace the built-in Marble material

Code Samples

MetalPlateName

string

Name of the MaterialVariant to replace the built-in MetalPlate material

Code Samples

RustName

string

Name of the MaterialVariant to replace the built-in Rust material

Code Samples

SandName

string

Name of the MaterialVariant to replace the built-in Sand material

Code Samples

SnowName

string

Name of the MaterialVariant to replace the built-in Snow material

Code Samples

StoneBrickName

string

Name of the MaterialVariant to replace the built-in StoneBrick material

Code Samples

StoneFloorName

string

Name of the MaterialVariant to replace the built-in StoneFloor material

Code Samples

SiverMetalName

string

Name of the MaterialVariant to replace the built-in SiverMetal material

Code Samples

CorrugatedSteelName

string

Name of the MaterialVariant to replace the built-in CorrugatedSteel material

Code Samples

GrassName

string

Name of the MaterialVariant to replace the built-in Grass material

Code Samples

PavingStonesName

string

Name of the MaterialVariant to replace the built-in PavingStones material

Code Samples

RoadName

string

Name of the MaterialVariant to replace the built-in Road material

Code Samples

WhiteGrayBrickName

string

Name of the MaterialVariant to replace the built-in WhiteGrayBrick material

Code Samples

ConcretePlateName

string

Name of the MaterialVariant to replace the built-in ConcretePlate material

Code Samples

RoofName

string

Name of the MaterialVariant to replace the built-in Roof material

Code Samples

GridQuadName

string

Name of the MaterialVariant to replace the built-in GridQuad material

Code Samples

DistroyedBronzeName

string

Name of the MaterialVariant to replace the built-in DistroyedBronze material

Code Samples

HalfLeafyGroundName

string

Name of the MaterialVariant to replace the built-in HalfLeafyGround material

Code Samples

PavingWallName

string

Name of the MaterialVariant to replace the built-in PavingWall material

Code Samples

GridBoxName

string

Name of the MaterialVariant to replace the built-in GridBox material

Code Samples

RustBrassName

string

Name of the MaterialVariant to replace the built-in RustBrass material

Code Samples

PavingFloorName

string

Name of the MaterialVariant to replace the built-in PavingFloor material

Code Samples

GridTileName

string

Name of the MaterialVariant to replace the built-in GridTile material

Code Samples

PavingBrickName

string

Name of the MaterialVariant to replace the built-in PavingBrick material

Code Samples

GridPentagonName

string

Name of the MaterialVariant to replace the built-in GridPentagon material

Code Samples

GridMarbleName

string

Name of the MaterialVariant to replace the built-in GridMarble material

Code Samples

Methods

GetBaseMaterialOverride

Gets the MaterialVariant name of the overridden material.

Parameters

Enum.Material InMaterial

Return

string

Code Samples

local MaterialService = game:GetService("MaterialService")

local VariantName = MaterialService:GetBaseMaterialOverride(Enum.Material.Plastic)
print(VariantName)

GetMaterialVariant

Retrieves the MaterialVariant associated with the given material and name.

Parameters

Enum.Material InMaterial	The material to associate the variant with.
string InName	The name of the MaterialVariant to retrieve.

Return

MaterialVariant

Code Samples

SetBaseMaterialOverride

Sets the base material override with a given material and name using parameters: an Enum.Material (InMaterial).

Parameters

Enum.Material InMaterial
string InName

Return

void

Code Samples

Events