Οδηγός · Συστήματα παιχνιδιού

Pathfinding NPC στο Roblox Studio: πώς να κάνεις ένα NPC να ακολουθεί τον παίκτη

Για να παρακάμπτει ένα NPC τους τοίχους και να φτάνει στον πλησιέστερο παίκτη χρειάζονται τρία πράγματα: ένα rig που μπορεί να κινηθεί, μια διαδρομή από το PathfindingService και ένας βρόχος που ακολουθεί τη διαδρομή χωρίς να τσακώνεται με τη μηχανή φυσικής. Σε αυτόν τον οδηγό φτιάχνουμε και τα τρία και στο τέλος έχουμε ένα script server που απλώς το βάζετε μέσα στο rig του NPC.

Ενημερώθηκε 20 Νοεμβρίου 202617 λεπτά ανάγνωσηςΣυντάκτης:

Με λίγα λόγια

Βάλτε ένα Script μέσα στο μοντέλο του NPC. Δημιουργήστε μια διαδρομή με PathfindingService:CreatePath(), υπολογίστε τη με path:ComputeAsync(start, goal) μέσα σε pcall και μετά περάστε τα waypoints ένα ένα με Humanoid:MoveTo(), περιμένοντας το MoveToFinished πριν από το επόμενο. Για να κυνηγά το NPC τον παίκτη, διαλέγετε τον πλησιέστερο χαρακτήρα και ξαναϋπολογίζετε τη διαδρομή όταν αυτός μετακινηθεί μερικά studs, όχι σε κάθε frame.

  • Χρειάζεστε ένα Humanoid και ένα HumanoidRootPart που δεν είναι anchored. Καλέστε SetNetworkOwner(nil) στο root part ώστε να το προσομοιώνει ο server: αυτή είναι η συνηθισμένη διόρθωση για NPC που τρεμοπαίζει κοντά σε παίκτες.
  • Πηδήξτε όταν το Action του waypoint είναι Jump, και υπολογίστε νέα διαδρομή όταν το Path.Blocked ενεργοποιείται για waypoint μπροστά από το NPC.
  • Όταν ο παίκτης φαίνεται καθαρά, παραλείψτε το pathfinding και κάντε MoveTo κατευθείαν προς αυτόν. Σταματήστε λίγα studs πριν ή πηγαίνετε μέχρι επαφής αν το NPC κάνει ζημιά με το άγγιγμα.
Σε αυτή τη σελίδα
  1. Πώς λειτουργεί το pathfinding
  2. 1. Ρύθμιση του NPC
  3. 2. Περπάτημα σε σημείο
  4. 3. Script κυνηγητού
  5. Πώς λειτουργεί το κυνηγητό
  6. Τέλος στο τρεμόπαιγμα
  7. 4. Ζημιά με άγγιγμα
  8. Modifiers και links
  9. Common errors
  10. With RoCode
  11. Συχνές ερωτήσεις
  12. Πηγές και περαιτέρω ανάγνωση

Πώς λειτουργεί το pathfinding NPC

ΕικονογράφησηΤο Chaser βρίσκει διαδρομή γύρω από τον τοίχο, πηδά στο πεζούλι και σταματά 4 studs από εσάς.

Το Roblox χτίζει ένα πλέγμα πλοήγησης (navigation mesh) από τις επιφάνειες πάνω στις οποίες μπορεί να περπατήσει ένας χαρακτήρας. Το PathfindingService ψάχνει σε αυτό το πλέγμα μια διαδρομή ανάμεσα σε δύο σημεία και την επιστρέφει ως λίστα από waypoints: το καθένα έχει θέση και ενέργεια, για παράδειγμα περπάτημα ή άλμα. Μετά το Humanoid του NPC περπατά από το ένα waypoint στο επόμενο. Το pathfinding μόνο σχεδιάζει τη διαδρομή: την κίνηση πάνω της την κάνει το script σας.

Τα API που χρησιμοποιεί αυτός ο οδηγός
APIΤι κάνει
PathfindingService:CreatePath()Δημιουργεί ένα αντικείμενο Path που μπορείτε να ξαναχρησιμοποιείτε, στο μέγεθος του NPC σας μέσω των παραμέτρων agent.
Path:ComputeAsync(start, finish)Υπολογίζει τη διαδρομή. Κάνει yield και μπορεί να αποτύχει, γι' αυτό καλέστε το μέσα σε pcall και ελέγξτε το Path.Status.
Path:GetWaypoints()Επιστρέφει τη διαδρομή ως πίνακα τιμών PathWaypoint, η καθεμία με Position, Action και Label.
Path.BlockedΕνεργοποιείται με τον δείκτη του waypoint όταν κάτι κλείνει την υπολογισμένη διαδρομή.
Humanoid:MoveTo(position)Οδηγεί το NPC σε ένα σημείο.
Humanoid.MoveToFinishedΕνεργοποιείται με true όταν το NPC φτάσει περίπου ένα stud από το σημείο, ή με false αν δεν έφτασε μέσα σε 8 δευτερόλεπτα.

Τρέξτε όλα αυτά σε ένα Script server: ο server βλέπει όλο τον χάρτη ακόμη και με streaming, όλοι οι παίκτες βλέπουν το ίδιο NPC και η ζημιά αποφασίζεται εκεί όπου ο client δεν μπορεί να την πλαστογραφήσει. Το Script, LocalScript και ModuleScript εξηγεί αυτόν τον διαχωρισμό.

Βήμα 1: Ένα NPC που μπορεί να κινηθεί

Οποιοδήποτε μοντέλο μπορεί να περπατήσει σε μια διαδρομή αν έχει τα τρία πράγματα του παρακάτω πίνακα. Στα rigs από το Toolbox ή από παλιά places κάτι λείπει μερικές φορές, και συνήθως αυτό φαίνεται έτσι: το NPC στέκεται ακίνητο και δεν υπάρχει σφάλμα.

Τι χρειάζεται το μοντέλο του NPC
ΑπαίτησηΓιατί έχει σημασία
Humanoid με όνομα HumanoidΤα MoveTo, WalkSpeed και τα άλματα ανήκουν στο Humanoid.
HumanoidRootPartΤο part που ελέγχει το Humanoid. Οι διαδρομές ξεκινούν από τη θέση του.
Τίποτα anchoredΈνα anchored part δεν μπορεί να κινηθεί, ούτε και τα parts που είναι ενωμένα με αυτό. Τα anchored parts ανήκουν πάντα στον server, οπότε η διόρθωση για το τρεμόπαιγμα που περιγράφεται παρακάτω δεν εφαρμόζεται σε αυτά.
  1. Ανοίξτε την καρτέλα Avatar ή Home και πατήστε Character για να ανοίξει το Rig Generator. Διαλέξτε R15 και μετά Block Avatar. Ένα rig θα εμφανιστεί στο Workspace. Τα rigs R6 δουλεύουν με τα ίδια scripts.
  2. Μετονομάστε το rig σε Chaser και βάλτε το σε ανοιχτό χώρο.
  3. Επιλέξτε το HumanoidRootPart του και ελέγξτε ότι το Anchored στο παράθυρο Properties είναι απενεργοποιημένο. Κάντε το ίδιο για κάθε άλλο anchored part στο μοντέλο. Για να τα βρείτε γρήγορα, ενεργοποιήστε το Anchored parts στο widget Visualization Options πάνω δεξιά στο 3D viewport.
Explorer: το μοντέλο του NPC στο τέλος αυτού του οδηγού
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (μέρη του σώματος)
    ChaseAI Script new
    TouchDamage Script new

Για να μιλάει επίσης το NPC, ο οδηγός για διάλογο με NPC προσθέτει την ένδειξη Talk με επιλογές απάντησης και εξηγεί τι αλλάζει όταν το NPC περπατά. Για να δείξετε το boss με την κάμερα πριν ξεκινήσει το κυνηγητό, δείτε τον οδηγό για cutscenes.

Βήμα 2: Στέλνουμε το NPC σε ένα σημείο

Ξεκινήστε με το μικρότερο script που λειτουργεί: να φτάσει σε ένα ακίνητο part. Δείχνει κάθε στάδιο του pathfinding χωρίς τη λογική του κυνηγητού.

  1. Βάλτε ένα Part στο Workspace, ονομάστε το Goal, ενεργοποιήστε το Anchored, απενεργοποιήστε το CanCollide και τοποθετήστε το στο πάτωμα έτσι ώστε το NPC να πρέπει να παρακάμψει έναν τοίχο.
  2. Στο Explorer περάστε τον δείκτη πάνω από το Chaser, πατήστε το κουμπί + και βάλτε ένα Script. Ονομάστε το WalkToGoal και επικολλήστε τον παρακάτω κώδικα.
  3. Πατήστε Play. Το NPC παρακάμπτει τον τοίχο και περπατά προς το part Goal.
Script στο μοντέλο Chaser με όνομα WalkToGoal
local PathfindingService = game:GetService("PathfindingService")

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

-- Τη φυσική του NPC πρέπει να την κατέχει ο server, αλλιώς το ChangeState (άλμα) από 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,
})

-- Το ComputeAsync κάνει yield και μπορεί να πετάξει σφάλμα, γι' αυτό είναι μέσα σε 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 είναι το σημείο όπου ήδη στέκεται το NPC
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- Περιμένουμε να φτάσει το NPC σε αυτό το waypoint και μόνο μετά πάμε στο επόμενο
		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 έχει απενεργοποιημένο το CanCollide, επειδή μια διαδρομή δεν μπορεί να τελειώνει μέσα σε συμπαγές part: το Status της διαδρομής θα ήταν NoPath.

Ο πίνακας που παίρνει το CreatePath περιγράφει το NPC (το Roblox το λέει agent), ώστε η διαδρομή να αποφεύγει κενά από τα οποία δεν χωράει. Το παραπάνω script ορίζει τα τρία πρώτα κλειδιά στις προεπιλεγμένες τιμές τους, για να φαίνεται πού τα αλλάζετε.

Παράμετροι agent για το CreatePath
ΚλειδίΠροεπιλογήΤι ορίζει
AgentRadius2Η ακτίνα του NPC σε studs. Αυξήστε τη για φαρδιά NPC, ώστε οι διαδρομές να μένουν μακριά από τους τοίχους.
AgentHeight5Το ύψος του NPC. Σημεία χαμηλότερα από αυτό, για παράδειγμα κάτω από μια σκάλα, θεωρούνται κλειστά.
AgentCanJumptrueΕπιτρέπει διαδρομές που χρειάζονται άλμα. Σε αυτά τα waypoints το Action είναι Jump.
AgentCanClimbfalseΕπιτρέπει σκαρφάλωμα σε TrussPart. Αυτά τα waypoints έχουν την ετικέτα Climb.
WaypointSpacing4Η απόσταση σε studs ανάμεσα στα ενδιάμεσα waypoints. Το math.huge τα αφαιρεί.
CostsκανέναΠόσο ακριβό είναι να περάσει από υλικά και σημαδεμένες περιοχές. Δείτε modifiers και links.

Στον βρόχο έχουν σημασία δύο λεπτομέρειες. Το πρώτο waypoint είναι η θέση του ίδιου του NPC, γι' αυτό ο βρόχος το παραλείπει. Και μετά από κάθε MoveTo ακολουθεί MoveToFinished:Wait(): ένα νέο MoveTo αντικαθιστά τον προηγούμενο στόχο, οπότε ένας βρόχος χωρίς αναμονή στέλνει το NPC κατευθείαν στο τελευταίο waypoint, μέσα στον ίδιο τον τοίχο που έπρεπε να παρακάμψει.

Για τα άλματα το Action του waypoint είναι Jump και το script καλεί ChangeState(Enum.HumanoidStateType.Jumping). Η τεκμηρίωση του Roblox για το Humanoid λέει ότι ένα script server μπορεί να αλλάξει την κατάσταση μόνο όταν ο server κατέχει τη φυσική του χαρακτήρα. Αυτός είναι ένας από τους λόγους που το script ορίζει πρώτα τον κάτοχο.

Στη σελίδα του Roblox για το pathfinding, ο χαρακτήρας του ίδιου του παίκτη κινείται με Humanoid:Move() και έλεγχο άφιξης σε κάθε frame, και αυτό περιγράφεται ως ο καλύτερος τρόπος να οδηγήσετε ένα Humanoid σε διαδρομή. Το MoveTo με MoveToFinished είναι πιο σύντομο και πιο κατανοητό για NPC στον server, γι' αυτό ο οδηγός το χρησιμοποιεί· αν αργότερα χρειαστείτε πιο ακριβή έλεγχο, μελετήστε το επίσημο script.

Βήμα 3: Το πλήρες script κυνηγητού

Αυτό είναι το script που ψάχνουν οι περισσότεροι. Το NPC κυνηγά τον πλησιέστερο παίκτη σε απόσταση έως 80 studs, παρακάμπτει τοίχους, πηδά όπου το χρειάζεται η διαδρομή, βρίσκει νέα διαδρομή όταν κάτι την κλείνει και γυρίζει σπίτι όταν δεν υπάρχει κανείς κοντά.

  1. Διαγράψτε το WalkToGoal από το Chaser, αν το είχατε προσθέσει.
  2. Περάστε τον δείκτη πάνω από το Chaser, πατήστε +, βάλτε ένα Script με όνομα ChaseAI και επικολλήστε τον παρακάτω κώδικα.
  3. Πατήστε Play, πηγαίνετε πίσω από τον τοίχο και μετά τρέξτε έξω από την εμβέλεια. Το NPC παρακάμπτει τον τοίχο πίσω σας και μετά επιστρέφει εκεί από όπου ξεκίνησε.
Script στο μοντέλο Chaser με όνομα ChaseAI
local Players = game:GetService("Players")
local PathfindingService = game:GetService("PathfindingService")

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

-- Ρυθμίσεις (αποστάσεις σε studs, χρόνος σε δευτερόλεπτα)
local DETECTION_RANGE = 80 -- παίκτες πιο μακριά από αυτό το NPC δεν τους προσέχει
local STOP_DISTANCE = 4 -- σταματά σε αυτή την απόσταση από τον στόχο (0 = πάει μέχρι επαφής, για ζημιά με άγγιγμα)
local DIRECT_CHASE_RANGE = 30 -- πιο κοντά από αυτό παραλείπουμε το pathfinding αν δεν υπάρχει τίποτα στον δρόμο
local REPATH_DISTANCE = 4 -- πόσο πρέπει να μετακινηθεί ο στόχος για να ξαναϋπολογιστεί η διαδρομή
local MIN_REPATH_INTERVAL = 0.5 -- ποτέ μην υπολογίζεις διαδρομές πιο συχνά από αυτό
local WAYPOINT_TIMEOUT = 2 -- παράτα τη διαδρομή αν ένα waypoint πάρει περισσότερο από αυτό
local CHASE_SPEED = 14 -- ο παίκτης περπατά από προεπιλογή με ταχύτητα 16, άρα μπορεί να ξεφύγει από αυτό το NPC
local HOME_RADIUS = 4 -- τόσο κοντά στο σπίτι μετράει ήδη ως σπίτι
local RAY_HEIGHTS = { 0, -2 } -- ακτίνες οπτικής επαφής στο ύψος της μέσης και κοντά στα γόνατα

local HOME = rootPart.Position -- πού επιστρέφει το NPC όταν δεν υπάρχει κανείς στην εμβέλεια

humanoid.WalkSpeed = CHASE_SPEED

-- Ας προσομοιώνει ο server το NPC. Αλλιώς το Roblox μπορεί να δώσει τη φυσική του στη συσκευή
-- ενός κοντινού παίκτη, και το NPC τρεμοπαίζει όταν αλλάζει ο κάτοχος.
local canSetOwner, ownerProblem = rootPart:CanSetNetworkOwnership()
if not canSetOwner then
	warn(`{npc.Name} cannot move: {ownerProblem}. Untick Anchored on every part of the rig.`)
	return
end
rootPart:SetNetworkOwner(nil)

local path = PathfindingService:CreatePath({
	AgentRadius = 2,
	AgentHeight = 5,
	AgentCanJump = true,
	Costs = {
		Water = 20, -- περνά μέσα από νερό μόνο για να μην κάνει μεγάλο γύρο
		DangerZone = math.huge, -- ποτέ μην μπαίνεις σε περιοχές με την ετικέτα DangerZone
	},
})

-- Η διαδρομή που ακολουθεί το NPC αυτή τη στιγμή
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Το Blocked μπορεί να ενεργοποιηθεί για waypoint που το NPC έχει ήδη περάσει. Μετράει μόνο το εμπόδιο μπροστά.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- parts με τα οποία τίποτα δεν συγκρούεται δεν κρύβουν τη θέα

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

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

-- Το HumanoidRootPart του πλησιέστερου ζωντανού παίκτη μέσα στο DETECTION_RANGE ή nil
local function findNearestTarget(): BasePart?
	local nearestRoot: BasePart? = nil
	local nearestDistance = DETECTION_RANGE
	for _, player in Players:GetPlayers() do
		local character = player.Character
		local targetHumanoid = character and character:FindFirstChildOfClass("Humanoid")
		local targetRoot = character and character:FindFirstChild("HumanoidRootPart")
		if targetHumanoid and targetHumanoid.Health > 0 and targetRoot and targetRoot:IsA("BasePart") then
			local distance = (targetRoot.Position - rootPart.Position).Magnitude
			if distance < nearestDistance then
				nearestDistance = distance
				nearestRoot = targetRoot
			end
		end
	end
	return nearestRoot
end

-- true όταν ο στόχος είναι περίπου στο ίδιο επίπεδο και δεν υπάρχει τίποτα συμπαγές ανάμεσα.
-- Μια καθαρή ακτίνα δεν αποδεικνύει ότι το έδαφος περπατιέται, γι' αυτό ισχύει μόνο σε μικρή απόσταση.
local function canSeeDirectly(targetRoot: BasePart): boolean
	local offset = targetRoot.Position - rootPart.Position
	if math.abs(offset.Y) > 3 then
		return false
	end
	local character = targetRoot.Parent
	rayParams.ExcludeInstances = if character then { npc, character } else { npc }
	for _, height in RAY_HEIGHTS do
		local origin = rootPart.Position + Vector3.new(0, height, 0)
		if workspace:Raycast(origin, offset, rayParams) then
			return false
		end
	end
	return true
end

local function computePath(goal: Vector3)
	lastComputeTime = os.clock()
	local ok, err = pcall(function()
		path:ComputeAsync(rootPart.Position, goal)
	end)
	-- Μηδενίζουμε μετά τον υπολογισμό, ώστε ένα Blocked από την παλιά διαδρομή να μη σημαδέψει τη νέα
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- το waypoint 1 είναι εκεί όπου στέκεται το NPC
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- δεν υπάρχει διαδρομή ακόμη· ο κύριος βρόχος θα ξαναδοκιμάσει σύντομα
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- μόλις υπολογίσαμε: συνεχίζουμε στην τρέχουσα διαδρομή
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- Περιμένει το MoveToFinished, αλλά τα παρατάει μετά από timeout δευτερόλεπτα αντί για τα ενσωματωμένα 8,
-- ώστε ένα κολλημένο NPC να πάρει γρήγορα νέα διαδρομή
local function waitForMoveToFinished(timeout: number): boolean
	local finished = false
	local reachedGoal = false
	local connection = humanoid.MoveToFinished:Connect(function(reached: boolean)
		finished = true
		reachedGoal = reached
	end)
	local deadline = os.clock() + timeout
	while not finished and os.clock() < deadline do
		task.wait()
	end
	connection:Disconnect()
	return reachedGoal
end

local function walkToNextWaypoint()
	local waypoint = waypoints[nextIndex]
	humanoid:MoveTo(waypoint.Position)
	if waypoint.Action == Enum.PathWaypointAction.Jump then
		humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
	end
	if waitForMoveToFinished(WAYPOINT_TIMEOUT) then
		nextIndex += 1
	else
		clearPath() -- κόλλησε ή το έσπρωξαν εκτός πορείας: υπολογίζουμε νέα διαδρομή
	end
end

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

	if targetRoot then
		local distance = (targetRoot.Position - rootPart.Position).Magnitude
		if distance <= STOP_DISTANCE then
			stopMoving() -- αρκετά κοντά: στεκόμαστε δίπλα στον στόχο
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Αν περάσουμε και το part, το NPC το ακολουθεί όσο αυτό κινείται
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- κανείς κοντά, και το NPC είναι ήδη σπίτι
			task.wait(0.5)
			continue
		end
		goal = HOME
	end

	if needsNewPath(goal) then
		computePath(goal)
	end

	if nextIndex >= 2 and nextIndex <= #waypoints then
		walkToNextWaypoint()
	else
		task.wait(0.1) -- δεν υπάρχει ακόμη διαδρομή που λειτουργεί, για παράδειγμα ο στόχος είναι απρόσιτος
	end
end

Όλες οι ρυθμίσεις είναι στην αρχή. Για πολλά NPC αντιγράψτε το Chaser: κάθε αντίγραφο τρέχει το δικό του ChaseAI και θυμάται το δικό του σπίτι. Τα παλιά scripts φιλτράρουν τις ακτίνες με FilterDescendantsInstances· η τεκμηρίωση του Roblox προτείνει πλέον για νέα δουλειά το ExcludeInstances, και αυτό το script χρησιμοποιεί ακριβώς αυτό.

Πώς λειτουργεί το script κυνηγητού

Κάθε πέρασμα του κύριου βρόχου παίρνει μία απόφαση και κάνει μία μικρή ενέργεια: να σταθεί, να κάνει ένα βήμα κατευθείαν προς τον παίκτη ή να πάει στο επόμενο waypoint. Τίποτα δεν αποφασίζεται για περισσότερο από ένα waypoint, οπότε το NPC αντιδρά συνεχώς.

Εύρεση του πλησιέστερου παίκτη

Η findNearestTarget περνά από το Players:GetPlayers(), παραλείπει όποιον δεν έχει χαρακτήρα, ζωντανό Humanoid ή HumanoidRootPart (παίκτες που κάνουν respawn ή βγαίνουν) και επιστρέφει το πλησιέστερο root part μέσα στο DETECTION_RANGE. Η αναζήτηση γίνεται σε κάθε πέρασμα, οπότε το NPC αλλάζει μόνο του σε πιο κοντινό παίκτη, και ένας παίκτης που βγήκε απλώς δεν βρίσκεται πια: δεν υπάρχει κατάσταση ανά παίκτη που πρέπει να καθαριστεί.

Επανυπολογισμός της διαδρομής όσο ο παίκτης κινείται, αλλά όχι σε κάθε frame

Ο υπολογισμός διαδρομής κάνει yield και ξοδεύει χρόνο του server. Η needsNewPath ζητά νέα διαδρομή μόνο όταν δεν υπάρχει διαδρομή, η παλιά τελείωσε ή έκλεισε, ή ο παίκτης απομακρύνθηκε περισσότερο από REPATH_DISTANCE studs από το τέλος της τρέχουσας διαδρομής, και ποτέ νωρίτερα από MIN_REPATH_INTERVAL δευτερόλεπτα μετά την προηγούμενη. Όσο υπολογίζεται η διαδρομή, το NPC συνεχίζει προς το τρέχον waypoint, και η νέα διαδρομή ακολουθείται από το waypoint 2, οπότε το NPC δεν γυρίζει πίσω προς το σημείο όπου ξεκίνησε η διαδρομή.

Κλειστές διαδρομές

Οι πόρτες κλείνουν, τα parts πέφτουν. Το Path.Blocked ενεργοποιείται με τον δείκτη του κλειστού waypoint, που μπορεί να είναι πίσω από το NPC, γι' αυτό το script αντιδρά μόνο όταν blockedIndex >= nextIndex: σηκώνει μια σημαία και ο βρόχος υπολογίζει νέα διαδρομή. Ένα waypoint στο οποίο το NPC χρειάζεται περισσότερο από WAYPOINT_TIMEOUT δευτερόλεπτα για να φτάσει, επειδή το έσπρωξαν ή σκάλωσε, ξεκινά επίσης νέα διαδρομή.

Κατευθείαν προς τον ορατό παίκτη

Το pathfinding δεν χρειάζεται όταν ο παίκτης φαίνεται σε ανοιχτό χώρο. Μέσα στο DIRECT_CHASE_RANGE η συνάρτηση canSeeDirectly ρίχνει δύο ακτίνες προς τον παίκτη, στο ύψος της μέσης και κοντά στα γόνατα, για να πιάσει χαμηλούς τοίχους, και αγνοεί και τους δύο χαρακτήρες. Αν καμία ακτίνα δεν χτύπησε τίποτα και ο παίκτης είναι περίπου στο ίδιο επίπεδο, το NPC καλεί MoveTo(targetRoot.Position, targetRoot). Το δεύτερο όρισμα κάνει τον στόχο να κινείται μαζί με τον παίκτη, και η επανάληψη της κλήσης κάθε 0.15 δευτερόλεπτα μηδενίζει συνεχώς το χρονικό όριο των 8 δευτερολέπτων.

Μια καθαρή ακτίνα αποδεικνύει ότι δεν υπάρχει τίποτα συμπαγές στον δρόμο, όχι όμως ότι υπάρχει πάτωμα. Αν ο χάρτης έχει χάσματα ή γκρεμούς ανάμεσα στο NPC και τους παίκτες, μειώστε το DIRECT_CHASE_RANGE ή βάλτε 0 για να χρησιμοποιείται πάντα pathfinding.

Σταμάτημα στη σωστή απόσταση

Όταν ο παίκτης είναι πιο κοντά από το STOP_DISTANCE, το NPC καλεί MoveTo στη δική του θέση, και αυτό το σταματά. Τα 4 studs ταιριάζουν σε NPC που πρέπει να στέκεται δίπλα στον παίκτη· για κατοικίδιο ή συνοδό που κρατά απόσταση, βάλτε 6 ή 8. Για εχθρό που χτυπά με το άγγιγμα, βάλτε 0 ώστε να πηγαίνει μέχρι επαφής, όπως στο βήμα 4.

Γιατί τρεμοπαίζει το NPC και πώς να το διορθώσετε

Αν το NPC τρεμοπαίζει, παγώνει σε κάθε waypoint ή κάνει βήματα προς τα πίσω, η αιτία είναι συνήθως ένα από τα παρακάτω. Το script κυνηγητού λαμβάνει ήδη υπόψη το καθένα· ο πίνακας χρησιμεύει για να διορθώσετε ένα script που γράψατε μόνοι σας.

Τρεμόπαιγμα στο pathfinding: αιτίες και διορθώσεις
Τι βλέπετεΑιτίαΔιόρθωση
Ομαλά όταν είναι μόνο του, με τινάγματα όταν υπάρχει παίκτης κοντάNetwork ownership. Το Roblox δίνει τη φυσική των parts που δεν είναι anchored στη συσκευή ενός κοντινού παίκτη, οπότε το NPC μπορεί να προσομοιώνεται στη συσκευή αυτού του παίκτη ενώ τις εντολές τις δίνει ο server, και κάθε παράδοση μπορεί να μοιάζει με τίναγμα.Καλέστε μία φορά SetNetworkOwner(nil) στο HumanoidRootPart από τον server. Αυτό ισχύει για όλα τα parts που είναι ενωμένα με αυτό.
Πηγαίνει κατευθείαν στο τελευταίο waypoint και πέφτει σε τοίχουςΤο MoveTo καλείται για κάθε waypoint σε βρόχο χωρίς αναμονή. Κάθε κλήση αντικαθιστά τον προηγούμενο στόχο.Περιμένετε το MoveToFinished πριν περάσετε στο επόμενο waypoint.
Σταματά για λίγο σε κάθε waypoint ή κόβει γωνίεςΣταθερό task.wait() ανάμεσα στα waypoints αντί για αναμονή άφιξης. Πολύ μεγάλο, και το NPC στέκεται· πολύ μικρό, και πηδά μπροστά.Περιμένετε το MoveToFinished με χρονικό όριο.
Τρεμοπαίζει ή κάνει βήματα πίσω πολλές φορές το δευτερόλεπτοΝέα διαδρομή σε κάθε frame. Η καθεμία ξεκινά από τη θέση του ίδιου του NPC, οπότε η διαδρομή προς το waypoint 1 το γυρίζει πίσω.Ξαναϋπολογίζετε τη διαδρομή μόνο όταν ο στόχος μετακινηθεί μερικά studs, όχι πάνω από δύο φορές το δευτερόλεπτο, και ξεκινάτε από το waypoint 2.
Παγώνει για μερικά δευτερόλεπτα και μετά συνεχίζειΤο MoveToFinished:Wait() σε απρόσιτο waypoint περιμένει το χρονικό όριο των 8 δευτερολέπτων.Χρησιμοποιήστε δικό σας, μικρότερο χρονικό όριο και υπολογίστε νέα διαδρομή όταν λήξει.

Για να δείτε ποιος κατέχει το NPC, ανοίξτε τα Visualization Options στη διάρκεια ενός playtest και ενεργοποιήστε το Network owners. Τα parts που προσομοιώνει ο δικός σας client παίρνουν πράσινο περίγραμμα· τα parts του server ή άλλου client έχουν λευκό ή γκρι περίγραμμα.

Βήμα 4: Ζημιά στους παίκτες με το άγγιγμα (προαιρετικά)

Για εχθρό, προσθέστε στο NPC ένα δεύτερο script που κάνει ζημιά στους παίκτες όταν τους αγγίζει. Τρέχει στον server, οπότε ο client του παίκτη δεν μπορεί να αλλάξει τη ζημιά ή να παρακάμψει το cooldown.

  1. Στο ChaseAI ορίστε το STOP_DISTANCE σε 0, ώστε το NPC να πηγαίνει μέχρι επαφής με τους παίκτες αντί να σταματά δίπλα τους.
  2. Βάλτε στο Chaser ένα Script με όνομα TouchDamage και επικολλήστε τον παρακάτω κώδικα.
Script στο μοντέλο Chaser με όνομα TouchDamage
local Players = game:GetService("Players")

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

local DAMAGE = 10
local COOLDOWN_SECONDS = 1

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

local function onTouched(hit: BasePart)
	if humanoid.Health <= 0 then
		return -- ένα νικημένο NPC δεν κάνει ζημιά
	end
	local character = hit:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	local targetHumanoid = character and character:FindFirstChildOfClass("Humanoid")
	if not player or not targetHumanoid or targetHumanoid.Health <= 0 then
		return
	end

	local now = os.clock()
	local last = lastHit[player]
	if last and now - last < COOLDOWN_SECONDS then
		return -- το Touched ενεργοποιείται πολλές φορές το δευτερόλεπτο όσο τα parts επικαλύπτονται
	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 λαμβάνει υπόψη τα force fields, οπότε οι παίκτες είναι ασφαλείς όσο διαρκεί το force field μετά το spawn. Για να αγνοήσετε τα force fields, μειώνετε απευθείας το Humanoid.Health.

Το cooldown κρατιέται χωριστά για κάθε παίκτη. Το Touched ενεργοποιείται πολλές φορές το δευτερόλεπτο όσο τα parts τρίβονται μεταξύ τους, και χωρίς cooldown ένα άγγιγμα θα μπορούσε να μηδενίσει την υγεία του παίκτη σε μια στιγμή. Η εγγραφή διαγράφεται όταν ο παίκτης της βγαίνει, οπότε ο πίνακας δεν μεγαλώνει όσο ζει ο server.

Για να μπορούν οι παίκτες να αμυνθούν, δώστε τους ένα σπαθί ή ένα όπλο με raycast. Και τα δύο κάνουν ζημιά στον server σε ό,τι έχει Humanoid, οπότε θα χτυπήσουν και το Chaser.

Modifiers και links του pathfinding

Από προεπιλογή η διαδρομή είναι η συντομότερη, χωρίς άλματα όπου είναι δυνατό. Μπορείτε να το αλλάξετε με τρεις τρόπους. Τα κόστη και οι modifiers δουλεύουν με το script κυνηγητού όπως είναι, επειδή αυτό περνά ήδη έναν πίνακα Costs στο CreatePath· τα links χρειάζονται μερικές δικές σας γραμμές.

Κόστος υλικών

Κλειδιά στο Costs μπορούν να είναι ονόματα υλικών, για παράδειγμα Water, Mud ή CrackedLava, τόσο για το terrain όσο και για parts. Από προεπιλογή κάθε υλικό κοστίζει 1. Ένας μεγαλύτερος αριθμός κάνει το NPC να παρακάμπτει αυτό το υλικό αν ο γύρος δεν είναι χειρότερος, και το math.huge το κάνει αδιάβατο. Το script κυνηγητού ορίζει Water = 20.

Περιοχές προς αποφυγή: PathfindingModifier

  1. Καλύψτε την περιοχή με ένα part με ενεργοποιημένο το Anchored και απενεργοποιημένο το CanCollide.
  2. Βάλτε σε αυτό το part έναν PathfindingModifier και ορίστε το Label του σε DangerZone.
  3. Αυτό ήταν. Το script κυνηγητού δίνει ήδη στο DangerZone κόστος math.huge, οπότε το NPC παρακάμπτει αυτή την περιοχή. Ενεργοποιήστε το Pathfinding modifiers στα Visualization Options για να δείτε την ετικέτα στο πλέγμα πλοήγησης.

Ένας modifier με ενεργοποιημένο το PassThrough κάνει το αντίθετο: η διαδρομή περνά μέσα από ένα συμπαγές εμπόδιο, για παράδειγμα μια κλειστή πόρτα, σαν να μην υπάρχει. Το NPC και πάλι δεν μπορεί να περάσει μέσα από την πόρτα, αλλά πηγαίνει προς αυτήν σαν να άκουσε τον παίκτη από την άλλη πλευρά.

Ένα PathfindingLink ενώνει δύο σημεία ανάμεσα στα οποία το NPC κανονικά δεν μπορεί να περάσει, για παράδειγμα τις όχθες ενός ποταμού που το διασχίζει με βάρκα. Βάλτε ένα Attachment σε κάθε άκρη, ορίστε στο link τα Attachment0 και Attachment1, δώστε του ένα Label, για παράδειγμα UseBoat, και προσθέστε το UseBoat στο Costs με κόστος χαμηλότερο από του Water. Τότε στη διαδρομή θα εμφανιστεί ένα waypoint με αυτή την ετικέτα: ελέγχετε το waypoint.Label στη walkToNextWaypoint και τρέχετε τη δική σας ενέργεια, για παράδειγμα βάζετε το NPC στη βάρκα, αντί για MoveTo. Τα links δουλεύουν και προς τις δύο κατευθύνσεις, εκτός αν απενεργοποιήσετε το IsBidirectional.

Συνηθισμένα λάθη και λύσεις

Ελέγξτε πρώτα το παράθυρο Output. Ανοίγει από το μενού Window ή από την καρτέλα Script. Τα scripts σε αυτή τη σελίδα βγάζουν προειδοποίηση όταν το αίτημα διαδρομής αποτύχει ή όταν το rig δεν μπορεί να κινηθεί.

Το NPC δεν κινείται καθόλου

Αν το Output γράφει ότι το NPC δεν μπορεί να κινηθεί (cannot move), ένα μέρος του rig είναι anchored: απενεργοποιήστε το Anchored στο HumanoidRootPart και στα υπόλοιπα parts. Αν όχι, ελέγξτε ότι ο κώδικας είναι σε Script και όχι σε LocalScript, ότι βρίσκεται μέσα στο μοντέλο στο Workspace και ότι το Humanoid δεν έχει πεθάνει.

Το Output γράφει "Infinite yield possible" στο WaitForChild

Το script περιμένει ένα αντικείμενο που δεν υπάρχει: Humanoid ή HumanoidRootPart με άλλο όνομα, ή το part Goal λείπει για το script του βήματος 2. Μετονομάστε το αντικείμενο ή τη γραμμή στο script. Ο οδηγός για σφάλματα scripts εξηγεί αυτή την προειδοποίηση.

Η διαδρομή δεν υπολογίζεται, ή το NPC αγνοεί έναν παίκτη στον οποίο θα μπορούσε να φτάσει

Το Path.Status μετά το ComputeAsync είναι NoPath όταν η αρχή ή το τέλος είναι μέσα σε συμπαγές part, όταν η μόνη διαδρομή χρειάζεται άλμα και το AgentCanJump είναι false, ή όταν το AgentHeight ή το AgentRadius είναι πολύ μεγάλο για ένα κενό στη διαδρομή. Η τεκμηρίωση του Roblox έχει και αυστηρά όρια: όχι πάνω από 3 000 studs σε ευθεία από την αρχή ως το τέλος και προϋπολογισμό αναζήτησης 20 000 κόμβων, που μπορεί να μη φτάνει για τεράστιους ανοιχτούς κόσμους ή λαβύρινθους. Ενεργοποιήστε το Navigation mesh για να ελέγξετε τη διαδρομή.

Το NPC γλιστράει και δεν κουνάει τα πόδια

Αυτό είναι πρόβλημα animation, όχι pathfinding. Οι χαρακτήρες των παικτών παίρνουν αυτόματα το script Animate, ενώ ένα NPC χρειάζεται δικό του script για να παίζει τα animations περπατήματος. Κάθε NPC του NPC kit του Roblox έχει ένα Script με όνομα Animate που μπορείτε να μελετήσετε. Πώς να φορτώσετε και να παίξετε ένα animation σε NPC από Script server, δείτε στην ενότητα animation σε NPC.

Το NPC κολλάει στις γωνίες ή πηδά αλλά δεν περνά πάνω από το εμπόδιο

Αυξήστε το AgentRadius ώστε οι διαδρομές να μένουν πιο μακριά από τους τοίχους, ειδικά για φαρδιά NPC. Αν πηδά αλλά δεν καταφέρνει να περάσει, το εμπόδιο είναι ψηλότερο από όσο μπορεί να πηδήξει το Humanoid: αυξήστε το JumpHeight ή το JumpPower του Humanoid ή αλλάξτε την πίστα.

Η ζημιά με άγγιγμα ενεργοποιείται πολύ συχνά ή ποτέ

Πολύ συχνά: δεν υπάρχει cooldown, ή κρατιέται για κάθε part αντί για κάθε παίκτη. Ποτέ: το STOP_DISTANCE είναι μεγαλύτερο από 0, οπότε το NPC συνήθως σταματά πριν αγγίξει κάποιον, ή ο παίκτης έχει ακόμη το force field μετά το spawn.

Φτιάξτε το με το RoCode

Αν σας είναι πιο εύκολο να περιγράψετε το NPC παρά να το φτιάξετε με το χέρι, το RoCode μπορεί να γράψει αυτά τα scripts στο place που έχετε ανοιχτό. Είναι ανεξάρτητος πράκτορας AI για το Roblox Studio: γράφετε στο web chat και το plugin του για το Studio δημιουργεί και επεξεργάζεται scripts στο Explorer σας.

Εσείς γράφετε

Κάνε το μοντέλο Chaser στο Workspace να κυνηγά τον πλησιέστερο παίκτη σε απόσταση έως 80 studs με pathfinding, να γυρίζει σπίτι όταν δεν υπάρχει κανείς κοντά και να κάνει 10 ζημιά με το άγγιγμα με cooldown 1 δευτερολέπτου.

Το RoCode κάνει
  • Μπορεί πρώτα να εξετάσει το μοντέλο με Get Properties και να διαβάσει βασικές τιμές, για παράδειγμα το Anchored στα parts του και το WalkSpeed του Humanoid. Πληκτρολογήστε / στη συνομιλία για να επισυνάψετε την ακριβή διαδρομή προς το μοντέλο
  • Γράφει τα scripts κυνηγητού και ζημιάς μέσα στο μοντέλο με Create Script και μπορεί να απενεργοποιήσει το Anchored με Set Property, αν το χρειάζεται το rig
  • Ελέγχει τη μεταγλώττιση και των δύο scripts με Check Script απευθείας στο Studio. Αυτό πιάνει σφάλματα μεταγλώττισης και πράγματα όπως wait() αντί για task.wait(), αλλά όχι λογικά bugs, όπως μια διαδρομή που δεν φτάνει ποτέ στον παίκτη
  • Στέλνει τις αλλαγές σε δέσμες, και κάθε δέσμη είναι σημείο αναίρεσης στο ιστορικό του Studio

Με το plugin 3.9 ή νεότερο το RoCode μπορεί να τρέξει ένα σύντομο playtest και να διαβάσει τα σφάλματα, και με το plugin 3.9.11 ή νεότερο μπορεί να χειριστεί έναν δοκιμαστικό χαρακτήρα για να ελέγξει ότι το παιχνίδι λειτουργεί, αλλά στη διάρκεια του παιχνιδιού δεν βγάζει στιγμιότυπα, οπότε πατήστε Play και δείτε το NPC μόνοι σας. Αν δεν συμπεριφέρεται σωστά, πείτε στο RoCode τι είδατε: το Check Output μπορεί να διαβάσει τις γραμμές Server και Client από το τελευταίο σας playtest. Το NPC είναι ένα σύστημα ανάμεσα σε πολλά· δείτε πώς να φτιάξετε ένα ολόκληρο παιχνίδι Roblox με AI: πρώτα ένας πυρήνας που παίζεται, μετά οι γύροι. Πώς συνδέεται το RoCode με το Studio.

Συχνές ερωτήσεις

Πού τρέχει το pathfinding NPC: στον server ή στον client;

Στον server, σε Script. Το δικό του παράδειγμα pathfinding του Roblox τρέχει σε LocalScript, αλλά εκεί κινείται ο χαρακτήρας του ίδιου του παίκτη. Ένα NPC είναι κοινό για όλους, και τη ζημιά που κάνει πρέπει να την αποφασίζει ο server. Δείτε Script, LocalScript και ModuleScript.

Πόσα NPC με κυνηγητό αντέχει ένας server;

Η τεκμηρίωση του Roblox δεν δίνει ακριβή αριθμό· εξαρτάται από τον χάρτη και από το πόσο συχνά υπολογίζονται διαδρομές. Το πιο ακριβό είναι ο υπολογισμός της διαδρομής, γι' αυτό το script κυνηγητού τον περιορίζει σε δύο φορές το δευτερόλεπτο ανά NPC και τον παραλείπει όταν ο παίκτης φαίνεται. Για μεγάλο αριθμό NPC, οι συστάσεις του Roblox για το πού να κρατάτε scripts προτείνουν να τα σημαδεύετε με tags και να τα χειρίζεστε μέσω CollectionService από ένα ModuleScript, αντί να βάζετε script σε κάθε μοντέλο.

Πώς κάνω το NPC να κάνει respawn μετά τον θάνατο;

Κρατήστε ένα αντίγραφο του NPC στο ServerStorage και κάντε το respawn από ένα script στο ServerScriptService, επειδή ένα script μέσα στο NPC καταστρέφεται μαζί του. Όταν ενεργοποιηθεί το event Died του Humanoid, περιμένετε λίγα δευτερόλεπτα, καταστρέψτε το παλιό μοντέλο και βάλτε ένα Clone() του αντιγράφου στο Workspace. Το script ChaseAI μέσα στον κλώνο θα ξεκινήσει μόνο του, επειδή τα scripts server τρέχουν μόλις βρεθούν στο Workspace.

Μπορώ να κάνω τα NPC να κυνηγούν παίκτες μόνο στη διάρκεια ενός γύρου;

Ναι. Αφήστε το script γύρων σας να κλωνοποιεί τα NPC στο Workspace όταν ξεκινά ο γύρος και να τα καταστρέφει όταν τελειώνει. Ο οδηγός για σύστημα γύρων φτιάχνει τον κύκλο διαλείμματος και γύρου στον οποίο συνδέεται αυτό.

Πηγές και περαιτέρω ανάγνωση

Πώς ελέγχθηκε ο κώδικας: κάθε script σε αυτή τη σελίδα περνά αυστηρό έλεγχο τύπων Luau με τους ορισμούς του Roblox API (luau-lsp, 20 Νοεμβρίου 2026). Ο έλεγχος τύπων πιάνει λάθη σε ονόματα API και λάθος τύπους, όχι όμως λάθη στη λογική του παιχνιδιού, γι' αυτό δοκιμάστε τα πάντα στο Studio πριν τη δημοσίευση.

Δοκιμάστε το RoCode στο παιχνίδι σας.

Δωρεάν credits κάθε μέρα, χωρίς κάρτα. Εγκαταστήστε το plugin, περιγράψτε μια λειτουργία και δείτε τι εμφανίζεται στο Studio.