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


---

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