Handleiding · Debuggen

Hoe los je scriptfouten op in Roblox Studio

Als een script in Roblox kapotgaat, vertelt Studio meestal in het venster Output waar en waarom. In deze handleiding lees je hoe je die melding leest, wat veelvoorkomende fouten betekenen en hoe je elke fout oplost, wat je controleert als een script helemaal niets doet zonder foutmelding, en een werkwijze die de oorzaak vindt in plaats van te gokken.

Bijgewerkt 20 november 202621 min lezenAuteur:

In het kort

Open het venster Output via het menu Window of het tabblad Script, klik op Play en klik op de eerste rode fout. Studio opent het script op de regel waar het misging. De melding zegt wat er fout ging: attempt to index nil with 'Humanoid' betekent dat de waarde direct vóór .Humanoid nil was. Los op waarom die waarde ontbreekt en start de game opnieuw.

  • Begin bij de eerste fout in de lijst. Fouten daaronder zijn vaak gewoon gevolgen ervan.
  • Veelvoorkomende fouten tijdens het spelen komen neer op drie oorzaken: een waarde is nil, een naam is verkeerd gespeld of nog niet geladen, of de code draait aan de verkeerde kant (server of client).
  • Is er helemaal geen fout, dan is de code meestal gewoon niet gestart. Controleer het type script, waar het in Explorer staat, zijn eigenschap Enabled en of het event waar het op wacht wel afgaat.
  • Wil je weten wat een waarde op een bepaalde regel echt is, print die dan met een label of zet een breakpoint op die regel.
Op deze pagina
  1. Output lezen
  2. Werkwijze
  3. Veelvoorkomende fouten
  4. Geen fouten, er gebeurt niets
  5. Debugtools
  6. Met RoCode
  7. Veelgestelde vragen
  8. Bronnen en verder lezen

Output openen en een fout lezen

IllustratieHet voorbeeld met de kill brick uit de handleiding, versneld: de kapotte regel geeft een fout, en na Stop, de oplossing en een nieuwe playtest valt de part zonder fout.

Het venster Output is de plek waar Roblox scriptfouten, waarschuwingen van de engine en alles wat je code print meldt. Het is niet altijd open, dus open het vóór je test. Heb je nog nooit een script gedraaid, dan begint de handleiding scripten voor beginners met het openen van Output en het printen van een eerste regel vanuit een script.

  1. Open Output via het menu Window in Studio of met de knop op het tabblad Script.
  2. Wis oude meldingen met Ctrl+K (⌘K op Mac), zodat je alleen deze test ziet.
  3. Klik op Play (F5) en doe wat de game kapotmaakt.
  4. Zoek de eerste rode regel. Fouten zijn rood. Waarschuwingen, zoals Infinite yield possible, worden oranje getoond.

Zo ziet een fout tijdens het spelen eruit in Output. Afhankelijk van de weergave-instellingen van Output kan elke regel ook een tijd, een label Client of Server en de naam van het script hebben.

Output (voorbeeld)
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 is de plek van het script in Explorer: een script met de naam CoinPad in ServerScriptService.
  • :14 is de regel waar de fout optrad.
  • De melding na het regelnummer zegt wat er fout ging. Elke melding wordt uitgelegd in de lijst met veelvoorkomende fouten hieronder.
  • De stack tussen Stack Begin en Stack End toont de aanroepen die hiernaartoe leidden, te beginnen met de laatste: regel 14 in de functie award, die werd aangeroepen vanaf regel 27.

Klik op een rode fout en Studio opent dat script met de cursor op de juiste regel. In een solotest komen de meldingen van de server en van je client in dezelfde Output: die van de server zijn groen gemarkeerd, die van de client blauw. Met de filters bovenaan beperk je de lijst op type melding (Error, Warning), op context (Client, Server) of op tekst.

Een debugwerkwijze die voor elk script werkt

Gokken en meerdere dingen tegelijk veranderen is een trage manier om een script te repareren. Deze werkwijze maakt het probleem stap voor stap kleiner, of er nu een foutmelding is of niet.

  1. Herhaal het probleem. Wis Output, klik op Play en doe precies wat de game kapotmaakt. Schrijf op wat je verwachtte en wat er in plaats daarvan gebeurde.
  2. Neem de eerste fout. Lees de eerste nieuwe rode regel: het pad van het script, het regelnummer en de melding. Is er geen fout, ga dan naar het deel scripts die zonder fouten draaien.
  3. Ga naar de regel. Klik op de fout. Lees de hele regel en vraag je af welke waarde erin nil kan zijn, verkeerd gespeld is of het verkeerde type heeft.
  4. Controleer de waarde, gok niet. Zet een print direct boven de regel of zet er een breakpoint op en bekijk de waarden in het venster Watch. typeof(x) vertelt je wat je hebt: een getal, een string, een Instance of nil.
  5. Volg het spoor terug. Is de waarde verkeerd, zoek dan waar hij werd ingesteld: een FindFirstChild die niets vond, een functie die niets teruggaf, een argument dat de aanroepende code nooit heeft meegegeven.
  6. Los de oorzaak op, één wijziging tegelijk. Verbeter de naam, wacht op het object of verplaats de code naar de juiste kant, en start de game dan opnieuw. Verpak de regel niet in pcall om hem stil te krijgen: zo verberg je de bug in plaats van hem op te lossen.
  7. Controleer het. Herhaal stap 1. De fout moet weg zijn en de functie moet doen wat je verwachtte. Gaat het om andere spelers, test dan ook in de modus Server & Clients met twee clients.
  8. Ruim op. Verwijder of schakel de debug-prints uit, zodat je het volgende probleem makkelijk ziet.

Veelvoorkomende scriptfouten in Roblox en hoe je ze oplost

Elke melding volgt een vast patroon waarin jouw namen worden ingevuld, dus de tekst van de fout zelf is de beste hint. Namen tussen aanhalingstekens hieronder, zoals 'Health' of "Workspace", zijn voorbeelden.

Veelvoorkomende fouten in Output. Kies een melding om de volledige uitleg te openen.
Wat Output meldtWat het betekentGebruikelijke oplossing
attempt to index nil with 'Health'De waarde vóór .Health was nil.Zoek uit waarom hij nil is en controleer hem met if voordat je hem gebruikt.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild wacht al 5 seconden en het object is nooit verschenen.Verbeter de naam of het pad, zorg dat iets het object aanmaakt, of voeg een time-out toe.
Bridge is not a valid member of Workspace "Workspace"Een child of eigenschap met precies die naam bestaat daar op dit moment niet.Vergelijk spelling en hoofdletters met Explorer. Gebruik op de client WaitForChild.
attempt to call a nil valueJe hebt iets aangeroepen dat geen functie is.Controleer de naam van de functie en of hij boven de aanroep is gedeclareerd.
attempt to perform arithmetic (add) on Instance and numberRekenen met iets dat geen getal is.Gebruik .Value bij value-objecten en tonumber voor tekst.
attempt to concatenate string with nil.. probeerde tekst aan nil of een object te plakken.Gebruik tostring(), .Name of string-interpolatie.
Expected 'end' (to close 'function' at line 3), got <eof>Een syntaxfout. Het script draait helemaal niet.Los op wat de Script Editor rood onderstreept.
Requested module experienced an error while loadingHet ModuleScript zelf liep vast met een fout terwijl het draaide.Los de eigen fout van de module op; die staat net daarboven in Output.
Argument 1 missing or nilEen Roblox-functie kreeg nil waar ze een waarde nodig heeft.Ga na waar dat argument vandaan had moeten komen.
FireServer can only be called from the clientEen RemoteEvent werd vanaf de verkeerde kant aangeroepen.De server gebruikt FireClient, LocalScripts gebruiken FireServer.
DataStore-fout 403, StudioAccessToApisNotAllowedStudio mag de DataStores van deze game niet gebruiken.Publiceer de game en zet Studio Access to API Services aan.

Elke melding hier, en meer, heeft een eigen pagina met elke oorzaak, de code die hem veroorzaakt en de oplossing: zie de foutmeldingen van Roblox Studio, bijvoorbeeld attempt to index nil, Infinite yield possible en is not a valid member of.

attempt to index nil with 'X'

Indexeren is iets lezen met een punt of vierkante haken: part.Position, player.Character, list[1]. Deze fout zegt dat wat links stond nil was, en de naam tussen aanhalingstekens is wat je eruit probeerde te lezen. Op de regel player.Character.Humanoid betekent de fout attempt to index nil with 'Humanoid' dus dat player.Character nil was. Is de sleutel een getal, dan eindigt de melding op with number.

Gebruikelijke redenen waarom de waarde nil was:

  • FindFirstChild, FindFirstChildOfClass of FindFirstAncestor vond niets, omdat de naam anders is of het object er nog niet is.
  • Players.LocalPlayer werd gebruikt in een server-Script. Die bestaat alleen in LocalScripts en in ModuleScripts die zij met require laden; op de server is hij altijd nil. Gebruik in plaats daarvan de player die PlayerAdded of een handler van een RemoteEvent je geeft.
  • player.Character werd gelezen voordat het personage was gespawnd, of terwijl het respawnt.
  • Een waarde in een tabel werd nooit ingesteld, bijvoorbeeld playerData[player] voordat de data van die speler geladen was, of een aangeroepen functie gaf niets terug.

Het klassieke geval is een kill brick. De kapotte versie gaat ervan uit dat alles wat de part aanraakt bij een personage hoort, en voor gedropte tools, niet-verankerde parts en accessoires klopt dat niet.

Script in Part in Workspace met de naam KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Kapotte versie:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Is de aanrakende part geen deel van het lichaam van een personage, dan geeft
	-- FindFirstChild nil terug en toont Output:
	--   attempt to index nil with 'Health'

	-- Opgelost: we controleren elke stap voordat we hem gebruiken
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Schrijf je hit.Parent.Humanoid, dan krijg je een andere melding, Humanoid is not a valid member of ..., die hieronder wordt uitgelegd. FindFirstAncestorOfClass("Model") vindt het personage ook als de aanrakende part in een accessoire of in een tool in de hand van het personage zit, dus een tool in de hand die de brick raakt telt ook.

Het patroon dat deze fout oplost: haal de waarde op, controleer hem en gebruik hem pas daarna. Op de server is FindFirstChild met een controle via if geschikt voor dingen die er heel goed niet kunnen zijn. Gebruik in een LocalScript WaitForChild voor dingen die de server aanmaakt, want die kunnen pas verschijnen nadat het script is gestart.

Infinite yield possible on ...

WaitForChild("Name") pauzeert het script tot er een child met die naam verschijnt. Wacht het langer dan 5 seconden en heb je geen time-out opgegeven, dan print Roblox deze waarschuwing. Het is een waarschuwing, geen fout: het script wacht nog steeds, en niets na deze regel draait totdat het object verschijnt, wat misschien nooit gebeurt. Gebruikelijke oorzaken:

  • Een verkeerde naam of parent. WaitForChild("leaderStats") vindt nooit een map leaderstats.
  • Niets maakt het object aan: het serverscript dat het maakt staat uit, staat op de verkeerde plek of liep eerder vast met een fout. Zoek naar een eerdere fout in Output.
  • Een LocalScript wacht op iets in ServerStorage of ServerScriptService. De inhoud daarvan wordt nooit naar spelers gestuurd, dus het wachten houdt nooit op.
  • Je wacht op een eigenschap, niet op een child. Een veelvoorkomend voorbeeld is player:WaitForChild("Character"): Character is een eigenschap van Player, geen object daarbinnen.
  • Instance streaming staat aan (Workspace.StreamingEnabled) en de part is te ver van de speler, dus nog niet naar die client gestuurd.
LocalScript in StarterPlayerScripts met de naam DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Kapotte versie:
--   local character = player:WaitForChild("Character")
-- Character is een eigenschap van Player, geen child, dus Output waarschuwt:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Met een time-out geeft WaitForChild nil terug in plaats van eeuwig te wachten
	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

-- Behandel het personage dat misschien al bestaat, en daarna elke respawn
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Een getal als tweede argument van WaitForChild is een time-out in seconden. Dan kan het script het probleem met warn melden en netjes stoppen, in plaats van stil te blijven hangen.

X is not a valid member of Y

Je hebt met een punt een child of eigenschap aangesproken die er op dat moment niet is, bijvoorbeeld workspace.Bridge terwijl er in Workspace geen part met de naam Bridge staat. De melding noemt eerst wat je vroeg en daarna de klasse en het volledige pad van het object waarin werd gezocht. Controleer drie dingen:

  • Spelling en hoofdletters komen precies overeen met Explorer. De map heet leaderstats, helemaal in kleine letters, en humanoid is niet Humanoid.
  • Namen van eigenschappen zijn in Amerikaans Engels. part.Colour loopt vast met Colour is not a valid member of Part "Workspace.Part"; de eigenschap heet Color.
  • Het object is geladen. Op de client kunnen objecten die de server aanmaakt pas aankomen nadat het LocalScript is gestart, dus gebruik daar WaitForChild.
LocalScript in StarterPlayerScripts met de naam CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Kapotte versie:
--   local coins = player.leaderstats.Coins
-- leaderstats wordt door de server aangemaakt en kan pas bij deze client aankomen
-- nadat dit script is gestart. Dan toont Output:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- de server maakt Coins als IntValue

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

Hiervoor is een serverscript nodig dat leaderstats aanmaakt met een IntValue genaamd Coins, zoals in de handleiding over het leaderboard.

attempt to call a nil value

De code zette haakjes achter iets dat nil is, dus er was niets om uit te voeren. Gebruikelijke oorzaken:

  • De naam van de functie is verkeerd gespeld of verschilt in hoofdletters. De module declareert Format.clock, maar de aanroepende code schrijft Format.Clock(95).
  • Een local function wordt aangeroepen op een regel boven de declaratie. Op dat moment bestaat de naam nog niet, dus zet de declaratie hoger.
  • Het ModuleScript voegt de functie nooit toe aan de tabel die het teruggeeft.

Twee vergelijkbare meldingen wijzen op dezelfde fout. Een methode van een tabel die niet bestaat aanroepen met een dubbele punt geeft attempt to call missing method 'Kill' of table. Een typfout in een methode van een Roblox-object, zoals part:Destory(), geeft Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau probeerde te rekenen (add, sub, mul, div enzovoort) en een van de kanten was geen getal. De typenamen aan het einde van de melding vertellen welk geval je hebt:

  • on Instance and number: je rekende met een value-object in plaats van met zijn getal. coins + 10 moet coins.Value + 10 zijn.
  • on nil and number: een variabele of waarde in een tabel werd nooit ingesteld. Geef hem een beginwaarde of schrijf (x or 0) waar een ontbrekende waarde echt nul betekent.
  • on string and number: tekst die geen getal is, vaak uit een TextBox. Zet hem om met tonumber(text) en controleer dat het resultaat niet nil is. Tekst waarin een getal staat, zoals "5", wordt automatisch omgezet.

Vergelijkingen gaan op dezelfde manier mis, met attempt to compare nil < number. Luau herschrijft a > b als b < a, dus de volgorde in de melding kan omgekeerd zijn ten opzichte van je code.

Script in ServerScriptService met de naam 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
		-- Meld waarom er niets gebeurde, in plaats van te zwijgen
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Kapotte versie:
	--   coins = coins + amount
	-- coins is een IntValue-object, niet zijn getal, dus Output toont:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Geef elke minuut elke speler op de server een paar munten
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

De operator .. plakt alleen strings en getallen aan elkaar. Met nil lukt dat niet, en met een object ook niet: "Hi " .. player geeft attempt to concatenate string with Instance. Gebruik player.Name, verpak de waarde in tostring() of gebruik string-interpolatie met backticks, print(`Coins: {coins}`), die nil print in plaats van het script te stoppen.

Expected 'end' en andere syntaxfouten

Meldingen die beginnen met Expected zijn syntaxfouten: de code is geen geldige Luau, Roblox kan hem niet compileren en er draait geen enkele regel van dat script, ook niet de regels boven de fout. De Script Editor onderstreept ze rood terwijl je typt, dus je kunt ze oplossen voordat je op Play klikt.

  • Expected 'end' (to close 'function' at line 3), got <eof>: een function, if, for of while die op regel 3 begint, heeft geen eigen end. Het regelnummer vóór de melding wijst vaak naar het einde van het bestand, dus kijk naar de regel die tussen haakjes wordt genoemd.
  • Expected 'then' when parsing if statement, got '=': een enkele = in een voorwaarde. Om te vergelijken heb je == nodig.
  • Expected ')' (to close '(' at line 1), got 'local': een haakje werd nooit gesloten.
  • Expected <eof>, got 'end': één end te veel.

Met nette inspringing zie je een ontbrekende of overbodige end makkelijk, omdat elk blok op dezelfde hoogte staat als de end die het sluit.

Requested module experienced an error while loading

De eerste require() van een ModuleScript voert de code ervan uit. Loopt de module tijdens het uitvoeren vast met een fout, dan krijgt het script dat hem laadde deze melding. Het echte probleem is de eigen fout van de module, een regel of twee hoger in Output: los die op. Twee vergelijkbare meldingen:

  • Module code did not return exactly one value: de module eindigt niet op return. Een ModuleScript moet één waarde teruggeven, niet nil, meestal zijn tabel.
  • Requested module was required recursively: twee modules laden elkaar. Haal het gedeelde deel naar een derde module die ze allebei laden.
ModuleScript in ReplicatedStorage met de naam Format
local Format = {}

-- Zet een aantal seconden om naar minuten en seconden: 95 wordt "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

-- Een module moet aan het einde zijn tabel teruggeven. Zonder deze regel loopt elke
-- require van deze module vast met: Module code did not return exactly one value
return Format

Een script laadt hem met local Format = require(ReplicatedStorage:WaitForChild("Format")) en roept daarna Format.clock(95) aan. Schrijf je Format.Clock(95), dan krijg je de fout attempt to call a nil value.

Argument 1 missing or nil

Een Roblox-functie kreeg nil in een argument dat ze nodig heeft, en het getal zegt welk argument. workspace:FindFirstChild(itemName) loopt zo vast als itemName nil is. De bug zit zelden op deze regel. Hij zit waar de waarde vandaan had moeten komen: een variabele met een typfout, een attribuut dat nooit werd ingesteld, of een argument van een RemoteEvent dat de client niet stuurde. Argumenten van een RemoteEvent komen van het apparaat van de speler, dus de server moet ze controleren voordat hij ze gebruikt. Hoe je dat doet, laat de handleiding over RemoteEvents zien.

FireServer can only be called from the client

Een RemoteEvent heeft een richting. Een LocalScript roept FireServer aan en een server-Script luistert met OnServerEvent. Een server-Script roept FireClient of FireAllClients aan en LocalScripts luisteren met OnClientEvent. Een methode aanroepen vanaf de verkeerde kant geeft deze fout of de gespiegelde, FireClient can only be called from the server. Meestal is de oplossing de code naar het juiste type script te verplaatsen: zie Script, LocalScript en ModuleScript.

DataStore-fout 403 in Studio

Aanroepen van een DataStore in Studio lopen vast met foutcode 403 (StudioAccessToApisNotAllowed) totdat je ze toestaat. Publiceer de place, open File, Experience Settings, Security, zet Enable Studio Access to API Services aan en sla op. Daarna gebruikt Studio dezelfde DataStores als de live game, dus Roblox raadt aan dit in een aparte testkopie te doen, niet in een game die al gespeeld wordt. Verpak elke DataStore-aanroep in pcall, want zulke aanroepen kunnen mislukken om redenen buiten je code. Hoe je veilig opslaat, lees je in de tutorial over DataStore.

Het script draait zonder fouten maar doet niets

Een stil script is meestal helemaal niet gestart, wacht nog ergens op of is aan de verkeerde kant gestart. Maak voordat je code verandert print(script:GetFullName(), "started") de eerste regel en start de game. Verschijnt die regel nooit in Output, dan zit het probleem in waar het script staat of hoe het is ingesteld, niet in wat erin staat.

Waarom een script niets kan doen zonder fout
Wat je controleertWat er misgaatHoe je het oplost
Type en plek van het scriptEen LocalScript draait alleen als je het in StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack of ReplicatedFirst zet (vanuit de Starter-containers draait het als kopie van de speler). Zet je het in Workspace, ServerScriptService of ReplicatedStorage, dan draait het nooit. Een Script met de standaard RunContext draait alleen in Workspace of ServerScriptService.Verplaats het of gebruik een ander type script. Code voor interface en besturing hoort in een LocalScript, de regels van de game horen in een Script in ServerScriptService.
EnabledEen script waarbij het vinkje Enabled uit staat, draait niet.Selecteer het en vink Enabled aan in het venster Properties.
RunContextDe RunContext van een Script bepaalt waar het draait. Legacy, de standaardwaarde, draait op de server vanuit Workspace of ServerScriptService. Server draait op de server, Client draait op het apparaat van elke speler, bijvoorbeeld vanuit ReplicatedStorage.Stel het bewust in. De Roblox-documentatie raadt aan Client Scripts in ReplicatedStorage of ReplicatedFirst te zetten en LocalScripts in de Starter-containers.
Het event gaat niet afTouched gaat alleen af door fysieke beweging, minstens een van de twee parts moet niet verankerd zijn, en beide hebben CanTouch nodig. PlayerAdded gaat niet af voor spelers die al op de server waren toen je met het event verbond. Een handler van een RemoteEvent draait niet als de andere kant het event nooit aanroept.Zet een print in de handler om zeker te weten of die draait, en los dan op wat hem zou moeten aanroepen.
Code na een lus of wachtenRegels onder een lus while true do draaien nooit, omdat de lus nooit eindigt. Regels onder een WaitForChild die het object nooit vindt, draaien ook niet.Verbind events vóór de lus of start de lus met task.spawn. Geef wachten een time-out.
Een controle die stil stoptEen beveiliging zoals if not coins then return end stopt de functie stilletjes als het object er niet is.Zet een warn met details vóór de return.
Filters in OutputOutput kun je filteren op type melding, op Client of Server en op tekst. Een vergeten filter kan de fout verbergen die je zoekt.Reset de filters en maak het zoekveld leeg.
Alleen jij ziet hetEen LocalScript heeft de wijziging gemaakt, dus alleen die speler ziet hem. De server en andere spelers zien hem niet.Maak de wijziging op de server. Zie waar scripts draaien.

Met het geval van PlayerAdded gaan veel mensen de mist in, omdat je in een test in Studio bijna direct na de start van de server binnenkomt. Als iets boven de regel met Connect wacht, zoals WaitForChild, task.wait of een require van een module die wacht, kun je binnenkomen voordat de verbinding bestaat. Behandel zowel nieuwe spelers als spelers die er al zijn:

Script in ServerScriptService met de naam Welcome
local Players = game:GetService("Players")

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- Voor spelers die er al waren toen de regel hierboven draaide, gaat
-- PlayerAdded in dit script niet af, dus behandelen we ze nu
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Debugtools in Roblox Studio

print schrijft een regel in Output en warn schrijft een waarschuwing. Dat is de snelste manier om de vragen "draaide dit wel?" en "wat is deze waarde?" te beantwoorden. Een kale print(x) is later moeilijk terug te vinden, dus voeg een label en de belangrijke details toe. typeof(x) laat zien wat voor waarde het is: een getal, een string, een Instance of nil, en GetFullName() laat zien welk object je precies hebt.

Script in ServerScriptService met de naam ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- zet op false als je klaar bent
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 en ClassName laten zien wat de waarde echt is
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Het zoekveld in Output filtert op tekst, dus met een vast label zoals [ShopServer] kun je alleen de regels van dat systeem tonen. Wil je weten hoe de code bij een regel kwam, dan geeft debug.traceback() de huidige call stack terug als string.

Breakpoints en stap voor stap uitvoeren

Een breakpoint pauzeert de game op een regel, zodat je alles op dat moment kunt bekijken. Klik in de Script Editor in de marge rechts van het regelnummer (er verschijnt een rode stip) en start dan een playtest. Als de uitvoering die regel bereikt, pauzeert de game en wijst een gele pijl de volgende regel aan. Met de knoppen voor stapsgewijs uitvoeren ga je verder door de code:

  • Step Over (F10) voert de huidige regel uit en stopt bij de volgende.
  • Step Into (F11) gaat de functie in die op deze regel wordt aangeroepen.
  • Step Out (Shift+F11) maakt de huidige functie af en stopt in de code die hem aanriep.
  • Resume Scripts gaat door tot het volgende breakpoint.

Een rechterklik in de marge geeft nog twee handige soorten. Een voorwaardelijk breakpoint pauzeert alleen als een expressie zoals amount < 0 waar is. Een logpoint print een melding in Output zonder te pauzeren, zodat je een waarde kunt loggen zonder het script te veranderen.

Watch en Call Stack

Terwijl de game gepauzeerd is, houd je de muis boven een variabele in de Script Editor om de waarde te zien. Het venster Watch toont op het tabblad Variables alle variabelen in de scope, en op het tabblad My Watches kun je elke expressie invoeren, zoals coins.Value + amount, en de huidige waarde zien. Het venster Call Stack laat zien welke functie welke aanriep om bij de gepauzeerde regel te komen. Beide open je via het tabblad Script of het menu Window.

Script Analysis en strict mode

De Script Editor onderstreept problemen terwijl je typt, en het venster Script Analysis, dat je opent met de knop Analysis op het tabblad Script, toont fouten en waarschuwingen voor alle scripts. Het vangt syntaxfouten en onbekende namen op voordat je op Play klikt. Zet je --!strict als eerste regel van een script, dan gaat de strikte typecontrole van Luau aan, die ook typfouten in eigenschappen, verkeerde typen argumenten en waarden die nil kunnen zijn meldt. Maar de draaiende game ziet hij niet: een part die niet in Workspace staat, laat alleen Output zien.

Command bar

De command bar (op het tabblad Script of Ctrl+9, ⌘9 op Mac) voert Luau direct uit. Terwijl de game draait, is het een snelle manier om een vraag te stellen: print(workspace:FindFirstChild("Bridge")) vertelt of die part bestaat, en print(#game:GetService("Players"):GetPlayers()) telt de spelers. In de bewerkmodus verandert code uit de command bar je place echt, dus wees voorzichtig met alles wat objecten verplaatst of verwijdert.

Developer Console in een live game

De Output van Studio werkt alleen in Studio. Druk in een live game op F9 of typ /console in de chat om de Developer Console te openen. De Log toont de uitvoer van je eigen apparaat, en die van de server als je de eigenaar van de game bent of lid van een groep met het recht om hem te bewerken.

De ingebouwde Assistant van Roblox kan ook helpen met een losse melding: de eigen handleiding van Roblox raadt aan de fout uit Output te plakken en Assistant te vragen die uit te leggen. Reageert Assistant niet meer of zegt hij dat je een limiet hebt bereikt, zie dan limieten en fouten van Assistant.

Fouten oplossen met RoCode

RoCode is een onafhankelijke AI-agent voor Roblox Studio: je beschrijft het probleem in een webchat en de plugin voor Studio leest en bewerkt de place die je open hebt. Bij fouten kan hij de leesstappen uit de werkwijze hierboven overnemen, op basis van de playtest die je al hebt gedraaid.

Jij typt

Ik heb op Play geklikt en een klik op de shopknop doet niets. Output toont attempt to index nil with 'Coins'. Zoek de oorzaak en los het op.

RoCode doet
  • Leest de Output in Studio met zijn tool Check Output, inclusief de regels van Server en Client van je laatste playtest, ook nadat je op Stop hebt geklikt
  • Opent het script uit de fout met Read Script en leest de code rond die regel, en kan met Search Scripts vinden waar de ontbrekende waarde had moeten worden aangemaakt
  • Maakt een gerichte bewerking met Edit Script, een exacte zoek-en-vervang in dat script, en draait daarna Check Script, dat het script in Studio compileert (het controleert geen typen, draait geen linter en voert je code niet uit)
  • Stuurt wijzigingen in groepen naar Studio, en elke groep is een ongedaan-maakpunt in de geschiedenis van Studio

Klik nog eens op Play en klik op de shopknop om zelf te controleren dat het is opgelost: met plugin 3.9 of nieuwer kan RoCode een korte playtest draaien en de fouten lezen, en met plugin 3.9.15 of nieuwer kan zijn testpersonage op knoppen op het scherm drukken, maar hij controleert alleen wat hij zelf heeft besloten te testen, en een compilatiecontrole vertelt je niet of de logica van de game klopt. Het lezen van fouten zit in elke build: de cyclus van bouwen, controleren en testen voor een hele game herhaalt deze controle na elk systeem. Hoe RoCode verbindt met Studio.

Veelgestelde vragen

Waarom werkt een script in Roblox niet terwijl er geen fouten zijn?

Meestal is het script helemaal niet gestart (verkeerd type script of verkeerde container, of Enabled staat uit), wacht het nog ergens op, of gaat het event waar het naar luistert nooit af. Een print op de eerste regel laat zien welk geval het is. Zie de checklist hierboven.

Wat betekent "attempt to index nil" in Roblox?

De waarde vóór de punt of dubbele punt was nil, dus Roblox kon er niet in kijken. Op de regel player.Character.Humanoid betekent de fout attempt to index nil with 'Humanoid' dat player.Character nil was: het bestaat niet of is nog niet geladen. Controleer de waarde met if voordat je hem gebruikt, en wacht in een LocalScript met WaitForChild op objecten die de server aanmaakt. Meer over de oorzaken.

Wat betekent "infinite yield possible" in Roblox?

WaitForChild wacht al meer dan 5 seconden op een child die nooit is verschenen, en blijft wachten. Vaak is de naam of parent verkeerd, of maakt niets het object aan. Meer over de oorzaken.

Waarom is het venster Output leeg of verschijnt het niet?

Open het via het menu Window of het tabblad Script. Is het open maar blijft het tijdens een test leeg, reset dan de filters en het zoekveld en controleer daarna of de scripts die iets zouden moeten printen wel starten.

Heeft Roblox een controle op fouten in scripts?

Ja, die zit in Studio: de Script Editor onderstreept problemen terwijl je typt, en het venster Script Analysis toont ze als lijst. Ze vinden syntaxfouten en typefouten, maar geen ontbrekende objecten en geen verkeerde gamelogica: dat zie je pas als de code draait.

Moet je code in pcall verpakken om fouten te voorkomen?

Alleen aanroepen die kunnen mislukken om redenen buiten je code, zoals verzoeken aan DataStores, HTTP of MarketplaceService. Verpak je een fout met nil in pcall, dan verdwijnt de melding, maar werkt de functie nog steeds niet.

Hoe zie je scriptfouten in een live game?

Druk in de game op F9 of typ /console in de chat om de Developer Console te openen. Die toont fouten van je eigen apparaat, en van de server als je de eigenaar van de game bent of lid van een groep die hem mag bewerken.

Bronnen en verder lezen

Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.

Probeer RoCode in je eigen game.

Elke dag gratis credits, geen creditcard nodig. Installeer de plugin, beschrijf een functie en kijk wat er in Studio verschijnt.