CharacterServer

CharacterServer

서버에서 사용되는 공용 캐릭터 객체에요.

속성

Visible

캐릭터의 가시성

-- 샘플 --

character.Visible = false

Transform

캐릭터의 Matring 에요

-- 샘플 --

local targetTransform = character.Transform

targetTransform.Location = Vector.new(0, 100, 0)
targetTransform.Rotation = Vector.new(0, 100, 0)
character.Transform = targetTransform --오브젝트를 보간으로 이동시켜요. (캐릭터는 보간없이 움직여요.)

Location

캐릭터 위치값이에요.

-- 샘플 --

local characterPos = character.Location --캐릭터의 위치값을 Vector로 반환해요.
character.Location = Vector.new(0, 300, 200)

Rotation

캐릭터 회전값이에요.

-- 샘플 --

local characterRot = character.Rotation --캐릭터의 회전값을 Vector로 반환해요.
character.Rotation = Vector.new(0, 0, 0)

함수

void SetEmissive(number Emissive)

캐릭터 Material의 Emissive 값을 변경 할 수 있어요. (자체 발광하는 수치 값)

-- 샘플 --

character:SetEmissive(1) --값이 클수록 캐릭터가 밝아져요.

void AddForce(Vector Force)

캐릭터에 물리적인 힘을 가할 수 있어요. (힘을 가할 Vector 값)

-- 샘플 --

local force = Vector.new(0, 0, 100000)
character:AddForce(force) --force값만큼 캐릭터를 밀어요.
func void SetMaxSpeed(number Speed)
** 캐릭터의 최대 이동속도를 설정할 수 있어요. (설정할 최대 이동속도 값)
샘플
```lua
</br>

| **number GetMaxSpeed()** |
| :--- |

캐릭터의 최대 이동속도를 얻을 수 있어요.

-- 샘플 --
```lua
print(character:GetMaxSpeed())

void SetMaxJump(number Jump)

캐릭터의 최대 점프속도를 설정할 수 있어요. (설정할 최대 점프속도 값)

-- 샘플 --

character:SetMaxJump(1000) --캐릭터의 최대 점프 속도를 설정해요.

number GetMaxJump()

캐릭터의 최대 점프속도를 얻을 수 있어요.

-- 샘플 --

print(character:GetMaxJump())

void SetFlyControl(number ControlRate)

공중에서 캐릭터 컨트롤 비율을 설정할 수 있어요. (설정할 비율 값)

-- 샘플 --

character:SetFlyControl(0) --0~1 사이의 값을 적용할 수 있어요

number GetFlyControl()

공중에서 캐릭터 컨트롤 비율을 얻을 수 있어요.

-- 샘플 --

print(character:GetFlyControl())

void SetFlyMaxSpeed(number Speed)

캐릭터의 최대 공중 이동속도를 설정할 수 있어요. 기어오르기, 날기 등의 상태에서만 반영돼요. (설정할 최대 공중 이동속도 값)

-- 샘플 --

character:SetFlyMaxSpeed(1000)

number GetFlyMaxSpeed()

캐릭터의 최대 공중 이동속도를 얻을 수 있어요.

-- 샘플 --

print(character:GetFlyMaxSpeed())

void JumpEnable(bool CanJump)

캐릭터의 점프 가능 여부를 설정할 수 있어요. (점프 가능 여부)

-- 샘플 --

character:JumpEnable(false)

void MoveRightEnable(bool CanMove)

캐릭터의 좌우 이동 가능 여부를 설정할 수 있어요. (좌우 이동 가능 여부)

-- 샘플 --

character:MoveRightEnable(false)

void MoveToSpawnPoint(SpawnPoint SpawnPointObjecrt, bool ResetRot)

캐릭터를 특정 스폰 위치로 이동시킬 수 있어요. (이동 할 스폰포인트 오브젝트, 방향 Rot 초기화 여부)

-- 샘플 --

local SpawnPoint = Game:AddSpawnPoint(Workspace.Cube)
character:MoveToSpawnPoint(SpawnPoint, true)

void ChangeCharacterType(CharacterType Type)

현재 캐릭터의 외형 타입을 바꿀 수 있어요.

-- 샘플 --

wait(2)
character:ChangeCharacterType(Enum.CharacterType.ToyCharacter)

wait(2)
character:ChangeCharacterType(Enum.CharacterType.PlayerAvatar)

void SetCapsuleSize(number Radius, number Height)

현재 캐릭터의 캡슐 콜리전의 크기를 바꿀 수 있어요.

-- 샘플 --

local radius = 140
local height = 100

character:SetCapsuleSize(radius, height)

CharacterType GetCharacterType()

현재 캐릭터의 외형 타입을 가져 올 수 있어요.

-- 샘플 --

print(character:GetCharacterType())

void AttachObject(Object TargetObject, AttachPoint Point)

캐릭터에 타겟 오브젝트를 붙일 수 있어요. (타겟 오브젝트, 붙일 AttachPoint)

-- 샘플 --

Character:AttachObject(Balloon, Enum.AttachPoint.Top)

void AttachObject(Object TargetObject, CharacterBone Bone)

캐릭터에 타겟 오브젝트를 붙일 수 있어요. (타겟 오브젝트, 붙일 Bone)

-- 샘플 --

Character:AttachObject(Balloon, Enum.Bone.LHand)

void DetachObject(Object TargetObject)

캐릭터에 붙어있는 오브젝트를 떨어뜨릴 수 있어요. (타겟 오브젝트)

-- 샘플 --

Character:DetachObject(Balloon)

void DetachAllObject()

캐릭터에 붙어있는 모든 오브젝트를 떨어뜨려요.

-- 샘플 --

Character:DetachAllObject()

사용 가능한 부모 오브젝트 기능들

속성

이름	설명

이벤트

이름	설명

함수

이름	설명
IsDie	현재 캐릭터가 죽어있는 상태인지 알 수 있어요.
IsFly	캐릭터가 공중에 떠 있는지 아닌지 얻을 수 있어요.
IsCanJump	캐릭터가 현재 점프 가능한 상태인지 알 수 있어요.
GetMoveSpeed	해당 캐릭터의 현재 이동 속도를 얻을 수 있어요.