Tóm tắt
Đặt Script bên trong model NPC. Tạo path bằng PathfindingService:CreatePath(), tính nó bằng path:ComputeAsync(start, goal) bên trong pcall, rồi đi qua từng waypoint một bằng Humanoid:MoveTo(), chờ MoveToFinished trước khi sang waypoint tiếp theo. Để NPC đuổi theo người chơi, hãy chọn nhân vật gần nhất và tính lại path khi người đó đã di chuyển vài stud, chứ không phải mỗi frame.
- Cần có Humanoid và một HumanoidRootPart không bị anchor. Gọi
SetNetworkOwner(nil)trên root part để server mô phỏng nó: đây là cách sửa thông thường cho NPC bị giật khi ở gần người chơi. - Nhảy khi
Actioncủa waypoint làJump, và tính path mới khiPath.Blockedkích hoạt cho một waypoint ở phía trước NPC. - Khi nhìn thấy người chơi trực tiếp, hãy bỏ qua pathfinding và gọi
MoveTothẳng tới người đó. Dừng lại cách vài stud, hoặc đi sát tận nơi nếu NPC gây sát thương khi chạm.
Trong trang này
Pathfinding NPC hoạt động như thế nào
Roblox dựng một lưới điều hướng (navigation mesh) từ những bề mặt mà nhân vật có thể đi trên đó. PathfindingService tìm trên lưới này một lộ trình giữa hai điểm và trả về dưới dạng danh sách waypoint: mỗi waypoint có một vị trí và một hành động, ví dụ đi bộ hoặc nhảy. Sau đó Humanoid của NPC đi từ waypoint này sang waypoint kế tiếp. Pathfinding chỉ lập lộ trình: việc di chuyển theo nó là phần script của bạn phải làm.
| API | Chức năng |
|---|---|
PathfindingService:CreatePath() | Tạo một object Path dùng lại được nhiều lần, theo kích thước NPC của bạn thông qua tham số agent. |
Path:ComputeAsync(start, finish) | Tính lộ trình. Hàm này yield và có thể lỗi, nên hãy gọi nó trong pcall và kiểm tra Path.Status. |
Path:GetWaypoints() | Trả về lộ trình dưới dạng mảng các giá trị PathWaypoint, mỗi giá trị có Position, Action và Label. |
Path.Blocked | Kích hoạt kèm chỉ số waypoint khi có thứ gì đó chắn lộ trình đã tính. |
Humanoid:MoveTo(position) | Dẫn NPC tới một điểm. |
Humanoid.MoveToFinished | Kích hoạt với true khi NPC tới gần điểm đó khoảng một stud, hoặc với false nếu nó không tới nơi trong 8 giây. |
Chạy tất cả những thứ này trong một Script server: server thấy toàn bộ bản đồ kể cả khi bật streaming, mọi người chơi thấy cùng một NPC, và sát thương được quyết định ở nơi client không thể làm giả. Script, LocalScript và ModuleScript giải thích sự phân chia này.
Bước 1: NPC có thể di chuyển
Bất kỳ model nào cũng đi theo path được nếu nó có đủ ba thứ trong bảng dưới. Rig lấy từ Toolbox hoặc từ place cũ đôi khi thiếu một thứ, và thường biểu hiện thế này: NPC đứng yên mà không có lỗi nào.
| Yêu cầu | Vì sao quan trọng |
|---|---|
Humanoid tên là Humanoid | MoveTo, WalkSpeed và việc nhảy đều thuộc về Humanoid. |
HumanoidRootPart | Part mà Humanoid điều khiển. Path bắt đầu từ vị trí của nó. |
| Không có gì bị anchor | Part bị anchor không thể di chuyển, các part nối với nó cũng vậy. Part bị anchor luôn do server sở hữu, nên cách sửa giật ở bên dưới không áp dụng cho chúng. |
- Mở tab Avatar hoặc Home và bấm Character để mở Rig Generator. Chọn R15, rồi Block Avatar. Một rig sẽ xuất hiện trong Workspace. Rig R6 cũng chạy được với cùng các script.
- Đổi tên rig thành
Chaservà đặt nó ở chỗ trống. - Chọn HumanoidRootPart của nó và kiểm tra rằng Anchored trong cửa sổ Properties đang tắt. Làm tương tự cho mọi part khác bị anchor trong model. Để tìm nhanh, bật Anchored parts trong widget Visualization Options ở góc trên bên phải viewport 3D.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (các bộ phận cơ thể)
ChaseAI Script new
TouchDamage Script new
Để NPC còn biết nói chuyện, hướng dẫn hội thoại NPC thêm lời nhắc Talk có các lựa chọn trả lời và giải thích những gì thay đổi khi NPC biết đi. Để giới thiệu boss bằng camera trước khi nó bắt đầu đuổi, xem hướng dẫn cutscene.
Bước 2: Đưa NPC tới một điểm
Bắt đầu với script nhỏ nhất chạy được: đi tới một part đứng yên. Nó cho thấy từng giai đoạn của pathfinding mà chưa có logic đuổi theo.
- Chèn một Part vào Workspace, đặt tên là
Goal, bật Anchored, tắt CanCollide và đặt nó trên sàn sao cho NPC phải đi vòng qua một bức tường. - Trong Explorer, rê chuột lên Chaser, bấm nút + và chèn một Script. Đặt tên là
WalkToGoalvà dán code bên dưới vào. - Bấm Play. NPC đi vòng qua tường và tới part Goal.
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
-- Server phải sở hữu physics của NPC, nếu không ChangeState (nhảy) từ Script sẽ không chạy
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 yield và có thể ném lỗi, nên nó nằm trong 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 -- waypoint đầu tiên là chỗ NPC đang đứng
end
humanoid:MoveTo(waypoint.Position)
if waypoint.Action == Enum.PathWaypointAction.Jump then
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
-- Chờ NPC tới waypoint này rồi mới đi tới waypoint tiếp theo
local reached = humanoid.MoveToFinished:Wait()
if not reached then
warn(`{npc.Name} got stuck on the way to the goal`)
break
end
end
end
Part Goal tắt CanCollide vì path không thể kết thúc bên trong một part rắn: Status của path sẽ là NoPath.
Bảng mà CreatePath nhận vào mô tả NPC (Roblox gọi nó là agent), để lộ trình tránh những khe hở mà nó không lọt qua được. Script ở trên đặt ba khóa đầu bằng giá trị mặc định để bạn thấy chỗ cần đổi.
| Khóa | Mặc định | Ý nghĩa |
|---|---|---|
AgentRadius | 2 | Bán kính NPC tính bằng stud. Tăng giá trị này cho NPC to ngang để path giữ khoảng cách xa tường hơn. |
AgentHeight | 5 | Chiều cao NPC. Những chỗ thấp hơn mức này, ví dụ dưới gầm cầu thang, bị coi là bị chắn. |
AgentCanJump | true | Cho phép lộ trình cần nhảy. Các waypoint đó có Action là Jump. |
AgentCanClimb | false | Cho phép leo TrussPart. Các waypoint đó có nhãn Climb. |
WaypointSpacing | 4 | Khoảng cách tính bằng stud giữa các waypoint trung gian. math.huge sẽ bỏ chúng đi. |
Costs | không có | Mức "đắt" khi đi qua các vật liệu và vùng được gắn nhãn. Xem modifier và link. |
Trong vòng lặp có hai chi tiết quan trọng. Waypoint đầu tiên là vị trí của chính NPC, nên vòng lặp bỏ qua nó. Và sau mỗi MoveTo là MoveToFinished:Wait(): một MoveTo mới sẽ thay thế mục tiêu trước đó, nên vòng lặp không chờ sẽ đưa NPC thẳng tới waypoint cuối cùng, đâm vào đúng bức tường mà nó phải đi vòng.
Với các cú nhảy, Action của waypoint là Jump, và script gọi ChangeState(Enum.HumanoidStateType.Jumping). Tài liệu Roblox về Humanoid ghi rằng script server chỉ đổi được state khi server sở hữu physics của nhân vật. Đây là một lý do khiến script đặt owner trước tiên.
Trên trang pathfinding của Roblox, nhân vật của chính người chơi di chuyển bằng Humanoid:Move() với việc kiểm tra đã tới nơi mỗi frame, và đó được gọi là cách tốt nhất để dẫn Humanoid theo path. MoveTo cùng MoveToFinished ngắn gọn và dễ hiểu hơn cho NPC phía server, nên hướng dẫn này dùng nó; nếu sau này cần điều khiển chính xác hơn, hãy xem script chính thức.
Bước 3: Script đuổi theo hoàn chỉnh
Đây là script mà đa số mọi người tìm kiếm. NPC đuổi theo người chơi gần nhất trong phạm vi 80 stud, đi vòng qua tường, nhảy ở chỗ lộ trình cần, tìm lộ trình mới khi có thứ chắn đường, và đi về nhà khi xung quanh không có ai.
- Xóa
WalkToGoalkhỏi Chaser nếu bạn đã thêm nó. - Rê chuột lên Chaser, bấm +, chèn một Script tên
ChaseAIvà dán code bên dưới vào. - Bấm Play, đi ra sau tường, rồi chạy ra ngoài tầm. NPC đi vòng qua tường theo bạn, sau đó quay về chỗ ban đầu.
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
-- Cài đặt (khoảng cách tính bằng stud, thời gian tính bằng giây)
local DETECTION_RANGE = 80 -- NPC không để ý người chơi ở xa hơn mức này
local STOP_DISTANCE = 4 -- dừng lại ở khoảng cách này so với mục tiêu (0 = đi sát tận nơi, cho sát thương khi chạm)
local DIRECT_CHASE_RANGE = 30 -- gần hơn mức này thì bỏ qua pathfinding nếu không có gì chắn đường
local REPATH_DISTANCE = 4 -- mục tiêu phải di chuyển bao xa thì path mới được tính lại
local MIN_REPATH_INTERVAL = 0.5 -- không bao giờ tính path thường xuyên hơn mức này
local WAYPOINT_TIMEOUT = 2 -- bỏ path nếu một waypoint mất lâu hơn mức này
local CHASE_SPEED = 14 -- người chơi mặc định đi với tốc độ 16, nên có thể chạy thoát NPC này
local HOME_RADIUS = 4 -- gần nhà chừng này thì đã tính là ở nhà
local RAY_HEIGHTS = { 0, -2 } -- tia kiểm tra tầm nhìn ở ngang thắt lưng và gần đầu gối
local HOME = rootPart.Position -- nơi NPC quay về khi không có ai trong phạm vi
humanoid.WalkSpeed = CHASE_SPEED
-- Để server mô phỏng NPC. Nếu không, Roblox có thể giao physics của nó cho thiết bị
-- của người chơi gần đó, và NPC bị giật khi owner thay đổi.
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, -- chỉ đi qua nước để tránh phải đi vòng quá xa
DangerZone = math.huge, -- không bao giờ đi vào vùng có nhãn DangerZone
},
})
-- Path mà NPC đang đi theo lúc này
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge
-- Blocked có thể kích hoạt cho waypoint mà NPC đã đi qua. Chỉ vật cản phía trước mới quan trọng.
path.Blocked:Connect(function(blockedIndex: number)
if blockedIndex >= nextIndex then
pathBlocked = true
end
end)
local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- part không va chạm với thứ gì thì không che tầm nhìn
local function clearPath()
waypoints = {}
nextIndex = 0
pathGoal = nil
end
local function stopMoving()
clearPath()
humanoid:MoveTo(rootPart.Position)
end
-- HumanoidRootPart của người chơi còn sống gần nhất trong phạm vi DETECTION_RANGE, hoặc 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 khi mục tiêu ở gần cùng độ cao và giữa hai bên không có gì rắn.
-- Tia thông thoáng không chứng minh mặt đất đi được, nên chỉ dùng ở khoảng cách ngắn.
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)
-- Đặt lại sau khi tính, để Blocked của lộ trình cũ không đánh dấu lộ trình mới
pathBlocked = false
if ok and path.Status == Enum.PathStatus.Success then
waypoints = path:GetWaypoints()
nextIndex = 2 -- waypoint 1 là chỗ NPC đang đứng
pathGoal = goal
else
if not ok then
warn(`{npc.Name}: path request failed: {err}`)
end
clearPath() -- chưa có lộ trình; vòng lặp chính sẽ sớm thử lại
end
end
local function needsNewPath(goal: Vector3): boolean
if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
return false -- vừa mới tính xong: đi theo path hiện tại
end
local currentGoal = pathGoal
if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
return true
end
return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end
-- Chờ MoveToFinished, nhưng bỏ cuộc sau timeout giây thay vì 8 giây mặc định,
-- để NPC bị kẹt nhanh chóng có path mới
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() -- bị kẹt hoặc bị đẩy lệch hướng: tính path mới
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() -- đủ gần rồi: đứng cạnh mục tiêu
task.wait(0.2)
continue
end
if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
clearPath()
-- Nếu truyền thêm một part, NPC sẽ đi theo nó trong lúc nó di chuyển
humanoid:MoveTo(targetRoot.Position, targetRoot)
task.wait(0.15)
continue
end
goal = targetRoot.Position
else
if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
stopMoving() -- xung quanh không có ai, và NPC đã ở nhà
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) -- chưa có path dùng được, ví dụ mục tiêu không tới được
end
end
Mọi cài đặt nằm ở trên cùng. Muốn có nhiều NPC thì nhân bản Chaser: mỗi bản sao chạy ChaseAI riêng và nhớ nhà riêng của nó. Script cũ lọc tia bằng FilterDescendantsInstances; tài liệu Roblox giờ khuyên dùng ExcludeInstances cho việc mới, và script này dùng đúng cái đó.
Script đuổi theo hoạt động như thế nào
Mỗi lượt của vòng lặp chính đưa ra một quyết định và làm một hành động nhỏ: đứng yên, bước thẳng tới người chơi, hoặc đi tới waypoint tiếp theo. Không có quyết định nào kéo dài quá một waypoint, nên NPC luôn phản ứng kịp.
Tìm người chơi gần nhất
findNearestTarget duyệt qua Players:GetPlayers(), bỏ qua những ai không có nhân vật, Humanoid còn sống hoặc HumanoidRootPart (người chơi đang respawn hoặc đang thoát) và trả về root part gần nhất trong phạm vi DETECTION_RANGE. Việc tìm diễn ra ở mỗi lượt, nên NPC tự chuyển sang người chơi gần hơn, còn người chơi đã thoát thì đơn giản là không còn được tìm thấy: không có trạng thái riêng cho từng người chơi cần dọn dẹp.
Tính lại path khi người chơi di chuyển, nhưng không phải mỗi frame
Tính path sẽ yield và tốn thời gian của server. needsNewPath chỉ yêu cầu path mới khi chưa có path, path cũ đã đi hết hoặc bị chắn, hoặc người chơi đã đi xa hơn REPATH_DISTANCE stud so với điểm cuối của path hiện tại, và không bao giờ sớm hơn MIN_REPATH_INTERVAL giây sau lần trước. Trong lúc path đang được tính, NPC vẫn tiếp tục đi tới waypoint hiện tại, còn path mới được đi từ waypoint 2, nên NPC không quay lại chỗ path bắt đầu.
Path bị chắn
Cửa đóng lại, part rơi xuống. Path.Blocked kích hoạt kèm chỉ số của waypoint bị chắn, và waypoint đó có thể ở phía sau NPC, nên script chỉ phản ứng khi blockedIndex >= nextIndex: nó bật một cờ, và vòng lặp tính lộ trình mới. Một waypoint mà NPC đi tới lâu hơn WAYPOINT_TIMEOUT giây, do bị đẩy hoặc bị vướng, cũng khởi động một lộ trình mới.
Đi thẳng tới người chơi nhìn thấy được
Không cần pathfinding khi người chơi ở trong tầm nhìn trên chỗ trống. Trong phạm vi DIRECT_CHASE_RANGE, hàm canSeeDirectly bắn hai tia về phía người chơi, ở ngang thắt lưng và gần đầu gối, để phát hiện tường thấp, và bỏ qua cả hai nhân vật. Nếu không tia nào trúng thứ gì và người chơi ở gần cùng độ cao, NPC gọi MoveTo(targetRoot.Position, targetRoot). Tham số thứ hai làm mục tiêu di chuyển theo người chơi, còn việc gọi lại mỗi 0.15 giây liên tục đặt lại thời gian chờ 8 giây.
Tia thông thoáng chứng minh trên đường không có gì rắn, nhưng không chứng minh ở đó có sàn. Nếu bản đồ có hố hoặc vực giữa NPC và người chơi, hãy giảm DIRECT_CHASE_RANGE hoặc đặt bằng 0 để luôn dùng pathfinding.
Dừng ở đúng khoảng cách
Khi người chơi gần hơn STOP_DISTANCE, NPC gọi MoveTo tới chính vị trí của nó, và điều đó làm nó dừng lại. 4 stud hợp với NPC cần đứng cạnh người chơi; với pet hoặc bạn đồng hành giữ khoảng cách, hãy đặt 6 hoặc 8. Với kẻ địch gây sát thương khi chạm, hãy đặt 0 để nó đi sát tận nơi, như trong bước 4.
Vì sao NPC bị giật và cách sửa
Nếu NPC bị giật, khựng lại ở mỗi waypoint hoặc bước lùi, nguyên nhân thường là một trong các mục dưới đây. Script đuổi theo đã xử lý từng mục; bảng này dùng để sửa script bạn tự viết.
| Bạn thấy gì | Nguyên nhân | Cách sửa |
|---|---|---|
| Mượt khi ở một mình, giật khi có người chơi ở gần | Network ownership. Roblox giao physics của các part không bị anchor cho thiết bị của người chơi ở gần, nên NPC có thể được mô phỏng trên thiết bị của người chơi đó trong khi server ra lệnh, và mỗi lần chuyển giao có thể trông như một cú giật. | Gọi SetNetworkOwner(nil) một lần trên HumanoidRootPart từ server. Lệnh này áp dụng cho mọi part nối với nó. |
| Đi thẳng tới waypoint cuối cùng và đâm vào tường | MoveTo được gọi cho từng waypoint trong vòng lặp mà không chờ. Mỗi lần gọi thay thế mục tiêu trước đó. | Chờ MoveToFinished trước khi sang waypoint tiếp theo. |
| Dừng một chút ở mỗi waypoint hoặc đi tắt qua góc | Dùng task.wait() cố định giữa các waypoint thay vì chờ tới nơi. Quá lâu thì NPC đứng yên; quá ngắn thì nó nhảy cóc lên trước. | Chờ MoveToFinished có thời gian chờ. |
| Giật hoặc bước lùi vài lần mỗi giây | Tạo path mới mỗi frame. Mỗi path bắt đầu từ vị trí của chính NPC, nên đường tới waypoint 1 khiến nó quay ngược lại. | Chỉ tính lại path khi mục tiêu đã di chuyển vài stud, không quá hai lần mỗi giây, và bắt đầu từ waypoint 2. |
| Khựng lại vài giây rồi mới đi tiếp | MoveToFinished:Wait() trên một waypoint không tới được sẽ chờ hết thời gian chờ 8 giây. | Dùng thời gian chờ riêng ngắn hơn và tính path mới khi hết giờ. |
Để xem ai đang sở hữu NPC, mở Visualization Options trong lúc playtest và bật Network owners. Các part do client của bạn mô phỏng có viền xanh lá; part của server hoặc của client khác có viền trắng hoặc xám.
Bước 4: Gây sát thương khi chạm vào người chơi (tùy chọn)
Với kẻ địch, thêm vào NPC một script thứ hai gây sát thương cho người chơi khi chạm. Nó chạy trên server, nên client của người chơi không thể đổi sát thương hay lách cooldown.
- Trong ChaseAI, đặt
STOP_DISTANCEbằng0để NPC đi sát vào người chơi thay vì dừng ở bên cạnh. - Chèn vào Chaser một Script tên
TouchDamagevà dán code bên dưới vào.
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 đã bị hạ không gây sát thương
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 kích hoạt nhiều lần mỗi giây khi các part chồng lên nhau
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 tính đến force field, nên người chơi an toàn khi force field sau lúc spawn vẫn còn. Để bỏ qua force field, hãy trừ Humanoid.Health trực tiếp.
Cooldown được lưu riêng cho từng người chơi. Touched kích hoạt nhiều lần mỗi giây khi các part cọ vào nhau, và không có cooldown thì một lần chạm có thể làm máu người chơi về 0 trong chớp mắt. Mục ghi bị xóa khi người chơi của nó thoát, nên bảng không phình ra suốt thời gian server chạy.
Để người chơi có thể đánh trả, hãy cho họ một thanh kiếm hoặc một khẩu súng dùng raycast. Cả hai đều gây sát thương trên server cho mọi thứ có Humanoid, nên cũng trúng được Chaser.
Modifier và link trong pathfinding
Mặc định path là lộ trình ngắn nhất và tránh nhảy khi có thể. Có ba cách để thay đổi điều này. Chi phí và modifier hoạt động với script đuổi theo như hiện tại, vì nó đã truyền bảng Costs vào CreatePath; còn link thì cần vài dòng code riêng.
Chi phí vật liệu
Khóa trong Costs có thể là tên vật liệu, ví dụ Water, Mud hoặc CrackedLava, áp dụng cho cả terrain và part. Mặc định mỗi vật liệu có chi phí 1. Số lớn hơn khiến NPC tránh vật liệu đó nếu đường vòng không tệ hơn, còn math.huge khiến nó không thể đi qua. Script đuổi theo đặt Water = 20.
Vùng cần tránh: PathfindingModifier
- Phủ vùng đó bằng một part bật Anchored và tắt CanCollide.
- Chèn vào part đó một PathfindingModifier và đặt
Labelcủa nó làDangerZone. - Vậy là xong. Script đuổi theo đã cho
DangerZonechi phímath.huge, nên NPC đi vòng qua vùng này. Bật Pathfinding modifiers trong Visualization Options để thấy nhãn trên lưới điều hướng.
Modifier bật PassThrough làm điều ngược lại: lộ trình đi xuyên qua một vật cản rắn, ví dụ cánh cửa đóng, như thể nó không tồn tại. NPC vẫn không đi xuyên qua cửa được, nhưng sẽ đi về phía cửa như thể nghe thấy người chơi ở phía bên kia.
Lối đi tùy chỉnh: PathfindingLink
PathfindingLink nối hai điểm mà bình thường NPC không đi qua được, ví dụ hai bờ sông mà nó qua bằng thuyền. Đặt một Attachment ở mỗi đầu, gán Attachment0 và Attachment1 cho link, đặt cho nó một Label, ví dụ UseBoat, và thêm UseBoat vào Costs với chi phí thấp hơn Water. Khi đó trong path sẽ có waypoint mang nhãn này: hãy kiểm tra waypoint.Label trong walkToNextWaypoint và chạy hành động riêng của bạn, ví dụ cho NPC lên thuyền, thay vì MoveTo. Link hoạt động theo cả hai chiều, trừ khi bạn tắt IsBidirectional.
Lỗi thường gặp và cách sửa
Trước tiên hãy xem cửa sổ Output. Mở nó từ menu Window hoặc trên tab Script. Các script trên trang này in cảnh báo khi yêu cầu path thất bại hoặc rig không di chuyển được.
NPC hoàn toàn không di chuyển
Nếu Output ghi NPC không thể di chuyển (cannot move), một phần của rig đang bị anchor: bỏ Anchored ở HumanoidRootPart và các part còn lại. Nếu không phải vậy, hãy kiểm tra code nằm trong Script chứ không phải LocalScript, nó nằm bên trong model trong Workspace và Humanoid chưa chết.
Output báo "Infinite yield possible" ở WaitForChild
Script đang chờ một object không tồn tại: Humanoid hoặc HumanoidRootPart có tên khác, hoặc thiếu part Goal cho script ở bước 2. Đổi tên object hoặc chuỗi trong script. Hướng dẫn lỗi script giải thích cảnh báo này.
Path không được tạo, hoặc NPC phớt lờ người chơi mà nó có thể tới được
Path.Status sau ComputeAsync là NoPath khi điểm đầu hoặc điểm cuối nằm trong part rắn, khi lộ trình duy nhất cần nhảy mà AgentCanJump là false, hoặc khi AgentHeight hay AgentRadius quá lớn so với khe hở trên đường. Tài liệu Roblox cũng có giới hạn cứng: không quá 3,000 stud theo đường thẳng từ đầu đến cuối và ngân sách tìm kiếm 20,000 node, có thể không đủ cho thế giới mở khổng lồ hoặc mê cung. Bật Navigation mesh để kiểm tra lộ trình.
NPC trượt đi mà không cử động chân
Đây là vấn đề animation, không phải pathfinding. Nhân vật người chơi tự động có script Animate, còn NPC cần script riêng để phát animation đi bộ. Mỗi NPC trong NPC kit của Roblox có một Script tên Animate mà bạn có thể xem để học. Cách tải và phát animation trên NPC từ Script server, xem phần animation trên NPC.
NPC bị kẹt ở góc hoặc nhảy nhưng không vượt qua vật cản
Tăng AgentRadius để lộ trình giữ xa tường hơn, nhất là với NPC to ngang. Nếu nó nhảy mà mãi không qua được, vật cản cao hơn mức Humanoid nhảy tới: tăng JumpHeight hoặc JumpPower của Humanoid, hoặc sửa lại màn chơi.
Sát thương khi chạm kích hoạt quá thường xuyên hoặc không bao giờ
Quá thường xuyên: không có cooldown, hoặc cooldown được lưu cho từng part chứ không phải cho từng người chơi. Không bao giờ: STOP_DISTANCE lớn hơn 0, nên NPC thường dừng lại trước khi chạm vào ai, hoặc người chơi vẫn còn force field sau lúc spawn.
Làm bằng RoCode
Nếu bạn thấy mô tả NPC dễ hơn tự tay dựng nó, RoCode có thể viết các script này trong place bạn đang mở. Đây là một AI agent độc lập cho Roblox Studio: bạn nhắn trong chat trên web, còn plugin của nó cho Studio tạo và sửa script trong Explorer của bạn.
Làm cho model Chaser trong Workspace đuổi theo người chơi gần nhất trong phạm vi 80 stud bằng pathfinding, đi về nhà khi xung quanh không có ai, và gây 10 sát thương khi chạm với cooldown 1 giây.
- Có thể xem trước model qua Get Properties và đọc các giá trị quan trọng, ví dụ Anchored trên các part của nó và WalkSpeed của Humanoid. Gõ / trong chat để đính kèm đường dẫn chính xác tới model
- Viết script đuổi theo và script sát thương bên trong model qua Create Script, và có thể bỏ Anchored qua Set Property nếu rig cần
- Kiểm tra cả hai script biên dịch được qua Check Script ngay trong Studio. Việc này bắt được lỗi biên dịch và những thứ như wait() thay vì task.wait(), nhưng không bắt được lỗi logic như lộ trình không bao giờ tới được người chơi
- Gửi thay đổi theo từng đợt, và mỗi đợt là một điểm undo trong lịch sử Studio
Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, còn với plugin 3.9.11 trở lên nó có thể điều khiển một nhân vật thử nghiệm để kiểm tra game chạy được, nhưng trong lúc chơi nó không chụp màn hình, nên hãy tự bấm Play và quan sát NPC. Nếu nó hoạt động không đúng, hãy kể cho RoCode những gì bạn thấy: Check Output có thể đọc các dòng Server và Client từ lần playtest gần nhất của bạn. NPC chỉ là một hệ thống trong nhiều hệ thống; xem cách làm cả một game Roblox bằng AI: phần lõi chơi được trước, rồi tới các round. RoCode kết nối với Studio như thế nào.
Câu hỏi thường gặp
Chạy pathfinding NPC ở đâu: trên server hay trên client?
Trên server, trong Script. Ví dụ pathfinding chính thức của Roblox chạy trong LocalScript, nhưng ở đó thứ di chuyển là nhân vật của chính người chơi. NPC dùng chung cho mọi người, và sát thương nó gây ra phải do server quyết định. Xem Script, LocalScript và ModuleScript.
Một server chịu được bao nhiêu NPC đuổi theo?
Tài liệu Roblox không đưa ra con số chính xác; nó phụ thuộc vào bản đồ và tần suất tính path. Tốn kém nhất là việc tính path, nên script đuổi theo giới hạn nó ở hai lần mỗi giây cho mỗi NPC và bỏ qua khi nhìn thấy người chơi. Với số lượng NPC lớn, khuyến nghị của Roblox về nơi đặt script là gắn tag cho chúng và xử lý qua CollectionService từ một ModuleScript, thay vì đặt script vào từng model.
Làm sao để NPC respawn sau khi chết?
Giữ một bản sao NPC trong ServerStorage và thực hiện respawn từ một script trong ServerScriptService, vì script bên trong NPC bị hủy cùng với nó. Khi sự kiện Died của Humanoid kích hoạt, chờ vài giây, hủy model cũ và đặt Clone() của bản sao vào Workspace. Script ChaseAI bên trong bản clone sẽ tự chạy, vì script server hoạt động ngay khi được đặt vào Workspace.
Có thể cho NPC chỉ đuổi người chơi trong lúc diễn ra round không?
Được. Hãy để script round của bạn clone NPC vào Workspace khi round bắt đầu và hủy chúng khi round kết thúc. Hướng dẫn hệ thống round dựng vòng lặp nghỉ và round để bạn gắn việc này vào.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Pathfinding (tiếng Anh). tham số agent, waypoint, path bị chắn, modifier, link và giới hạn
- Roblox Creator Docs: PathfindingService (tiếng Anh). CreatePath và các giá trị mặc định
- Roblox Creator Docs: Path (tiếng Anh). ComputeAsync, GetWaypoints, Status và sự kiện Blocked
- Roblox Creator Docs: Humanoid (tiếng Anh). MoveTo, thời gian chờ 8 giây của MoveToFinished, ChangeState và TakeDamage
- Roblox Creator Docs: Network ownership (tiếng Anh). quyền sở hữu tự động, SetNetworkOwner và chế độ Network owners
- Roblox Creator Docs: RaycastParams (tiếng Anh). ExcludeInstances và RespectCanCollide
- Roblox Creator Docs: NPC kit (tiếng Anh). các NPC mẫu với script Animate riêng
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.