Guide · Debugging

Skript-Fehler in Roblox beheben

Wenn ein Roblox-Skript kaputtgeht, sagt dir Studio meistens im Output-Fenster, wo und warum. Dieser Guide zeigt, wie du diese Meldung liest, was die häufigen Fehler bedeuten und wie du jeden behebst, was du prüfst, wenn ein Skript ohne jeden Fehler scheitert, und eine Routine, die die Ursache findet, statt zu raten.

Aktualisiert am 14. November 202620 Min. LesezeitGeschrieben von

Kurz gesagt

Öffne das Output-Fenster über das Menü Window oder den Tab Script, drück Play und klick auf den ersten roten Fehler. Studio öffnet das Skript an der fehlerhaften Zeile. Die Meldung sagt, was dort schiefging: attempt to index nil with 'Humanoid' heißt, dass der Wert direkt vor .Humanoid nil war. Behebe den Grund, warum dieser Wert fehlt, und spiel dann noch einmal.

  • Fang mit dem ersten Fehler in der Liste an. Fehler weiter unten sind oft nur Folgen davon.
  • Die häufigen Laufzeitfehler haben drei Ursachen: ein Wert, der nil ist, ein Name, der falsch geschrieben oder noch nicht geladen ist, oder Code, der auf der falschen Seite läuft (Server oder Client).
  • Gar kein Fehler heißt meistens, dass der Code nie gelaufen ist. Prüf den Skripttyp, wo es im Explorer liegt, seine Eigenschaft Enabled und ob das Event, auf das es wartet, jemals feuert.
  • Um zu sehen, was ein Wert in einer bestimmten Zeile wirklich ist, gib ihn mit einer Beschriftung per print aus oder halte mit einem Breakpoint an dieser Zeile an.
Auf dieser Seite
  1. Output lesen
  2. Debugging-Routine
  3. Häufige Fehler
  4. Kein Fehler, nichts passiert
  5. Debugging-Werkzeuge
  6. Mit RoCode
  7. Häufige Fragen
  8. Quellen und weiterführende Links

Output öffnen und einen Fehler lesen

IllustrationDas Kill-Brick-Beispiel aus dem Guide, beschleunigt: Die kaputte Zeile wirft einen Fehler, und nach Stop, der Lösung und einem neuen Playtest landet der Part ohne Fehler.

Im Output-Fenster meldet Roblox Skriptfehler, Warnungen der Engine und alles, was dein Code ausgibt. Es ist nicht immer offen, also öffne es, bevor du testest. Wenn du noch nie ein Skript ausgeführt hast: Der Scripting-Guide für Anfänger beginnt damit, Output zu öffnen und eine erste Zeile aus einem Skript auszugeben.

  1. Öffne Output über das Menü Window in Studio oder mit seinem Button im Tab Script.
  2. Lösch alte Meldungen mit Strg+K (⌘K auf dem Mac), damit du nur diesen Test siehst.
  3. Drück Play (F5) und mach das, was kaputtgeht.
  4. Such die erste rote Zeile. Fehler sind rot. Warnungen wie Infinite yield possible erscheinen orange.

Ein Laufzeitfehler sieht im Output so aus. Je nach Anzeigeoptionen des Outputs kann jede Zeile auch einen Zeitstempel, ein Label Client oder Server und den Skriptnamen tragen.

Output (Beispiel)
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
  • ServerScriptService.CoinPad ist der Ort des Skripts im Explorer: ein Skript namens CoinPad in ServerScriptService.
  • :14 ist die Zeile, die fehlschlug.
  • Die Meldung nach der Zeilennummer sagt, was schiefging. Die Liste häufiger Fehler weiter unten erklärt jeden.
  • Der Stack zwischen Stack Begin und Stack End listet die Aufrufe, die dorthin geführt haben, den neuesten zuerst: Zeile 14 in der Funktion award, die aus Zeile 27 aufgerufen wurde.

Klick auf den roten Fehler, und Studio öffnet das Skript mit dem Cursor auf der fehlerhaften Zeile. In einem Solo-Test teilen sich Meldungen vom Server und von deinem eigenen Client einen Output, grün markiert für den Server und blau für den Client. Die Filter oben grenzen ihn nach Meldungstyp (Error, Warning), nach Kontext (Client, Server) oder nach Text ein.

Eine Debugging-Routine, die für jedes Skript funktioniert

Raten und mehrere Dinge auf einmal ändern ist der langsame Weg, ein Skript zu reparieren. Diese Reihenfolge grenzt das Problem Schritt für Schritt ein, egal ob es eine Fehlermeldung gibt oder nicht.

  1. Reproduzier es. Lösch den Output, drück Play und mach genau das, was kaputtgeht. Notier, was du erwartet hast und was stattdessen passiert ist.
  2. Nimm den ersten Fehler. Lies die erste neue rote Zeile: den Skriptpfad, die Zeilennummer und die Meldung. Gibt es keinen Fehler, geh zu Skripte, die ohne Fehler laufen.
  3. Geh zur Zeile. Klick auf den Fehler. Lies die ganze Zeile und frag dich, welcher Wert darin nil, falsch geschrieben oder vom falschen Typ sein könnte.
  4. Prüf den Wert, statt ihn anzunehmen. Füg direkt über der Zeile ein print ein oder setz einen Breakpoint darauf und lies die Werte im Watch-Fenster. typeof(x) sagt dir, ob du eine Zahl, einen String, eine Instance oder nil hast.
  5. Verfolg ihn zurück. Ist der Wert falsch, such die Stelle, an der er gesetzt wurde: ein FindFirstChild, das nichts gefunden hat, eine Funktion, die nichts zurückgegeben hat, ein Argument, das der Aufrufer nie geschickt hat.
  6. Behebe die Ursache, eine Änderung nach der anderen. Korrigier den Namen, warte auf das Objekt oder verschieb den Code auf die richtige Seite, und spiel dann noch einmal. Pack die Zeile nicht in ein pcall, um sie zum Schweigen zu bringen: Das versteckt den Bug, statt ihn zu beheben.
  7. Bestätige es. Wiederhol Schritt 1. Der Fehler sollte weg sein und das Feature sollte tun, was du erwartest. Bei allem, was andere Spieler betrifft, teste auch mit Server & Clients und zwei Clients.
  8. Räum auf. Entfern deine Debug-Ausgaben oder schalt sie ab, damit das nächste Problem leicht zu finden ist.

Häufige Roblox-Skriptfehler und wie du sie behebst

Jede Meldung folgt einem festen Muster, in das deine eigenen Namen eingesetzt werden, deshalb ist der Wortlaut selbst der beste Hinweis. Die Namen in Anführungszeichen unten, etwa 'Health' oder "Workspace", sind Beispiele.

Häufige Fehler im Output. Wähl eine Meldung für die ganze Erklärung.
Output sagtWas es bedeutetÜbliche Lösung
attempt to index nil with 'Health'Der Wert vor .Health war nil.Find heraus, warum er nil ist, und prüf ihn mit if, bevor du ihn nutzt.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild hat 5 Sekunden gewartet, und das Objekt ist nicht aufgetaucht.Korrigier den Namen oder Pfad, sorg dafür, dass etwas das Objekt erstellt, oder setz ein Timeout.
Bridge is not a valid member of Workspace "Workspace"Dort gibt es gerade kein Child und keine Eigenschaft mit genau diesem Namen.Gleich Schreibweise und Großbuchstaben mit dem Explorer ab. Auf dem Client nutzt du WaitForChild.
attempt to call a nil valueDu hast etwas aufgerufen, das keine Funktion ist.Prüf den Funktionsnamen und ob die Funktion über dem Aufruf definiert ist.
attempt to perform arithmetic (add) on Instance and numberRechnen mit etwas, das keine Zahl ist.Nutze .Value bei Value-Objekten und tonumber bei Text.
attempt to concatenate string with nil.. wollte Text mit nil oder einem Objekt verbinden.Nutze tostring(), .Name oder String-Interpolation.
Expected 'end' (to close 'function' at line 3), got <eof>Ein Syntaxfehler. Nichts vom Skript läuft.Behebe die rote Unterstreichung im Script Editor.
Requested module experienced an error while loadingDas ModuleScript selbst hat beim Ausführen einen Fehler geworfen.Behebe den eigenen Fehler des Moduls, der direkt darüber im Output steht.
Argument 1 missing or nilEine Roblox-Funktion hat nil bekommen, wo sie einen Wert braucht.Verfolg zurück, woher dieses Argument hätte kommen sollen.
FireServer can only be called from the clientEin RemoteEvent wurde von der falschen Seite gefeuert.Der Server nutzt FireClient, LocalScripts nutzen FireServer.
Data-Store-Fehler 403, StudioAccessToApisNotAllowedStudio darf für dieses Spiel keine Data Stores nutzen.Veröffentliche es und schalt dann Studio Access to API Services ein.

Jede Meldung hier, und noch mehr, hat eine eigene Seite mit jeder Ursache, dem Code, der sie auslöst, und der Lösung: siehe Roblox-Studio-Fehlermeldungen (auf Englisch), zum Beispiel attempt to index nil (auf Englisch), Infinite yield possible (auf Englisch) und is not a valid member of (auf Englisch).

attempt to index nil with 'X'

Indexieren heißt, etwas mit einem Punkt oder eckigen Klammern auszulesen: part.Position, player.Character, list[1]. Dieser Fehler sagt, dass das Ding links davon nil war, und der Name in Anführungszeichen ist das, was du daraus lesen wolltest. In der Zeile player.Character.Humanoid heißt attempt to index nil with 'Humanoid' also, dass player.Character nil war. Ist der Schlüssel eine Zahl, endet die Meldung stattdessen mit with number.

Die üblichen Gründe, warum der Wert nil war:

  • FindFirstChild, FindFirstChildOfClass oder FindFirstAncestor hat nichts gefunden, weil der Name anders ist oder das Objekt noch nicht existiert.
  • Players.LocalPlayer wurde in einem Server-Script benutzt. Es existiert nur in LocalScripts und den ModuleScripts, die sie per require laden; auf dem Server ist es immer nil. Nutze stattdessen den player, den dir PlayerAdded oder ein RemoteEvent-Handler gibt.
  • player.Character wurde gelesen, bevor die Figur gespawnt ist, oder während sie respawnt.
  • Ein Tabelleneintrag wurde nie gesetzt, etwa playerData[player], bevor die Daten dieses Spielers geladen waren, oder eine aufgerufene Funktion hat nichts zurückgegeben.

Ein Kill Brick ist der klassische Fall. Die kaputte Version nimmt an, dass alles, was den Part berührt, zu einer Figur gehört, was für fallen gelassene Tools, lose Parts oder Accessoires nicht stimmt.

Script in einem Part in Workspace namens KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Kaputte Version:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Wenn der berührende Part kein Körperteil einer Figur ist, gibt FindFirstChild
	-- nil zurück, und der Output zeigt:
	--   attempt to index nil with 'Health'

	-- Behoben: jeden Schritt prüfen, bevor du ihn nutzt
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Schreibst du stattdessen hit.Parent.Humanoid, scheitert es mit einer anderen Meldung, Humanoid is not a valid member of ..., die weiter unten erklärt wird. FindFirstAncestorOfClass("Model") findet die Figur auch, wenn der berührende Part in einem Accessoire oder einem Tool steckt, das die Figur hält, also zählt auch ein gehaltenes Tool, das den Brick berührt.

Das Muster, das diesen Fehler behebt: Wert holen, prüfen und erst dann benutzen. Auf dem Server passt FindFirstChild plus eine if-Prüfung für Dinge, die tatsächlich fehlen dürfen. In einem LocalScript nutzt du WaitForChild für Dinge, die der Server erstellt, weil sie nach dem Start deines Skripts ankommen können.

Infinite yield possible on ...

WaitForChild("Name") hält das Skript an, bis ein Child mit diesem Namen existiert. Hat es länger als 5 Sekunden gewartet und du hast kein Timeout angegeben, gibt Roblox diese Warnung aus. Es ist eine Warnung, kein Fehler: Das Skript wartet weiter, und nichts nach dieser Zeile läuft, bis das Child auftaucht, was vielleicht nie passiert. Die üblichen Ursachen:

  • Der Name oder das Parent ist falsch. WaitForChild("leaderStats") passt nie auf einen Ordner namens leaderstats.
  • Nichts erstellt das Objekt: Das Server-Skript, das es anlegt, ist deaktiviert, liegt am falschen Ort oder hat vorher einen Fehler geworfen. Such im Output nach einem früheren Fehler.
  • Ein LocalScript wartet auf etwas in ServerStorage oder ServerScriptService. Deren Inhalt wird nie an Spieler geschickt, also endet das Warten nie.
  • Du wartest auf eine Eigenschaft, nicht auf ein Child. player:WaitForChild("Character") ist der häufige Fall: Character ist eine Eigenschaft von Player, kein Objekt darin.
  • Instance Streaming (Workspace.StreamingEnabled) ist an, und der Part ist zu weit vom Spieler weg, um schon an diesen Client geschickt worden zu sein.
LocalScript in StarterPlayerScripts namens DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Kaputte Version:
--   local character = player:WaitForChild("Character")
-- Character ist eine Eigenschaft von Player, kein Child, also warnt der Output:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Mit Timeout gibt WaitForChild nil zurück, statt ewig zu warten
	local humanoid = character:WaitForChild("Humanoid", 10)
	if not (humanoid and humanoid:IsA("Humanoid")) then
		warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
		return
	end
	humanoid.Died:Connect(function()
		print(`[DeathMessage] {player.Name} died`)
	end)
end

-- Die Figur behandeln, die vielleicht schon existiert, dann jeden Respawn
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Eine Zahl als zweites Argument von WaitForChild ist ein Timeout in Sekunden. Das Skript kann das Problem dann mit warn melden und sauber aufhören, statt still hängen zu bleiben.

X is not a valid member of Y

Du hast mit einem Punkt ein Child oder eine Eigenschaft angesprochen, die in diesem Moment nicht existiert, etwa workspace.Bridge, wenn Workspace keinen Part namens Bridge hat. Die Meldung nennt, wonach du gefragt hast, dann die Klasse und den vollen Pfad des Objekts, in dem gesucht wurde. Prüf drei Dinge:

  • Schreibweise und Großbuchstaben stimmen genau mit dem Explorer überein. Der Ordner heißt leaderstats, komplett klein, und humanoid ist nicht Humanoid.
  • Eigenschaftsnamen nutzen amerikanische Schreibweise. part.Colour scheitert mit Colour is not a valid member of Part "Workspace.Part"; die Eigenschaft heißt Color.
  • Das Objekt ist geladen. Auf dem Client können Objekte, die der Server erstellt, nach dem Start deines LocalScripts ankommen, also nutzt du dort WaitForChild.
LocalScript in StarterPlayerScripts namens CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Kaputte Version:
--   local coins = player.leaderstats.Coins
-- Der Server erstellt leaderstats, und es kann bei diesem Client ankommen, nachdem
-- dieses Skript gestartet ist. Dann zeigt der Output:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- der Server macht Coins zu einem IntValue

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

Das setzt ein Server-Skript voraus, das leaderstats mit einem IntValue namens Coins erstellt, wie das im Leaderboard-Guide.

attempt to call a nil value

Der Code hat Klammern hinter etwas gesetzt, das nil ist, also gab es keine Funktion zum Ausführen. Die üblichen Ursachen:

  • Der Funktionsname ist falsch geschrieben oder die Groß- und Kleinschreibung weicht ab. Ein Modul definiert Format.clock, und der Aufrufer schreibt Format.Clock(95).
  • Eine local function wird in einer Zeile über ihrer Definition aufgerufen. An dieser Stelle gibt es den Namen noch nicht, also schieb die Definition nach oben.
  • Ein ModuleScript fügt die Funktion nie in die Tabelle ein, die es zurückgibt.

Zwei verwandte Meldungen deuten auf dieselbe Art von Fehler. Eine fehlende Methode auf einer Tabelle mit Doppelpunkt aufzurufen ergibt attempt to call missing method 'Kill' of table. Eine falsch geschriebene Methode auf einem Roblox-Objekt, etwa part:Destory(), ergibt Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau wollte rechnen (add, sub, mul, div und so weiter), aber eine Seite war keine Zahl. Die Typnamen am Ende der Meldung sagen dir, welcher Fall vorliegt:

  • on Instance and number: Du hast mit einem Value-Objekt gerechnet statt mit seiner Zahl. coins + 10 sollte coins.Value + 10 sein.
  • on nil and number: Eine Variable oder ein Tabelleneintrag wurde nie gesetzt. Gib ihr einen Startwert, oder schreib (x or 0), wenn ein fehlender Wert wirklich null bedeutet.
  • on string and number: Text, der keine Zahl ist, oft aus einer TextBox. Wandle ihn mit tonumber(text) um und prüf, dass das Ergebnis nicht nil ist. Text, der eine Zahl enthält, etwa "5", wird automatisch umgewandelt.

Vergleiche scheitern genauso, mit attempt to compare nil < number. Luau schreibt a > b als b < a um, deshalb kann die Reihenfolge in der Meldung umgekehrt zu deinem Code sein.

Script in ServerScriptService namens CoinDrip
local Players = game:GetService("Players")

local REWARD = 5
local INTERVAL_SECONDS = 60

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		-- Sagen, warum nichts passiert ist, statt still zu scheitern
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Kaputte Version:
	--   coins = coins + amount
	-- coins ist das IntValue-Objekt, nicht seine Zahl, also zeigt der Output:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Jede Minute bekommt jeder Spieler auf dem Server ein paar Coins
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

Der Operator .. verbindet nur Strings und Zahlen. Nil anzuhängen scheitert, und ein Objekt anzuhängen auch: "Hi " .. player ergibt attempt to concatenate string with Instance. Nutze player.Name, pack den Wert in tostring() oder nutze String-Interpolation mit Backticks, print(`Coins: {coins}`), die nil ausgibt, statt das Skript anzuhalten.

Expected 'end' und andere Syntaxfehler

Meldungen, die mit Expected beginnen, sind Syntaxfehler: Der Code ist kein gültiges Luau, also kann Roblox ihn nicht kompilieren, und keine Zeile dieses Skripts läuft, nicht einmal die Zeilen über dem Fehler. Der Script Editor unterstreicht sie beim Tippen rot, sodass du sie beheben kannst, bevor du Play drückst.

  • Expected 'end' (to close 'function' at line 3), got <eof>: Ein function, if, for oder while, das in Zeile 3 beginnt, hat kein passendes end. Die Zeilennummer vor der Meldung ist oft das Dateiende, also schau auf die Zeile, die in den Klammern steht.
  • Expected 'then' when parsing if statement, got '=': ein einzelnes = in einer Bedingung. Vergleiche nutzen ==.
  • Expected ')' (to close '(' at line 1), got 'local': Eine Klammer wurde nie geschlossen.
  • Expected <eof>, got 'end': ein end zu viel.

Einheitliches Einrücken macht ein fehlendes oder überzähliges end leicht sichtbar, weil jeder Block mit dem end in einer Linie steht, das ihn schließt.

Requested module experienced an error while loading

Das erste require() eines ModuleScripts führt dessen Code aus. Wirft das Modul dabei einen Fehler, bekommt das Skript, das es geladen hat, diese Meldung. Das eigentliche Problem ist der eigene Fehler des Moduls, eine oder zwei Zeilen darüber im Output: Behebe den. Zwei verwandte Meldungen:

  • Module code did not return exactly one value: Das Modul endet nicht mit einem return. Ein ModuleScript muss einen Wert zurückgeben, der nicht nil ist, meistens seine Tabelle.
  • Requested module was required recursively: Zwei Module laden sich gegenseitig per require. Verschieb den gemeinsamen Teil in ein drittes Modul, das beide laden.
ModuleScript in ReplicatedStorage namens Format
local Format = {}

-- Macht aus einer Zahl von Sekunden Minuten und Sekunden: 95 wird "1:35"
function Format.clock(seconds: number): string
	local whole = math.max(0, math.floor(seconds))
	return string.format("%d:%02d", whole // 60, whole % 60)
end

-- Das Modul muss mit der Rückgabe seiner Tabelle enden. Ohne diese Zeile scheitert
-- jedes require davon mit: Module code did not return exactly one value
return Format

Ein Skript nutzt es mit local Format = require(ReplicatedStorage:WaitForChild("Format")) und dann Format.clock(95). Stattdessen Format.Clock(95) zu schreiben ist der Fehler attempt to call a nil value.

Argument 1 missing or nil

Eine Roblox-Funktion hat für ein Argument, das sie braucht, nil bekommen, und die Zahl sagt, welches Argument. workspace:FindFirstChild(itemName) scheitert so, wenn itemName nil ist. Der Bug liegt selten in dieser Zeile. Er liegt dort, woher der Wert hätte kommen sollen: eine falsch geschriebene Variable, ein Attribut, das nie gesetzt wurde, oder ein RemoteEvent-Argument, das der Client nicht geschickt hat. RemoteEvent-Argumente kommen vom Gerät des Spielers, also sollte der Server sie prüfen, bevor er sie nutzt. Der RemoteEvents-Guide zeigt, wie.

FireServer can only be called from the client

RemoteEvents haben eine Richtung. Ein LocalScript ruft FireServer auf, und ein Server-Script hört mit OnServerEvent zu. Ein Server-Script ruft FireClient oder FireAllClients auf, und LocalScripts hören mit OnClientEvent zu. Eine Methode von der falschen Seite aufzurufen ergibt diesen Fehler oder sein Gegenstück, FireClient can only be called from the server. Die Lösung ist meistens, den Code in die richtige Art von Skript zu verschieben: siehe Script vs LocalScript vs ModuleScript (auf Englisch).

Data-Store-Fehler 403 in Studio

Data-Store-Aufrufe scheitern in Studio mit dem Fehlercode 403 (StudioAccessToApisNotAllowed), bis du sie erlaubst. Veröffentliche das Spiel, öffne File, Experience Settings, Security, schalt Enable Studio Access to API Services ein und speichere. Studio nutzt dann dieselben Data Stores wie das Live-Spiel, deshalb rät Roblox, das in einer separaten Testkopie zu machen, nicht in einem Spiel, das schon gespielt wird. Pack jeden Data-Store-Aufruf in ein pcall, weil diese Aufrufe aus Gründen außerhalb deines Codes scheitern können. Das DataStore-Tutorial zeigt sicheres Speichern.

Wenn ein Skript ohne Fehler läuft, aber nichts tut

Ein stummes Skript ist meistens nie gelaufen, wartet noch auf etwas oder lief auf der falschen Seite. Bevor du irgendeinen Code änderst, mach print(script:GetFullName(), "started") zu seiner ersten Zeile und spiel. Taucht diese Zeile nie im Output auf, liegt das Problem daran, wo das Skript liegt oder wie es eingerichtet ist, nicht daran, was drinsteht.

Warum ein Skript ohne Fehler nichts tun kann
PrüfenWas schiefgehtLösung
Skripttyp und OrtEin LocalScript läuft nur, wenn du es in StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack oder ReplicatedFirst legst (aus den Starter-Containern läuft es als Kopie des Spielers). Eins in Workspace, ServerScriptService oder ReplicatedStorage läuft nie. Ein Script mit dem Standard-RunContext läuft nur in Workspace oder ServerScriptService.Verschieb es oder nimm den anderen Skripttyp. Code für Oberfläche und Eingabe gehört in ein LocalScript, Spielregeln in ein Script in ServerScriptService.
EnabledEin Skript, dessen Eigenschaft Enabled nicht angehakt ist, läuft nicht.Wähl es aus und hak Enabled im Properties-Fenster an.
RunContextDer RunContext eines Scripts entscheidet, wo es läuft. Legacy, der Standard, läuft auf dem Server aus Workspace oder ServerScriptService. Server läuft auf dem Server, Client auf dem Gerät jedes Spielers, zum Beispiel aus ReplicatedStorage.Stell ihn bewusst ein. Die Roblox-Doku empfiehlt Client-Scripts in ReplicatedStorage oder ReplicatedFirst und LocalScripts in den Starter-Containern.
Das Event feuert nieTouched feuert nur durch physische Bewegung, braucht mindestens einen der beiden Parts nicht verankert und braucht CanTouch bei beiden. PlayerAdded feuert nicht für Spieler, die schon auf dem Server waren, als du verbunden hast. Ein RemoteEvent-Handler läuft nie, wenn die andere Seite das Event nie feuert.Setz ein print in den Handler, um zu beweisen, ob er läuft, und behebe dann, was ihn auslösen sollte.
Code nach einer Schleife oder einem WaitZeilen unter einer while true do-Schleife laufen nie, weil die Schleife nie endet. Zeilen unter einem WaitForChild, das sein Child nie findet, laufen auch nie.Verbinde Events vor der Schleife oder starte die Schleife mit task.spawn. Gib Waits ein Timeout.
Eine Prüfung, die still abbrichtEine Abfrage wie if not coins then return end beendet die Funktion ohne ein Wort, wenn das Objekt fehlt.Füg vor dem return ein warn mit den Details ein.
Output-FilterDer Output lässt sich nach Meldungstyp, nach Client oder Server und nach Text filtern. Ein übrig gebliebener Filter kann den Fehler verstecken, den du suchst.Setz die Filter zurück und leer das Suchfeld.
Nur du siehst esEin LocalScript hat die Änderung gemacht, also sieht nur dieser Spieler sie. Der Server und andere Spieler nicht.Mach die Änderung auf dem Server. Siehe wo Skripte laufen (auf Englisch).

Der PlayerAdded-Fall erwischt viele, weil du in einem Studio-Test fast sofort nach dem Serverstart beitrittst. Wenn irgendetwas über der Connect-Zeile wartet, etwa ein WaitForChild, ein task.wait oder ein require auf ein Modul, das wartet, kannst du beitreten, bevor die Verbindung existiert. Behandle neue und schon vorhandene Spieler:

Script in ServerScriptService namens Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- Spieler, die schon da waren, als die Zeile oben lief, feuern für dieses Skript
-- nie PlayerAdded, also werden sie jetzt behandelt
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Debugging-Werkzeuge in Roblox Studio

print schreibt eine Zeile in den Output und warn eine Warnung. Sie sind der schnellste Weg, „Lief das?“ und „Was ist dieser Wert?“ zu beantworten. Ein nacktes print(x) findest du später schwer wieder, also füg eine Beschriftung und die wichtigen Details hinzu. typeof(x) zeigt, ob ein Wert eine Zahl, ein String, eine Instance oder nil ist, und GetFullName() zeigt genau, welches Objekt du hast.

Script in ServerScriptService namens ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- auf false setzen, wenn du fertig bist
local TAG = "[ShopServer]"

local function debugPrint(...: any)
	if DEBUG then
		print(TAG, ...)
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	debugPrint("joined:", player.Name, player.UserId)

	local leaderstats = player:WaitForChild("leaderstats", 10)
	if not leaderstats then
		warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
		return
	end

	local coins = leaderstats:FindFirstChild("Coins")
	-- typeof und ClassName zeigen, was ein Wert wirklich ist
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Das Suchfeld des Outputs filtert nach Text, also kannst du mit einer festen Markierung wie [ShopServer] nur die Zeilen dieses Systems anzeigen. Wenn du wissen musst, wie der Code eine Zeile erreicht hat, gibt debug.traceback() den aktuellen Call Stack als String zurück.

Breakpoints und Stepping

Ein Breakpoint hält das Spiel an einer Zeile an, damit du in diesem Moment alles untersuchen kannst. Klick im Script Editor in den Rand direkt rechts neben einer Zeilennummer (ein roter Kreis erscheint) und starte dann einen Playtest. Wenn diese Zeile erreicht wird, pausiert das Spiel mit einem gelben Pfeil auf der nächsten Zeile, die laufen soll. Die Stepping-Buttons gehen dann durch den Code:

  • Step Over (F10) führt die aktuelle Zeile aus und hält bei der nächsten an.
  • Step Into (F11) geht in die Funktion hinein, die in dieser Zeile aufgerufen wird.
  • Step Out (Shift+F11) beendet die aktuelle Funktion und hält wieder beim Aufrufer an.
  • Resume Scripts läuft weiter bis zum nächsten Breakpoint.

Ein Rechtsklick auf den Rand bietet zwei weitere nützliche Arten. Ein bedingter Breakpoint (Conditional Breakpoint) hält nur an, wenn ein Ausdruck wie amount < 0 wahr ist. Ein Logpoint schreibt eine Meldung in den Output, ohne anzuhalten, sodass du einen Wert protokollieren kannst, ohne das Skript zu ändern.

Watch und Call Stack

Während das Spiel pausiert ist, fahr mit der Maus über eine Variable im Script Editor, um ihren Wert zu sehen. Das Fenster Watch listet auf seinem Tab Variables jede Variable im Gültigkeitsbereich, und auf dem Tab My Watches kannst du jeden Ausdruck eintippen, etwa coins.Value + amount, um seinen aktuellen Wert zu sehen. Das Fenster Call Stack zeigt, welche Funktion welche aufgerufen hat, um zur pausierten Zeile zu kommen. Beide öffnest du über den Tab Script oder das Menü Window.

Script Analysis und Strict Mode

Der Script Editor unterstreicht Probleme beim Tippen, und das Fenster Script Analysis, das du mit dem Button Analysis im Tab Script öffnest, listet die Fehler und Warnungen in all deinen Skripten. Es findet Syntaxfehler und unbekannte Namen, bevor du Play drückst. --!strict als erste Zeile eines Skripts schaltet die strikte Typprüfung von Luau ein, die auch falsch geschriebene Eigenschaften, falsche Argumenttypen und Werte meldet, die nil sein könnten. Das laufende Spiel sieht sie aber nicht: Ein Part, der in Workspace fehlt, zeigt sich nur im Output.

Die Command Bar

Die Command Bar (im Tab Script, oder Strg+9, ⌘9 auf dem Mac) führt Luau sofort aus. Während das Spiel läuft, ist sie ein schneller Weg, eine Frage zu stellen: print(workspace:FindFirstChild("Bridge")) sagt dir, ob der Part existiert, und print(#game:GetService("Players"):GetPlayers()) zählt die Spieler. Im Bearbeitungsmodus ändert Code aus der Command Bar dein Spiel wirklich, also sei vorsichtig mit allem, was Objekte bewegt oder löscht.

Developer Console für Live-Spiele

Der Output von Studio deckt nur Studio ab. In einem Live-Spiel drückst du F9 oder tippst /console in den Chat, um die Developer Console zu öffnen. Ihr Log zeigt die Ausgabe deines eigenen Geräts und die Server-Ausgabe, wenn dir das Spiel gehört oder du ein Gruppenmitglied mit Bearbeitungsrecht bist.

Der eingebaute Assistant von Roblox kann auch bei einer einzelnen Meldung helfen: Roblox empfiehlt in seinem eigenen Guide, einen Fehler aus dem Output einzufügen und Assistant um eine Diagnose zu bitten. Wenn Assistant nicht mehr antwortet oder sagt, dass du ein Limit erreicht hast, siehe Limits und Fehler von Assistant.

Fehler mit RoCode beheben

RoCode ist ein unabhängiger KI-Agent für Roblox Studio: Du beschreibst das Problem in einem Webchat, und ein Studio-Plugin liest und bearbeitet das Spiel, das du offen hast. Bei Fehlern kann es die Leseschritte der Routine oben übernehmen, ausgehend von einem Playtest, den du schon gemacht hast.

Du schreibst

Ich habe Play gedrückt, und ein Klick auf den Shop-Button macht nichts. Der Output zeigt attempt to index nil with 'Coins'. Finde die Ursache und behebe sie.

RoCode macht
  • Liest den Output von Studio mit seinem Werkzeug Check Output, einschließlich der Server- und Client-Zeilen aus deinem letzten Playtest, auch nachdem du Stop gedrückt hast
  • Öffnet das im Fehler genannte Skript mit Read Script und liest den Code um diese Zeile, und kann mit Search Scripts suchen, wo der fehlende Wert hätte erstellt werden sollen
  • Macht mit Edit Script eine gezielte Änderung, ein exaktes Suchen und Ersetzen in diesem Skript, und startet dann Check Script, das es in Studio kompiliert (es prüft keine Typen, lintet nicht und führt deinen Code nicht aus)
  • Schickt seine Änderungen in Runden an Studio, und jede Runde ist ein Undo-Punkt im Verlauf von Studio

Drück wieder Play und klick auf den Shop-Button, um die Lösung selbst zu bestätigen: Mit Plugin 3.9 oder neuer kann RoCode einen kurzen Playtest starten und die Fehler lesen, und mit Plugin 3.9.15 oder neuer kann seine Testfigur Buttons auf dem Bildschirm anklicken, aber es prüft nur, was es selbst zum Testen ausgewählt hat, und eine Kompilierprüfung kann nicht sagen, ob die Spiellogik stimmt. Fehler lesen gehört zu jedem Build: die Schleife aus Bauen, Prüfen und Testen für ein ganzes Spiel wiederholt diese Prüfung nach jedem System. Wie sich RoCode mit Studio verbindet.

Häufige Fragen

Warum funktioniert mein Roblox-Skript nicht, obwohl es keine Fehler gibt?

Meistens ist das Skript nie gelaufen (falscher Skripttyp oder Container, oder Enabled ist aus), es wartet noch auf etwas, oder das Event, auf das es hört, feuert nie. Ein print in seiner ersten Zeile sagt dir, was davon. Siehe die Checkliste oben.

Was bedeutet „attempt to index nil“ in Roblox?

Der Wert vor dem Punkt oder Doppelpunkt war nil, also konnte Roblox nicht hineinschauen. In der Zeile player.Character.Humanoid heißt attempt to index nil with 'Humanoid', dass player.Character nil war: fehlt oder ist noch nicht geladen. Prüf einen Wert mit if, bevor du ihn nutzt, und warte in einem LocalScript mit WaitForChild auf Objekte, die der Server erstellt. Mehr zu den Ursachen.

Was bedeutet „infinite yield possible“ in Roblox?

WaitForChild hat länger als 5 Sekunden auf ein Child gewartet, das nicht aufgetaucht ist, und wartet immer noch. Oft ist der Name oder das Parent falsch, oder nichts erstellt das Objekt. Mehr zu den Ursachen.

Warum ist das Output-Fenster leer oder wird nicht angezeigt?

Öffne es über das Menü Window oder den Tab Script. Ist es offen, bleibt aber während eines Tests leer, setz seine Filter und das Suchfeld zurück und prüf dann, ob die Skripte, die etwas ausgeben sollen, laufen.

Gibt es einen Fehlerprüfer für Roblox-Skripte?

Ja, eingebaut in Studio: Der Script Editor unterstreicht Probleme beim Tippen, und das Fenster Script Analysis listet sie. Sie finden Syntax- und Typfehler, aber keine fehlenden Objekte oder falsche Spiellogik, die sich erst zeigen, wenn der Code läuft.

Soll ich meinen Code in pcall packen, um Fehler zu stoppen?

Nur Aufrufe, die aus Gründen außerhalb deines Codes scheitern können, etwa Anfragen an Data Stores, HTTP oder MarketplaceService. Einen nil-Fehler in pcall zu packen versteckt die Meldung, und das Feature funktioniert trotzdem nicht.

Wie sehe ich Skriptfehler in einem Live-Spiel?

Drück im Spiel F9 oder tipp /console in den Chat, um die Developer Console zu öffnen. Sie zeigt Fehler von deinem Gerät und vom Server, wenn dir das Spiel gehört oder du ein Gruppenmitglied bist, das es bearbeiten darf.

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.