Tutorial · Game systems

NPC pathfinding sa Roblox Studio: paano gumawa ng NPC na humahabol sa player

Para umikot ang NPC sa mga pader at maabot ang pinakamalapit na player, tatlong bagay ang kailangan: rig na kayang gumalaw, ruta mula sa PathfindingService, at loop na sumusunod sa ruta nang hindi nakikipag-away sa physics engine. Sa guide na ito, bubuuin natin ang tatlo, at sa dulo ay may isang server script ka na puwedeng ilagay lang sa rig ng NPC.

In-update Nobyembre 20, 202617 minutong basaIsinulat ni

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 Jump ang Action ng waypoint, at mag-compute ng bagong path kapag nag-fire ang Path.Blocked para sa waypoint sa unahan ng NPC.
  • Kapag direktang kita ang player, laktawan ang pathfinding at mag-MoveTo diretso sa kanya. Huminto nang ilang stud ang layo, o lumapit nang dikit kung nananakit ang NPC sa pagdikit.
Sa page na ito
  1. Paano gumagana ang pathfinding
  2. 1. Setup ng NPC
  3. 2. Lakad papunta sa punto
  4. 3. Chase script
  5. Paano gumagana ang paghabol
  6. Pag-ayos sa stutter
  7. 4. Touch damage
  8. Mga modifier at link
  9. Common errors
  10. With RoCode
  11. Mga madalas itanong
  12. Mga source at dagdag na babasahin

Paano gumagana ang NPC pathfinding

IlustrasyonNakakahanap ang Chaser ng daan paikot sa pader, tumatalon sa ledge at humihinto 4 studs mula sa iyo.

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.

Mga API na ginagamit ng guide na ito
APIAno 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.BlockedNagpa-fire kasama ang index ng waypoint kapag may humarang sa nakalkulang ruta.
Humanoid:MoveTo(position)Pinapalakad ang NPC papunta sa isang punto.
Humanoid.MoveToFinishedNagpa-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.

Ano ang kailangan ng NPC model
KailanganBakit ito mahalaga
Humanoid na pinangalanang HumanoidSa Humanoid kabilang ang MoveTo, WalkSpeed at ang pagtalon.
HumanoidRootPartAng part na kinokontrol ng Humanoid. Sa posisyon nito nagsisimula ang mga path.
Walang anchoredHindi 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.
  1. 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.
  2. I-rename ang rig sa Chaser at ilagay ito sa bukas na lugar.
  3. 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.
Explorer: ang NPC model sa dulo ng guide na ito
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.

  1. 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.
  2. Sa Explorer, i-hover ang Chaser, pindutin ang + button at mag-insert ng Script. Pangalanan itong WalkToGoal at i-paste ang code sa ibaba.
  3. Pindutin ang Play. Umiikot ang NPC sa pader at naglalakad papunta sa Goal part.
Script sa model na Chaser na pinangalanang 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

-- 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.

Agent parameters para sa CreatePath
KeyDefaultAno ang sine-set
AgentRadius2Radius ng NPC sa studs. Taasan ito para sa malalapad na NPC, para lumayo sa pader ang mga path.
AgentHeight5Taas ng NPC. Ang mga lugar na mas mababa rito, halimbawa sa ilalim ng hagdan, ay itinuturing na harang.
AgentCanJumptruePinapayagan ang mga rutang kailangang tumalon. Jump ang Action ng mga ganoong waypoint.
AgentCanClimbfalsePinapayagan ang pag-akyat sa TrussPart. May label na Climb ang mga ganoong waypoint.
WaypointSpacing4Layo sa studs sa pagitan ng mga intermediate waypoint. Tinatanggal sila ng math.huge.
CostswalaGaano 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.

  1. Burahin ang WalkToGoal sa Chaser kung idinagdag mo ito.
  2. I-hover ang Chaser, pindutin ang +, mag-insert ng Script na pinangalanang ChaseAI at i-paste ang code sa ibaba.
  3. 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.
Script sa model na Chaser na pinangalanang 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

-- 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.

Stutter sa pathfinding: mga sanhi at ayos
Ang nakikita moSanhiAyos
Makinis kapag mag-isa, paputol-putol kapag may player sa malapitNetwork 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 paderTinatawag 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 kantoFixed 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 segundoBagong 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 ulitHinihintay 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.

  1. Sa ChaseAI, gawing 0 ang STOP_DISTANCE para lumapit nang dikit ang NPC sa mga player sa halip na huminto sa tabi.
  2. Mag-insert sa Chaser ng Script na pinangalanang TouchDamage at i-paste ang code sa ibaba.
Script sa model na Chaser na pinangalanang 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 -- 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

  1. Takpan ang area ng part na naka-on ang Anchored at naka-off ang CanCollide.
  2. Mag-insert sa part na iyon ng PathfindingModifier at gawing DangerZone ang Label nito.
  3. Iyon lang. Binibigyan na ng chase script ang DangerZone ng cost na math.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.

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.

Ang tina-type 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.

Ang ginagawa ng RoCode
  • 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

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.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.