# MaterialService

MaterialService : `Instance`

## Overview

MaterialService is a global service that manages the various material representation methods used in the game.

If you specify the name of a MaterialVariant to apply for each material, when selecting that material in a BasePart, the connected MaterialVariant is automatically used instead of the default material. Also, the MaterialVariant must have a BaseMaterial value that matches the target material it is intended to replace for it to apply correctly.

## Properties

### Aspalt

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Bark

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Basic

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### BeigeTerrazzoFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Brick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### BrickCeramicTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### BrokenConcrete

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### BrokenRoof

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### BrushMetal

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### CementWall

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Chainmail

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### CheckerTileFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Concrete

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### ConcretePlate

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Copper

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### CorrugatedSteel

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### CrackedMiddleCeramicTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### CrackedSmallCeramicTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### CrocEmbossedLeather

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### DamagedRoof

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### DistroyedBronze

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### EmeraldGridTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### FabricDenim

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### FabricWeave

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Foil

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GalvanizedMetal

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Glass

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GrainLeather

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Grass

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GreyWovenFabric

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GridBorder

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GridBox

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GridMarble

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GridPentagon

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GridQuad

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### GridTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Ground

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### HalfLeafyGround

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### HouseBricks

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### IndustrialRibbedSteel

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### LeafyGround

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Marble

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### MatteRubber

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Metal

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### MetalPlate

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### MixRoad

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### MosaicCarpet

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### MossyGround

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### MossyRock

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### OceanPanelTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### OfficeCeilingLight

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### OfficeCeilingWhite

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PaintedMetal

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PaintedWood

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PaintedWornWood

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Paving

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PavingBlock

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PavingBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PavingFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PavingStones

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PavingWall

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### PeelingPaintSteel

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Plank

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Plastic

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Road

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Rock

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Roof

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Rust

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### RustBrass

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### RustMetal

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### RustySteel

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Sand

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### SandstoneBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### SilverMetal

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### SmallBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Snow

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### SoilRockGround

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### SquareCeramicTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### StoneBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### StoneFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### TakenOffCeramicTile

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Tatami

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### TerrazzoFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### ThickCarpet

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Unlit

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### UrbanSlateFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### WeatheredPlasterBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### WhiteCementBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### WhiteGrayBrick

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### Wood

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### WoodLogSidingWall

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### WoodSidingWall

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

### WoodTileFloor

`string`

Specifies MaterialVariant to replace the material.

#### Code Samples

## Methods

### GetBaseMaterialOverride

Currently not supported.

#### Parameters

| `Enum.Material` InMaterial | The target material to query the override information for. |
| -------------------------- | ---------------------------------------------------------- |

#### Return

| `string` | The name of the MaterialVariant designated to replace the material. |
| -------- | ------------------------------------------------------------------- |

#### Code Samples

### GetMaterialVariant

Finds and returns the MaterialVariant with the matching name from the specified material.

#### Parameters

| `Enum.Material` InMaterial | The material to search.                                         |
| -------------------------- | --------------------------------------------------------------- |
| `string` InName            | The name of the MaterialVariant to look up within the material. |

#### Return

| `MaterialVariant` | The returned MaterialVariant. |
| ----------------- | ----------------------------- |

#### Code Samples

```lua
local MaterialService = game:GetService("MaterialService")

local Variant = MaterialService:GetMaterialVariant(Enum.Material.Basic, "MaterialVariant1")
print(Variant)
```

### SetBaseMaterialOverride

Currently not supported.

#### Parameters

| `Enum.Material` InMaterial | The target material to set the override for.                    |
| -------------------------- | --------------------------------------------------------------- |
| `string` InName            | The name of the MaterialVariant that will replace the material. |

#### Return

| `void` |   |
| ------ | - |

#### Code Samples

## Events

## See also


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/development/api-reference/classes/materialservice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
