> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/classes/materialservice.md).

# 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 %}