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

# StarterPlayer

StarterPlayer : `Instance`

## Overview

플레이어 객체의 초기 속성을 설정할 수 있는 서비스입니다.

플레이어가 게임에 접속할 때마다 해당 플레이어의 Player 인스턴스를 생성하며, Player 인스턴스의 속성들은 StarterPlayer에 설정된 값을 기준으로 자동 설정됩니다.

이 서비스는 다음과 같은 컨테이너를 포함하며, 각각 특정한 목적을 가지고 동작합니다:

* StarterPlayerScripts: 플레이어가 입장할 때 실행할 클라이언트용 스크립트를 보관합니다.
* StarterCharacterScripts: 플레이어의캐릭터가 생성될 때마다 실행할 클라이언트용 스크립트를 보관합니다.

## Properties

### AirControl

`number`

플레이어 캐릭터가 공중에서 이동 입력에 반응하는 정도를 정의합니다.

값이 0에 가까울수록 점프나 낙하 중 방향 전환이 어렵고, 1에 가까울수록 공중에서도 지상과 유사한 제어감을 느낄 수 있습니다.

#### Code Samples

### CameraMaxZoomDistance

`number`

기본 카메라가 플레이어 캐릭터로부터 멀어질 수 있는 최대 거리를 설정합니다.

3인칭 시점에서 사용자가 얼마나 멀리까지 카메라를 줌 아웃할 수 있는지를 제한할 수 있습니다.

#### Code Samples

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

print(StarterPlayer.CameraMaxZoomDistance)
```

### CameraMinZoomDistance

`number`

기본 카메라가 플레이어 캐릭터에 가까워질 수 있는 최소 거리를 설정합니다.

1인칭 시점 또는 근접 시점에서 카메라가 캐릭터에 접근할 수 있는 최소 거리를 제한할 수 있습니다.

#### Code Samples

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

print(StarterPlayer.CameraMinZoomDistance)
```

### CapsuleHeight

`number`

플레이어 캐릭터의 충돌 판정을 담당하는 캡슐의 세로 높이를 지정합니다.

캐릭터의 실제 메시 크기와는 무관하게 충돌 영역만 변경되며, 값이 커질수록 충돌체가 더 커집니다.

#### Code Samples

### CapsuleRadius

`number`

플레이어 캐릭터의 충돌 캡슐 반지름을 지정합니다.

값을 줄이면 좁은 통로나 작은 공간을 통과할 수 있고, 크게 하면 충돌 범위가 넓어집니다.

#### Code Samples

### CharacterMeshPos

`Vector3`

플레이어 캐릭터의 메시를 기준 위치에서 얼마나 이동시킬지를 지정합니다.

주로 메시와 충돌 캡슐 사이의 정렬을 맞추거나 커스텀 리그 정렬에 사용됩니다.

#### Code Samples

### FallingDeceleration

`number`

플레이어 캐릭터가 공중에서 낙하할 때 속도가 줄어드는 정도를 제어합니다.

값이 0이면 낙하 중 감속이 적용되지 않으며, 값이 클수록 부드럽게 착지하는 느낌을 줄 수 있습니다.

#### Code Samples

### FallingLateralFriction

`number`

공중에서 좌우로 이동할 때 적용되는 마찰 계수를 정의합니다.

값이 작으면 미끄러지듯 부드럽게 움직이고, 크면 공중 제어가 즉각적으로 반응합니다.

#### Code Samples

### GravityScale

`number`

플레이어 캐릭터에 적용되는 중력의 배율을 지정합니다.

값이 커질수록 더 빠르게 떨어지고 점프 높이가 낮아집니다.

#### Code Samples

### GroundFriction

`number`

지상에서 이동할 때 적용되는 마찰 계수를 나타냅니다.

값이 낮으면 미끄러지는 느낌이 강하고, 높으면 방향 전환이 즉각적으로 이루어집니다.

#### Code Samples

### IgnoreBaseRotation

`boolean`

플레이어가 서 있는 바닥이 회전할 때 그 회전을 입력과 카메라에 반영할지 여부를 제어합니다.

기본값은 true이며, false로 설정하면 바닥 회전이 캐릭터 및 카메라 모두에 적용됩니다.

#### Code Samples

### JumpHeight

`number`

플레이어 캐릭터가 점프했을 때 도달 가능한 최대 높이를 설정합니다.

값이 0이면 점프할 수 없으며, 기본값은 135입니다.

#### Code Samples

### JumpPower

`number`

점프 시 위로 가해지는 힘의 크기를 지정합니다.

실제 점프 높이는 Workspace.Gravity 값의 영향을 받습니다.

#### Code Samples

### LoadCharacterAppearance

`boolean`

사용자가 OVERDARE App에서 설정한 외형을 플레이어의 캐릭터에 적용할지 여부를 설정합니다.

만약 커스텀 외형 설정을 위해 HumanoidDescription를 사용한다면, 외형을 불러올 필요가 없기 때문에 이 속성을 false로 설정하는 것을 권장합니다.

#### Code Samples

### MaxAcceleration

`number`

플레이어 캐릭터가 가속할 수 있는 최대 속도를 정의합니다.

값이 클수록 반응이 빠르고, 낮을수록 묵직한 움직임을 구현할 수 있습니다.

#### Code Samples

### MaxJumpCount

`number`

플레이어 캐릭터가 연속 점프할 수 있는 최대 횟수를 지정합니다.

기본값은 1이며, 2 이상이면 이중 점프가 가능합니다.

#### Code Samples

### MaxSlopeAngle

`number`

캐릭터가 오를 수 있는 최대 경사면의 각도를 설정하는 속성입니다.

이 속성은 동적으로는 변경할 수 없으며, 스튜디오에서 Game Settings 창에서 World 탭으로 이동한 후, Max Slope Angle 항목을 통해 설정할 수 있습니다.

#### Code Samples

### RotationSpeed

`number`

초당 회전할 수 있는 속도를 도(º) 단위로 지정합니다.

값이 낮을수록 느리게 회전하고, 높을수록 즉각적으로 시선을 돌립니다.

#### Code Samples

### StompJumpMultiplier

`number`

플레이어 캐릭터가 다른 캐릭터를 밟았을 때 적용되는 점프 배율을 지정합니다.

기본값은 0이며, 1 이상으로 설정하면 밟는 순간 추가 점프가 발생합니다.

#### Code Samples

### UseJumpPower

`boolean`

점프 높이를 계산할 때 JumpPower 값을 사용할지 여부를 지정합니다.

기본값은 false이며, true로 설정하면 JumpPower와 Gravity 값으로 점프 높이를 계산합니다.

#### Code Samples

### WalkingDeceleration

`number`

플레이어 캐릭터가 이동을 멈출 때 감속되는 정도를 정의합니다.

값이 크면 즉시 멈추고, 작으면 관성처럼 미끄러집니다.

#### Code Samples

### WalkSpeed

`number`

플레이어 캐릭터가 초당 이동할 수 있는 속도를 정의합니다.

기본값은 500이며, 0으로 설정하면 이동이 불가능합니다.

#### Code Samples

## Methods

## Events

## See also

{% content-ref url="/pages/55cnJQIQ6G6kKQlyMLOq" %}
[캐릭터 이동 파라미터](/korean/manual/studio-manual/character/character-movement-parameters.md)
{% endcontent-ref %}