StarterPlayer

StarterPlayer : Instance

Overview

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

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

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

• StarterPlayerScripts: 플레이어가 입장할 때 실행할 클라이언트용 스크립트를 보관합니다.

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

Properties

AirControl

number

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

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

Code Samples

AllowCustomAnimations

number

현재 지원되지 않습니다.

Code Samples

CameraMaxZoomDistance

number

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

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

Code Samples

local StarterPlayer = game:GetService("StarterPlayer")

print(StarterPlayer.CameraMaxZoomDistance)

CameraMinZoomDistance

number

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

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

Code Samples

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

bool

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

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

Code Samples

JumpHeight

number

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

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

Code Samples

JumpPower

number

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

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

Code Samples

LoadCharacterAppearance

bool

사용자가 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

bool

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

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

Code Samples

WalkSpeed

number

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

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

Code Samples

WalkingDeceleration

number

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

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

Code Samples

Methods

Events