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
Actioneines WaypointsJumpist, und berechne einen neuen Pfad, wennPath.Blockedfür einen Waypoint vor dem NPC feuert. - Wenn der Spieler frei sichtbar ist, lass das Pathfinding weg und ruf
MoveTodirekt auf ihn auf. Halt ein paar Studs vorher an, oder lauf weiter, wenn der NPC bei Berührung Schaden macht.
Auf dieser Seite
So funktioniert NPC-Pathfinding
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.
| API | Was 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.Blocked | Feuert mit einem Waypoint-Index, wenn etwas die berechnete Route blockiert. |
Humanoid:MoveTo(position) | Lässt den NPC auf einen Punkt zulaufen. |
Humanoid.MoveToFinished | Feuert 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.
| Voraussetzung | Warum sie wichtig ist |
|---|---|
Ein Humanoid mit dem Namen Humanoid | MoveTo, WalkSpeed und Springen gehören alle zum Humanoid. |
Ein HumanoidRootPart | Der Part, den der Humanoid steuert. Pfade starten an seiner Position. |
| Nichts verankert | Ein 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. |
- Ö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.
- Benenn das Rig in
Chaserum und stell es auf freien Boden. - 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.
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.
- 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. - Fahr im Explorer mit der Maus über Chaser, klick auf den +-Button und füg ein Script ein. Nenn es
WalkToGoalund füg den Code unten ein. - Drück auf Play. Der NPC läuft um die Wand herum zum Goal-Part.
local PathfindingService = game:GetService("PathfindingService")
local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
local rootPart = npc:WaitForChild("HumanoidRootPart") :: BasePart
local goalPart = workspace:WaitForChild("Goal") :: BasePart
-- 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.
| Key | Standard | Was er steuert |
|---|---|---|
AgentRadius | 2 | Der Radius des NPCs in Studs. Erhöh ihn für breite NPCs, damit Pfade Abstand zu Wänden halten. |
AgentHeight | 5 | Die Höhe des NPCs. Räume, die niedriger sind, zum Beispiel unter Treppen, zählen als blockiert. |
AgentCanJump | true | Erlaubt Routen, die einen Sprung brauchen. Diese Waypoints haben Action auf Jump. |
AgentCanClimb | false | Erlaubt das Klettern an TrussParts. Diese Waypoints haben das Label Climb. |
WaypointSpacing | 4 | Abstand in Studs zwischen den Zwischen-Waypoints. math.huge entfernt sie. |
Costs | keine | Wie 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.
- Lösch
WalkToGoalaus Chaser, falls du es hinzugefügt hast. - Fahr mit der Maus über Chaser, klick auf +, füg ein Script mit dem Namen
ChaseAIein und füg den Code unten ein. - 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.
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.
| Was du siehst | Ursache | Lösung |
|---|---|---|
| Flüssig, solange er allein ist, ruckelig, sobald ein Spieler nah kommt | Network 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ände | MoveTo 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 Kurven | Ein 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 hinten | Ein 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 weiter | MoveToFinished: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.
- Setz in ChaseAI
STOP_DISTANCEauf0, damit der NPC in Spieler hineinläuft, statt neben ihnen anzuhalten. - Füg ein Script mit dem Namen
TouchDamagein Chaser ein und füg den Code unten ein.
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
- Deck den Bereich mit einem Part ab, mit Anchored an und CanCollide aus.
- Füg in diesen Part einen PathfindingModifier ein und setz sein
LabelaufDangerZone. - Das war es. Das Jagd-Skript gibt
DangerZoneschon Kosten vonmath.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.
Eigene Übergänge: PathfindingLink
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.
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.
- 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
- Roblox Creator Docs: Pathfinding (auf Englisch). Agent-Parameter, Waypoints, blockierte Pfade, Modifier, Links und Grenzen
- Roblox Creator Docs: PathfindingService (auf Englisch). CreatePath und seine Standardwerte
- Roblox Creator Docs: Path (auf Englisch). ComputeAsync, GetWaypoints, Status und das Event Blocked
- Roblox Creator Docs: Humanoid (auf Englisch). MoveTo, das 8-Sekunden-Timeout von MoveToFinished, ChangeState und TakeDamage
- Roblox Creator Docs: Network ownership (auf Englisch). automatische Ownership, SetNetworkOwner und die Ansicht Network owners
- Roblox Creator Docs: RaycastParams (auf Englisch). ExcludeInstances und RespectCanCollide
- Roblox Creator Docs: NPC kit (auf Englisch). Beispiel-NPCs mit eigenen Animate-Skripten
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.