# MaterialService

MaterialService : `Instance`

## Overview

MaterialService는 게임 내에서 활용되는 다양한 재질의 표현 방식을 관리하는 전역 서비스입니다.

재질마다 적용할 MaterialVariant의 이름을 지정해두면, BasePart에서 해당 재질을 선택할 때 기본 제공 재질 대신 연결된 MaterialVariant가 자동으로 사용됩니다. 또한, 해당 MaterialVariant는 BaseMaterial 값이 대체하려는 대상 재질과 일치해야 정상적으로 적용됩니다.

## Properties

### Aspalt

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Bark

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Basic

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### BeigeTerrazzoFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Brick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### BrickCeramicTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### BrokenConcrete

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### BrokenRoof

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### BrushMetal

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### CementWall

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Chainmail

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### CheckerTileFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Concrete

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### ConcretePlate

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Copper

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### CorrugatedSteel

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### CrackedMiddleCeramicTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### CrackedSmallCeramicTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### CrocEmbossedLeather

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### DamagedRoof

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### DistroyedBronze

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### EmeraldGridTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### FabricDenim

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### FabricWeave

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Foil

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GalvanizedMetal

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Glass

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GrainLeather

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Grass

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GreyWovenFabric

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GridBorder

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GridBox

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GridMarble

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GridPentagon

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GridQuad

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### GridTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Ground

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### HalfLeafyGround

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### HouseBricks

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### IndustrialRibbedSteel

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### LeafyGround

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Marble

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### MatteRubber

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Metal

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### MetalPlate

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### MixRoad

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### MosaicCarpet

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### MossyGround

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### MossyRock

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### OceanPanelTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### OfficeCeilingLight

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### OfficeCeilingWhite

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PaintedMetal

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PaintedWood

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PaintedWornWood

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Paving

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PavingBlock

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PavingBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PavingFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PavingStones

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PavingWall

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### PeelingPaintSteel

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Plank

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Plastic

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Road

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Rock

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Roof

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Rust

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### RustBrass

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### RustMetal

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### RustySteel

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Sand

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### SandstoneBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### SilverMetal

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### SmallBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Snow

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### SoilRockGround

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### SquareCeramicTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### StoneBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### StoneFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### TakenOffCeramicTile

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Tatami

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### TerrazzoFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### ThickCarpet

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Unlit

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### UrbanSlateFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### WeatheredPlasterBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### WhiteCementBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### WhiteGrayBrick

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### Wood

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### WoodLogSidingWall

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### WoodSidingWall

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

### WoodTileFloor

`string`

해당 재질을 대체할 MaterialVariant를 지정합니다.

#### Code Samples

## Methods

### GetBaseMaterialOverride

현재 지원되지 않습니다.

#### Parameters

| `Enum.Material` InMaterial | 오버라이드 정보를 조회할 대상 재질입니다. |
| -------------------------- | ----------------------- |

#### Return

| `string` | 해당 재질을 대체하도록 지정된 MaterialVariant의 이름입니다. |
| -------- | ---------------------------------------- |

#### Code Samples

### GetMaterialVariant

지정한 재질에서 입력된 이름과 일치하는 MaterialVariant를 찾아 반환합니다.

#### Parameters

| `Enum.Material` InMaterial | 탐색할 재질입니다.                            |
| -------------------------- | ------------------------------------- |
| `string` InName            | 해당 재질 내에서 탐색할 MaterialVariant의 이름입니다. |

#### Return

| `MaterialVariant` | 반환된 MaterialVariant입니다. |
| ----------------- | ----------------------- |

#### Code Samples

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

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

### SetBaseMaterialOverride

현재 지원되지 않습니다.

#### Parameters

| `Enum.Material` InMaterial | 오버라이드를 설정할 대상 재질입니다.               |
| -------------------------- | ---------------------------------- |
| `string` InName            | 해당 재질을 대체할 MaterialVariant의 이름입니다. |

#### Return

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

#### Code Samples

## Events

## See also

{% content-ref url="/pages/jCNdUlp5Hl1wzQFnSMEz" %}
[Material Manager](/korean/manual/studio-manual/game-development/material-manager.md)
{% endcontent-ref %}


---

# 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/korean/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.