Tutorial · Spielsysteme

Roblox NPC Pathfinding: einen NPC Spielern folgen und sie jagen lassen

Ein NPC, der um Wände herumläuft, um den nächsten Spieler zu erreichen, braucht drei Dinge: ein Rig, das sich bewegen kann, eine Route von PathfindingService und eine Schleife, die der Route folgt, ohne gegen die Physik-Engine zu kämpfen. Dieser Guide baut alle drei und endet mit einem einzigen Server-Skript, das du einfach in ein NPC-Rig legen kannst.

Aktualisiert am 14. November 202616 Min. LesezeitGeschrieben von

Kurz gesagt

Leg ein Script in das NPC-Model. Erstell einen Pfad mit PathfindingService:CreatePath(), berechne ihn mit path:ComputeAsync(start, goal) in einem pcall und lauf dann die Waypoints einzeln mit Humanoid:MoveTo() ab, wobei du vor dem nächsten jeweils auf MoveToFinished wartest. Um einen Spieler zu jagen, nimm den nächsten Charakter und berechne den Pfad neu, wenn er sich ein paar Studs bewegt hat, nicht in jedem Frame.

  • Der NPC braucht einen Humanoid und einen nicht verankerten HumanoidRootPart. Ruf SetNetworkOwner(nil) am Root-Part auf, damit der Server ihn simuliert: Das ist die übliche Lösung für einen NPC, der in der Nähe von Spielern ruckelt.
  • Spring, wenn die Action eines Waypoints Jump ist, und berechne einen neuen Pfad, wenn Path.Blocked für einen Waypoint vor dem NPC feuert.
  • Wenn der Spieler frei sichtbar ist, lass das Pathfinding weg und ruf MoveTo direkt auf ihn auf. Halt ein paar Studs vorher an, oder lauf weiter, wenn der NPC bei Berührung Schaden macht.
Auf dieser Seite
  1. So funktioniert Pathfinding
  2. 1. NPC einrichten
  3. 2. Zu einem Punkt laufen
  4. 3. Jagd-Skript
  5. So funktioniert die Jagd
  6. Ruckeln beheben
  7. 4. Berührungsschaden
  8. Modifier und Links
  9. Häufige Fehler
  10. Mit RoCode
  11. Häufige Fragen
  12. Quellen und weiterführende Links

So funktioniert NPC-Pathfinding

IllustrationDer Chaser findet einen Weg um die Wand, springt auf den Absatz und bleibt 4 Studs vor dir stehen.

Roblox baut ein Navigation Mesh aus den Flächen, auf denen ein Charakter laufen könnte. PathfindingService sucht auf diesem Mesh eine Route zwischen zwei Punkten und gibt sie als Liste von Waypoints zurück, jeder eine Position plus eine Aktion wie Laufen oder Springen. Der Humanoid des NPCs läuft dann von einem Waypoint zum nächsten. Pathfinding plant nur die Route: Sich auf ihr zu bewegen ist die Aufgabe deines Skripts.

Die APIs, die dieser Guide nutzt
APIWas sie macht
PathfindingService:CreatePath()Erstellt ein wiederverwendbares Path-Objekt, über Agent-Parameter an die Größe deines NPCs angepasst.
Path:ComputeAsync(start, finish)Berechnet die Route. Sie yieldet und kann fehlschlagen, also ruf sie in einem pcall auf und prüf Path.Status.
Path:GetWaypoints()Gibt die Route als Array von PathWaypoint-Werten zurück, jeder mit Position, Action und Label.
Path.BlockedFeuert mit einem Waypoint-Index, wenn etwas die berechnete Route blockiert.
Humanoid:MoveTo(position)Lässt den NPC auf einen Punkt zulaufen.
Humanoid.MoveToFinishedFeuert mit true, wenn der NPC bis auf etwa einen Stud an den Punkt herankommt, oder mit false, wenn er nach 8 Sekunden nicht angekommen ist.

Führ das alles in einem Server-Script aus: Der Server sieht die ganze Map auch mit eingeschaltetem Streaming, jeder Spieler sieht denselben NPC, und Schaden wird dort entschieden, wo ein Client ihn nicht fälschen kann. Script vs LocalScript vs ModuleScript (auf Englisch) erklärt die Aufteilung.

Schritt 1: Einen NPC einrichten, der sich bewegen kann

Jedes Model kann einem Pfad folgen, wenn es die drei Dinge unten hat. Rigs aus der Toolbox oder aus älteren Spielen fehlt manchmal eins davon, und das übliche Symptom ist ein NPC, der ohne Fehlermeldung stillsteht.

Was das NPC-Model braucht
VoraussetzungWarum sie wichtig ist
Ein Humanoid mit dem Namen HumanoidMoveTo, WalkSpeed und Springen gehören alle zum Humanoid.
Ein HumanoidRootPartDer Part, den der Humanoid steuert. Pfade starten an seiner Position.
Nichts verankertEin verankerter Part kann sich nicht bewegen, und die Parts, die mit ihm verbunden sind, auch nicht. Verankerte Parts gehören immer dem Server, also lässt sich die Ruckel-Lösung unten bei ihnen nicht anwenden.
  1. Öffne den Tab Avatar oder Home und klick auf Character, um den Rig Generator zu öffnen. Wähl R15 und dann Block Avatar. Ein Rig erscheint in Workspace. R6-Rigs funktionieren mit denselben Skripten.
  2. Benenn das Rig in Chaser um und stell es auf freien Boden.
  3. Wähl seinen HumanoidRootPart aus und prüf im Properties-Fenster, dass Anchored aus ist. Mach dasselbe für jeden anderen verankerten Part im Model. Um sie schnell zu finden, schalte Anchored parts im Widget Visualization Options oben rechts im 3D-Viewport ein.
Explorer: das NPC-Model am Ende dieses Guides
Workspace
  Chaser Model
    Humanoid Humanoid
    HumanoidRootPart Part
    Head, UpperTorso, LowerTorso ... (the body parts)
    ChaseAI Script new
    TouchDamage Script new

Damit der NPC auch spricht, fügt der NPC-Dialog-Guide einen Talk-Prompt mit Antworten zum Auswählen hinzu und erklärt, was sich ändert, wenn der NPC läuft. Um einen Boss mit der Kamera zu zeigen, bevor er die Jagd beginnt, sieh dir den Cutscene-Guide an.

Schritt 2: Den NPC zu einem Punkt laufen lassen

Fang mit dem kleinsten Skript an, das funktioniert: zu einem festen Part laufen. Es zeigt jede Stufe des Pathfindings ohne die Jagd-Logik.

  1. Füg einen Part in Workspace ein, nenn ihn Goal, schalte Anchored ein und CanCollide aus und leg ihn so auf den Boden, dass der NPC um eine Wand herumlaufen muss, um ihn zu erreichen.
  2. Fahr im Explorer mit der Maus über Chaser, klick auf den +-Button und füg ein Script ein. Nenn es WalkToGoal und füg den Code unten ein.
  3. Drück auf Play. Der NPC läuft um die Wand herum zum Goal-Part.
Script in dem Model Chaser namens 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

-- Der Server muss die Physik des NPCs besitzen, damit ChangeState (Springen) aus einem Script funktioniert
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 yieldet und kann einen Fehler werfen, deshalb steht es in einem 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 -- der erste Waypoint ist die Stelle, an der der NPC schon steht
		end
		humanoid:MoveTo(waypoint.Position)
		if waypoint.Action == Enum.PathWaypointAction.Jump then
			humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
		end
		-- Warten, bis dieser Waypoint erreicht ist, bevor es zum nächsten geht
		local reached = humanoid.MoveToFinished:Wait()
		if not reached then
			warn(`{npc.Name} got stuck on the way to the goal`)
			break
		end
	end
end

Der Goal-Part hat CanCollide aus, weil ein Pfad nicht in einem festen Part enden kann: Der Status des Pfads wäre dann NoPath.

Die Tabelle, die an CreatePath geht, beschreibt den NPC, den Roblox den Agent nennt, damit die Route Lücken meidet, durch die er nicht passt. Das Skript oben setzt die ersten drei Keys auf ihre Standardwerte, damit du siehst, wo du sie änderst.

Agent-Parameter für CreatePath
KeyStandardWas er steuert
AgentRadius2Der Radius des NPCs in Studs. Erhöh ihn für breite NPCs, damit Pfade Abstand zu Wänden halten.
AgentHeight5Die Höhe des NPCs. Räume, die niedriger sind, zum Beispiel unter Treppen, zählen als blockiert.
AgentCanJumptrueErlaubt Routen, die einen Sprung brauchen. Diese Waypoints haben Action auf Jump.
AgentCanClimbfalseErlaubt das Klettern an TrussParts. Diese Waypoints haben das Label Climb.
WaypointSpacing4Abstand in Studs zwischen den Zwischen-Waypoints. math.huge entfernt sie.
CostskeineWie teuer es ist, Materialien und gelabelte Bereiche zu durchqueren. Siehe Modifier und Links.

Zwei Details in der Schleife sind wichtig. Der erste Waypoint ist die eigene Position des NPCs, also überspringt die Schleife ihn. Und auf jedes MoveTo folgt MoveToFinished:Wait(): Ein neues MoveTo ersetzt das vorherige Ziel, also schickt eine Schleife, die nicht wartet, den NPC direkt zum letzten Waypoint, mitten in die Wand, um die er herumlaufen soll.

Bei Sprüngen ist die Action des Waypoints Jump, und das Skript ruft ChangeState(Enum.HumanoidStateType.Jumping) auf. Die Humanoid-Referenz von Roblox weist darauf hin, dass ein Server-Skript einen State nur ändern kann, wenn der Server die Physik des Charakters besitzt, ein Grund, warum das Skript zuerst den Network Owner setzt.

Die Pathfinding-Seite von Roblox bewegt den eigenen Charakter eines Spielers mit Humanoid:Move() und einer Ankunftsprüfung in jedem Frame und nennt das den besten Weg, einen Humanoid entlang eines Pfads zu bewegen. MoveTo mit MoveToFinished ist für einen Server-NPC kürzer und leichter nachzuvollziehen, also nutzt dieser Guide das; schau dir das offizielle Skript an, wenn du später feinere Kontrolle brauchst.

Schritt 3: Das komplette Jagd-Skript

Das ist das Skript, das die meisten suchen. Der NPC jagt den nächsten Spieler innerhalb von 80 Studs, läuft um Wände herum, springt, wo die Route es braucht, findet eine neue Route, wenn etwas sie blockiert, und läuft nach Hause, wenn niemand in der Nähe ist.

  1. Lösch WalkToGoal aus Chaser, falls du es hinzugefügt hast.
  2. Fahr mit der Maus über Chaser, klick auf +, füg ein Script mit dem Namen ChaseAI ein und füg den Code unten ein.
  3. Drück auf Play, lauf hinter eine Wand und renn dann aus der Reichweite. Der NPC folgt dir um die Wand herum und kehrt dann zu seinem Startpunkt zurück.
Script in dem Model Chaser namens 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

-- Einstellungen (Entfernungen in Studs, Zeiten in Sekunden)
local DETECTION_RANGE = 80 -- Spieler, die weiter weg sind, werden ignoriert
local STOP_DISTANCE = 4 -- so nah am Ziel anhalten (0 = in das Ziel hineinlaufen, für Berührungsschaden)
local DIRECT_CHASE_RANGE = 30 -- innerhalb dieser Reichweite Pathfinding überspringen, wenn nichts im Weg ist
local REPATH_DISTANCE = 4 -- wie weit sich das Ziel bewegen muss, bevor der Pfad neu berechnet wird
local MIN_REPATH_INTERVAL = 0.5 -- Pfade nie öfter als in diesem Abstand berechnen
local WAYPOINT_TIMEOUT = 2 -- einen Pfad aufgeben, wenn ein Waypoint länger dauert als das
local CHASE_SPEED = 14 -- ein Spieler läuft standardmäßig mit 16, also kann er diesem NPC davonlaufen
local HOME_RADIUS = 4 -- so nah am Zuhause zählt als zu Hause
local RAY_HEIGHTS = { 0, -2 } -- Sichtlinien-Rays auf Hüfthöhe und knapp über den Knien

local HOME = rootPart.Position -- wohin der NPC zurückgeht, wenn niemand in Reichweite ist

humanoid.WalkSpeed = CHASE_SPEED

-- Den Server den NPC simulieren lassen. Sonst kann Roblox seine Physik an das Gerät
-- eines Spielers in der Nähe übergeben, und der NPC ruckelt bei jedem Wechsel.
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, -- nur durch Wasser waten, um einen langen Umweg zu vermeiden
		DangerZone = math.huge, -- niemals Bereiche mit dem Label DangerZone betreten
	},
})

-- Der Pfad, dem der NPC gerade folgt
local waypoints: { PathWaypoint } = {}
local nextIndex = 0
local pathGoal: Vector3? = nil
local pathBlocked = false
local lastComputeTime = -math.huge

-- Blocked kann für einen Waypoint feuern, den der NPC schon passiert hat. Nur eine Blockade vor ihm zählt.
path.Blocked:Connect(function(blockedIndex: number)
	if blockedIndex >= nextIndex then
		pathBlocked = true
	end
end)

local rayParams = RaycastParams.new()
rayParams.RespectCanCollide = true -- Parts, mit denen nichts kollidieren kann, verdecken die Sicht nicht

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

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

-- Der HumanoidRootPart des nächsten lebenden Spielers innerhalb von DETECTION_RANGE, oder 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, wenn das Ziel ungefähr auf derselben Höhe ist und nichts Festes dazwischen liegt.
-- Ein freier Ray beweist nicht, dass man auf dem Boden laufen kann, deshalb gilt das nur auf kurze Distanz.
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)
	-- Nach dem Berechnen zurücksetzen, damit ein Blocked-Event der alten Route die neue nicht markiert
	pathBlocked = false
	if ok and path.Status == Enum.PathStatus.Success then
		waypoints = path:GetWaypoints()
		nextIndex = 2 -- Waypoint 1 ist die Stelle, an der der NPC steht
		pathGoal = goal
	else
		if not ok then
			warn(`{npc.Name}: path request failed: {err}`)
		end
		clearPath() -- gerade keine Route; die Hauptschleife versucht es gleich wieder
	end
end

local function needsNewPath(goal: Vector3): boolean
	if os.clock() - lastComputeTime < MIN_REPATH_INTERVAL then
		return false -- gerade erst berechnet: dem aktuellen Pfad weiter folgen
	end
	local currentGoal = pathGoal
	if currentGoal == nil or pathBlocked or nextIndex > #waypoints then
		return true
	end
	return (goal - currentGoal).Magnitude > REPATH_DISTANCE
end

-- Wartet auf MoveToFinished, gibt aber nach `timeout` Sekunden auf statt nach den
-- eingebauten 8, damit ein festhängender NPC schnell einen neuen Pfad bekommt
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() -- hängt fest oder wurde vom Kurs geschoben: einen frischen Pfad berechnen
	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() -- nah genug: neben dem Ziel bleiben
			task.wait(0.2)
			continue
		end
		if distance <= DIRECT_CHASE_RANGE and canSeeDirectly(targetRoot) then
			clearPath()
			-- Wenn auch der Part übergeben wird, folgt der NPC ihm, während er sich bewegt
			humanoid:MoveTo(targetRoot.Position, targetRoot)
			task.wait(0.15)
			continue
		end
		goal = targetRoot.Position
	else
		if (HOME - rootPart.Position).Magnitude <= HOME_RADIUS then
			stopMoving() -- niemand in der Nähe und schon zu Hause
			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) -- noch kein brauchbarer Pfad, zum Beispiel weil das Ziel unerreichbar ist
	end
end

Alle Einstellungen stehen oben. Für mehr NPCs duplizierst du Chaser: Jede Kopie führt ihr eigenes ChaseAI aus und merkt sich ihr eigenes Zuhause. Ältere Skripte filtern Rays mit FilterDescendantsInstances; die Referenz von Roblox empfiehlt für neue Arbeit jetzt ExcludeInstances, und das nutzt dieses Skript.

So funktioniert das Jagd-Skript

Jeder Durchlauf der Hauptschleife trifft eine Entscheidung und macht dann eine kleine Sache: stehen bleiben, direkt auf den Spieler zugehen oder zum nächsten Waypoint laufen. Nichts wird länger als für einen Waypoint festgelegt, also reagiert der NPC ständig.

Den nächsten Spieler finden

findNearestTarget geht Players:GetPlayers() durch, überspringt alle ohne Charakter, ohne lebenden Humanoid oder ohne HumanoidRootPart (Spieler, die gerade respawnen oder das Spiel verlassen) und gibt den nächsten Root-Part innerhalb von DETECTION_RANGE zurück. Die Suche läuft in jedem Durchlauf, also wechselt der NPC von selbst zu einem näheren Spieler, und ein Spieler, der das Spiel verlässt, wird einfach nicht mehr gefunden: Es gibt keine Daten pro Spieler, die aufgeräumt werden müssen.

Neu berechnen, während sich der Spieler bewegt, aber nicht in jedem Frame

Einen Pfad zu berechnen yieldet und kostet Serverzeit. needsNewPath fordert nur dann einen an, wenn es keinen Pfad gibt, der alte fertig oder blockiert ist oder sich der Spieler mehr als REPATH_DISTANCE Studs vom Ende des aktuellen Pfads entfernt hat, und nie innerhalb von MIN_REPATH_INTERVAL Sekunden nach dem letzten. Während er rechnet, läuft der NPC weiter zu seinem aktuellen Waypoint, und dem neuen Pfad folgt er ab Waypoint 2, damit er nicht zu der Stelle umkehrt, an der der Pfad begann.

Blockierte Pfade

Türen gehen zu und Parts fallen herunter. Path.Blocked feuert mit dem Index des blockierten Waypoints, der auch hinter dem NPC liegen kann, also reagiert das Skript nur bei blockedIndex >= nextIndex: Es setzt ein Flag, und die Schleife berechnet eine neue Route. Ein Waypoint, der länger als WAYPOINT_TIMEOUT Sekunden braucht, weil der NPC geschoben wurde oder hängen geblieben ist, löst ebenfalls eine neue Route aus.

Direkt auf einen sichtbaren Spieler zu

Pathfinding ist verschwendet, wenn der Spieler frei sichtbar auf offenem Gelände steht. Innerhalb von DIRECT_CHASE_RANGE schießt canSeeDirectly zwei Rays auf den Spieler, auf Hüfthöhe und knapp über den Knien, um niedrige Mauern zu erwischen, und ignoriert dabei beide Charaktere. Trifft keiner etwas und ist der Spieler ungefähr auf derselben Höhe, ruft der NPC MoveTo(targetRoot.Position, targetRoot) auf. Das zweite Argument lässt das Ziel mit dem Spieler mitwandern, und der Aufruf alle 0,15 Sekunden setzt das 8-Sekunden-Timeout immer wieder zurück.

Ein freier Ray beweist, dass nichts Festes im Weg ist, nicht dass es Boden zum Laufen gibt. Hat deine Map Lücken oder Abgründe zwischen dem NPC und den Spielern, senk DIRECT_CHASE_RANGE, oder setz es auf 0, damit immer Pathfinding genutzt wird.

Im richtigen Abstand anhalten

Ist der Spieler innerhalb von STOP_DISTANCE, ruft der NPC MoveTo auf seine eigene Position auf, was ihn anhält. 4 Studs passen für einen NPC, der neben einem Spieler stehen soll; erhöh auf 6 oder 8 für ein Pet oder einen Begleiter, der etwas Abstand hält. Für einen Gegner, der bei Berührung Schaden macht, setz es auf 0, damit er in den Spieler hineinläuft, wie in Schritt 4.

Warum NPCs ruckeln und wie du es behebst

Ein NPC, der ruckelt, an jedem Waypoint pausiert oder nach hinten zuckt, hat meistens eine der Ursachen unten. Das Jagd-Skript behandelt jede davon schon; die Tabelle ist dafür da, ein selbst geschriebenes Skript zu reparieren.

Ruckelndes Pathfinding: Ursachen und Lösungen
Was du siehstUrsacheLösung
Flüssig, solange er allein ist, ruckelig, sobald ein Spieler nah kommtNetwork Ownership. Roblox gibt die Physik nicht verankerter Parts an das Gerät eines Spielers in der Nähe, also kann der NPC auf dem Gerät dieses Spielers simuliert werden, während der Server die Befehle gibt, und jede Übergabe kann sich als Hänger zeigen.Ruf SetNetworkOwner(nil) einmal am HumanoidRootPart auf, vom Server aus. Das gilt für jeden Part, der mit ihm verbunden ist.
Läuft direkt zum letzten Waypoint und in WändeMoveTo wird in einer Schleife für jeden Waypoint ohne Warten aufgerufen. Jeder Aufruf ersetzt das vorherige Ziel.Warte auf MoveToFinished, bevor es zum nächsten Waypoint geht.
Hält an jedem Waypoint kurz an oder schneidet KurvenEin festes task.wait() zwischen den Waypoints statt auf die Ankunft zu warten. Zu lang, und der NPC steht still; zu kurz, und er springt voraus.Warte auf MoveToFinished, mit einem Timeout.
Zuckt oder macht mehrmals pro Sekunde Schritte nach hintenEin neuer Pfad in jedem Frame. Jeder beginnt an der eigenen Position des NPCs, also dreht ihn der Weg zu Waypoint 1 zurück.Berechne nur neu, wenn sich das Ziel ein paar Studs bewegt hat, höchstens zweimal pro Sekunde, und starte bei Waypoint 2.
Friert ein paar Sekunden ein und läuft dann weiterMoveToFinished:Wait() auf einen Waypoint, den er nicht erreichen kann, wartet auf das 8-Sekunden-Timeout.Nimm ein eigenes, kürzeres Timeout und berechne einen neuen Pfad, wenn es abläuft.

Um zu sehen, wem der NPC gehört, öffne während eines Playtests Visualization Options und schalte Network owners ein. Parts, die dein Client simuliert, bekommen einen grünen Umriss; Parts, die dem Server oder einem anderen Client gehören, sind weiß oder grau umrandet.

Schritt 4: Spielern bei Berührung Schaden zufügen (optional)

Für einen Gegner fügst du dem NPC ein zweites Skript hinzu, das Spielern Schaden zufügt, die er berührt. Es läuft auf dem Server, also kann der Client eines Spielers weder die Menge ändern noch den Cooldown überspringen.

  1. Setz in ChaseAI STOP_DISTANCE auf 0, damit der NPC in Spieler hineinläuft, statt neben ihnen anzuhalten.
  2. Füg ein Script mit dem Namen TouchDamage in Chaser ein und füg den Code unten ein.
Script in dem Model Chaser namens 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 -- ein besiegter NPC macht keinen Schaden
	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 feuert viele Male pro Sekunde, solange sich Parts überlappen
	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 respektiert Force Fields, also sind Spieler sicher, solange ihr Spawn-Force-Field hält. Um Force Fields zu ignorieren, senk stattdessen direkt Humanoid.Health.

Der Cooldown wird pro Spieler gespeichert. Touched feuert viele Male pro Sekunde, solange Parts aneinander reiben, und ohne den Cooldown könnte ein einziger Rempler die Lebenspunkte eines Spielers in einem Moment leeren. Jeder Eintrag wird entfernt, wenn sein Spieler geht, also wächst die Tabelle nicht während der ganzen Laufzeit des Servers.

Damit Spieler sich wehren können, gib ihnen das Schwert oder die Raycast-Waffe (auf Englisch). Beide fügen ihren Schaden auf dem Server allem mit einem Humanoid zu, also treffen sie auch den Chaser.

Pathfinding-Modifier und Links

Standardmäßig ist ein Pfad die kürzeste Route, die Sprünge meidet, wo es geht. Drei Werkzeuge ändern das. Costs und Modifier funktionieren mit dem Jagd-Skript so, wie es ist, weil es schon eine Costs-Tabelle an CreatePath übergibt; Links brauchen ein paar eigene Zeilen.

Materialkosten

Keys in Costs können Materialnamen wie Water, Mud oder CrackedLava sein, für Terrain und Parts gleichermaßen. Jedes Material kostet standardmäßig 1. Eine höhere Zahl lässt den NPC dieses Material meiden, außer der Umweg ist schlimmer, und math.huge macht es unpassierbar. Das Jagd-Skript setzt Water = 20.

Bereiche meiden: PathfindingModifier

  1. Deck den Bereich mit einem Part ab, mit Anchored an und CanCollide aus.
  2. Füg in diesen Part einen PathfindingModifier ein und setz sein Label auf DangerZone.
  3. Das war es. Das Jagd-Skript gibt DangerZone schon Kosten von math.huge, also führt die Route des NPCs um den Bereich herum. Schalte Pathfinding modifiers in Visualization Options ein, um das Label auf dem Navigation Mesh zu sehen.

Ein Modifier mit eingeschaltetem PassThrough macht das Gegenteil: Die Route führt durch ein festes Hindernis, zum Beispiel eine geschlossene Tür, als wäre es nicht da. Der NPC kann trotzdem nicht durch die Tür laufen, aber er steuert auf sie zu, als hätte er den Spieler auf der anderen Seite gehört.

Ein PathfindingLink verbindet zwei Punkte, zwischen denen der NPC sich normalerweise nicht bewegen könnte, etwa die Ufer eines Flusses, den er mit einem Boot überquert. Setz an jedes Ende ein Attachment, stell Attachment0 und Attachment1 des Links ein, gib ihm ein Label wie UseBoat und füg UseBoat mit niedrigeren Kosten als Water zu Costs hinzu. Der Pfad enthält dann einen Waypoint mit diesem Label: Prüf waypoint.Label in walkToNextWaypoint und führ statt MoveTo deine eigene Aktion aus, zum Beispiel den NPC ins Boot setzen. Links funktionieren in beide Richtungen, außer du schaltest IsBidirectional aus.

Häufige Fehler und Lösungen

Prüf zuerst das Output-Fenster. Du öffnest es über das Menü Window oder den Tab Script. Die Skripte auf dieser Seite geben eine Warnung aus, wenn eine Pfadanfrage fehlschlägt oder sich das Rig nicht bewegen kann.

Der NPC bewegt sich überhaupt nicht

Steht in Output, dass sich der NPC nicht bewegen kann, ist ein Teil des Rigs verankert: Nimm den Haken bei Anchored am HumanoidRootPart und an den anderen Parts heraus. Sonst prüf, dass der Code ein Script ist und kein LocalScript, dass er im Model in Workspace liegt und dass der Humanoid nicht gestorben ist.

Output meldet "Infinite yield possible" bei WaitForChild

Das Skript wartet auf ein Objekt, das es nicht gibt: einen Humanoid oder HumanoidRootPart mit anderem Namen, oder keinen Part namens Goal für das Skript aus Schritt 2. Benenn das Objekt oder den String im Skript um. Der Guide zu Skriptfehlern erklärt diese Warnung.

Der Pfad schlägt fehl, oder der NPC ignoriert einen Spieler, den er erreichen könnte

Path.Status ist nach ComputeAsync NoPath, wenn Start oder Ziel in einem festen Part liegt, wenn die einzige Route einen Sprung braucht und AgentCanJump false ist, oder wenn AgentHeight oder AgentRadius für eine Lücke auf dem Weg zu groß ist. Roblox dokumentiert außerdem feste Grenzen: höchstens 3.000 Studs Luftlinie vom Start zum Ziel und ein Suchbudget von 20.000 Knoten, das in riesigen offenen Welten oder Labyrinthen ausgehen kann. Schalte Navigation mesh ein, um die Route zu prüfen.

Der NPC gleitet, ohne die Beine zu bewegen

Das ist ein Animationsproblem, kein Pathfinding-Problem. Spielercharaktere bekommen automatisch ein Animate-Skript, aber ein NPC braucht ein eigenes Skript, um Laufanimationen abzuspielen. Jeder NPC im NPC-Kit von Roblox enthält ein Script namens Animate, das du dir ansehen kannst. Wie du aus einem Server-Script eine Animation auf einem NPC lädst und abspielst, zeigt eine Animation auf einem NPC abspielen.

Der NPC bleibt an Ecken hängen oder springt, ohne über ein Hindernis zu kommen

Erhöh AgentRadius, damit Routen mehr Abstand zu Wänden halten, vor allem bei breiten NPCs. Springt er, kommt aber nie drüber, ist das Hindernis höher, als der Humanoid springen kann: Erhöh JumpHeight oder JumpPower des Humanoids oder bau das Level um.

Der Berührungsschaden trifft zu oft oder nie

Zu oft: Der Cooldown fehlt, oder er wird pro Part statt pro Spieler gespeichert. Nie: STOP_DISTANCE ist über 0, also hält der NPC meistens an, bevor er jemanden berührt, oder der Spieler hat noch ein Spawn-Force-Field.

Mit RoCode bauen

Wenn du den NPC lieber beschreibst, statt ihn von Hand zu verdrahten, kann RoCode diese Skripte in das Spiel schreiben, das du offen hast. Es ist ein unabhängiger KI-Agent für Roblox Studio: Du tippst in einem Webchat, und sein Studio-Plugin erstellt und bearbeitet die Skripte in deinem Explorer.

Du schreibst

Lass das Model Chaser in Workspace den nächsten Spieler innerhalb von 80 Studs mit Pathfinding jagen, nach Hause laufen, wenn niemand in der Nähe ist, und bei Berührung 10 Schaden mit 1 Sekunde Cooldown machen.

RoCode macht
  • Kann sich das Model zuerst ansehen und mit Get Properties wichtige Werte lesen, etwa Anchored an seinen Parts und WalkSpeed an seinem Humanoid. Tipp / in den Chat, um den genauen Pfad des Models anzuhängen
  • Schreibt das Jagd- und das Schadensskript mit Create Script in das Model und kann mit Set Property den Haken bei Anchored herausnehmen, wenn das Rig es braucht
  • Prüft beide Skripte mit Check Script in Studio auf Kompilierfehler. Das findet Kompilierfehler und Muster wie wait() statt task.wait(), keine Logikfehler wie eine Route, die den Spieler nie erreicht
  • Schickt seine Änderungen in Runden, und jede Runde ist ein Undo-Punkt im Verlauf von Studio

Mit Plugin 3.9 oder neuer kann RoCode einen kurzen Playtest machen und die Fehler lesen, und mit Plugin 3.9.11 oder neuer kann es einen Test-Charakter steuern, um zu prüfen, ob das Spiel funktioniert, aber es macht keine Screenshots, während das Spiel läuft, also drück auf Play und schau dem NPC selbst zu. Wenn er sich falsch verhält, sag RoCode, was du gesehen hast: Check Output kann die Server- und Client-Zeilen aus deinem letzten Playtest lesen. NPCs sind ein System unter vielen; sieh dir an, wie du ein ganzes Roblox-Spiel mit KI baust, zuerst einen spielbaren Kern und dann weitere Runden. Wie sich RoCode mit Studio verbindet.

Häufige Fragen

Soll NPC-Pathfinding auf dem Server oder auf dem Client laufen?

Auf dem Server, in einem Script. Das Pathfinding-Beispiel von Roblox selbst läuft in einem LocalScript, aber es bewegt den eigenen Charakter des Spielers. Ein NPC gehört allen gemeinsam, und Schaden, den er macht, muss der Server entscheiden. Siehe Script vs LocalScript vs ModuleScript (auf Englisch).

Wie viele jagende NPCs schafft ein Server?

Die Docs von Roblox nennen keine feste Zahl; es hängt von deiner Map ab und davon, wie oft Pfade berechnet werden. Die Pfadberechnung ist der teure Teil, deshalb begrenzt das Jagd-Skript sie auf zweimal pro Sekunde pro NPC und lässt sie weg, wenn der Spieler in Sicht ist. Bei vielen NPCs schlagen die Hinweise von Roblox zum Ort von Skripten vor, sie zu taggen und mit CollectionService aus einem einzigen ModuleScript zu steuern, statt einem Skript in jedem Model.

Wie lasse ich den NPC nach seinem Tod respawnen?

Bewahr eine Kopie des NPCs in ServerStorage auf und erledige das Respawnen aus einem Skript in ServerScriptService, weil ein Skript im NPC mit ihm zerstört wird. Wenn das Event Died des Humanoids feuert, warte ein paar Sekunden, zerstör das alte Model und setz einen Clone() der Kopie nach Workspace. Das ChaseAI-Skript im Klon startet von selbst, weil Server-Skripte laufen, sobald sie in Workspace sind.

Können NPCs Spieler nur während einer Runde jagen?

Ja. Lass dein Rundenskript die NPCs zu Rundenbeginn nach Workspace klonen und sie am Rundenende zerstören. Der Guide zum Rundensystem baut die Pausen- und Rundenschleife, in die du das einhängst.

Quellen und weiterführende Links

So wurde der Code geprüft: Jedes Skript auf dieser Seite besteht die strikte Typprüfung von Luau mit den Roblox API-Definitionen (luau-lsp, 14. November 2026). Eine Typprüfung findet falsch geschriebene APIs und falsche Typen, aber keine Fehler in der Spiellogik. Teste also in Studio, bevor du veröffentlichst.

Probier RoCode in deinem eigenen Spiel aus.

Jeden Tag kostenlose Credits, ohne Karte. Installiere das Plugin, beschreibe das Feature und prüfe, was in Studio ankommt.