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
nilist, 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
Enabledund 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
Output öffnen und einen Fehler lesen
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.
- Öffne Output über das Menü Window in Studio oder mit seinem Button im Tab Script.
- Lösch alte Meldungen mit Strg+K (⌘K auf dem Mac), damit du nur diesen Test siehst.
- Drück Play (F5) und mach das, was kaputtgeht.
- Such die erste rote Zeile. Fehler sind rot. Warnungen wie
Infinite yield possibleerscheinen 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.
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.CoinPadist der Ort des Skripts im Explorer: ein Skript namens CoinPad in ServerScriptService.:14ist 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.
- 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.
- 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.
- 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. - Prüf den Wert, statt ihn anzunehmen. Füg direkt über der Zeile ein
printein 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. - 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. - 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. - 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.
- 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.
| Output sagt | Was 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 value | Du 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 number | Rechnen 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 loading | Das 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 nil | Eine 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 client | Ein RemoteEvent wurde von der falschen Seite gefeuert. | Der Server nutzt FireClient, LocalScripts nutzen FireServer. |
Data-Store-Fehler 403, StudioAccessToApisNotAllowed | Studio 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,FindFirstChildOfClassoderFindFirstAncestorhat nichts gefunden, weil der Name anders ist oder das Objekt noch nicht existiert.Players.LocalPlayerwurde 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 denplayer, den dirPlayerAddedoder ein RemoteEvent-Handler gibt.player.Characterwurde 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.
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 namensleaderstats. - 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:Characterist 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.
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, undhumanoidist nichtHumanoid. - Eigenschaftsnamen nutzen amerikanische Schreibweise.
part.Colourscheitert mitColour is not a valid member of Part "Workspace.Part"; die Eigenschaft heißtColor. - 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.
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 schreibtFormat.Clock(95). - Eine
local functionwird 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 + 10solltecoins.Value + 10sein.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 mittonumber(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.
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>: Einfunction,if,foroderwhile, das in Zeile 3 beginnt, hat kein passendesend. 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': einendzu 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 einemreturn. 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.
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.
| Prüfen | Was schiefgeht | Lösung |
|---|---|---|
| Skripttyp und Ort | Ein 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. |
| Enabled | Ein Skript, dessen Eigenschaft Enabled nicht angehakt ist, läuft nicht. | Wähl es aus und hak Enabled im Properties-Fenster an. |
| RunContext | Der 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 nie | Touched 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 Wait | Zeilen 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 abbricht | Eine 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-Filter | Der 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 es | Ein 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:
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 und warn, mit Kontext
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.
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.
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.
- 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
- Roblox Creator Docs: Output (auf Englisch). wo Output ist, seine Filter und Anzeigeoptionen
- Roblox Creator Docs: Debugging (auf Englisch). Breakpoints, Stepping, Watch, Call Stack, Command Bar und Developer Console
- Roblox Creator Docs: Script Editor (auf Englisch). das Fenster Script Analysis
- Roblox Creator Docs: Studio interface (auf Englisch). wo sich Output und Command Bar öffnen
- Roblox Creator Docs: Script types and locations (auf Englisch). wo jeder Skripttyp läuft, und RunContext
- Roblox Creator Docs: Studio testing modes (auf Englisch). Play, die Ansichten Client und Server, und Tests mit Server & Clients
- Roblox Engine API: Instance (auf Englisch). WaitForChild, sein Timeout und die Warnung nach 5 Sekunden
- Roblox Creator Docs: Reuse code (auf Englisch). ModuleScripts und rekursive requires
- Roblox Creator Docs: Data store error codes and limits (auf Englisch). Fehler 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (auf Englisch). den Studio-Zugriff einschalten und eine separate Testkopie nutzen
- Roblox Engine API: BasePart (auf Englisch). wann Touched feuert, und CanTouch
- Roblox Creator Docs: Type checking (auf Englisch). Strict Mode
- Roblox Creator Docs: Developer Console (auf Englisch). wer in einem Live-Spiel die Server-Ausgabe sieht
- Roblox Creator Docs: Build your first game with Assistant (auf Englisch). einen Output-Fehler einfügen, damit Assistant ihn diagnostiziert
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.