Sa madaling salita
Maglagay ng Script sa loob ng NPC model. Gumawa ng path gamit ang PathfindingService:CreatePath(), kalkulahin ito gamit ang path:ComputeAsync(start, goal) sa loob ng pcall, saka daanan ang mga waypoint isa-isa gamit ang Humanoid:MoveTo(), at hintayin ang MoveToFinished bago ang susunod. Para habulin ng NPC ang player, piliin ang pinakamalapit na character at i-recompute ang path kapag gumalaw ito nang ilang stud, hindi bawat frame.
- Kailangan ng Humanoid at ng HumanoidRootPart na hindi anchored. Tawagin ang
SetNetworkOwner(nil)sa root part para ang server ang mag-simulate nito: ito ang karaniwang ayos sa NPC na nag-i-stutter malapit sa mga player. - Tumalon kapag
JumpangActionng waypoint, at mag-compute ng bagong path kapag nag-fire angPath.Blockedpara sa waypoint sa unahan ng NPC. - Kapag direktang kita ang player, laktawan ang pathfinding at mag-
MoveTodiretso sa kanya. Huminto nang ilang stud ang layo, o lumapit nang dikit kung nananakit ang NPC sa pagdikit.
Sa page na ito
Paano gumagana ang NPC pathfinding
Bumubuo ang Roblox ng navigation mesh mula sa mga surface na kayang lakaran ng character. Naghahanap ang PathfindingService sa mesh na ito ng ruta sa pagitan ng dalawang punto at ibinabalik ito bilang listahan ng mga waypoint: bawat isa ay may posisyon at action, halimbawa paglalakad o pagtalon. Saka naglalakad ang Humanoid ng NPC mula sa isang waypoint papunta sa susunod. Nagpaplano lang ng ruta ang pathfinding: ang script mo ang dapat magpagalaw dito.
| API | Ano ang ginagawa |
|---|---|
PathfindingService:CreatePath() | Gumagawa ng Path object na puwedeng gamitin nang maraming beses, ayon sa laki ng NPC mo gamit ang agent parameters. |
Path:ComputeAsync(start, finish) | Kinakalkula ang ruta. Nagyi-yield ito at puwedeng pumalya, kaya tawagin ito sa loob ng pcall at i-check ang Path.Status. |
Path:GetWaypoints() | Ibinabalik ang ruta bilang array ng mga PathWaypoint value, bawat isa ay may Position, Action at Label. |
Path.Blocked | Nagpa-fire kasama ang index ng waypoint kapag may humarang sa nakalkulang ruta. |
Humanoid:MoveTo(position) | Pinapalakad ang NPC papunta sa isang punto. |
Humanoid.MoveToFinished | Nagpa-fire ng true kapag nasa mga isang stud na ang NPC mula sa punto, o ng false kung hindi ito nakarating sa loob ng 8 segundo. |
Patakbuhin ang lahat ng ito sa server Script: kita ng server ang buong map kahit may streaming, iisang NPC ang nakikita ng lahat ng player, at sa lugar na hindi kayang dayain ng client pinagpapasyahan ang damage. Ipinapaliwanag ng Script, LocalScript at ModuleScript ang hatiang ito.
Hakbang 1: NPC na kayang gumalaw
Kayang maglakad sa path ng kahit anong model kung meron itong tatlong bagay sa table sa ibaba. Minsan may kulang sa mga rig mula sa Toolbox o lumang place, at kadalasan ganito ang itsura: nakatayo lang ang NPC, at walang error.
| Kailangan | Bakit ito mahalaga |
|---|---|
Humanoid na pinangalanang Humanoid | Sa Humanoid kabilang ang MoveTo, WalkSpeed at ang pagtalon. |
HumanoidRootPart | Ang part na kinokontrol ng Humanoid. Sa posisyon nito nagsisimula ang mga path. |
| Walang anchored | Hindi gumagalaw ang anchored na part, pati ang mga part na nakakabit dito. Laging server ang may-ari ng mga anchored part, kaya hindi ito maaapektuhan ng ayos sa stutter na nasa ibaba. |
- Buksan ang Avatar o Home tab at pindutin ang Character para buksan ang Rig Generator. Piliin ang R15, tapos Block Avatar. May lalabas na rig sa Workspace. Gumagana rin ang mga R6 rig sa parehong mga script.
- I-rename ang rig sa
Chaserat ilagay ito sa bukas na lugar. - I-select ang HumanoidRootPart nito at siguraduhing naka-off ang Anchored sa Properties window. Gawin din ito sa kahit anong ibang anchored na part sa model. Para mabilis silang mahanap, i-on ang Anchored parts sa Visualization Options widget sa kanang itaas ng 3D viewport.
Workspace
Chaser Model
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (mga bahagi ng katawan)
ChaseAI Script new
TouchDamage Script new
Para makapagsalita rin ang NPC, nagdadagdag ang guide sa NPC dialogue ng Talk prompt na may mga pagpipiliang sagot at ipinapaliwanag kung ano ang nagbabago kapag naglalakad ang NPC. Para ipakita ang boss gamit ang camera bago ito magsimulang humabol, tingnan ang guide sa cutscene.
Hakbang 2: Papuntahin ang NPC sa isang punto
Magsimula sa pinakamaliit na gumaganang script: maglakad papunta sa isang part na hindi gumagalaw. Ipinapakita nito ang bawat bahagi ng pathfinding nang walang chase logic.
- Mag-insert ng Part sa Workspace, pangalanan itong
Goal, i-on ang Anchored, i-off ang CanCollide at ilagay ito sa sahig para kailangang umikot ng NPC sa isang pader. - Sa Explorer, i-hover ang Chaser, pindutin ang + button at mag-insert ng Script. Pangalanan itong
WalkToGoalat i-paste ang code sa ibaba. - Pindutin ang Play. Umiikot ang NPC sa pader at naglalakad papunta sa Goal part.
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
-- Dapat server ang may-ari ng physics ng NPC, kung hindi ay hindi gagana ang ChangeState (pagtalon) mula sa Script
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,
})
-- Nagyi-yield ang ComputeAsync at puwedeng mag-throw ng error, kaya nasa loob ito ng 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 -- ang unang waypoint ay kung saan nakatayo na ang NPC
end
humanoid:MoveTo(waypoint.Position)
if waypoint.Action == Enum.PathWaypointAction.Jump then
humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
end
-- Hintayin munang makarating ang NPC sa waypoint na ito bago pumunta sa susunod
local reached = humanoid.MoveToFinished:Wait()
if not reached then
warn(`{npc.Name} got stuck on the way to the goal`)
break
end
end
end
Naka-off ang CanCollide ng Goal part dahil hindi puwedeng magtapos ang path sa loob ng solid na part: magiging NoPath ang Status ng path.
Inilalarawan ng table na natatanggap ng CreatePath ang NPC (agent ang tawag dito ng Roblox), para umiwas ang ruta sa mga siwang na hindi nito kasya. Sine-set ng script sa itaas ang unang tatlong key sa mga default value nila, para makita kung saan sila babaguhin.
| Key | Default | Ano ang sine-set |
|---|---|---|
AgentRadius | 2 | Radius ng NPC sa studs. Taasan ito para sa malalapad na NPC, para lumayo sa pader ang mga path. |
AgentHeight | 5 | Taas ng NPC. Ang mga lugar na mas mababa rito, halimbawa sa ilalim ng hagdan, ay itinuturing na harang. |
AgentCanJump | true | Pinapayagan ang mga rutang kailangang tumalon. Jump ang Action ng mga ganoong waypoint. |
AgentCanClimb | false | Pinapayagan ang pag-akyat sa TrussPart. May label na Climb ang mga ganoong waypoint. |
WaypointSpacing | 4 | Layo sa studs sa pagitan ng mga intermediate waypoint. Tinatanggal sila ng math.huge. |
Costs | wala | Gaano kamahal daanan ang mga material at may label na area. Tingnan ang mga modifier at link. |
Dalawang detalye ang mahalaga sa loop. Ang unang waypoint ay ang posisyon mismo ng NPC, kaya nilalaktawan ito ng loop. At pagkatapos ng bawat MoveTo ay may MoveToFinished:Wait(): pinapalitan ng bagong MoveTo ang dating target, kaya ang loop na walang paghihintay ay magpapadiretso sa NPC sa huling waypoint, papunta mismo sa pader na dapat nitong ikutan.
Para sa pagtalon, Jump ang Action ng waypoint, at tinatawag ng script ang ChangeState(Enum.HumanoidStateType.Jumping). Sabi ng Roblox reference para sa Humanoid, kaya lang baguhin ng server script ang state kapag server ang may-ari ng physics ng character. Isa ito sa mga dahilan kung bakit sine-set muna ng script ang may-ari.
Sa page ng Roblox tungkol sa pathfinding, gumagalaw ang sariling character ng player gamit ang Humanoid:Move() na may check ng pagdating bawat frame, at tinatawag itong pinakamahusay na paraan para gabayan ang Humanoid sa path. Mas maikli at mas malinaw ang MoveTo na may MoveToFinished para sa server NPC, kaya ito ang gamit ng guide; kung kakailanganin mo ng mas eksaktong kontrol mamaya, pag-aralan ang official script.
Hakbang 3: Ang buong chase script
Ito ang script na hinahanap ng karamihan. Hinahabol ng NPC ang pinakamalapit na player sa loob ng 80 studs, umiikot sa mga pader, tumatalon kung saan kailangan ng ruta, naghahanap ng bagong ruta kapag may humarang, at umuuwi kapag walang tao sa paligid.
- Burahin ang
WalkToGoalsa Chaser kung idinagdag mo ito. - I-hover ang Chaser, pindutin ang +, mag-insert ng Script na pinangalanang
ChaseAIat i-paste ang code sa ibaba. - Pindutin ang Play, pumunta sa likod ng pader, tapos tumakbo palabas ng range. Iikot ang NPC sa pader para sundan ka, saka babalik kung saan ito nagsimula.
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
-- Mga setting (layo sa studs, oras sa segundo)
local DETECTION_RANGE = 80 -- hindi napapansin ng NPC ang mga player na mas malayo rito
local STOP_DISTANCE = 4 -- huminto sa ganitong layo mula sa target (0 = lumapit nang dikit, para sa touch damage)
local DIRECT_CHASE_RANGE = 30 -- mas malapit dito, nilalaktawan ang pathfinding kung walang harang
local REPATH_DISTANCE = 4 -- gaano kalayo dapat gumalaw ang target para ma-recompute ang path
local MIN_REPATH_INTERVAL = 0.5 -- huwag kailanman mag-compute ng path nang mas madalas dito
local WAYPOINT_TIMEOUT = 2 -- iwan ang path kung mas matagal dito ang isang waypoint
local CHASE_SPEED = 14 -- 16 ang default na bilis ng player, kaya kaya niyang takasan ang NPC na ito
local HOME_RADIUS = 4 -- ganito kalapit sa bahay ay bahay na
local RAY_HEIGHTS = { 0, -2 } -- line-of-sight ray sa taas ng baywang at malapit sa tuhod
local HOME = rootPart.Position -- kung saan bumabalik ang NPC kapag walang tao sa range
humanoid.WalkSpeed = CHASE_SPEED
-- Hayaang ang server ang mag-simulate sa NPC. Kung hindi, puwedeng ibigay ng Roblox ang physics nito sa device
-- ng player na malapit, at nag-i-stutter ang NPC kapag nagpapalit ang may-ari.
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, -- dumaan sa tubig para lang hindi umikot nang malayo
DangerZone = math.huge, -- huwag kailanman pumasok sa mga area na may label na DangerZone
},
})
-- Ang path na nilalakaran ngayon ng NPC
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge
-- Puwedeng mag-fire ang Blocked para sa waypoint na nadaanan na ng NPC. Ang harang lang sa unahan ang mahalaga.
path.Blocked:Connect(function(blockedIndex: number)
if blockedIndex >= nextIndex then
pathBlocked = true
end
end)
local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- hindi humaharang sa tingin ang mga part na walang bumabangga
local function clearPath()
waypoints = {}
nextIndex = 0
pathGoal = nil
end
local function stopMoving()
clearPath()
humanoid:MoveTo(rootPart.Position)
end
-- HumanoidRootPart ng pinakamalapit na buhay na player sa loob ng DETECTION_RANGE, o 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 kapag halos kapantay ang target at walang solid sa pagitan nila.
-- Hindi patunay ang malinis na ray na nalalakaran ang lupa, kaya sa malapit na layo lang ito.
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)
-- Ni-reset pagkatapos ng compute, para hindi markahan ng Blocked mula sa lumang ruta ang bago
pathBlocked = false
if ok and path.Status == Enum.PathStatus.Success then
waypoints = path:GetWaypoints()
nextIndex = 2 -- ang waypoint 1 ay kung saan nakatayo ang NPC
pathGoal = goal
else
if not ok then
warn(`{npc.Name}: path request failed: {err}`)
end
clearPath() -- wala pang ruta; susubok ulit ang main loop maya-maya
end
end
local function needsNewPath(goal: Vector3): boolean
if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
return false -- kaka-compute lang: sundan ang kasalukuyang path
end
local currentGoal = pathGoal
if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
return true
end
return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end
-- Hinihintay ang MoveToFinished, pero sumusuko pagkalipas ng timeout na segundo sa halip na ng built-in na 8,
-- para mabilis makakuha ng bagong path ang naipit na 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() -- naipit o naitulak palayo sa daan: mag-compute ng bagong path
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() -- sapat na ang lapit: tumayo sa tabi ng target
task.wait(0.2)
continue
end
if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
clearPath()
-- Kapag ipinasa rin ang part, sinusundan ito ng NPC habang gumagalaw ito
humanoid:MoveTo(targetRoot.Position, targetRoot)
task.wait(0.15)
continue
end
goal = targetRoot.Position
else
if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
stopMoving() -- walang tao sa paligid, at nasa bahay na ang 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) -- wala pang gumaganang path, halimbawa hindi maabot ang target
end
end
Nasa itaas ang lahat ng setting. Para sa ilang NPC, i-duplicate ang Chaser: bawat kopya ay nagpapatakbo ng sarili nitong ChaseAI at naaalala ang sarili nitong bahay. Ang mga lumang script ay nagfi-filter ng ray gamit ang FilterDescendantsInstances; ang Roblox reference ngayon ay nagrerekomenda ng ExcludeInstances para sa bagong trabaho, at iyon mismo ang gamit ng script na ito.
Paano gumagana ang chase script
Bawat ikot ng main loop ay gumagawa ng isang desisyon at isang maliit na aksyon: tumayo, humakbang diretso sa player, o lumakad sa susunod na waypoint. Walang desisyong lumalampas sa isang waypoint, kaya laging tumutugon ang NPC.
Paghahanap sa pinakamalapit na player
Dinadaanan ng findNearestTarget ang Players:GetPlayers(), nilalaktawan ang lahat ng walang character, buhay na Humanoid o HumanoidRootPart (mga player na nagre-respawn o umaalis), at ibinabalik ang pinakamalapit na root part sa loob ng DETECTION_RANGE. Ginagawa ang paghahanap sa bawat ikot, kaya kusang lumilipat ang NPC sa mas malapit na player, at ang player na umalis ay hindi na lang nahahanap: walang state kada player na kailangang linisin.
Pag-recompute ng path habang gumagalaw ang player, pero hindi bawat frame
Nagyi-yield ang pag-compute ng path at gumagastos ng oras ng server. Humihingi ang needsNewPath ng bagong path kapag walang path, tapos na o may harang ang luma, o lumayo ang player nang higit sa REPATH_DISTANCE studs mula sa dulo ng kasalukuyang path, at hindi kailanman mas maaga sa MIN_REPATH_INTERVAL segundo pagkatapos ng nauna. Habang kinakalkula ang path, patuloy na naglalakad ang NPC sa kasalukuyang waypoint, at sinisimulan ang bagong path mula sa waypoint 2, kaya hindi umiikot pabalik ang NPC sa lugar kung saan nagsimula ang path.
Mga path na may harang
Nagsasara ang mga pinto, nahuhulog ang mga part. Nagpa-fire ang Path.Blocked kasama ang index ng waypoint na may harang, na puwedeng nasa likod ng NPC, kaya tumutugon lang ang script kapag blockedIndex >= nextIndex: nagse-set ito ng flag, at nagko-compute ang loop ng bagong ruta. Ang waypoint na inaabot ng NPC nang higit sa WAYPOINT_TIMEOUT segundo, dahil naitulak ito o sumabit, ay nagsisimula rin ng bagong ruta.
Diretso sa nakikitang player
Hindi kailangan ang pathfinding kapag kita ang player sa bukas na lugar. Sa loob ng DIRECT_CHASE_RANGE, nagpapadala ang canSeeDirectly ng dalawang ray papunta sa player, sa taas ng baywang at malapit sa tuhod, para mapansin ang mabababang pader, at hindi nito pinapansin ang dalawang character. Kung walang tinamaan ang alinmang ray at halos kapantay ang player, tinatawag ng NPC ang MoveTo(targetRoot.Position, targetRoot). Pinapasunod ng pangalawang argument ang target kasabay ng player, at nire-reset ng pag-ulit ng call kada 0.15 segundo ang 8-segundong timeout.
Pinapatunayan ng malinis na ray na walang solid sa daan, pero hindi na may sahig doon. Kung may bangin o bitin sa map sa pagitan ng NPC at ng mga player, ibaba ang DIRECT_CHASE_RANGE o gawing 0 para laging gumamit ng pathfinding.
Paghinto sa tamang layo
Kapag mas malapit ang player kaysa STOP_DISTANCE, tinatawag ng NPC ang MoveTo sa sarili nitong posisyon, at iyon ang nagpapahinto rito. Bagay ang 4 studs sa NPC na dapat tumayo sa tabi ng player; para sa pet o kasamang nagpapanatili ng layo, gawing 6 o 8. Para sa kalabang nananakit sa pagdikit, gawing 0 para lumapit ito nang dikit, gaya sa hakbang 4.
Bakit nag-i-stutter ang NPC at paano ito aayusin
Kung nag-i-stutter ang NPC, natitigilan sa bawat waypoint o humahakbang paatras, kadalasan ay dahil sa isa sa mga nasa ibaba. Asikaso na ng chase script ang bawat isa; ang table ay para ayusin ang script na ikaw mismo ang sumulat.
| Ang nakikita mo | Sanhi | Ayos |
|---|---|---|
| Makinis kapag mag-isa, paputol-putol kapag may player sa malapit | Network ownership. Ibinibigay ng Roblox ang physics ng mga hindi anchored na part sa device ng player na malapit, kaya puwedeng sa device ng player na iyon ma-simulate ang NPC habang server ang nag-uutos, at puwedeng magmukhang putol ang bawat paglipat. | Tawagin nang isang beses ang SetNetworkOwner(nil) sa HumanoidRootPart mula sa server. Apektado nito ang lahat ng part na nakakabit dito. |
| Dumidiretso sa huling waypoint at sa mga pader | Tinatawag ang MoveTo para sa bawat waypoint sa loop nang walang paghihintay. Pinapalitan ng bawat call ang dating target. | Hintayin ang MoveToFinished bago lumipat sa susunod na waypoint. |
| Saglit na humihinto sa bawat waypoint o kumakaltas sa mga kanto | Fixed na task.wait() sa pagitan ng mga waypoint sa halip na hintayin ang pagdating. Kapag masyadong matagal, nakatayo ang NPC; kapag masyadong maikli, lumalaktaw ito pauna. | Hintayin ang MoveToFinished na may timeout. |
| Nag-i-stutter o humahakbang paatras nang ilang beses kada segundo | Bagong path bawat frame. Bawat isa ay nagsisimula sa posisyon mismo ng NPC, kaya pinapaikot ito pabalik ng daan papunta sa waypoint 1. | I-recompute lang ang path kapag gumalaw ang target nang ilang stud, hindi lalampas sa dalawang beses kada segundo, at magsimula sa waypoint 2. |
| Natitigilan nang ilang segundo, tapos tuloy ulit | Hinihintay ng MoveToFinished:Wait() sa hindi maabot na waypoint ang 8-segundong timeout. | Gumamit ng sarili mong mas maikling timeout at mag-compute ng bagong path kapag natapos ito. |
Para makita kung sino ang may-ari ng NPC, buksan ang Visualization Options habang nagpe-playtest at i-on ang Network owners. Ang mga part na sini-simulate ng client mo ay may berdeng outline; ang mga part ng server o ng ibang client ay may puti o abong outline.
Hakbang 4: Damage sa player kapag dumikit (optional)
Para sa kalaban, magdagdag sa NPC ng pangalawang script na nananakit sa mga player kapag dumikit. Tumatakbo ito sa server, kaya hindi kayang baguhin ng client ng player ang damage o lusutan ang cooldown.
- Sa ChaseAI, gawing
0angSTOP_DISTANCEpara lumapit nang dikit ang NPC sa mga player sa halip na huminto sa tabi. - Mag-insert sa Chaser ng Script na pinangalanang
TouchDamageat i-paste ang code sa ibaba.
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 -- hindi nananakit ang natalong 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 -- ilang beses kada segundo nagpa-fire ang Touched habang nagsasapawan ang mga part
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)
Isinasaalang-alang ng TakeDamage ang mga force field, kaya ligtas ang mga player habang may force field pa sila pagka-spawn. Para hindi pansinin ang mga force field, direktang bawasan ang Humanoid.Health.
Hiwalay na iniimbak ang cooldown para sa bawat player. Ilang beses kada segundo nagpa-fire ang Touched habang nagkikiskisan ang mga part, at kung walang cooldown, kayang ubusin ng isang dikit ang health ng player sa isang iglap. Binubura ang entry kapag umalis ang player nito, kaya hindi lumalaki ang table habang buhay ang server.
Para makalaban ang mga player, bigyan sila ng espada o ng baril na gumagamit ng raycast. Pareho silang nananakit sa server sa kahit anong may Humanoid, kaya tatamaan din nila ang Chaser.
Mga pathfinding modifier at link
By default, ang path ay ang pinakamaikling ruta na walang pagtalon kung posible. Tatlong paraan para baguhin ito. Gumagana ang mga cost at modifier sa chase script nang ganoon lang, dahil ipinapasa na nito ang Costs table sa CreatePath; ang mga link ay kailangan ng ilang sariling linya.
Cost ng mga material
Puwedeng maging key sa Costs ang mga pangalan ng material, halimbawa Water, Mud o CrackedLava, para sa terrain at para sa mga part. By default, 1 ang cost ng bawat material. Pinapaiwas ng mas mataas na numero ang NPC sa material na iyon kung hindi mas masama ang pag-ikot, at ginagawa itong hindi madadaanan ng math.huge. Sine-set ng chase script ang Water = 20.
Mga area na dapat iwasan: PathfindingModifier
- Takpan ang area ng part na naka-on ang Anchored at naka-off ang CanCollide.
- Mag-insert sa part na iyon ng PathfindingModifier at gawing
DangerZoneangLabelnito. - Iyon lang. Binibigyan na ng chase script ang
DangerZoneng cost namath.huge, kaya iniiwasan ng NPC ang area na ito. I-on ang Pathfinding modifiers sa Visualization Options para makita ang label sa navigation mesh.
Ang modifier na naka-on ang PassThrough ay gumagawa ng kabaligtaran: dumadaan ang ruta sa solid na harang, halimbawa sa saradong pinto, na parang wala ito. Hindi pa rin kayang tumagos ng NPC sa pinto, pero naglalakad ito papunta rito, na parang narinig nito ang player sa kabilang panig.
Sariling daanan: PathfindingLink
Ikinokonekta ng PathfindingLink ang dalawang punto na karaniwang hindi madadaanan ng NPC, halimbawa ang dalawang pampang ng ilog na tinatawid nito gamit ang bangka. Maglagay ng Attachment sa bawat dulo, i-set ang Attachment0 at Attachment1 ng link, bigyan ito ng Label, halimbawa UseBoat, at idagdag ang UseBoat sa Costs na may cost na mas mababa kaysa sa Water. Saka lalabas sa path ang waypoint na may label na iyon: i-check ang waypoint.Label sa walkToNextWaypoint at patakbuhin ang sarili mong aksyon, halimbawa isakay ang NPC sa bangka, sa halip na MoveTo. Gumagana ang mga link sa parehong direksyon maliban kung i-off ang IsBidirectional.
Mga karaniwang error at solusyon
Tingnan muna ang Output window. Nabubuksan ito mula sa Window menu o sa Script tab. Nagpi-print ng warning ang mga script sa page na ito kapag pumalya ang path request o hindi makagalaw ang rig.
Hindi gumagalaw ang NPC
Kung sinasabi ng Output na hindi makagalaw ang NPC (cannot move), may anchored na bahagi ang rig: i-off ang Anchored sa HumanoidRootPart at sa iba pang part. Kung hindi, siguraduhing nasa Script ang code, hindi sa LocalScript, na nasa loob ito ng model sa Workspace, at na hindi patay ang Humanoid.
Sinasabi ng Output ang "Infinite yield possible" sa WaitForChild
Naghihintay ang script ng object na wala: Humanoid o HumanoidRootPart na iba ang pangalan, o walang Goal part para sa script sa hakbang 2. I-rename ang object o ang linya sa script. Ipinapaliwanag ng guide sa mga error ng script ang warning na ito.
Hindi nabubuo ang path, o hindi pinapansin ng NPC ang player na kaya naman nitong abutin
NoPath ang Path.Status pagkatapos ng ComputeAsync kapag nasa loob ng solid na part ang simula o dulo, kapag kailangan ng pagtalon ang tanging ruta at false ang AgentCanJump, o kapag masyadong malaki ang AgentHeight o AgentRadius para sa siwang sa daan. May mahigpit na limitasyon din sa Roblox docs: hindi hihigit sa 3,000 studs nang tuwid mula simula hanggang dulo, at search budget na 20,000 node, na puwedeng kulangin sa napakalalaking open world o maze. I-on ang Navigation mesh para suriin ang ruta.
Dumudulas ang NPC at hindi gumagalaw ang mga binti
Problema ito ng animation, hindi ng pathfinding. Awtomatikong nakakakuha ng Animate script ang mga character ng player, pero kailangan ng NPC ng sariling script para patugtugin ang mga walking animation. Bawat NPC sa NPC kit ng Roblox ay may Script na pinangalanang Animate na puwede mong pag-aralan. Para sa pag-load at pagpapatugtog ng animation sa NPC mula sa server Script, tingnan ang section na animation sa NPC.
Naiipit ang NPC sa mga kanto, o tumatalon pero hindi nakakalampas sa harang
Taasan ang AgentRadius para lumayo sa mga pader ang mga ruta, lalo na para sa malalapad na NPC. Kung tumatalon ito pero hindi talaga nakakaakyat, mas mataas ang harang kaysa sa kayang talunin ng Humanoid: taasan ang JumpHeight o JumpPower ng Humanoid, o baguhin ang level.
Masyadong madalas o hindi kailanman nagti-trigger ang touch damage
Masyadong madalas: walang cooldown, o iniimbak ito kada part sa halip na kada player. Hindi kailanman: mas malaki sa 0 ang STOP_DISTANCE, kaya kadalasan humihinto ang NPC bago makadikit kahit kanino, o may force field pa ang player pagka-spawn.
Buuin ito gamit ang RoCode
Kung mas madali sa iyong ilarawan ang NPC kaysa buuin ito nang mano-mano, kayang isulat ng RoCode ang mga script na ito sa place na bukas mo. Isa itong independent na AI agent para sa Roblox Studio: nagsusulat ka sa web chat, at ang plugin nito para sa Studio ang gumagawa at nag-e-edit ng mga script sa Explorer mo.
Gawin mong habulin ng Chaser model sa Workspace ang pinakamalapit na player sa loob ng 80 studs gamit ang pathfinding, umuwi kapag walang tao sa paligid, at manakit ng 10 damage kapag dumikit na may 1 segundong cooldown.
- Puwedeng tingnan muna ang model gamit ang Get Properties at basahin ang mahahalagang value, gaya ng Anchored sa mga part nito at ng WalkSpeed ng Humanoid. I-type ang / sa chat para i-attach ang eksaktong path ng model
- Sumusulat ng chase at damage script sa loob ng model gamit ang Create Script, at kayang i-off ang Anchored gamit ang Set Property kung kailangan ng rig
- Chine-check ang compile ng dalawang script gamit ang Check Script mismo sa Studio. Nahuhuli nito ang mga compile error at mga bagay gaya ng wait() sa halip na task.wait(), pero hindi ang mga logic bug gaya ng rutang hindi kailanman nakakarating sa player
- Ipinapadala ang mga pagbabago nang batch-batch, at bawat batch ay isang undo point sa history ng Studio
Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, at sa plugin 3.9.11 o mas bago, kaya nitong kontrolin ang isang test character para suriin na gumagana ang game, pero hindi ito kumukuha ng screenshot habang naglalaro, kaya pindutin ang Play at tingnan mo mismo ang NPC. Kung hindi tama ang kilos nito, sabihin sa RoCode ang nakita mo: kayang basahin ng Check Output ang mga Server at Client line mula sa huli mong playtest. Isang system lang ang NPC sa marami; tingnan ang paano bumuo ng buong Roblox game gamit ang AI: playable na core muna, saka ang mga round. Paano kumokonekta ang RoCode sa Studio.
Mga madalas itanong
Saan dapat patakbuhin ang NPC pathfinding: sa server o sa client?
Sa server, sa Script. Tumatakbo sa LocalScript ang sariling pathfinding example ng Roblox, pero doon ang character mismo ng player ang gumagalaw. Pinaghahatian ng lahat ang NPC, at dapat server ang magpasya sa damage na ginagawa nito. Tingnan ang Script, LocalScript at ModuleScript.
Ilang humahabol na NPC ang kaya ng isang server?
Walang eksaktong numero sa Roblox docs; depende ito sa map at kung gaano kadalas kinakalkula ang mga path. Ang pag-compute ng path ang pinakamahal, kaya nililimitahan ito ng chase script sa dalawang beses kada segundo kada NPC at nilalaktawan kapag kita ang player. Para sa maraming NPC, pinapayo ng mga rekomendasyon ng Roblox tungkol sa kung saan ilalagay ang mga script na lagyan sila ng tag at hawakan gamit ang CollectionService mula sa isang ModuleScript, sa halip na maglagay ng script sa bawat model.
Paano mag-respawn ang NPC pagkamatay?
Mag-imbak ng kopya ng NPC sa ServerStorage, at gawin ang respawn mula sa script sa ServerScriptService, dahil nasisira kasama ng NPC ang script sa loob nito. Kapag nag-fire ang Died event ng Humanoid, maghintay ng ilang segundo, sirain ang lumang model at ilagay ang Clone() ng kopya sa Workspace. Kusang tatakbo ang ChaseAI script sa loob ng clone, dahil tumatakbo ang mga server script sa sandaling mapunta sila sa Workspace.
Puwede bang humabol lang ang mga NPC sa mga player habang may round?
Oo. Ipa-clone sa round script mo ang mga NPC papunta sa Workspace kapag nagsimula ang round, at ipasira sila kapag natapos ito. Binubuo ng guide sa round system ang loop ng intermission at round na kinakabitan nito.
Mga source at dagdag na babasahin
- Roblox Creator Docs: Pathfinding (sa English). agent parameters, mga waypoint, mga path na may harang, mga modifier, link at limitasyon
- Roblox Creator Docs: PathfindingService (sa English). CreatePath at mga default value
- Roblox Creator Docs: Path (sa English). ComputeAsync, GetWaypoints, Status at ang Blocked event
- Roblox Creator Docs: Humanoid (sa English). MoveTo, ang 8-segundong timeout ng MoveToFinished, ChangeState at TakeDamage
- Roblox Creator Docs: Network ownership (sa English). awtomatikong ownership, SetNetworkOwner at ang Network owners mode
- Roblox Creator Docs: RaycastParams (sa English). ExcludeInstances at RespectCanCollide
- Roblox Creator Docs: NPC kit (sa English). mga halimbawang NPC na may sariling Animate script
Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.