튜토리얼 · 게임 시스템

Roblox Studio NPC Pathfinding: NPC가 플레이어를 따라오게 만들기

NPC가 벽을 돌아 가장 가까운 플레이어에게 가려면 세 가지가 필요합니다. 움직일 수 있는 리그, PathfindingService가 만든 경로, 그리고 물리 엔진과 싸우지 않으면서 그 경로를 따라가는 반복문입니다. 이 가이드에서는 세 가지를 모두 만들고, 마지막에는 NPC 리그에 그냥 넣으면 되는 서버 스크립트 하나를 완성합니다.

업데이트: 2026년 11월 20일읽는 데 11분작성:

요약

NPC 모델 안에 Script를 넣으세요. PathfindingService:CreatePath()로 경로를 만들고, pcall 안에서 path:ComputeAsync(start, goal)로 계산한 다음, Humanoid:MoveTo()로 웨이포인트를 하나씩 지나가되 다음으로 넘어가기 전에 MoveToFinished를 기다리세요. NPC가 플레이어를 쫓게 하려면 가장 가까운 캐릭터를 고르고, 매 프레임이 아니라 그 캐릭터가 몇 스터드 움직였을 때 경로를 다시 계산하세요.

  • Humanoid와 고정(Anchored)되지 않은 HumanoidRootPart가 필요합니다. root part에 SetNetworkOwner(nil)을 호출해 서버가 시뮬레이션하게 하세요. 플레이어 근처에서 덜덜 떠는 NPC를 고치는 일반적인 방법입니다.
  • 웨이포인트의 Action이 Jump이면 점프하고, NPC 앞쪽 웨이포인트에 대해 Path.Blocked가 발생하면 새 경로를 계산하세요.
  • 플레이어가 바로 보이면 pathfinding을 건너뛰고 그 플레이어에게 바로 MoveTo하세요. 몇 스터드 앞에서 멈추거나, NPC가 닿아서 데미지를 준다면 바짝 붙도록 하세요.
이 페이지의 내용
  1. pathfinding 작동 방식
  2. 1. NPC 설정
  3. 2. 지점으로 걷기
  4. 3. 추격 스크립트
  5. 추격 작동 방식
  6. 떨림 없애기
  7. 4. 닿으면 데미지
  8. 모디파이어와 링크
  9. Common errors
  10. With RoCode
  11. 자주 묻는 질문
  12. 출처와 더 읽을거리

NPC pathfinding의 작동 방식

일러스트Chaser가 벽을 돌아가는 경로를 찾고, 턱 위로 뛰어올라, 내게서 4스터드 앞에서 멈춥니다.

Roblox는 캐릭터가 걸을 수 있는 표면으로 내비게이션 메시(navigation mesh)를 만듭니다. PathfindingService는 이 메시에서 두 지점 사이의 경로를 찾아 웨이포인트 목록으로 돌려줍니다. 각 웨이포인트에는 위치와 걷기나 점프 같은 동작이 있습니다. 그다음 NPC의 Humanoid가 웨이포인트에서 다음 웨이포인트로 걸어갑니다. Pathfinding은 경로를 계획할 뿐이고, 그 경로를 따라 움직이는 것은 여러분의 스크립트가 해야 합니다.

이 가이드에서 쓰는 API
API하는 일
PathfindingService:CreatePath()에이전트 매개변수로 NPC 크기에 맞춘, 여러 번 재사용할 수 있는 Path 오브젝트를 만듭니다.
Path:ComputeAsync(start, finish)경로를 계산합니다. 실행을 양보(yield)하고 실패할 수 있으므로 pcall 안에서 호출하고 Path.Status를 확인하세요.
Path:GetWaypoints()경로를 PathWaypoint 값의 배열로 돌려줍니다. 각각 Position, Action, Label이 있습니다.
Path.Blocked계산한 경로를 무언가가 막으면 웨이포인트 인덱스와 함께 발생합니다.
Humanoid:MoveTo(position)NPC를 한 지점으로 걸어가게 합니다.
Humanoid.MoveToFinishedNPC가 목표 지점에 약 1스터드 안으로 다가가면 true와 함께, 8초 안에 도착하지 못하면 false와 함께 발생합니다.

이 모든 것은 서버 Script에서 실행하세요. 서버는 스트리밍을 켜도 맵 전체를 볼 수 있고, 모든 플레이어가 같은 NPC를 보며, 데미지는 클라이언트가 조작할 수 없는 곳에서 결정됩니다. 이 구분은 Script, LocalScript, ModuleScript에서 설명합니다.

1단계: 움직일 수 있는 NPC

아래 표의 세 가지를 갖춘 모델이라면 어떤 모델이든 경로를 따라 걸을 수 있습니다. Toolbox나 오래된 플레이스의 리그에는 가끔 무언가가 빠져 있는데, 보통은 NPC가 오류 없이 그냥 서 있는 모습으로 나타납니다.

NPC 모델에 필요한 것
요구 사항중요한 이유
이름이 Humanoid인 HumanoidMoveTo, WalkSpeed, 점프는 Humanoid에 속합니다.
HumanoidRootPartHumanoid가 움직이는 파트입니다. 경로는 이 파트의 위치에서 시작합니다.
고정된 것이 없음고정된 파트는 움직일 수 없고, 거기에 연결된 파트도 마찬가지입니다. 고정된 파트는 항상 서버가 소유하므로, 아래에서 다루는 떨림 해결법을 적용할 수 없습니다.
  1. Avatar 또는 Home 탭을 열고 Character를 눌러 Rig Generator를 여세요. R15를 고른 다음 Block Avatar를 고르세요. Workspace에 리그가 생깁니다. R6 리그도 같은 스크립트로 작동합니다.
  2. 리그 이름을 Chaser로 바꾸고 탁 트인 곳에 놓으세요.
  3. HumanoidRootPart를 선택하고 Properties 창에서 Anchored가 꺼져 있는지 확인하세요. 모델 안의 다른 고정된 파트도 똑같이 처리하세요. 빨리 찾으려면 3D 뷰포트 오른쪽 위 Visualization Options 위젯에서 Anchored parts를 켜세요.
Explorer: 이 가이드를 마쳤을 때의 NPC 모델
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (신체 부위)
    ChaseAI Script new
    TouchDamage Script new

NPC가 말도 하게 하려면, NPC 대화 가이드에서 선택지가 있는 Talk 프롬프트를 추가하고 NPC가 걸어 다닐 때 무엇이 달라지는지 설명합니다. 보스가 추격을 시작하기 전에 카메라로 보여 주려면 컷씬 가이드를 보세요.

2단계: NPC를 한 지점으로 보내기

가장 작은 작동 스크립트부터 시작하세요. 움직이지 않는 파트까지 걸어가는 스크립트입니다. 추격 로직 없이 pathfinding의 모든 단계를 보여 줍니다.

  1. Workspace에 Part를 넣고 이름을 Goal로 정한 다음, Anchored를 켜고 CanCollide를 끄고, NPC가 벽을 돌아가야 하는 위치의 바닥에 놓으세요.
  2. Explorer에서 Chaser에 마우스를 올리고 + 버튼을 눌러 Script를 넣으세요. 이름을 WalkToGoal로 정하고 아래 코드를 붙여 넣으세요.
  3. Play를 누르세요. NPC가 벽을 돌아 Goal 파트로 걸어갑니다.
Script 위치: Chaser 모델 이름: WalkToGoal
local PathfindingService = game:GetService("PathfindingService")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart
local goalPart = workspace:WaitForChild("Goal") :: BasePart

-- NPC의 물리를 서버가 소유해야 합니다. 그렇지 않으면 Script에서 ChangeState(점프)가 작동하지 않습니다
local canSetOwner, ownerProblem = rootPart:CanSetNetworkOwnership()
if not canSetOwner then
	warn(`{npc.Name} cannot move: {ownerProblem}. Untick Anchored on every part of the rig.`)
	return
end
rootPart:SetNetworkOwner(nil)

local path = PathfindingService:CreatePath({
	AgentRadius = 2,
	AgentHeight = 5,
	AgentCanJump = true,
})

-- ComputeAsync는 실행을 양보하고 오류를 낼 수 있으므로 pcall 안에 둡니다
local ok, err = pcall(function()
	path:ComputeAsync(rootPart.Position, goalPart.Position)
end)

if not ok then
	warn(`Path request failed: {err}`)
elseif path.Status ~= Enum.PathStatus.Success then
	warn(`No path to the goal: {path.Status.Name}`)
else
	for index, waypoint in path:GetWaypoints() do
		if index == 1 then
			continue -- 첫 번째 웨이포인트는 NPC가 이미 서 있는 곳입니다
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- NPC가 이 웨이포인트에 도착할 때까지 기다린 뒤에야 다음으로 갑니다
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Goal 파트는 CanCollide가 꺼져 있습니다. 경로는 단단한 파트 안에서 끝날 수 없기 때문입니다. 그러면 경로의 Status가 NoPath가 됩니다.

CreatePath가 받는 테이블은 NPC(Roblox는 에이전트라고 부릅니다)를 설명하므로, 경로가 NPC가 지나갈 수 없는 틈을 피해 갑니다. 위 스크립트는 처음 세 키를 기본값과 같게 설정해 두었습니다. 어디서 바꾸면 되는지 보이도록 하기 위해서입니다.

CreatePath의 에이전트 매개변수
키기본값정하는 것
AgentRadius2NPC의 반지름(스터드). 몸집이 넓은 NPC라면 늘려서 경로가 벽에서 더 떨어지게 하세요.
AgentHeight5NPC의 높이. 계단 밑처럼 이보다 낮은 곳은 막힌 것으로 봅니다.
AgentCanJumptrue점프가 필요한 경로를 허용합니다. 그런 웨이포인트는 Action이 Jump입니다.
AgentCanClimbfalseTrussPart를 타고 오르는 것을 허용합니다. 그런 웨이포인트에는 Climb 레이블이 붙습니다.
WaypointSpacing4중간 웨이포인트 사이의 거리(스터드). math.huge로 설정하면 중간 웨이포인트가 없어집니다.
Costs없음재질과 레이블이 붙은 영역을 지나가는 비용. 모디파이어와 링크를 보세요.

반복문에서 중요한 점이 두 가지 있습니다. 첫 번째 웨이포인트는 NPC 자신의 위치이므로 반복문이 건너뜁니다. 그리고 MoveTo마다 그 뒤에 MoveToFinished:Wait()가 옵니다. 새 MoveTo는 이전 목표를 덮어쓰기 때문에, 기다리지 않는 반복문은 NPC를 곧장 마지막 웨이포인트로, 즉 돌아가야 할 바로 그 벽으로 보냅니다.

점프하는 곳에서는 웨이포인트의 Action이 Jump이고, 스크립트가 ChangeState(Enum.HumanoidStateType.Jumping)를 호출합니다. Roblox Humanoid 레퍼런스에 따르면 서버 스크립트는 서버가 캐릭터의 물리를 소유할 때만 상태를 바꿀 수 있습니다. 스크립트가 먼저 소유자를 정하는 이유 중 하나입니다.

Roblox의 pathfinding 페이지에서는 플레이어 자신의 캐릭터를 Humanoid:Move()로 움직이면서 매 프레임 도착을 확인하며, 이를 Humanoid를 경로를 따라 움직이는 가장 좋은 방법이라고 설명합니다. 서버 NPC에는 MoveTo와 MoveToFinished가 더 짧고 이해하기 쉬워서 이 가이드는 그 방법을 씁니다. 나중에 더 정밀한 제어가 필요하면 공식 스크립트를 살펴보세요.

3단계: 완성된 추격 스크립트

대부분이 찾는 스크립트가 바로 이것입니다. NPC는 80스터드 안의 가장 가까운 플레이어를 쫓고, 벽을 돌아가고, 경로에 필요한 곳에서 점프하고, 무언가가 길을 막으면 새 경로를 찾고, 주변에 아무도 없으면 집으로 돌아갑니다.

  1. WalkToGoal을 추가했다면 Chaser에서 지우세요.
  2. Chaser에 마우스를 올리고 +를 눌러 이름이 ChaseAI인 Script를 넣고 아래 코드를 붙여 넣으세요.
  3. Play를 누르고 벽 뒤로 간 다음, 범위 밖으로 달아나 보세요. NPC가 벽을 돌아 쫓아오다가 처음 있던 곳으로 돌아갑니다.
Script 위치: Chaser 모델 이름: ChaseAI
local Players = game:GetService("Players")
local PathfindingService = game:GetService("PathfindingService")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart

-- 설정 (거리는 스터드, 시간은 초)
local DETECTION_RANGE = 80 -- 이보다 먼 플레이어는 NPC가 알아채지 못합니다
local STOP_DISTANCE = 4 -- 목표에서 이 거리만큼 떨어져 멈춥니다 (0 = 바짝 붙기, 닿으면 데미지용)
local DIRECT_CHASE_RANGE = 30 -- 이보다 가깝고 길에 아무것도 없으면 pathfinding을 건너뜁니다
local REPATH_DISTANCE = 4 -- 목표가 이만큼 움직여야 경로를 다시 계산합니다
local MIN_REPATH_INTERVAL = 0.5 -- 이보다 자주 경로를 계산하지 않습니다
local WAYPOINT_TIMEOUT = 2 -- 웨이포인트 하나에 이보다 오래 걸리면 경로를 버립니다
local CHASE_SPEED = 14 -- 플레이어 기본 걷기 속도는 16이므로 이 NPC에게서 달아날 수 있습니다
local HOME_RADIUS = 4 -- 집에서 이만큼 가까우면 집에 있는 것으로 봅니다
local RAY_HEIGHTS = { 0, -2 } -- 허리 높이와 무릎 근처에서 쏘는 시야 레이

local HOME = rootPart.Position -- 범위 안에 아무도 없을 때 NPC가 돌아가는 곳

humanoid.WalkSpeed = CHASE_SPEED

-- NPC는 서버가 시뮬레이션하게 합니다. 그렇지 않으면 Roblox가 물리를 근처
-- 플레이어의 기기에 넘길 수 있고, 소유자가 바뀔 때 NPC가 덜덜 떱니다.
local canSetOwner, ownerProblem = rootPart:CanSetNetworkOwnership()
if not canSetOwner then
	warn(`{npc.Name} cannot move: {ownerProblem}. Untick Anchored on every part of the rig.`)
	return
end
rootPart:SetNetworkOwner(nil)

local path = PathfindingService:CreatePath({
	AgentRadius = 2,
	AgentHeight = 5,
	AgentCanJump = true,
	Costs = {
		Water = 20, -- 크게 돌아가는 것을 피할 때만 물을 지나갑니다
		DangerZone = math.huge, -- DangerZone 레이블이 붙은 영역에는 절대 들어가지 않습니다
	},
})

-- NPC가 지금 따라가고 있는 경로
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked는 NPC가 이미 지나간 웨이포인트에 대해서도 발생할 수 있습니다. 앞쪽 장애물만 중요합니다.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- 아무것과도 충돌하지 않는 파트는 시야를 가리지 않습니다

local function clearPath()
	waypoints = {}
	nextIndex = 0
	pathGoal = nil
end

local function stopMoving()
	clearPath()
	humanoid:MoveTo(rootPart.Position)
end

-- DETECTION_RANGE 안에서 가장 가까운 살아 있는 플레이어의 HumanoidRootPart, 없으면 nil
local function findNearestTarget(): BasePart?
	local nearestRoot: BasePart? = nil
	local nearestDistance = DETECTION_RANGE
	for _, player in Players:GetPlayers() do
		local character = player.Character
		local targetHumanoid = character and character:FindFirstChildOfClass("Humanoid")
		local targetRoot = character and character:FindFirstChild("HumanoidRootPart")
		if targetHumanoid and targetHumanoid.Health > 0 and targetRoot and targetRoot:IsA("BasePart") then
			local distance = (targetRoot.Position - rootPart.Position).Magnitude
			if distance < nearestDistance then
				nearestDistance = distance
				nearestRoot = targetRoot
			end
		end
	end
	return nearestRoot
end

-- 목표가 대략 같은 높이에 있고 사이에 단단한 것이 없으면 true.
-- 레이가 막히지 않았다고 땅으로 걸어갈 수 있다는 뜻은 아니므로, 짧은 거리에서만 씁니다.
local function canSeeDirectly(targetRoot: BasePart): boolean
	local offset = targetRoot.Position - rootPart.Position
	if math.abs(offset.Y) > 3 then
		return false
	end
	local character = targetRoot.Parent
	rayParams.ExcludeInstances = if character then { npc, character } else { npc }
	for _, height in RAY_HEIGHTS do
		local origin = rootPart.Position + Vector3.new(0, height, 0)
		if workspace:Raycast(origin, offset, rayParams) then
			return false
		end
	end
	return true
end

local function computePath(goal: Vector3)
	lastComputeTime = os.clock()
	local ok, err = pcall(function()
		path:ComputeAsync(rootPart.Position, goal)
	end)
	-- 계산이 끝난 뒤 초기화해서, 이전 경로의 Blocked가 새 경로에 표시되지 않게 합니다
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- 웨이포인트 1은 NPC가 서 있는 곳입니다
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- 아직 경로가 없습니다. 메인 반복문이 곧 다시 시도합니다
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- 방금 계산했습니다. 현재 경로를 따라갑니다
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- MoveToFinished를 기다리지만, 기본 8초 대신 timeout초 뒤에 포기해서
-- 막힌 NPC가 빨리 새 경로를 받게 합니다
local function waitForMoveToFinished(timeout: number): boolean
	local finished = false
	local reachedGoal = false
	local connection = humanoid.MoveToFinished:Connect(function(reached: boolean)
		finished = true
		reachedGoal = reached
	end)
	local deadline = os.clock() + timeout
	while not finished and os.clock() < deadline do
		task.wait()
	end
	connection:Disconnect()
	return reachedGoal
end

local function walkToNextWaypoint()
	local waypoint = waypoints[nextIndex]
	humanoid:MoveTo(waypoint.Position)
	if waypoint.Action == Enum.PathWaypointAction.Jump then
		humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
	end
	if waitForMoveToFinished(WAYPOINT_TIMEOUT) then
		nextIndex += 1
	else
		clearPath() -- 막혔거나 밀려서 경로를 벗어났습니다. 새 경로를 계산합니다
	end
end

while humanoid.Health > 0 do
	local targetRoot = findNearestTarget()
	local goal: Vector3

	if targetRoot then
		local distance = (targetRoot.Position - rootPart.Position).Magnitude
		if distance <= STOP_DISTANCE then
			stopMoving() -- 충분히 가깝습니다. 목표 옆에 서 있습니다
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- 파트도 함께 넘기면 NPC는 그 파트가 움직이는 동안 계속 따라갑니다
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- 주변에 아무도 없고 NPC는 이미 집에 있습니다
			task.wait(0.5)
			continue
		end
		goal = HOME
	end

	if needsNewPath(goal) then
		computePath(goal)
	end

	if nextIndex >= 2 and nextIndex <= #waypoints then
		walkToNextWaypoint()
	else
		task.wait(0.1) -- 아직 쓸 수 있는 경로가 없습니다. 예를 들어 목표에 갈 수 없을 때
	end
end

모든 설정은 맨 위에 있습니다. NPC를 여러 개 두려면 Chaser를 복제하세요. 복사본마다 자신의 ChaseAI를 실행하고 자신의 집을 기억합니다. 예전 스크립트는 FilterDescendantsInstances로 레이를 걸러 냈지만, 지금 Roblox 레퍼런스는 새 작업에 ExcludeInstances를 권장하며 이 스크립트도 그것을 씁니다.

추격 스크립트의 작동 방식

메인 반복문은 한 번 돌 때마다 결정 하나를 내리고 작은 동작 하나를 합니다. 서 있기, 플레이어 쪽으로 곧장 한 걸음, 또는 다음 웨이포인트로 걷기입니다. 웨이포인트 하나보다 길게 결정되는 것은 없으므로 NPC는 항상 반응합니다.

가장 가까운 플레이어 찾기

findNearestTarget는 Players:GetPlayers()를 돌면서 캐릭터, 살아 있는 Humanoid, HumanoidRootPart가 없는 플레이어(리스폰 중이거나 나가는 플레이어)를 건너뛰고, DETECTION_RANGE 안에서 가장 가까운 root part를 돌려줍니다. 매번 반복할 때마다 찾으므로 NPC는 더 가까운 플레이어로 알아서 바꾸고, 나간 플레이어는 그냥 더 이상 찾아지지 않습니다. 플레이어별로 정리해야 할 상태가 전혀 없습니다.

플레이어가 움직이는 동안 경로를 다시 계산하되, 매 프레임은 아니게

경로 계산은 실행을 양보하고 서버 시간을 씁니다. needsNewPath는 경로가 없을 때, 기존 경로가 끝났거나 막혔을 때, 또는 플레이어가 현재 경로의 끝에서 REPATH_DISTANCE스터드보다 멀어졌을 때만 새 경로를 요청하며, 이전 계산 후 MIN_REPATH_INTERVAL초가 지나기 전에는 절대 요청하지 않습니다. 경로를 계산하는 동안 NPC는 현재 웨이포인트로 계속 걸어가고, 새 경로는 웨이포인트 2부터 따라가므로 NPC가 경로가 시작된 곳으로 몸을 돌리지 않습니다.

막힌 경로

문은 닫히고 파트는 떨어집니다. Path.Blocked는 막힌 웨이포인트의 인덱스와 함께 발생하는데, 그 웨이포인트가 NPC 뒤에 있을 수도 있으므로 스크립트는 blockedIndex >= nextIndex일 때만 반응합니다. 플래그를 세우면 반복문이 새 경로를 계산합니다. 밀리거나 걸려서 NPC가 WAYPOINT_TIMEOUT초보다 오래 걸리는 웨이포인트도 새 경로를 계산하게 만듭니다.

보이는 플레이어에게 곧장 가기

플레이어가 탁 트인 곳에서 보인다면 pathfinding이 필요 없습니다. DIRECT_CHASE_RANGE 안에서 canSeeDirectly 함수는 낮은 벽도 알아채도록 허리 높이와 무릎 근처에서 플레이어에게 레이 두 개를 쏘고, 두 캐릭터는 무시합니다. 어떤 레이도 아무것에 맞지 않고 플레이어가 대략 같은 높이에 있으면 NPC는 MoveTo(targetRoot.Position, targetRoot)를 호출합니다. 두 번째 인수 덕분에 목표가 플레이어와 함께 움직이고, 0.15초마다 다시 호출해서 8초 타임아웃이 계속 초기화됩니다.

막히지 않은 레이는 길에 단단한 것이 없다는 것만 증명할 뿐, 바닥이 있다는 것은 증명하지 않습니다. 맵에서 NPC와 플레이어 사이에 구덩이나 절벽이 있다면 DIRECT_CHASE_RANGE를 줄이거나 0으로 설정해 항상 pathfinding을 쓰게 하세요.

알맞은 거리에서 멈추기

플레이어가 STOP_DISTANCE보다 가까우면 NPC는 자기 위치로 MoveTo를 호출하고, 그러면 멈춥니다. 4스터드는 플레이어 옆에 서 있어야 하는 NPC에 알맞고, 거리를 두는 펫이나 동행 NPC라면 6이나 8로 설정하세요. 닿으면 공격하는 적이라면 4단계처럼 0으로 설정해 바짝 붙게 하세요.

NPC가 덜덜 떠는 이유와 해결법

NPC가 덜덜 떨거나, 웨이포인트마다 멈추거나, 뒷걸음질한다면 보통 아래 중 하나가 원인입니다. 추격 스크립트는 이미 이것들을 모두 처리합니다. 이 표는 직접 작성한 스크립트를 고칠 때 쓰세요.

pathfinding 떨림: 원인과 해결법
보이는 증상원인해결법
혼자일 때는 부드럽고 플레이어가 가까이 오면 끊김Network ownership. Roblox는 고정되지 않은 파트의 물리를 근처 플레이어의 기기에 넘기므로, 명령은 서버가 내리는데 NPC는 그 플레이어의 기기에서 시뮬레이션될 수 있고, 넘어갈 때마다 끊김처럼 보일 수 있습니다.서버에서 HumanoidRootPart에 SetNetworkOwner(nil)을 한 번 호출하세요. 거기에 연결된 모든 파트에 적용됩니다.
곧장 마지막 웨이포인트로 가서 벽에 부딪힘반복문에서 기다리지 않고 웨이포인트마다 MoveTo를 호출합니다. 호출할 때마다 이전 목표가 덮어써집니다.다음 웨이포인트로 넘어가기 전에 MoveToFinished를 기다리세요.
웨이포인트마다 잠깐 멈추거나 모서리를 가로지름도착을 기다리는 대신 웨이포인트 사이에 고정된 task.wait()를 씁니다. 너무 길면 NPC가 서 있고, 너무 짧으면 앞질러 갑니다.타임아웃을 두고 MoveToFinished를 기다리세요.
1초에 여러 번 떨거나 뒷걸음질함매 프레임 새 경로를 만듭니다. 경로는 매번 NPC 자신의 위치에서 시작하므로, 웨이포인트 1로 가는 경로가 NPC를 뒤로 돌려세웁니다.목표가 몇 스터드 움직였을 때만, 1초에 두 번 이하로 경로를 다시 계산하고 웨이포인트 2부터 시작하세요.
몇 초 동안 멈췄다가 다시 걸어감갈 수 없는 웨이포인트에서 MoveToFinished:Wait()가 8초 타임아웃을 기다립니다.더 짧은 자체 타임아웃을 쓰고, 시간이 다 되면 새 경로를 계산하세요.

누가 NPC를 소유하는지 보려면 플레이테스트 중에 Visualization Options를 열고 Network owners를 켜세요. 내 클라이언트가 시뮬레이션하는 파트는 초록색 테두리가 생기고, 서버나 다른 클라이언트의 파트는 흰색이나 회색 테두리가 생깁니다.

4단계: 닿으면 플레이어에게 데미지 주기(선택)

적으로 쓰려면 NPC에 닿은 플레이어에게 데미지를 주는 두 번째 스크립트를 넣으세요. 서버에서 실행되므로 플레이어의 클라이언트가 데미지를 바꾸거나 쿨다운을 우회할 수 없습니다.

  1. ChaseAI에서 STOP_DISTANCE를 0으로 설정해 NPC가 옆에서 멈추지 않고 플레이어에게 바짝 붙게 하세요.
  2. Chaser에 이름이 TouchDamage인 Script를 넣고 아래 코드를 붙여 넣으세요.
Script 위치: Chaser 모델 이름: TouchDamage
local Players = game:GetService("Players")

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

local DAMAGE = 10
local COOLDOWN_SECONDS = 1

local lastHit: { [Player]: number } = {}

local function onTouched(hit: BasePart)
	if humanoid.Health <= 0 then
		return -- 쓰러진 NPC는 데미지를 주지 않습니다
	end
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	local targetHumanoid = character and character:FindFirstChildOfClass("Humanoid")
	if not player or not targetHumanoid or targetHumanoid.Health <= 0 then
		return
	end

	local now = os.clock()
	local last = lastHit[player]
	if last and now - last < COOLDOWN_SECONDS then
		return -- 파트가 겹쳐 있는 동안 Touched는 1초에 여러 번 발생합니다
	end
	lastHit[player] = now

	targetHumanoid:TakeDamage(DAMAGE)
end

for _, descendant in npc:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant.Touched:Connect(onTouched)
	end
end

Players.PlayerRemoving:Connect(function(player: Player)
	lastHit[player] = nil
end)

TakeDamage는 포스필드를 고려하므로, 스폰 후 포스필드가 유지되는 동안 플레이어는 안전합니다. 포스필드를 무시하려면 Humanoid.Health를 직접 줄이세요.

쿨다운은 플레이어마다 따로 저장됩니다. 파트끼리 스치는 동안 Touched는 1초에 여러 번 발생하므로, 쿨다운이 없으면 한 번 닿는 것만으로 순식간에 플레이어 체력이 0이 될 수 있습니다. 플레이어가 나가면 그 플레이어의 기록을 지우므로, 서버가 살아 있는 동안 테이블이 계속 커지지 않습니다.

플레이어가 맞서 싸울 수 있게 하려면 검이나 레이캐스트 총을 주세요. 둘 다 서버에서 Humanoid가 있는 모든 것에 데미지를 주므로 Chaser도 맞힙니다.

Pathfinding 모디파이어와 링크

기본적으로 경로는 가능하면 점프가 없는 가장 짧은 경로입니다. 이를 바꾸는 방법은 세 가지입니다. 비용과 모디파이어는 추격 스크립트에서 그대로 작동합니다. 스크립트가 이미 CreatePath에 Costs 테이블을 넘기기 때문입니다. 링크에는 직접 쓴 코드 몇 줄이 필요합니다.

재질 비용

Costs의 키로는 Water, Mud, CrackedLava 같은 재질 이름을 쓸 수 있으며, 지형과 파트 모두에 적용됩니다. 기본적으로 모든 재질의 비용은 1입니다. 숫자가 클수록 돌아가는 길이 더 나쁘지 않다면 NPC가 그 재질을 피하고, math.huge로 설정하면 지나갈 수 없게 됩니다. 추격 스크립트는 Water = 20을 설정합니다.

피해야 할 영역: PathfindingModifier

  1. Anchored를 켜고 CanCollide를 끈 파트로 영역을 덮으세요.
  2. 그 파트에 PathfindingModifier를 넣고 Label을 DangerZone으로 설정하세요.
  3. 끝입니다. 추격 스크립트가 이미 DangerZone에 math.huge 비용을 주므로 NPC는 이 영역을 피해 갑니다. Visualization Options에서 Pathfinding modifiers를 켜면 내비게이션 메시에서 레이블을 볼 수 있습니다.

PassThrough를 켠 모디파이어는 반대로 작동합니다. 닫힌 문 같은 단단한 장애물을 마치 없는 것처럼 경로가 통과합니다. NPC가 문을 통과할 수는 없지만, 반대편에서 플레이어 소리를 들은 것처럼 문 쪽으로 걸어갑니다.

PathfindingLink는 NPC가 보통은 오갈 수 없는 두 지점을 연결합니다. 예를 들어 NPC가 배로 건너는 강의 양쪽 기슭입니다. 양 끝에 Attachment를 하나씩 두고, 링크의 Attachment0와 Attachment1을 설정하고, UseBoat 같은 Label을 붙인 다음, Costs에 UseBoat를 Water보다 낮은 비용으로 추가하세요. 그러면 경로에 그 레이블이 붙은 웨이포인트가 생깁니다. walkToNextWaypoint에서 waypoint.Label을 확인하고, MoveTo 대신 NPC를 배에 태우는 것 같은 자체 동작을 실행하세요. IsBidirectional을 끄지 않으면 링크는 양방향으로 작동합니다.

자주 발생하는 오류와 해결 방법

먼저 Output 창을 확인하세요. Window 메뉴나 Script 탭에서 열 수 있습니다. 이 페이지의 스크립트는 경로 요청이 실패하거나 리그가 움직일 수 없을 때 경고를 출력합니다.

NPC가 전혀 움직이지 않음

Output에 NPC가 움직일 수 없다(cannot move)고 나오면 리그 일부가 고정되어 있는 것입니다. HumanoidRootPart와 나머지 파트의 Anchored를 끄세요. 그런 메시지가 없다면 코드가 LocalScript가 아니라 Script에 있는지, Workspace 안의 모델 안에 있는지, Humanoid가 죽지 않았는지 확인하세요.

Output에 WaitForChild에서 "Infinite yield possible"이 나옴

스크립트가 없는 오브젝트를 기다리고 있습니다. 이름이 다른 Humanoid나 HumanoidRootPart, 또는 2단계 스크립트에 필요한 Goal 파트가 없는 경우입니다. 오브젝트 이름이나 스크립트의 문자열을 바꾸세요. 이 경고는 스크립트 오류 가이드에서 설명합니다.

경로가 만들어지지 않거나, NPC가 갈 수 있는 플레이어를 무시함

시작점이나 끝점이 단단한 파트 안에 있을 때, 유일한 경로에 점프가 필요한데 AgentCanJump가 false일 때, 또는 AgentHeight나 AgentRadius가 길에 있는 틈보다 클 때 ComputeAsync 후 Path.Status는 NoPath입니다. Roblox 문서에는 엄격한 제한도 있습니다. 시작점에서 끝점까지 직선거리 3,000스터드 이하, 그리고 탐색 예산 20,000노드인데, 거대한 오픈 월드나 미로에서는 부족할 수 있습니다. Navigation mesh를 켜서 경로를 확인하세요.

NPC가 다리를 움직이지 않고 미끄러짐

pathfinding이 아니라 애니메이션 문제입니다. 플레이어 캐릭터는 Animate 스크립트를 자동으로 받지만, NPC는 걷기 애니메이션을 재생할 자체 스크립트가 필요합니다. Roblox의 NPC kit에 있는 모든 NPC에는 살펴볼 수 있는 Animate라는 Script가 들어 있습니다. 서버 Script에서 NPC에 애니메이션을 불러와 재생하는 방법은 NPC 애니메이션 섹션을 보세요.

NPC가 모서리에 걸리거나, 점프는 하는데 장애물을 넘지 못함

특히 몸집이 넓은 NPC라면 AgentRadius를 늘려 경로가 벽에서 더 떨어지게 하세요. 점프는 하는데 도무지 넘지 못한다면 장애물이 Humanoid가 뛸 수 있는 높이보다 높은 것입니다. Humanoid의 JumpHeight나 JumpPower를 늘리거나 레벨을 바꾸세요.

닿으면 주는 데미지가 너무 자주 들어가거나 전혀 안 들어감

너무 자주: 쿨다운이 없거나, 플레이어별이 아니라 파트별로 저장되어 있습니다. 전혀 안 들어감: STOP_DISTANCE가 0보다 커서 NPC가 대개 누군가에게 닿기 전에 멈추거나, 플레이어에게 스폰 후 포스필드가 아직 남아 있습니다.

RoCode로 만들어 보기

NPC를 직접 조립하기보다 설명하는 편이 편하다면, RoCode가 열어 둔 플레이스에 이 스크립트들을 작성해 줄 수 있습니다. RoCode는 Roblox Studio용 독립 AI 에이전트입니다. 웹 채팅에 입력하면 Studio 플러그인이 Explorer 안에서 스크립트를 만들고 수정합니다.

입력하는 내용

Workspace의 Chaser 모델이 pathfinding으로 80스터드 안의 가장 가까운 플레이어를 쫓아가고, 주변에 아무도 없으면 집으로 돌아가고, 닿으면 쿨다운 1초로 10 데미지를 주게 만들어 줘.

RoCode가 하는 일
  • 먼저 Get Properties로 모델을 살펴보고, 파트의 Anchored나 Humanoid의 WalkSpeed 같은 핵심 값을 읽을 수 있습니다. 채팅에 /를 입력하면 모델의 정확한 경로를 첨부할 수 있습니다
  • Create Script로 모델 안에 추격 스크립트와 데미지 스크립트를 작성하고, 리그에 필요하면 Set Property로 Anchored를 끌 수 있습니다
  • Check Script로 Studio 안에서 두 스크립트의 컴파일을 확인합니다. 컴파일 오류와 task.wait() 대신 wait()를 쓴 것 같은 문제는 잡아내지만, 플레이어에게 끝내 도달하지 못하는 경로 같은 논리 버그는 잡지 못합니다
  • 변경 사항을 묶음으로 보내며, 묶음마다 Studio 기록에 실행 취소 지점이 생깁니다

플러그인 3.9 이상에서는 RoCode가 짧은 플레이테스트를 실행해 오류를 읽을 수 있고, 플러그인 3.9.11 이상에서는 테스트 캐릭터를 조종해 게임이 작동하는지 확인할 수 있지만, 플레이 중에는 스크린샷을 찍지 않으므로 직접 Play를 눌러 NPC를 지켜보세요. 예상과 다르게 움직이면 본 내용을 RoCode에 알려 주세요. Check Output이 마지막 플레이테스트의 Server와 Client 줄을 읽을 수 있습니다. NPC는 여러 시스템 중 하나일 뿐입니다. AI로 Roblox 게임 전체를 만드는 방법: 먼저 플레이 가능한 핵심, 그다음 라운드를 보세요. RoCode가 Studio에 연결되는 방식.

자주 묻는 질문

pathfinding NPC는 서버와 클라이언트 중 어디서 실행해야 하나요?

서버의 Script에서 실행하세요. Roblox 자체 pathfinding 예제는 LocalScript에서 실행되지만, 거기서 움직이는 것은 플레이어 자신의 캐릭터입니다. NPC는 모두가 공유하고, NPC가 주는 데미지는 서버가 결정해야 합니다. Script, LocalScript, ModuleScript를 보세요.

서버 하나가 추격 NPC를 몇 개까지 감당할 수 있나요?

Roblox 문서에 정확한 숫자는 없습니다. 맵과 경로를 얼마나 자주 계산하는지에 따라 다릅니다. 가장 비싼 것은 경로 계산이므로, 추격 스크립트는 NPC당 1초에 두 번으로 제한하고 플레이어가 보이면 건너뜁니다. NPC가 많다면 스크립트를 어디에 둘지에 관한 Roblox 권장 사항에 따라, 모델마다 스크립트를 넣는 대신 태그를 붙이고 하나의 ModuleScript에서 CollectionService로 처리하세요.

NPC가 죽은 뒤 리스폰되게 하려면 어떻게 하나요?

NPC의 복사본을 ServerStorage에 두고, 리스폰은 ServerScriptService의 스크립트에서 처리하세요. NPC 안의 스크립트는 NPC와 함께 사라지기 때문입니다. Humanoid의 Died 이벤트가 발생하면 몇 초 기다렸다가 기존 모델을 제거하고 복사본의 Clone()을 Workspace에 넣으세요. 서버 스크립트는 Workspace에 들어가는 즉시 실행되므로 복제본 안의 ChaseAI 스크립트도 저절로 시작됩니다.

NPC가 라운드 중에만 플레이어를 쫓게 할 수 있나요?

네. 라운드 스크립트가 라운드가 시작될 때 NPC를 Workspace에 복제하고, 끝날 때 제거하게 하세요. 라운드 시스템 가이드에서 여기에 연결할 휴식 시간과 라운드 루프를 만듭니다.

출처와 더 읽을거리

코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.

내 게임에서 RoCode를 사용해 보세요.

매일 무료 크레딧, 카드 등록 없이 시작합니다. 플러그인을 설치하고, 원하는 기능을 설명한 뒤, Studio에 만들어진 결과를 확인하세요.