NPC

NPC

서버에서 사용되는 NPC 객체에요.

함수

void MoveToLocation(Vector Target)

캐릭터가 목표 지점까지 길찾기를 이용해 이동합니다. (NavMeshVolume를 배치해야 동작해요.)

-- 샘플 --

local npc = Script.Parent
local goalPos = Workspace.Cube.Transform.Location

wait(3)
npc:MoveToLocation(goalPos) --해당 지점까지 길찾기로 이동해요.

void StopMovement()

캐릭터의 길찾기 이동을 중지합니다.

-- 샘플 --

local npc = Script.Parent
local goalPos = Workspace.Cube.Transform.Location

wait(3)
npc:MoveToLocation(goalPos) --해당 지점까지 길찾기로 이동해요.

wait(5)
npc:StopMovement() --진행중인 길찾기를 중지해요.

PathFollowingStatus GetPathFollowingStatus()

캐릭터의 길찾기 이동 상태입니다.

-- 샘플 --

local npc = Script.Parent
local goalPos = Workspace.Cube.Transform.Location

wait(3)
npc:MoveToLocation(goalPos) --해당 지점까지 길찾기로 이동해요.
print(npc:GetPathFollowingStatus()) --대상의 길찾기 상태를 숫자로 반환해요.

void MoveForward(number Value)

설정된 이동 타입에 따라 앞으로 이동시켜요. (1 : 전진, -1 : 후진 이동)

-- 샘플 --

local npc = Script.Parent

local function update(updateTime)
    npc:MoveForward(-1) --1이면 전진, -1이면 후진해요
end
npc.OnUpdateEvent:Connect(update)

void MoveRight(number Value)

좌, 우로 이동시켜요. (-1 : 좌측, 1 : 우측 이동)

-- 샘플 --

local npc = Script.Parent

local function update(updateTime)
    npc:MoveRight(-1) --1이면 우측, -1이면 좌측으로 이동해요
end
npc.OnUpdateEvent:Connect(update)

void Jump()

점프동작을 실행해요.

-- 샘플 --

local npc = Script.Parent

wait(5)
npc:Jump() -- 점프동작을 실행해요.

string GetNPCName()

NPC의 이름을 얻을 수 있어요.

-- 샘플 --

local NPC = Script.Parent
print(NPC:GetNPCName())

void SetNPCName(string Name)

-- 샘플 --

local NPC = Script.Parent
NPC:SetNPCName("기사")

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

속성

이름	설명
Visible	캐릭터의 가시성
Transform	캐릭터의 Matring 에요
Location	캐릭터 위치값이에요.
Rotation	캐릭터 회전값이에요.
Enable	객체 활성화 여부
Transform	객체의 Matrix
LocalTransform	객체의 Local Transform
Location	객체의 위치 Vector
LocalLocation	객체의 로컬좌표 Vector
Rotation	객체의 회전 Vector
LocalRotation	객체의 로컬 회전 Vector
Scale	객체의 크기 Vector
Visible	객체의 가시성

이벤트

이름	설명
OnUpdateEvent	생성 후 매 프레임마다 호출되는 이벤트에요. 연결함수 형식은 function(updateTime), updateTime 은 number 입니다.
OnDestroyEvent	삭제될 때 호출되는 이벤트에요. 연결함수 형식은 function() 입니다.
OnEnableEvent	Enable 될때 호출되는 이벤트에요. 연결함수 형식은 function() 입니다.
OnDisableEvent	Disable 될때 호출되는 이벤트에요. 연결함수 형식은 function() 입니다.

함수

이름	설명
SetEmissive	캐릭터 Material의 Emissive 값을 변경 할 수 있어요. (자체 발광하는 수치 값)
AddForce	캐릭터에 물리적인 힘을 가할 수 있어요. (힘을 가할 Vector 값)
GetMaxSpeed	캐릭터의 최대 이동속도를 얻을 수 있어요.
SetMaxJump	캐릭터의 최대 점프속도를 설정할 수 있어요. (설정할 최대 점프속도 값)
GetMaxJump	캐릭터의 최대 점프속도를 얻을 수 있어요.
SetFlyControl	공중에서 캐릭터 컨트롤 비율을 설정할 수 있어요. (설정할 비율 값)
GetFlyControl	공중에서 캐릭터 컨트롤 비율을 얻을 수 있어요.
SetFlyMaxSpeed	캐릭터의 최대 공중 이동속도를 설정할 수 있어요. 기어오르기, 날기 등의 상태에서만 반영돼요. (설정할 최대 공중 이동속도 값)
GetFlyMaxSpeed	캐릭터의 최대 공중 이동속도를 얻을 수 있어요.
JumpEnable	캐릭터의 점프 가능 여부를 설정할 수 있어요. (점프 가능 여부)
MoveRightEnable	캐릭터의 좌우 이동 가능 여부를 설정할 수 있어요. (좌우 이동 가능 여부)
MoveToSpawnPoint	캐릭터를 특정 스폰 위치로 이동시킬 수 있어요. (이동 할 스폰포인트 오브젝트, 방향 Rot 초기화 여부)
ChangeCharacterType	현재 캐릭터의 외형 타입을 바꿀 수 있어요.
SetCapsuleSize	현재 캐릭터의 캡슐 콜리전의 크기를 바꿀 수 있어요.
GetCharacterType	현재 캐릭터의 외형 타입을 가져 올 수 있어요.
AttachObject	캐릭터에 타겟 오브젝트를 붙일 수 있어요. (타겟 오브젝트, 붙일 AttachPoint)
AttachObject	캐릭터에 타겟 오브젝트를 붙일 수 있어요. (타겟 오브젝트, 붙일 Bone)
DetachObject	캐릭터에 붙어있는 오브젝트를 떨어뜨릴 수 있어요. (타겟 오브젝트)
DetachAllObject	캐릭터에 붙어있는 모든 오브젝트를 떨어뜨려요.
GetKey	객체의 키 값을 얻을 수 있어요.
SetTransformWithCollisionCheck	현재 매트릭스에서 설정 된 매트릭스로 보간이 되는 매트릭스를 설정할 수 있어요 설정할 수 있어요. (Matrix 값, bool 충돌 처리 여부)
SetLocalTransformWithCollisionCheck	현재 매트릭스에서 설정 된 매트릭스로 보간이 되는 매트릭스를 로컬좌표기준으로 설정할 수 있어요 설정할 수 있어요. (Matrix 값, bool 충돌 처리 여부)
Teleport	순간이동 하는 매트릭스를 설정할 수 있어요. (Matrix 값)
SetLocationWithCollisionCheck	객체의 위치를 설정할 수 있어요. (설정할 위치 Vector 값, 충돌 처리 여부)
SetTag	객체의 tag를 설정해요. (설정할 tag)
GetTag	객체에 설정된 tag를 얻을 수 있어요.
ConnectEventFunction	유저가 추가한 오브젝트 커스텀 이벤트에 함수를 연결할 수 있어요. (이벤트 이름, 연결 함수)
LookAt	오브젝트가 해당하는 위치를 바라보게 할 수 있어요. (바라볼 위치 Vector)