Character

Character

클라이언트에서 사용되는 캐릭터에 대한 개체에요.

함수

Player GetPlayer()

해당 캐릭터의 플레이어를 얻을 수 있어요.

-- 샘플 --

local player = character:GetPlayer() --캐릭터의 플레이어를 반환해요.

number GetPlayerID()

플레이어의 아이디를 얻을 수 있어요.

-- 샘플 --

print(character:GetPlayerID()) --캐릭터의 플레이어 아이디를 숫자로 반환해요.

string GetPlayerNickName()

플레이어의 닉네임을 얻을 수 있어요.

-- 샘플 --

print(character:GetPlayerNickName()) --캐릭터의 플레이어 닉네임을 문자열로 반환해요.

FX CreateFX(ObjectFX FXObject, Bone BoneType)

캐릭터 특정 위치에 FX를 생성할 수 있어요. (생성 하고싶은 FX 오브젝트, Enum.BoneType.타입 )

-- 샘플 --

character:CreateFX(Workspace.Effect, Enum.Bone.Body) --캐릭터의 특정 부위에 이펙트를 생성해요.

ObjectSound CreateSound(ObjectSound SoundObject)

캐릭터의 위치에 Sound를 생성할 수 있어요. (생성 하고싶은 Sound 오브젝트)

-- 샘플 --

character:CreateSound(Workspace.Sound)

SurfaceUI AddPlayerHUD(string UIName, UIScreen UI, UIDisplayType Type)

UI HUD를 붙일 수 있어요. (붙혀 질 UI 이름, 붙일 UI Screen, Enum.UIDisplayType.타입 )

-- 샘플 --

local playerNameUI = HUD.PlayerNameUI
playerNameUI.Visible = false

local function spawn(character)
   local ui = character:AddPlayerHUD("Name", playerNameUI, Enum.UIDisplayType.Billboard) --캐릭터에 HUD를 추가하고 이름으로 등록해요.
   ui.Visible = true
end
Game.OnSpawnCharacter:Connect(spawn)

void RemovePlayerHUD(string UIName)

UI HUD를 제거해요. (제거하고 싶은 UI 이름)

-- 샘플 --

character:RemovePlayerHUD("Name") --캐릭터에 추가된 HUD를 이름으로 찾아서 삭제해요.

void RemovePlayerAllHUD()

현재 캐릭터의 모든 UI HUD를 제거해요.

-- 샘플 --

character:RemovePlayerAllHUD() --캐릭터에 추가된 모든 HUD를 삭제해요.

SurfaceUI GetPlayerHUD(string UIName)

UI HUD를 얻을 수 있어요. (얻고싶은 UI 이름)

-- 샘플 --

local playerNameUI = character:GetPlayerHUD("Name") --캐릭터에 추가된 HUD를 이름으로 찾아서 반환해요.
playerNameUI.Text:SetTextColor(Color.new(255, 0, 0, 255))

bool IsMyCharacter()

플레이어 자신의 캐릭터인지 아닌지 확인할 수 있어요.

-- 샘플 --

print(character:IsMyCharacter()) --캐릭터가 자신의 캐릭터이면 true를 반환해요.

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

속성

이름	설명
Visible	캐릭터의 가시성
Transform	캐릭터의 Matring 에요
Location	캐릭터 위치값이에요.
Rotation	캐릭터 회전값이에요.
Parent	부모 객체를 얻을 수 있어요.
Name	객체의 이름입니다.

이벤트

이름	설명

함수

이름	설명
AddAnimStateMachine	Game:AddAnimStateMachineSetting로 추가된 상태 머신 중 애니메이션 상태 머신을 추가해요. (추가할 상태 머신 이름)
GetAnimStateMachine	해당 애니메이션 상태 머신을 얻을 수 있어요. (얻고싶은 상태 머신 이름)
GetCurAnimState	현재 애니메이션의 상태를 얻을 수 있어요.
ChangeAnimState	해당하는 애니메이션의 상태로 변경할 수 있어요. (변경하고 싶은 애니메이션 상태 이름)
ChangeAnimState	해당하는 애니메이션의 상태로 변경할 수 있어요. (변경하고 싶은 애니메이션 상태 이름, 블렌딩 시간)
ChangeAnimStateMachine	해당 애니메이션 상태 머신을 변경할 수 있어요. (변경하고 싶은 상태 머신 이름)
PlayAnimWithExpression	해당하는 애니메이션의 상태와 표정으로 변경할 수 있어요(상태가 변경되면 표정도 재생을 중지해요).
SetCharacterFaceExpression	캐릭터의 표정을 재생해요.
StopCharacterFaceExpression	캐릭터의 표정 재생을 취소해요.
AttachObject	캐릭터에 타겟 오브젝트를 붙일 수 있어요. (타겟 오브젝트, 붙일 AttachPoint)
AttachObject	캐릭터에 타겟 오브젝트를 붙일 수 있어요. (타겟 오브젝트, 붙일 Bone)
DetachObject	캐릭터에 붙어있는 오브젝트를 떨어뜨릴 수 있어요. (타겟 오브젝트)
DetachAllObject	캐릭터에 붙어있는 모든 오브젝트를 떨어뜨려요.
ConnectChangeEventFunction	추가된 값이 변경 될 때 호출되는 이벤트에요. (Value 이름, 연결 함수)
GetChild	이름으로 자식 객체를 얻을 수 있어요. (찾고싶은 자식 객체 이름)
GetChildList	자식 객체의 리스트를 얻을 수 있어요.
IsCharacter	캐릭터인지 확인할 수 있어요.
IsStaticMesh	스테틱 메시인지 확인할 수 있어요.
IsFX	FX인지 확인할 수 있어요.
IsSound	Sound인지 확인할 수 있어요.
IsPointLight	포인트 라이트인지 확인할 수 있어요.
IsSpotLight	스포트 라이트인지 확인할 수 있어요.
IsSurfaceUI	서피스 UI인지 확인할 수 있어요.
IsScreenUI	스크린 UI인지 확인할 수 있어요.
IsTouchUI	터치 UI인지 확인할 수 있어요.
IsItem	아이템인지 확인할 수 있어요.
IsNPC	NPC인지 확인할 수 있어요.
IsScript	스트립트인지 확인할 수 있어요.
IsCollider	Collider인지 확인할 수 있어요.
IsWidget	Widget인지 확인할 수 있어요.
IsCamera	Camera인지 확인할 수 있어요.
IsValid	해당 오브젝트가 유효한지 확인 할 수있어요.
IsValidValue	해당 오브젝트의 값이 유효한지 확인할 수 있어요.
AddReplicateValue	해당 객체에 서버, 클라이언트 간 동기화가 가능한 벡터를 추가해요. (추가할 Value 이름, Vector 데이터, Enum.ReplicateType.타입 , 동기화 시간)
AddReplicateValue	해당 객체에 서버, 클라이언트 간 동기화가 가능한 실수를 추가해요. (추가할 Value 이름, number 데이터, Enum.ReplicateType.타입 , 동기화 시간)
AddReplicateValue	해당 객체에 서버, 클라이언트 간 동기화가 가능한 bool를 추가해요. (추가할 Value 이름, bool 데이터, Enum.ReplicateType.타입 , 동기화 시간)
AddReplicateValue	해당 객체에 서버, 클라이언트 간 동기화가 가능한 문자열을 추가해요. (추가할 Value 이름, string 데이터, Enum.ReplicateType.타입 , 동기화 시간)
AddReplicateValue	해당 객체에 서버, 클라이언트 간 동기화가 가능한 컬러를 추가해요. (추가할 Value 이름, Color 데이터, Enum.ReplicateType.타입 , 동기화 시간)