Pe scurt
Deschide fereastra Output din meniul Window sau din fila Script, apasă Play și dă clic pe prima eroare roșie. Studio deschide scriptul la rândul unde a căzut. Mesajul spune ce a mers prost: attempt to index nil with 'Humanoid' înseamnă că valoarea de imediat dinainte de .Humanoid era nil. Repară motivul pentru care lipsește acea valoare și pornește din nou jocul.
- Începe cu prima eroare din listă. Erorile de dedesubt sunt adesea doar urmările ei.
- Erorile frecvente din timpul jocului se reduc la trei cauze: valoarea e
nil, numele e scris greșit sau nu s-a încărcat încă ori codul rulează pe partea greșită (server sau client). - Dacă nu e deloc vreo eroare, de obicei codul pur și simplu nu a rulat. Verifică tipul scriptului, unde stă în Explorer, proprietatea lui
Enabledși dacă evenimentul pe care îl așteaptă se declanșează vreodată. - Ca să afli cât e de fapt o valoare pe rândul care te interesează, afișeaz-o cu print și o etichetă sau pune un breakpoint pe acel rând.
Pe această pagină
Cum deschizi Output și cum citești o eroare
Fereastra Output e locul unde Roblox raportează erorile de script, avertismentele motorului și tot ce afișează codul tău. Nu e mereu deschisă, așa că deschide-o înainte de test. Dacă n-ai rulat încă niciun script, ghidul de scripting pentru începători începe chiar cu deschiderea Output și afișarea primului rând dintr-un script.
- Deschide Output din meniul Window din Studio sau cu butonul din fila Script.
- Șterge mesajele vechi cu Ctrl+K (⌘K pe Mac), ca să vezi doar acest test.
- Apasă Play (F5) și fă ce strică jocul.
- Găsește primul rând roșu. Erorile sunt roșii. Avertismentele, de exemplu
Infinite yield possible, apar cu portocaliu.
O eroare din timpul jocului arată așa în Output. În funcție de setările de afișare ale Output, fiecare rând mai poate avea ora, eticheta Client sau Server și numele scriptului.
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.CoinPade locul scriptului în Explorer: un script numit CoinPad în ServerScriptService.:14e rândul pe care a apărut eroarea.- Mesajul de după numărul rândului spune ce a mers prost. Fiecare e explicat în lista erorilor frecvente de mai jos.
- Stiva dintre Stack Begin și Stack End arată apelurile care au dus aici, începând cu ultimul: rândul 14 din funcția
award, apelată de pe rândul 27.
Dă clic pe o eroare roșie, iar Studio deschide acel script cu cursorul pe rândul potrivit. Într-un test solo, mesajele serverului și ale clientului tău merg în același Output: cele de server sunt marcate cu verde, cele de client cu albastru. Filtrele de sus restrâng lista după tipul mesajului (Error, Warning), după context (Client, Server) sau după text.
O ordine de depanare potrivită pentru orice script
Să ghicești și să schimbi mai multe lucruri deodată e o cale lentă de a repara un script. Ordinea asta restrânge problema pas cu pas, fie că există un mesaj de eroare, fie că nu.
- Reprodu problema. Șterge Output, apasă Play și fă exact ce strică jocul. Notează ce te așteptai și ce s-a întâmplat în schimb.
- Ia prima eroare. Citește primul rând roșu nou: calea scriptului, numărul rândului și mesajul. Dacă nu e nicio eroare, treci la secțiunea scripturi care rulează fără erori.
- Mergi la rând. Dă clic pe eroare. Citește tot rândul și întreabă-te ce valoare din el poate fi
nil, scrisă greșit sau de tipul greșit. - Verifică valoarea, nu o ghici. Adaugă un
printchiar deasupra rândului sau pune pe el un breakpoint și uită-te la valori în fereastra Watch.typeof(x)îți spune ce ai: număr, șir, Instance sau nil. - Mergi înapoi pe urme. Dacă valoarea e greșită, găsește unde a fost setată: un
FindFirstChildcare nu a găsit nimic, o funcție care nu a returnat nimic, un argument pe care codul apelant nu l-a transmis niciodată. - Repară cauza, câte o schimbare odată. Corectează numele, așteaptă obiectul sau mută codul pe partea potrivită, apoi pornește din nou jocul. Nu înveli rândul într-un
pcallca să tacă: așa bug-ul se ascunde, nu se repară. - Asigură-te. Repetă pasul 1. Eroarea trebuie să dispară, iar funcția trebuie să facă ce te așteptai. Dacă e vorba de alți jucători, testează și în modul Server & Clients cu doi clienți.
- Fă curat. Șterge sau dezactivează print-urile de depanare, ca următoarea problemă să se observe ușor.
Erori frecvente în scripturile Roblox și cum le repari
Fiecare mesaj e construit după același tipar, în care se pun numele tale, așa că textul erorii e cel mai bun indiciu. Numele dintre ghilimele de mai jos, de exemplu 'Health' sau "Workspace", sunt exemple.
| Ce scrie Output | Ce înseamnă | Cum se repară de obicei |
|---|---|---|
attempt to index nil with 'Health' | Valoarea de dinainte de .Health era nil. | Află de ce e nil și verific-o cu un if înainte s-o folosești. |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | WaitForChild așteaptă deja de 5 secunde, iar obiectul nu a apărut. | Repară numele sau calea, asigură-te că obiectul e creat de cineva sau adaugă un timeout. |
Bridge is not a valid member of Workspace "Workspace" | Un obiect copil sau o proprietate cu exact acest nume nu există acolo acum. | Compară scrierea și majusculele cu Explorer. Pe client folosește WaitForChild. |
attempt to call a nil value | Ai apelat ceva ce nu e o funcție. | Verifică numele funcției și dacă e declarată deasupra apelului. |
attempt to perform arithmetic (add) on Instance and number | Calcule cu ceva ce nu e un număr. | Folosește .Value la value-object-uri și tonumber pentru text. |
attempt to concatenate string with nil | .. a încercat să lipească text cu nil sau cu un obiect. | Folosește tostring(), .Name sau interpolarea șirurilor. |
Expected 'end' (to close 'function' at line 3), got <eof> | O eroare de sintaxă. Scriptul nu rulează deloc. | Repară ce e subliniat cu roșu în Script Editor. |
Requested module experienced an error while loading | ModuleScript-ul însuși a căzut cu o eroare cât rula. | Repară eroarea proprie a modulului, arătată puțin mai sus în Output. |
Argument 1 missing or nil | O funcție Roblox a primit nil acolo unde îi trebuie o valoare. | Urmărește de unde trebuia să vină acest argument. |
FireServer can only be called from the client | Un RemoteEvent a fost apelat din partea greșită. | Serverul folosește FireClient, LocalScript-urile folosesc FireServer. |
Eroarea de data store 403, StudioAccessToApisNotAllowed | Studio nu are voie să folosească data store-urile acestui joc. | Publică jocul și activează Studio Access to API Services. |
Fiecare mesaj de aici, și nu numai, are propria pagină cu fiecare cauză, codul care o provoacă și reparația: vezi mesajele de eroare din Roblox Studio, de exemplu attempt to index nil, Infinite yield possible și is not a valid member of.
attempt to index nil with 'X'
Indexarea înseamnă să citești ceva prin punct sau paranteze drepte: part.Position, player.Character, list[1]. Eroarea spune că ce era în stânga era nil, iar numele dintre ghilimele e ce ai încercat să citești din el. Deci, pe rândul player.Character.Humanoid, eroarea attempt to index nil with 'Humanoid' înseamnă că player.Character era nil. Dacă cheia e un număr, mesajul se termină cu with number.
Motivele obișnuite pentru care valoarea era nil:
FindFirstChild,FindFirstChildOfClasssauFindFirstAncestornu a găsit nimic, pentru că numele e altul sau obiectul încă nu există.Players.LocalPlayera fost folosit într-un Script de server. Există doar în LocalScript-uri și în ModuleScript-urile pe care acestea le includ prin require; pe server e mereu nil. Folosește în schimbplayer-ul dat dePlayerAddedsau de handler-ul unui RemoteEvent.player.Charactera fost citit înainte să apară personajul sau cât acesta reapare.- O intrare din tabel nu a fost setată niciodată, de exemplu
playerData[player]înainte să se încarce datele acelui jucător, sau funcția apelată nu a returnat nimic.
Cazul clasic e kill brick-ul. Versiunea stricată presupune că tot ce atinge part-ul aparține unui personaj, iar pentru instrumentele aruncate, part-urile neancorate și accesorii nu e așa.
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- Versiunea stricată:
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- Dacă part-ul care a atins nu e o parte a corpului unui personaj, FindFirstChild
-- returnează nil, iar Output arată:
-- attempt to index nil with 'Health'
-- Reparat: verificăm fiecare pas înainte de folosire
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
Dacă scrii hit.Parent.Humanoid, apare alt mesaj, Humanoid is not a valid member of ..., explicat mai jos. FindFirstAncestorOfClass("Model") găsește personajul și când part-ul care a atins e într-un accesoriu sau într-un instrument din mâna personajului, așa că și un instrument din mână care atinge blocul contează.
Tiparul care repară această eroare: obții valoarea, o verifici și abia apoi o folosești. Pe server, FindFirstChild cu o verificare if e potrivit pentru ce poate foarte bine să lipsească. Într-un LocalScript folosește WaitForChild pentru ce creează serverul, pentru că poate apărea abia după pornirea scriptului.
Infinite yield possible on ...
WaitForChild("Name") pune scriptul pe pauză până apare un obiect copil cu acest nume. Dacă așteaptă mai mult de 5 secunde și nu ai setat un timeout, Roblox afișează acest avertisment. E un avertisment, nu o eroare: scriptul încă așteaptă, iar nimic de după acest rând nu rulează până nu apare obiectul, ceea ce s-ar putea să nu se întâmple niciodată. Cauzele obișnuite:
- Nume sau părinte greșit.
WaitForChild("leaderStats")nu va găsi niciodată folderulleaderstats. - Obiectul nu e creat de nimeni: scriptul de server care îl face e dezactivat, stă în locul greșit sau a căzut mai devreme cu o eroare. Caută o eroare anterioară în Output.
- Un LocalScript așteaptă ceva din ServerStorage sau ServerScriptService. Conținutul lor nu se trimite niciodată jucătorilor, așa că așteptarea nu se termină.
- Aștepți o proprietate, nu un obiect copil. Un exemplu frecvent e
player:WaitForChild("Character"):Charactere o proprietate a Player, nu un obiect din el. - E activat streamingul de obiecte (
Workspace.StreamingEnabled), iar part-ul e prea departe de jucător, așa că încă nu a fost trimis acestui client.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Versiunea stricată:
-- local character = player:WaitForChild("Character")
-- Character e o proprietate a Player, nu un obiect copil, așa că Output avertizează:
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- Cu timeout, WaitForChild returnează nil în loc să aștepte la nesfârșit
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
-- Tratăm personajul care poate exista deja, apoi fiecare respawn
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
Un număr ca al doilea argument al WaitForChild e un timeout în secunde. Atunci scriptul poate raporta problema prin warn și se poate opri curat, în loc să stea blocat în tăcere.
X is not a valid member of Y
Ai accesat prin punct un obiect copil sau o proprietate care nu există în acel moment, de exemplu workspace.Bridge, când în Workspace nu e niciun part numit Bridge. Mesajul arată întâi ce ai cerut, apoi clasa și calea completă a obiectului în care ai căutat. Verifică trei lucruri:
- Scrierea și majusculele se potrivesc exact cu Explorer. Folderul se numește
leaderstats, cu litere mici, iarhumanoidnu eHumanoid. - Numele proprietăților se scriu în engleza americană.
part.Colourcade cuColour is not a valid member of Part "Workspace.Part"; proprietatea se numeșteColor. - Obiectul s-a încărcat. Pe client, obiectele create de server pot sosi abia după pornirea LocalScript-ului, așa că acolo folosește
WaitForChild.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Versiunea stricată:
-- local coins = player.leaderstats.Coins
-- leaderstats îl creează serverul și poate ajunge la acest client abia după
-- pornirea acestui script. Atunci Output arată:
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- serverul face Coins ca IntValue
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
Aici e nevoie de un script de server care creează leaderstats cu un IntValue numit Coins, ca în ghidul despre clasament.
attempt to call a nil value
Codul a pus paranteze după ceva ce e nil, așa că nu era nimic de rulat. Cauzele obișnuite:
- Numele funcției e scris greșit sau diferă prin majuscule. Modulul declară
Format.clock, iar codul apelant scrieFormat.Clock(95). - O
local functione apelată pe un rând deasupra declarației ei. În acel moment numele încă nu există, așa că mută declarația mai sus. - Un ModuleScript nu adaugă niciodată funcția în tabelul pe care îl returnează.
Două mesaje asemănătoare indică aceeași greșeală. Apelul unei metode inexistente a unui tabel prin două puncte dă attempt to call missing method 'Kill' of table. O greșeală de tastare în metoda unui obiect Roblox, de exemplu part:Destory(), dă Destory is not a valid member of Part "Workspace.Part".
attempt to perform arithmetic (add) on ...
Luau a încercat să calculeze (add, sub, mul, div și așa mai departe), iar una dintre părți nu era un număr. Numele tipurilor de la finalul mesajului îți spun ce caz ai:
on Instance and number: ai calculat cu un value-object, nu cu numărul lui.coins + 10trebuie să fiecoins.Value + 10.on nil and number: variabila sau intrarea din tabel nu a fost setată niciodată. Dă-i o valoare inițială sau scrie(x or 0)acolo unde lipsa valorii chiar înseamnă zero.on string and number: un text care nu e un număr, adesea dintr-un TextBox. Transformă-l printonumber(text)și verifică dacă rezultatul nu e nil. Un text în care e scris un număr, de exemplu"5", se transformă automat.
Comparațiile se strică la fel, cu attempt to compare nil < number. Luau rescrie a > b ca b < a, așa că ordinea din mesaj poate fi inversă față de codul tău.
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
-- Scriem de ce nu s-a întâmplat nimic, în loc să tăcem
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- Versiunea stricată:
-- coins = coins + amount
-- coins e obiectul IntValue, nu numărul lui, așa că Output arată:
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- În fiecare minut îi dăm fiecărui jucător de pe server câteva monede
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
Operatorul .. lipește doar șiruri și numere. Nu poți lipi cu nil și nici cu un obiect: "Hi " .. player dă attempt to concatenate string with Instance. Folosește player.Name, învelește valoarea în tostring() sau folosește interpolarea șirurilor cu backtick-uri, print(`Coins: {coins}`), care afișează nil în loc să oprească scriptul.
Expected 'end' și alte erori de sintaxă
Mesajele care încep cu Expected sunt erori de sintaxă: codul nu e Luau corect, Roblox nu-l poate compila și nu rulează niciun rând din acest script, nici măcar cele de deasupra erorii. Script Editor le subliniază cu roșu chiar în timp ce scrii, așa că le poți repara înainte să apeși Play.
Expected 'end' (to close 'function' at line 3), got <eof>: unfunction,if,forsauwhilecare începe pe rândul 3 nu are propriulend. Numărul rândului de dinaintea mesajului indică adesea sfârșitul fișierului, așa că uită-te la rândul numit în paranteze.Expected 'then' when parsing if statement, got '=': un singur=într-o condiție. Pentru comparație îți trebuie==.Expected ')' (to close '(' at line 1), got 'local': paranteza nu a fost închisă.Expected <eof>, got 'end': unendîn plus.
Cu o indentare regulată, un end lipsă sau în plus se observă ușor, pentru că fiecare bloc stă la același nivel cu end-ul care îl închide.
Requested module experienced an error while loading
Primul require() al unui ModuleScript îi rulează codul. Dacă modulul cade cu o eroare în timpul rulării, scriptul care l-a inclus primește acest mesaj. Problema reală e eroarea proprie a modulului, cu un rând sau două mai sus în Output: pe ea o repari. Două mesaje asemănătoare:
Module code did not return exactly one value: modulul nu se termină cureturn. Un ModuleScript trebuie să returneze o singură valoare, nu nil, de obicei tabelul lui.Requested module was required recursively: două module se includ unul pe altul. Mută partea comună într-un al treilea modul, pe care îl includ amândouă.
local Format = {}
-- Transformă un număr de secunde în minute și secunde: 95 devine "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
-- Modulul trebuie să-și returneze tabelul la final. Fără acest rând, fiecare
-- require al acestui modul cade cu: Module code did not return exactly one value
return Format
Un script îl include prin local Format = require(ReplicatedStorage:WaitForChild("Format")), apoi apelează Format.clock(95). Dacă scrii Format.Clock(95), primești eroarea attempt to call a nil value.
Argument 1 missing or nil
O funcție Roblox a primit nil într-un argument de care are nevoie, iar numărul spune care anume. workspace:FindFirstChild(itemName) cade așa când itemName e nil. Bug-ul stă rar pe acest rând. E acolo de unde trebuia să vină valoarea: o variabilă cu greșeală de tastare, un atribut care nu a fost setat niciodată sau un argument de RemoteEvent pe care clientul nu l-a trimis. Argumentele RemoteEvent vin de pe dispozitivul jucătorului, așa că serverul trebuie să le verifice înainte de folosire. Cum faci asta arată ghidul despre RemoteEvent.
FireServer can only be called from the client
Un RemoteEvent are o direcție. Un LocalScript apelează FireServer, iar un Script de server ascultă prin OnServerEvent. Un Script de server apelează FireClient sau FireAllClients, iar LocalScript-urile ascultă prin OnClientEvent. Apelul unei metode din partea greșită dă această eroare sau pe cea în oglindă, FireClient can only be called from the server. De obicei reparația e să muți codul într-un script de tipul potrivit: vezi Script, LocalScript și ModuleScript.
Eroarea de data store 403 în Studio
Apelurile de data store din Studio cad cu codul de eroare 403 (StudioAccessToApisNotAllowed) până nu le permiți. Publică place-ul, deschide File, Experience Settings, Security, activează Enable Studio Access to API Services și salvează. După asta Studio folosește aceleași data store-uri ca jocul live, așa că Roblox recomandă să faci asta într-o copie de test separată, nu într-un joc în care deja se joacă. Învelește fiecare apel de data store într-un pcall, pentru că astfel de apeluri pot cădea din motive din afara codului tău. Cum salvezi în siguranță e explicat în tutorialul DataStore.
Scriptul rulează fără erori, dar nu face nimic
Un script care tace de obicei nu a rulat deloc, încă așteaptă ceva sau a rulat pe partea greșită. Înainte să schimbi codul, pune ca prim rând print(script:GetFullName(), "started") și pornește jocul. Dacă acest rând nu apare niciodată în Output, problema e unde stă scriptul sau cum e configurat, nu ce scrie în el.
| Ce verifici | Ce merge prost | Cum repari |
|---|---|---|
| Tipul și locul scriptului | Un LocalScript rulează doar dacă îl pui în StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack sau ReplicatedFirst (din containerele Starter rulează ca o copie a jucătorului). Dacă îl pui în Workspace, ServerScriptService sau ReplicatedStorage, nu rulează niciodată. Un Script cu RunContext implicit rulează doar în Workspace sau ServerScriptService. | Mută-l sau ia alt tip de script. Codul de interfață și de control merge într-un LocalScript, regulile jocului merg într-un Script în ServerScriptService. |
| Enabled | Un script cu Enabled debifat nu rulează. | Selectează-l și bifează Enabled în fereastra Properties. |
| RunContext | RunContext-ul unui Script decide unde rulează. Legacy, valoarea implicită, rulează pe server din Workspace sau ServerScriptService. Server rulează pe server, Client rulează pe dispozitivul fiecărui jucător, de exemplu din ReplicatedStorage. | Setează-l conștient. Documentația Roblox recomandă să pui un Script Client în ReplicatedStorage sau ReplicatedFirst, iar un LocalScript în containerele Starter. |
| Evenimentul nu se declanșează | Touched se declanșează doar din mișcare fizică, are nevoie ca cel puțin unul dintre cele două part-uri să nu fie ancorat și de CanTouch la amândouă. PlayerAdded nu se declanșează pentru jucătorii care erau deja pe server când te-ai conectat la eveniment. Handler-ul unui RemoteEvent nu rulează dacă cealaltă parte nu declanșează niciodată evenimentul. | Pune un print în handler ca să afli sigur dacă rulează, apoi repară ce trebuie să-l declanșeze. |
| Cod după o buclă sau o așteptare | Rândurile de sub o buclă while true do nu rulează niciodată, pentru că bucla nu se termină. Nici rândurile de sub un WaitForChild care nu găsește niciodată obiectul nu rulează. | Conectează evenimentele înainte de buclă sau pornește bucla prin task.spawn. Dă-le așteptărilor un timeout. |
| O verificare care iese în tăcere | O protecție precum if not coins then return end oprește în tăcere funcția când obiectul lipsește. | Adaugă un warn cu detalii înainte de return. |
| Filtrele Output | Output se poate filtra după tipul mesajului, după Client sau Server și după text. Un filtru uitat poate ascunde eroarea pe care o cauți. | Resetează filtrele și golește câmpul de căutare. |
| Vezi doar tu | Schimbarea a făcut-o un LocalScript, așa că o vede doar acel jucător. Serverul și ceilalți jucători nu o văd. | Fă schimbarea pe server. Vezi unde rulează scripturile. |
La cazul cu PlayerAdded se prind mulți, pentru că într-un test Studio intri aproape imediat după pornirea serverului. Dacă ceva deasupra rândului cu Connect așteaptă, de exemplu un WaitForChild, un task.wait sau un require al unui modul care așteaptă, poți intra înainte să apară conexiunea. Tratează atât jucătorii noi, cât și pe cei deja intrați:
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- Pentru jucătorii care erau deja aici când s-a executat rândul de mai sus,
-- PlayerAdded din acest script nu se declanșează, așa că îi tratăm acum
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Instrumente de depanare în Roblox Studio
print și warn cu context
print scrie un rând în Output, iar warn scrie un avertisment. E cel mai rapid mod de a răspunde la întrebările "a rulat asta măcar?" și "cât e această valoare?". Un print(x) gol e greu de găsit mai târziu, așa că adaugă o etichetă și detaliile importante. typeof(x) arată ce fel de valoare e: număr, șir, Instance sau nil, iar GetFullName() arată ce obiect anume ai.
local Players = game:GetService("Players")
local DEBUG = true -- pune false când termini
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 și ClassName arată ce e de fapt valoarea
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Câmpul de căutare din Output filtrează după text, așa că o etichetă constantă precum [ShopServer] îți permite să arăți doar rândurile acestui sistem. Dacă trebuie să afli cum a ajuns codul la un rând, debug.traceback() returnează stiva curentă de apeluri ca șir.
Breakpoint-uri și execuție pas cu pas
Un breakpoint pune jocul pe pauză pe un rând, ca să te poți uita la tot în acel moment. În Script Editor dă clic pe marginea din dreapta numărului de rând (apare un cerc roșu), apoi pornește un playtest. Când execuția ajunge la acel rând, jocul se pune pe pauză, iar o săgeată galbenă arată rândul următor. Mai departe prin cod te duc butoanele de execuție pas cu pas:
- Step Over (F10) execută rândul curent și se oprește pe următorul.
- Step Into (F11) intră în funcția apelată pe acest rând.
- Step Out (Shift+F11) duce funcția curentă până la capăt și se oprește în codul care a apelat-o.
- Resume Scripts continuă până la următorul breakpoint.
Un clic dreapta pe margine mai dă două tipuri utile. Un breakpoint condiționat pune pe pauză doar când o expresie precum amount < 0 e adevărată. Un logpoint afișează un mesaj în Output fără pauză, așa că poți înregistra o valoare fără să schimbi scriptul.
Watch și Call Stack
Cât jocul e pe pauză, treci cu mouse-ul peste o variabilă din Script Editor ca să-i vezi valoarea. Fereastra Watch, în fila Variables, arată toate variabilele din domeniul curent, iar în fila My Watches poți scrie orice expresie, de exemplu coins.Value + amount, și îi vezi valoarea curentă. Fereastra Call Stack arată ce funcție a apelat-o pe care ca să se ajungă la rândul pus pe pauză. Amândouă se deschid din fila Script sau din meniul Window.
Script Analysis și modul strict
Script Editor subliniază problemele chiar în timp ce scrii, iar fereastra Script Analysis, deschisă cu butonul Analysis din fila Script, arată erorile și avertismentele din toate scripturile. Prinde erorile de sintaxă și numele necunoscute înainte să apeși Play. Dacă pui ca prim rând al unui script --!strict, se activează verificarea strictă de tipuri Luau, care raportează și greșeli de tastare în proprietăți, tipuri greșite de argumente și valori care pot fi nil. Dar nu vede jocul pornit: un part care lipsește din Workspace îl arată doar Output.
Command bar
Command bar (în fila Script sau Ctrl+9, ⌘9 pe Mac) execută imediat Luau. Cât jocul rulează, e o cale rapidă de a pune o întrebare: print(workspace:FindFirstChild("Bridge")) îți spune dacă există un astfel de part, iar print(#game:GetService("Players"):GetPlayers()) numără jucătorii. În modul de editare, codul din command bar îți schimbă place-ul de-adevăratelea, așa că ai grijă cu tot ce mută sau șterge obiecte.
Developer Console într-un joc live
Output din Studio funcționează doar în Studio. Într-un joc live apasă F9 sau scrie /console în chat ca să deschizi Developer Console. Log-ul ei arată ce afișează dispozitivul tău, iar ce afișează serverul, dacă ești proprietarul jocului sau membru al unui grup cu dreptul de a-l edita.
Assistant-ul integrat din Roblox poate ajuta și el cu un mesaj anume: propriul ghid al Roblox recomandă să lipești eroarea din Output și să-i ceri lui Assistant s-o explice. Dacă Assistant nu mai răspunde sau scrie că ai atins o limită, vezi limitele și erorile Assistant.
Repararea erorilor cu RoCode
RoCode este un agent AI independent pentru Roblox Studio: descrii problema în chatul web, iar pluginul pentru Studio citește și editează place-ul pe care îl ai deschis. La erori poate prelua pașii de citire din ordinea de mai sus, sprijinindu-se pe playtestul pe care l-ai rulat deja.
Am apăsat Play și clicul pe butonul de magazin nu face nimic. Output arată attempt to index nil with 'Coins'. Găsește cauza și repar-o.
- Citește Output-ul din Studio cu instrumentul lui Check Output, inclusiv rândurile Server și Client din ultimul tău playtest, chiar și după ce ai apăsat Stop
- Deschide scriptul din eroare prin Read Script și citește codul din jurul acelui rând, iar prin Search Scripts poate găsi unde trebuia creată valoarea lipsă
- Face o editare precisă prin Edit Script, o căutare și înlocuire exactă în acel script, apoi rulează Check Script, care compilează scriptul în Studio (nu verifică tipurile, nu rulează un linter și nu îți execută codul)
- Trimite modificările în Studio în loturi, iar fiecare lot e un punct de anulare în istoria Studio
Apasă din nou Play și dă clic pe butonul de magazin ca să te convingi singur de reparație: cu pluginul 3.9 sau mai nou, RoCode poate porni un playtest scurt și citi erorile, iar cu pluginul 3.9.15 sau mai nou personajul lui de test poate apăsa butoane de pe ecran, dar verifică doar ce a hotărât el să testeze, iar verificarea de compilare nu-ți spune dacă logica jocului e corectă. Citirea erorilor face parte din fiecare construcție: bucla de construcție, verificare și test pentru un joc întreg repetă această verificare după fiecare sistem. Cum se conectează RoCode la Studio.
Întrebări frecvente
De ce nu merge un script în Roblox, deși nu sunt erori?
De obicei scriptul nu a rulat deloc (tipul de script sau containerul e greșit ori Enabled e dezactivat), încă așteaptă ceva sau evenimentul pe care îl ascultă nu se declanșează niciodată. Un print pe primul rând îți arată care variantă e. Vezi lista de verificare de mai sus.
Ce înseamnă "attempt to index nil" în Roblox?
Valoarea de dinainte de punct sau de două puncte era nil, așa că Roblox nu a putut să se uite înăuntru. Pe rândul player.Character.Humanoid, eroarea attempt to index nil with 'Humanoid' înseamnă că player.Character era nil: lipsește sau încă nu s-a încărcat. Verifică valoarea cu un if înainte de folosire, iar într-un LocalScript așteaptă obiectele create de server prin WaitForChild. Mai multe despre cauze.
Ce înseamnă "infinite yield possible" în Roblox?
WaitForChild așteaptă de peste 5 secunde un obiect copil care nu a apărut și continuă să aștepte. Adesea e un nume sau un părinte greșit ori obiectul nu e creat de nimeni. Mai multe despre cauze.
De ce e fereastra Output goală sau nu apare?
Deschide-o din meniul Window sau din fila Script. Dacă e deschisă, dar rămâne goală în timpul testului, resetează filtrele și câmpul de căutare, apoi verifică dacă scripturile care ar trebui să afișeze ceva chiar rulează.
Are Roblox o verificare a scripturilor pentru erori?
Da, e integrată în Studio: Script Editor subliniază problemele în timp ce scrii, iar fereastra Script Analysis le arată ca listă. Găsesc erorile de sintaxă și de tipuri, dar nu și obiectele lipsă sau logica greșită a jocului: asta se vede doar când codul rulează.
Trebuie să învelesc codul în pcall ca să nu fie erori?
Doar apelurile care pot cădea din motive din afara codului tău, de exemplu cererile la data store-uri, HTTP sau MarketplaceService. Dacă învelești în pcall o eroare cu nil, mesajul dispare, dar funcția tot nu va merge.
Cum văd erorile de script într-un joc live?
Apasă F9 în joc sau scrie /console în chat ca să deschizi Developer Console. Arată erorile de pe dispozitivul tău, iar pe cele de pe server, dacă ești proprietarul jocului sau membru al unui grup care îl poate edita.
Surse și lecturi suplimentare
- Roblox Creator Docs: Output (în engleză). unde se află Output, filtrele și setările lui de afișare
- Roblox Creator Docs: Debugging (în engleză). breakpoint-uri, execuție pas cu pas, Watch, Call Stack, command bar și Developer Console
- Roblox Creator Docs: Script Editor (în engleză). fereastra Script Analysis
- Roblox Creator Docs: Studio interface (în engleză). unde se deschid Output și command bar
- Roblox Creator Docs: Script types and locations (în engleză). unde rulează fiecare tip de script și RunContext
- Roblox Creator Docs: Studio testing modes (în engleză). Play, vederile Client și Server și testele Server & Clients
- Roblox Engine API: Instance (în engleză). WaitForChild, timeout-ul lui și avertismentul după 5 secunde
- Roblox Creator Docs: Reuse code (în engleză). ModuleScript și require recursiv
- Roblox Creator Docs: Data store error codes and limits (în engleză). eroarea 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (în engleză). activarea accesului din Studio și copia de test separată
- Roblox Engine API: BasePart (în engleză). când se declanșează Touched și CanTouch
- Roblox Creator Docs: Type checking (în engleză). modul strict
- Roblox Creator Docs: Developer Console (în engleză). cine vede output-ul serverului într-un joc live
- Roblox Creator Docs: Build your first game with Assistant (în engleză). lipirea unei erori din Output ca s-o explice Assistant
Cum a fost verificat codul: fiecare script de pe această pagină trece printr-o verificare strictă a tipurilor Luau cu definițiile API Roblox (luau-lsp, 20 noiembrie 2026). Verificarea tipurilor prinde nume greșite de API și tipuri greșite, dar nu și greșelile de logică a jocului, așa că testează totul în Studio înainte să publici.