RemotePlayer

RemotePlayer

클라이언트 스크립트에서 사용되는 플레이어 객체에요. Game:GetRemotePlayer(PlayerID) 혹은 LocalPlayer:GetRemotePlayer() 함수를 이용하면 얻을 수 있어요.

함수

Character GetCharacter()

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

-- 샘플 --

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

number GetPlayerID()

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

-- 샘플 --

local remotePlayer = LocalPlayer:GetRemotePlayer()
print(remotePlayer:GetPlayerID()) --플레이어의 플레이어 아이디를 반환해요.

string GetPlayerNickName()

플레이어의 이름을 얻을 수 있어요.

-- 샘플 --

local remotePlayer = LocalPlayer:GetRemotePlayer()
print(remotePlayer:GetPlayerNickName()) --플레이어 닉네임을 문자로 반환해요.

FX CreateFX(ObjectFX FXObject, Bone BoneType)

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

-- 샘플 --

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

ObjectSound CreateSound(ObjectSound SourceSoundObject)

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

-- 샘플 --

player:CreateSound(Workspace.Sound)

HitResult LineTrace(Vector Start, Vector Dir, number Distance)

(deprecated) 설정된 시작 지점에서 원하는 방향으로 지정된 거리 만큼 충돌이 있는지 체크할 수 있어요. (시작 지점 Vector, 방향 Vector, 거리 값) 사용하는 RemotePlayer는 체크에서 제외됩니다.

HitResult LineTrace(Vector Start, Vector Dir, number Distance, string UserCollisionTypeName)

(deprecated) 설정된 시작 지점에서 원하는 방향으로 지정된 거리 만큼 유저가 추가한 충돌 타입과의 충돌이 있는지 체크할 수 있어요. (시작 지점 Vector, 방향 Vector, 거리 값, 원하는 유저 충돌 타입 이름) 사용하는 RemotePlayer는 체크에서 제외됩니다.

HitResult LineTraceList(Vector Start, Vector Dir, number Distance)

설정된 시작 지점에서 원하는 방향으로 지정된 거리 만큼 충돌이 있는지 체크할 수 있어요. (시작 지점 Vector, 방향 Vector, 거리 값) 사용하는 RemotePlayer는 체크에서 제외됩니다.

HitResult LineTraceList(Vector Start, Vector Dir, number Distance, string UserCollisionTypeName)

설정된 시작 지점에서 원하는 방향으로 지정된 거리 만큼 유저가 추가한 충돌 타입과의 충돌이 있는지 체크할 수 있어요. (시작 지점 Vector, 방향 Vector, 거리 값, 원하는 유저 충돌 타입 이름) 사용하는 RemotePlayer는 체크에서 제외됩니다.

-- 샘플 --

local startPos = Workspace.Cube.Transform.Location
local dir = Vector.new(1, 0, 0)
local distance = 1000

local target = player:LineTrace(startPos, dir, distance) --시작 위치에서 지정 방향의 거리에 충돌체가 있으면 충돌 정보를 반환해요.

print(target.HitObject.Name) --충돌한 오브젝트에요.
print(target.HitLocation) --충돌한 오브젝트의 위치에요.

bool IsMyPlayer()

플레이어 자신의 플레이어인지 확인할 수 있어요.

-- 샘플 --

print(player:IsMyPlayer()) --해당 플레이어가 자신이면 true를 반환해요.

Item GetEquipItem(string EquipSlot)

해당 플레이어 캐릭터가 착용중인 아이템을 얻을 수 있어요. (장착 중인 아이템 슬롯)

-- 샘플 --

local item = LocalPlayer:GetRemotePlayer():GetEquipItem("Kickboard")

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

속성

이름	설명
Parent	부모 객체를 얻을 수 있어요.
Name	객체의 이름입니다.

이벤트

이름

설명

함수

이름	설명
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.타입 , 동기화 시간)
AddTimeEvent	일정 시간뒤에 연결 함수가 호출되는 이벤트를 추가해요. (추가할 이벤트 이름, 시간, 연결 함수)
DeleteTimeEvent	등록된 시간 이벤트를 삭제해요. (삭제할 이벤트 이름)