> 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/humanoiddescription.md).

# HumanoidDescription

HumanoidDescription : `Instance`

## Overview

Humanoid(캐릭터)의 외형 요소들을 정의하는 인스턴스로, 신체 형태, 색상, 크기 비율, 애니메이션 등 캐릭터 표현에 관련된 여러 속성을 함께 제어할 수 있습니다.

## Properties

### AccessoryBlob

`string`

현재 지원되지 않습니다.

#### Code Samples

### BackAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### BodyTypeScale

`number`

현재 지원되지 않습니다.

#### Code Samples

### ClimbAnimation

`string`

Humanoid가 Climb 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.ClimbAnimation = "ovdrassetid://20479500"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### DepthScale

`number`

Humanoid의 앞뒤 두께를 조정하는 스케일 비율입니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.DepthScale = 0.5

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### DieAnimation

`string`

Humanoid가 Die 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.DieAnimation = "ovdrassetid://18419100"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### Face

`string`

현재 지원되지 않습니다.

#### Code Samples

### FaceAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### FallAnimation

`string`

Humanoid가 Fall 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.FallAnimation = "ovdrassetid://18563700"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### FrontAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### GraphicTShirt

`string`

현재 지원되지 않습니다.

#### Code Samples

### HairAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### HatAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### Head

`string`

Humanoid의 Head에 적용할 에셋 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.Head = 8213300

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### HeadColor

`Color3`

Humanoid의 Head에 적용할 색상을 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.HeadColor = Color3.fromRGB(255, 0, 0)

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### HeadScale

`number`

현재 지원되지 않습니다.

#### Code Samples

### HeadTextureId

`string`

Humanoid의 Head에 적용할 텍스쳐 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.HeadTextureId = 8211400

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### HeightScale

`number`

Humanoid의 높이를 조정하는 스케일 비율입니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.HeightScale = 0.5

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### IdleAnimation

`string`

Humanoid가 Idle 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.IdleAnimation = "ovdrassetid://18558100"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### IdleVariations

`Array`

Idle 상태에서 랜덤으로 재생할 변형 애니메이션 목록입니다.

#### Code Samples

### JumpAnimation

`string`

Humanoid가 Jump 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.JumpAnimation = "ovdrassetid://18563500"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LandedAnimation

`string`

Humanoid가 Landed 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LandedAnimation = "ovdrassetid://18565100"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LeftArm

`string`

Humanoid의 LeftArm에 적용할 에셋 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LeftArm = 8213200

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LeftArmColor

`Color3`

Humanoid의 LeftArm에 적용할 색상을 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LeftArmColor = Color3.fromRGB(255, 0, 0)

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LeftArmTextureId

`string`

Humanoid의 LeftArm에 적용할 텍스쳐 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LeftArmTextureId = 8212400

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LeftLeg

`string`

Humanoid의 LeftLeg에 적용할 에셋 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LeftLeg = 8213400

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LeftLegColor

`Color3`

Humanoid의 LeftLeg에 적용할 색상을 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LeftLegColor = Color3.fromRGB(255, 0, 0)

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### LeftLegTextureId

`string`

Humanoid의 LeftLeg에 적용할 텍스쳐 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.LeftLegTextureId = 8211500

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### MoodAnimation

`string`

현재 지원되지 않습니다.

#### Code Samples

### NeckAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### Pants

`string`

현재 지원되지 않습니다.

#### Code Samples

### ProportionScale

`number`

현재 지원되지 않습니다.

#### Code Samples

### RightArm

`string`

Humanoid의 RightArm에 적용할 에셋 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RightArm = 8213100

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### RightArmColor

`Color3`

Humanoid의 RightArm에 적용할 색상을 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RightArmColor = Color3.fromRGB(255, 0, 0)

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### RightArmTextureId

`string`

Humanoid의 RightArm에 적용할 텍스쳐 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RightArmTextureId = 8212500

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### RightLeg

`string`

Humanoid의 RightLeg에 적용할 에셋 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RightLeg = 8214100

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### RightLegColor

`Color3`

Humanoid의 RightLeg에 적용할 색상을 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RightLegColor = Color3.fromRGB(255, 0, 0)

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### RightLegTextureId

`string`

Humanoid의 RightLeg에 적용할 텍스쳐 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RightLegTextureId = 8212500

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### RunAnimation

`string`

Humanoid가 Run 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.RunAnimation = "ovdrassetid://18559300"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### Shirt

`string`

현재 지원되지 않습니다.

#### Code Samples

### ShoulderAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### SprintAnimation

`string`

Humanoid가 Sprint 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.SprintAnimation = "ovdrassetid://18839100"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### SwimmingBreaststrokeAnimation

`string`

현재 지원되지 않습니다.

#### Code Samples

### SwimmingIdleAnimation

`string`

현재 지원되지 않습니다.

#### Code Samples

### Torso

`string`

Humanoid의 Torso에 적용할 에셋 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.Torso = 8214200

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### TorsoColor

`Color3`

Humanoid의 Torso에 적용할 색상을 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.TorsoColor = Color3.fromRGB(255, 0, 0)

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### TorsoTextureId

`string`

Humanoid의 Torso에 적용할 텍스쳐 ID를 정의합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.TorsoTextureId = 8212600

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### WaistAccessory

`string`

현재 지원되지 않습니다.

#### Code Samples

### WalkAnimation

`string`

Humanoid가 Walk 상태로 전환될 때 재생할 애니메이션을 설정합니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.WalkAnimation = "ovdrassetid://18560100"

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

### WidthScale

`number`

Humanoid의 좌우 폭을 조정하는 스케일 비율입니다.

#### Code Samples

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

local HumanoidDescription = Workspace:WaitForChild("HumanoidDescription")
HumanoidDescription.WidthScale = 0.5

Humanoid:ApplyDescription(HumanoidDescription, Enum.AssetTypeVerification.Default)
```

## Methods

### AddEmote

현재 지원되지 않습니다.

#### Parameters

| `string` InName    | 추가할 이모트를 식별하는 이름입니다.            |
| ------------------ | ------------------------------- |
| `string` InAssetId | 해당 이름에 매핑할 이모트 애니메이션의 에셋 ID입니다. |

#### Return

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

#### Code Samples

### GetAccessories

현재 지원되지 않습니다.

#### Parameters

| `boolean` InIncludeRigidAccessories | true로 지정하면 결과에 Rigid 액세서리까지 포함합니다. 기본값은 false입니다. |
| ----------------------------------- | ------------------------------------------------- |

#### Return

| `Tuple` | 현재 Humanoid에 적용되어 있는 액세서리 정보를 담은 테이블입니다. |
| ------- | ---------------------------------------- |

#### Code Samples

### GetEmotes

현재 지원되지 않습니다.

#### Parameters

#### Return

| `Value` | 이 HumanoidDescription에 추가되거나 설정된 이모트 목록을 이름과 에셋 ID 쌍으로 담은 딕셔너리입니다. |
| ------- | ------------------------------------------------------------------ |

#### Code Samples

### GetEquippedEmotes

현재 지원되지 않습니다.

#### Parameters

#### Return

| `Tuple` | 이 HumanoidDescription에 현재 장착된 이모트들의 정보를 담은 테이블 배열입니다. |
| ------- | ----------------------------------------------------- |

#### Code Samples

### RemoveEmote

현재 지원되지 않습니다.

#### Parameters

| `string` InName | 제거할 이모트의 이름입니다. 해당 이름으로 추가된 이모트가 모두 제거됩니다. |
| --------------- | ------------------------------------------ |

#### Return

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

#### Code Samples

### SetAccessories

현재 지원되지 않습니다.

#### Parameters

| `Array` InAccessories               | Humanoid에 적용할 액세서리 정보를 담은 배열입니다.                           |
| ----------------------------------- | ---------------------------------------------------------- |
| `boolean` InIncludeRigidAccessories | true로 지정하면 입력 배열에 포함된 Rigid 액세서리도 함께 적용합니다. 기본값은 false입니다. |

#### Return

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

#### Code Samples

### SetEmotes

현재 지원되지 않습니다.

#### Parameters

| `Value` InEmotes | 이 HumanoidDescription에 설정할 이모트들의 이름과 에셋 ID 쌍을 담은 딕셔너리입니다. |
| ---------------- | --------------------------------------------------------- |

#### Return

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

#### Code Samples

### SetEquippedEmotes

현재 지원되지 않습니다.

#### Parameters

| `Array` InEquippedEmotes | 장착할 이모트 이름들의 배열입니다. 배열 순서대로 장착됩니다. |
| ------------------------ | ---------------------------------- |

#### Return

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

#### Code Samples

## Events

## See also

{% content-ref url="/pages/9CavGOa2tE245i4VgYhQ" %}
[Humanoid Description](/korean/manual/studio-manual/character/humanoid-description.md)
{% endcontent-ref %}