Pe scurt
Ca să scrii un script în Roblox Studio, treci cu mouse-ul peste ServerScriptService în Explorer, apasă + și inserează un Script. Studio îl deschide în Script Editor. Scrie Luau, de exemplu print("Hello"), apasă Play (F5) și citește rezultatul în fereastra Output (meniul Window sau fila Script). Un Script rulează pe server și schimbă totul pentru toți; un LocalScript din StarterPlayerScripts rulează pe dispozitivul unui singur jucător.
- Învață întâi patru idei: variabile (
local coins = 3), funcții (local function name() ... end), condiții if și evenimente (part.Touched:Connect(...)). Cele patru scripturi din acest ghid sunt construite din ele, plus bucle și tabele. - Folosește
task.wait(), nuwait(). Referința Roblox marchează funcția globalăwait()ca învechită și înlocuită detask.wait(). - În setările de afișare ale ferestrei Output activează Show Context, ca fiecare rând să arate dacă a venit de la Server sau de la Client.
Pe această pagină
Înainte să începi: Studio, Baseplate și fereastra Output
Ai nevoie de Roblox Studio și de un cont Roblox, și de nimic altceva: niciun editor de cod, niciun plugin. Fiecare script din acest ghid se scrie în Script Editor-ul propriu al Studio.
- Instalează Roblox Studio, aplicația gratuită a Roblox pentru Windows și Mac, și conectează-te cu contul Roblox.
- Deschide Studio. Pagina de start are șabloane: alege Baseplate. Primești o podea cu o textură de grilă 4x4 și un SpawnLocation, locul unde apare avatarul tău când joci.
- Dacă ferestrele Explorer și Properties nu se văd, deschide-le din meniul Window sau din fila Home. Explorer enumeră toate obiectele din place; Properties arată setările celui selectat.
- Deschide Output din meniul Window sau din fila Script. Aici apar mesajele și erorile scripturilor tale.
- În setările de afișare ale ferestrei Output activează Show Context, care marchează fiecare mesaj ca Client sau Server, și Show Source, care arată scriptul și numărul rândului de unde a venit.
| Script | Tip | Unde stă | Ce te învață |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Variabile, o funcție, o condiție if, bucle și un tabel |
ColourChanger | Script | Într-un Part din Workspace | Schimbarea proprietăților, script.Parent și o buclă cu așteptare |
TouchPad | Script | Într-un Part numit Pad | Evenimente, găsirea jucătorului care a atins un part și debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, în StarterPlayer | Cod pe dispozitivul unui jucător, apăsări de taste și ce rămâne pe acel dispozitiv |
Workspace
Baseplate Part
SpawnLocation SpawnLocation
Part Part new
ColourChanger Script new
Pad Part new
TouchPad Script new
ServerScriptService
FirstScript Script new
StarterPlayer
StarterPlayerScripts
MyFirstLocalScript LocalScript new
Pasul 1: scrie primul script
- În Explorer treci cu mouse-ul peste ServerScriptService, apasă + și alege Script (scurtătura Ctrl+I sau ⌘I pe Mac). Studio creează scriptul și îl deschide în Script Editor.
- Dă clic dreapta pe noul script, alege Rename și numește-l
FirstScript. Numele nu schimbă ce face scriptul, dar îți spune ce script a afișat ce. - Scripturile noi încep cu un singur rând,
print("Hello world!"). Șterge-l și lipește codul de mai jos. - Apasă Play (F5), cu Test ales în lista din stânga lui. Studio pornește un playtest și îți pune avatarul pe SpawnLocation.
- Citește rândurile din Output, apoi apasă Stop (Shift+F5). Stop readuce și toate obiectele la starea dinainte de Play, așa că tot ce ai mutat sau ai revopsit în timpul jocului revine.
-- Script în ServerScriptService cu numele FirstScript.
-- Primul tău Luau: variabile, o funcție, o condiție if, o buclă și un tabel.
-- Apasă Play (F5) și citește rezultatul în fereastra Output.
-- O variabilă e un nume care păstrează o valoare
local gameName = "Coin Run"
local coinsToWin = 3
-- O funcție e un bloc de cod cu nume pe care îl poți rula de oricâte ori.
-- name și goal sunt parametrii ei; return îi dă o valoare înapoi celui care a apelat-o.
local function describe(name: string, goal: number): string
return `{name}: collect {goal} coins to win`
end
print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win
-- O condiție if rulează codul doar când condiția e adevărată
if coinsToWin > 5 then
print("That is a long game")
elseif coinsToWin > 1 then
print("That is a short game")
else
print("One coin and you win")
end
-- O buclă for repetă codul de un număr dat de ori
for count = 1, coinsToWin do
print("Coin number", count)
end
-- Un tabel păstrează o listă de valori; această buclă le parcurge în ordine
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
print(position, colour) --> 1 Red, apoi 2 Green, apoi 3 Blue
end
Tot ce e după -- pe un rând e un comentariu: Luau îl sare, așa că îți poți lăsa notițe. Comentariile --> arată ce afișează rândul.
Output trebuie să arate aceste opt rânduri, amestecate cu mesajele Studio însuși. Când print primește mai multe valori, pune un spațiu între ele. Cu Show Context și Show Source activate, fiecare rând mai e marcat cu Server și FirstScript, cu numărul rândului.
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue
Potrivește fiecare rând cu codul care l-a afișat. Mai târziu vei face același lucru cu mesajele de eroare, așa că obiceiul îți va prinde bine.
FirstScript folosește doar Luau curat, fără obiecte Roblox, așa că merge și în locul de joacă Luau gratuit din browser. Schimbă acolo o valoare și rulează din nou ca să vezi ce se schimbă.
| Cod | Idee | Ce înseamnă |
|---|---|---|
local gameName = "Coin Run" | Variabilă | Un nume care păstrează o valoare. local înseamnă că o poate folosi doar acest script sau blocul în care stă. Textul dintre ghilimele e un șir; 3 e un număr. Numele țin cont de majuscule, așa că coinsToWin și CoinsToWin sunt două variabile diferite. |
local function describe(name: string, goal: number): string | Funcție | Un bloc de cod cu nume pe care îl poți rula de oricâte ori. name și goal sunt parametrii ei: valori transmise la fiecare apel. : string și : number sunt adnotări de tip opționale. Luau le folosește ca să te avertizeze despre greșeli în Script Editor; fără ele codul merge la fel. |
return | Valoarea returnată | Îi dă o valoare codului care a apelat funcția. print(describe(gameName, coinsToWin)) afișează ce returnează describe. |
`{name}: collect {goal} coins to win` | Interpolarea șirurilor | Un text între backtick-uri poate conține valori: Luau înlocuiește {name} și {goal} cu valorile lor curente. |
if, elseif, else, end | Condiția if | Luau verifică condițiile de sus în jos și o execută doar pe prima adevărată. coinsToWin e 3, ceea ce nu e mai mare decât 5, dar e mai mare decât 1, așa că se afișează doar „That is a short game”. |
for count = 1, coinsToWin do | Bucla for numerică | Execută codul din ea câte o dată pentru fiecare număr de la 1 la coinsToWin, unde count e 1, apoi 2, apoi 3. |
{ "Red", "Green", "Blue" } și for position, colour in colours do | Tabel și buclă | Un tabel ca listă, pe care Luau o numește array. Pozițiile încep de la 1, nu de la 0. Bucla parcurge fiecare element și îi dă poziția și valoarea. |
Fiecare bloc care se deschide cu cuvântul function, if, for sau while se închide cu cuvântul end. Un singur end lipsă împiedică pornirea întregului script; secțiunea citirea erorilor arată ce mesaj vei primi.
Pasul 2: schimbă un part dintr-un script
Scripturile devin utile când schimbă ceva în lume. Setările pe care le vezi în fereastra Properties, de exemplu Color, Transparency sau Anchored la un part, sunt proprietăți, iar un script le poate seta și el.
- În fila Home apasă Part. Studio adaugă un bloc în Workspace. Numele lui nu contează.
- În Explorer treci cu mouse-ul peste noul part, apasă + și inserează un Script. Redenumește-l în
ColourChangerși înlocuiește-i conținutul cu codul de mai jos. - Apasă Play. Part-ul devine roșu, apoi albastru, apoi verde, schimbându-se o dată pe secundă, și o ia de la capăt.
-- Script într-un Part din Workspace, cu numele ColourChanger.
-- Scripturile schimbă aceleași proprietăți care se văd în fereastra Properties.
-- Acesta îi dă part-ului său o culoare nouă în fiecare secundă, pentru toți jucătorii.
local part = script.Parent :: BasePart -- part-ul în care stă acest script
local colours = {
Color3.fromRGB(255, 85, 85), -- roșu
Color3.fromRGB(85, 170, 255), -- albastru
Color3.fromRGB(85, 255, 127), -- verde
}
part.Anchored = true -- un part ancorat rămâne unde l-ai pus
local index = 1
while true do
part.Color = colours[index]
index = index % #colours + 1 -- 1, 2, 3, apoi din nou 1
task.wait(1) -- pauză de o secundă (vechiul wait() e învechit)
end
script.Parente obiectul în care stă scriptul, aici part-ul. Trage scriptul în alt part și îl va schimba pe acela.:: BaseParte o conversie de tip. Îi spune lui Script Editor că părintele e un part, ca să verifice proprietățile folosite. Luau folosește tipurile doar pentru avertismente și sugestii, așa că conversia nu schimbă ce face rândul.part.Colorșipart.Anchoredsunt aceleași proprietăți ca în fereastra Properties, cu aceleași nume. Roblox folosește scrierea americană, așa că proprietatea se numeșteColor, deși scriptul se numește ColourChanger.Anchored = trueține part-ul pe loc: referința Roblox spune că un part ancorat nu se mișcă niciodată din cauza gravitației, coliziunilor sau altei fizici.colours[index]citește un element din listă.#colourse lungimea listei, 3, iar%dă restul împărțirii, așa căindex % #colours + 1numără 1, 2, 3, 1, 2, 3.while true dose repetă la nesfârșit, de aceeatask.wait(1)din ea e atât de important. Documentația Roblox spune să pui mereu o întârziere precumtask.wait()într-o buclă infinită: fără ea jocul se blochează, iar Studio cade.
ColourChanger e un Script, așa că rulează pe server, iar toți jucătorii văd aceeași culoare în același timp. Pasul 4 arată alt fel de script.
Pasul 3: reacționează la un jucător printr-un eveniment
Cea mai mare parte din codul de joc așteaptă să se întâmple ceva: a intrat un jucător, a fost atins un part, a fost apăsat un buton. Roblox numește asta evenimente. Ca să rulezi cod când se declanșează un eveniment, îi conectezi o funcție.
- Inserează încă un Part și redenumește-l exact în
Pad, cu P mare. Lasă-l direct în Workspace, nu într-un folder sau model, pentru că LocalScript-ul de la pasul 4 îl caută acolo. - Fă-l o platformă plată pe care poți sta, de exemplu setează
Sizela6, 1, 6în fereastra Properties. Pune-l pe podea lângă SpawnLocation și bifează Anchored, ca să nu se miște. - Treci cu mouse-ul peste Pad, apasă +, inserează un Script, redenumește-l în
TouchPadși lipește codul de mai jos. - Apasă Play și calcă pe platformă. Devine galbenă timp de 2 secunde, iar Output îți spune numele.
-- Script într-un Part din Workspace numit Pad, scriptul cu numele TouchPad.
-- Evenimente: când un jucător calcă pe platformă, aceasta luminează galben, iar Output scrie cine a fost.
-- Debounce-ul împiedică codul să ruleze de multe ori pe secundă cât jucătorul stă pe ea.
local Players = game:GetService("Players")
local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2
local normalColour = pad.Color
local busy = false
local function onTouched(otherPart: BasePart)
if busy then
return -- încă merge cooldown-ul de la atingerea anterioară
end
-- Personajul e Model-ul în care stă partea corpului (sau pălăria) care a atins platforma
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player then
return -- a atins un part liber sau un NPC, nu un jucător
end
busy = true
print(`{player.Name} stepped on the pad`)
pad.Color = Color3.fromRGB(255, 220, 0)
task.wait(COOLDOWN_SECONDS)
pad.Color = normalColour
busy = false
end
pad.Touched:Connect(onTouched)
| Cod | Ce face |
|---|---|
pad.Touched:Connect(onTouched) | Conectează o funcție la evenimentul Touched al platformei, așa că Roblox rulează onTouched de fiecare dată când ceva atinge platforma și îi transmite part-ul care a atins. |
otherPart | Part-ul care a atins platforma: o labă, un picior, mânerul unei pălării sau un instrument din mâna jucătorului. Nu e niciodată jucătorul însuși, așa că următoarele două rânduri află cui îi aparține. |
otherPart:FindFirstAncestorOfClass("Model") | Urcă de la acest part la primul strămoș a cărui clasă e exact Model, adică la personaj. Pentru că numele clasei trebuie să se potrivească exact, sare peste pălărie (clasa Accessory) și peste instrumentul din mână (clasa Tool). |
Players:GetPlayerFromCharacter(character) | Returnează Player-ul căruia îi aparține personajul sau nil, dacă e un personaj al nimănui, de exemplu un NPC. character and din față sare peste apel dacă modelul nu a fost găsit, iar player rămâne nil. |
if not player then return end | Se oprește aici pentru tot ce nu e jucător. return iese din funcție mai devreme. |
De ce are nevoie platforma de debounce
Pagina Roblox despre debounce avertizează că Touched se declanșează de mai multe ori la rând cât part-urile se ating, iar un personaj care merge are mai multe părți ale corpului. Fără verificare, un singur pas pe platformă ar putea afișa multe rânduri și ar reporni iar și iar strălucirea galbenă.
Variabila busy e chiar debounce-ul. Prima atingere o setează la true, iar fiecare atingere din următoarele 2 secunde ajunge la if busy then return end și se oprește. După task.wait(COOLDOWN_SECONDS), platforma își recapătă culoarea, iar busy devine din nou false. COOLDOWN_SECONDS e scris cu majuscule pentru că e o setare care nu se schimbă în timpul jocului: așa recomandă Roblox să numești constantele.
Platforma asta are un singur debounce pentru toți, așa că un al doilea jucător care calcă pe ea în acele 2 secunde e ignorat. Pentru o platformă care luminează e în regulă. O platformă care dă recompense trebuie să țină un cooldown pentru fiecare jucător, ca platforma cu monede din ghidul despre clasament.
Pasul 4: primul LocalScript și prin ce diferă
Un joc care rulează înseamnă un server plus câte un client pentru fiecare jucător. Tot ce am făcut până acum a fost un Script, care rulează pe server, așa că schimbările lui ajung la toți jucătorii. Un LocalScript rulează pe dispozitivul unui singur jucător. Apăsările de taste, camera și meniurile de pe ecran se tratează acolo, pentru că doar acel dispozitiv știe de ele.
- În Explorer deschide StarterPlayer, treci cu mouse-ul peste StarterPlayerScripts, apasă + și inserează un LocalScript. Redenumește-l în
MyFirstLocalScriptși lipește codul de mai jos. - Apasă Play. Output arată
Hello,și numele tău cu marcajul Client. - Dă clic în fereastra jocului și apasă E. Platforma devine mai transparentă. Apasă din nou E ca s-o readuci.
- Cât rulează playtestul, apasă comutatorul Client/Server din controalele de testare ale Studio, ca să treci la copia jocului de pe server. Acolo platforma e opacă: serverul nu a aflat nimic despre schimbare.
-- LocalScript în StarterPlayer > StarterPlayerScripts cu numele MyFirstLocalScript.
-- Un LocalScript rulează pe dispozitivul unui singur jucător. Apasă E: Pad devine mai transparent doar
-- pe ecranul tău, pentru că o schimbare a part-ului de aici nu ajunge nici la server, nici la ceilalți.
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")
local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- apare în Output cu marcajul Client
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- tasta a fost folosită pentru altceva, de exemplu pentru scrisul în chat
end
if input.KeyCode == Enum.KeyCode.E then
local pad = workspace:FindFirstChild("Pad")
if pad and pad:IsA("BasePart") then
pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
end
end
end)
Players.LocalPlayere jucătorul pe al cărui dispozitiv rulează scriptul. Roblox îl definește doar pentru LocalScript-uri și pentru ModuleScript-urile pe care le includ ele, așa că un cod de server nu-l poate folosi.UserInputService.InputBeganse declanșează când jucătorul începe o apăsare de tastă, un clic sau o atingere.gameProcessedetruecând motorul a folosit deja acest input, de exemplu un clic pe un buton sau o tastă în linia de chat, așa că scriptul îl ignoră.workspace:FindFirstChild("Pad")returnează urmașul numit Pad saunil, dacă nu există.pad:IsA("BasePart")verifică dacă e chiar un part, înainte ca scriptul să-i schimbeTransparency.if pad.Transparency == 0 then 0.6 else 0e o expresie if: alege una din două valori. Transparency 0 înseamnă complet vizibil, 1 invizibil.- Scriptul de sprint pe Shift e bun ca al doilea LocalScript: ascultă o tastă și schimbă WalkSpeed-ul personajului.
| Tip | Unde rulează | Unde ajung schimbările | Pentru ce | De obicei stă în |
|---|---|---|---|---|
| Script | Pe server | La toți jucătorii | Regulile jocului: monede, daune, uși, runde, salvare | ServerScriptService sau într-un part, cât înveți |
| LocalScript | Pe dispozitivul unui singur jucător | Doar pe acel dispozitiv, cu excepția mișcării propriului personaj | Input, cameră, meniuri pe ecran, efecte pentru un singur jucător | StarterPlayerScripts sau StarterGui |
| ModuleScript | Pe partea care face require() pentru el | Unde ajung și ale scriptului care l-a inclus | Cod comun pentru mai multe scripturi | ReplicatedStorage pentru ambele părți, ServerScriptService doar pentru server |
Ce poate schimba un trișor
Consideră că un trișor controlează tot de pe dispozitivul lui. Își poate rula propriile LocalScript-uri și le poate schimba pe ale tale, așa că poate face transparentă platforma sau orice altceva pe ecranul lui. Aici e inofensiv: transparența e doar de formă și rămâne pe dispozitivul lui. Tocmai de aceea tot ce contează îl decide un Script pe server.
Nici un Script de server nu e sigur automat. TouchPad rulează pe server, dar dispozitivul fiecărui jucător controlează fizica personajului său, iar documentația de securitate Roblox numește printre lucrurile pe care clientul le poate face cu part-urile pe care le controlează alegerea momentului în care se declanșează Touched sau blocarea lui completă. Pentru o platformă care luminează nu contează. Pentru o platformă care plătește, verifică și ce urmărește serverul singur, ca regula din ghidul de obby că checkpointurile contează doar în ordine.
Pasul 5: testează toate cele patru scripturi împreună
- Șterge Output cu Ctrl+K (⌘K pe Mac) și apasă Play (F5). Output arată opt rânduri FirstScript cu marcajul Server și rândul tău Hello cu marcajul Client. Part-ul ColourChanger își schimbă culoarea în fiecare secundă.
- Calcă pe platformă. Devine galbenă timp de 2 secunde, iar Output îți arată o dată numele și „stepped on the pad”. Plimbă-te pe ea: un rând nou apare cel mult o dată la 2 secunde, nu la fiecare declanșare Touched.
- Apasă E. Platforma devine semitransparentă (Transparency 0.6). Apasă din nou E și e opacă.
- Apasă Stop. În lista de testare alege Server & Clients, pune 2 clienți și apasă Play (sau F7). Studio deschide o fereastră de server și două ferestre de client. Într-un client apasă E: platforma devine mai transparentă acolo, iar celălalt client și serverul o arată opacă. Apasă End Session când termini.
- Strică ceva intenționat. Redenumește Pad în
Pad2și pornește jocul. Un pas pe platformă o face tot galbenă, pentru că TouchPad își găsește part-ul prinscript.Parent, nu după nume. Apăsarea lui E nu mai face acum nimic și nu apare nicio eroare:FindFirstChild("Pad")a returnatnil, iar verificareaif pad and ...a sărit în tăcere restul. Adaugăprint(pad)pe rândul de dupăFindFirstChild, pornește și apasă E: Output aratănil. Un astfel de print e cel mai rapid mod de a înțelege de ce un script nu face nimic. Oprește jocul, șterge rândul cu print și dă-i part-ului înapoi numele Pad.
Unde pui scripturile
De locul în care stă un script depinde dacă pornește deloc, iar Studio nu te avertizează dacă nu va porni niciodată. Pentru următoarele tale scripturi:
| Container | Ce pui | De ce |
|---|---|---|
| ServerScriptService | Scripturile cu cele mai multe reguli de joc: recompense, runde, salvare | Rulează pe server, iar nimic din ServerScriptService nu se trimite jucătorilor. |
| Într-un part din Workspace | Un Script legat de un singur part, ca ColourChanger și TouchPad | E în regulă cât înveți: part-ul e script.Parent. Pentru proiecte reale, Roblox recomandă în schimb să marchezi part-urile cu taguri (vezi mai jos). |
| StarterPlayerScripts, în StarterPlayer | Cele mai multe LocalScript-uri: input, cameră, efecte pentru un singur jucător | Fiecare jucător își primește propria copie la intrare. |
| StarterGui | LocalScript-uri într-un ScreenGui, care controlează un meniu de pe ecran | Fiecare jucător își primește propria copie a interfeței. |
| ReplicatedStorage | ModuleScript-uri pe care le includ atât codul de server, cât și cel de client | Îl văd ambele părți. Un LocalScript sau un Script cu setările implicite nu va rula niciodată aici. |
Pagina Roblox despre locurile scripturilor recomandă să nu pui deloc scripturi direct în part-uri din Workspace: marchează part-urile cu taguri și lucrează cu ele dintr-un singur ModuleScript prin CollectionService. Un script într-un part e totuși cel mai simplu început, iar pentru unul-două obiecte, cât înveți, e în regulă. Ghidul despre uși arată tiparul cu taguri, cu un singur script pentru toate ușile, iar ghidul despre client și server are tabelul complet cu ce containere rulează ce scripturi.
Când ceva a mers prost: citește Output
Erorile apar în Output cu roșu. Fiecare începe cu locul unde a apărut, numele complet al scriptului și numărul rândului, apoi spune ce nu e în regulă. Dă clic pe eroare, iar Studio deschide scriptul la acel rând. De exemplu, dacă scoți verificarea if not player din TouchPad, iar pe platformă cade un part liber, Output arată:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
Greșelile în felul în care e scris codul, de exemplu un end lipsă, se văd încă înainte să apeși Play: Script Editor le subliniază cu roșu, iar fereastra Script Analysis (butonul Analysis din fila Script) le enumeră. Un script cu o astfel de greșeală nu pornește deloc, nici măcar rândurile de deasupra ei.
| Mesaj | Ce înseamnă | Cum repari |
|---|---|---|
Colour is not a valid member of Part "Workspace.Part" | Acest obiect nu are nimic cu exact acest nume. Aici proprietatea se scrie Color. | Compară scrierea și majusculele cu fereastra Properties sau Explorer. Mai multe despre această eroare. |
attempt to index nil with 'Name' | Codul a citit ceva, aici .Name, dintr-o valoare nil. În exemplul de mai sus player era nil, pentru că platforma a fost atinsă de un part liber. | Află de ce valoarea e nil și verific-o cu un if înainte s-o folosești. Mai multe despre această eroare. |
Expected 'end' (to close 'then' at line 2), got <eof> | if-ul de pe rândul 2 nu are end-ul pereche. Pentru o funcție, mesajul spune to close 'function', iar <eof> înseamnă sfârșitul fișierului. | Adaugă end-ul lipsă, orientându-te după rândul din paranteze, nu după ultimul. Uneori mesajul se termină cu fraza „did you forget to close ... at line N?”. E o presupunere a lui Luau după indentare și poate indica alt bloc, așa că verifică întâi rândul din paranteze. Mai multe despre erorile de sintaxă. |
Dacă scriptul nu face nimic și Output e gol, de obicei scriptul stă într-un loc unde nu rulează niciodată sau așteaptă un eveniment care nu se declanșează. Ghidul despre erori are o listă de verificare pentru scripturile care tac și mai multe despre citirea Output.
Ce fac altfel tutorialele vechi de scripting
Dacă înveți și din videoclipuri și postări de pe forumuri, vei întâlni tipare vechi. Iată-le pe cele importante, cu motivul pentru care fiecare e o problemă.
| Tutorialul | Problema | Ghidul acesta |
|---|---|---|
Face pauză prin wait(1) | Referința Roblox marchează funcția globală wait() ca învechită și spune că a fost înlocuită de task.wait(). | task.wait(1) |
Găsește personajul prin otherPart.Parent, ca în lecția Roblox despre lavă | Când part-ul e atins de o pălărie sau de un instrument din mână, otherPart.Parent e un Accessory sau un Tool, nu personajul, așa că Humanoid-ul nu e găsit și atingerea se pierde. | FindFirstAncestorOfClass("Model"), apoi GetPlayerFromCharacter |
Folosește Touched fără debounce | Touched se declanșează de mai multe ori la rând la un singur pas, așa că codul rulează iar și iar. | Flagul busy și un cooldown |
| Pune un LocalScript într-un part din Workspace | Un LocalScript nu rulează niciodată acolo. Rulează doar din locuri care aparțin unui singur jucător. | LocalScript în StarterPlayerScripts (de ce) |
Scrie part.Touched:connect(...) sau table.getn(list) | Ghidul de denumire al Roblox spune că API-urile în camelCase sunt în mare parte învechite, iar referința enumeră doar Connect. table.getn e învechit în favoarea #list. | :Connect(...) și #list |
| Schimbă monedele sau dă daune într-un LocalScript | Schimbarea rămâne pe dispozitivul acelui jucător, așa că nu o vede nimeni altcineva, iar serverul nu o ia în calcul. | Regulile jocului într-un Script pe server |
Exercițiu: trei schimbări de încercat
Să schimbi cod te învață mai mult decât să-l citești. Încearcă-le în place-ul tău pe rând și apasă Play după fiecare.
- Fă platforma să dea un punct. Adaugă scriptul Leaderstats de la pasul 1 din ghidul despre clasament. Apoi, în TouchPad, după
busy = true, găsește folderulleaderstatsal jucătorului și adaugă 1 la valoareaCoins. Indiciu:player:FindFirstChild("leaderstats"), apoileaderstats:FindFirstChild("Coins"), apoicoins.Value += 1. Platforma cu monede din ghidul despre clasament e versiunea gata făcută, cu cooldown pentru fiecare jucător. - Fă ColourChanger să schimbe și transparența. Fă ca ColourChanger să schimbe în fiecare secundă și
Transparency-ul part-ului. Indiciu: adaugă un al doilea tabel cu numere de la 0 la 1, de exemplu{ 0, 0.3, 0.6 }, și setează din elpart.Transparencype rândul de dupăpart.Color, cu acelașiindex. - Afișează culoarea platformei. Fă ca MyFirstLocalScript să afișeze
Color-ul platformei la apăsarea lui E. Indiciu:print(pad.Color)în bloculif pad and pad:IsA("BasePart"). Apasă E cât platforma e galbenă: clientul vede culoarea setată de server, pentru că schimbările de pe server ajung la toți clienții.
Ce să înveți mai departe
Acum ai folosit piesele din care e construită cea mai mare parte a scripturilor de joc. O ordine bună mai departe:
- LocalScript vs Script vs ModuleScript: unde rulează fiecare tip de script și ce poate schimba, mai în profunzime decât la pasul 4.
- RemoteEvents: cum îi cere un LocalScript serverului să facă ceva și cum verifică serverul cererea.
- Clasamentul: primele tale statistici, create și schimbate pe server.
- Primul tău joc: un traseu scurt cu lavă, monede și o platformă de final pe două scripturi de server, apoi publicarea.
- Apoi alege un sistem: GUI de magazin, sistem de runde, checkpointuri în obby, ecran de încărcare sau animație la apăsarea unei taste. Când se strică ceva, ghidul despre erorile din scripturi te ajută să citești mesajul. Ghidul despre checkpointuri e deocamdată în engleză.
Propriile tutoriale Roblox Coding fundamentals (în engleză) completează bine acest ghid: șase serii de la variabile și funcții, prin condiții, bucle, array-uri și dicționare, până la organizarea codului în ModuleScript-uri, cu proiecte mici în Studio.
Erori frecvente și soluții
Cele mai multe probleme cu primele scripturi sunt un nume care nu se potrivește, un script în locul greșit sau o buclă fără așteptare. Ține Output deschis în timpul testului.
Studio se blochează sau nu mai răspunde când apeși Play
Bucla while true do nu are nicio așteptare, așa că nimic altceva nu mai poate rula. Documentația Roblox spune că o buclă infinită fără o întârziere precum task.wait() blochează jocul și face Studio să cadă. Pune task.wait() în fiecare buclă infinită, ca în ColourChanger.
Nu se întâmplă nimic când calc pe platformă
Verifică dacă TouchPad e un Script, nu un LocalScript, dacă stă direct în part-ul Pad, dacă nu e dezactivat și dacă proprietatea CanTouch a platformei e bifată. Apoi fă print("touched", otherPart.Name) primul rând din onTouched. Dacă nu se afișează, evenimentul nu se declanșează; dacă se afișează, problema e mai jos.
Apăsarea lui E nu face nimic
MyFirstLocalScript trebuie să fie un LocalScript în StarterPlayerScripts: un LocalScript din Workspace sau ServerScriptService nu rulează niciodată. Part-ul trebuie să se numească exact Pad și să stea direct în Workspace. Dă întâi clic în fereastra jocului și asigură-te că nu scrii în chat, pentru că scriptul ignoră tastele pe care jocul le-a folosit deja.
Part-ul se schimbă pe ecranul meu, dar nu și la ceilalți jucători
Schimbarea a făcut-o un LocalScript, așa că a rămas pe dispozitivul tău. Fă-o într-un Script de server sau lasă LocalScript-ul să-i ceară serverului printr-un RemoteEvent.
ColourChanger merge într-un part, dar se strică în ServerScriptService
Folosește script.Parent ca part al lui. În ServerScriptService părintele e ServerScriptService, care nu are Anchored sau Color, așa că Output arată eroarea „not a valid member”. Ține-l în part sau dă-i part-ului un nume și caută-l după nume, de exemplu local part = workspace:WaitForChild("ColourPart") :: BasePart.
Output nu arată nimic
Verifică dacă fereastra Output e deschisă (meniul Window sau fila Script) și dacă nu e setat un filtru: Output se poate filtra după tipul mesajelor, după Client sau Server și după text. Dacă e deschisă și tot e goală, probabil scriptul nu a rulat. Vezi lista de verificare pentru scripturile care nu fac nimic.
Dacă te-ai blocat: RoCode
Dacă te-ai blocat la un script din place-ul tău, RoCode îl poate analiza împreună cu tine. RoCode este un agent AI independent pentru Roblox Studio, nu de la Roblox: scrii în chatul web, iar pluginul lui pentru Studio creează și editează scripturi în Explorer-ul tău.
Cât înveți, modul Ask e util: scripturile le scrii tu, iar RoCode citește ce există deja și răspunde la întrebări.
Explică rând cu rând ce face scriptul TouchPad din part-ul Pad și de ce folosește un debounce.
- În modul Ask folosește doar instrumente de citire, de exemplu Search Scripts și Read Script, și nu schimbă nimic în place
- Dacă trebuie reparat ceva, spune ce și unde ar schimba și îți propune să treci pe Build
- În modul Build editează scripturile pe loc, apoi verifică fiecare prin Check Script. E o verificare de compilare, nu o verificare de tipuri și nici un playtest
- Citește Output-ul din Studio cu instrumentul Check Output, inclusiv rândurile Server și Client din ultimul tău playtest, chiar și după ce ai apăsat Stop
În modul Build, cu pluginul 3.9 sau mai nou, RoCode poate porni un playtest scurt și citi erorile, iar cu 3.9.11 sau mai nou poate controla un personaj de test, dar în timpul jocului nu face capturi de ecran, așa că pe platformă tot tu calci. Cum se conectează RoCode la Studio.
Întrebări frecvente
Unde scrii scripturi în Roblox Studio?
În Explorer treci cu mouse-ul peste un container, de exemplu ServerScriptService, apasă + și alege Script. Studio îl deschide în Script Editor, unde scrii Luau. Scripturile de server stau de obicei în ServerScriptService; LocalScript-urile în StarterPlayerScripts sau StarterGui.
Cum rulezi un script în Roblox Studio?
Apasă Play (F5). Studio pornește un playtest, iar fiecare Script activ din ServerScriptService sau Workspace rulează imediat la pornirea jocului; LocalScript-urile din StarterPlayerScripts rulează când intri în playtest. Run (îl alegi din lista de lângă Play sau apeși F8) pornește jocul fără avatar, așa că pentru acest ghid folosește Play. Stop (Shift+F5) termină testul. Ca să deschizi un script existent, dă dublu clic pe el în Explorer.
Ce limbaj de programare folosește Roblox?
Luau. Roblox îl descrie ca un limbaj de scripting rapid, mic și sigur, cu tipizare graduală, derivat din Lua 5.1, așa că cele mai multe tutoriale de Lua sunt încă utile. Luau adaugă funcții precum interpolarea șirurilor între backtick-uri și adnotările de tip opționale, iar Roblox adaugă propriile biblioteci și obiecte, de exemplu task.wait.
Prin ce diferă un Script de un LocalScript?
Un Script rulează pe server, iar schimbările lui ajung la toți jucătorii. Un LocalScript rulează pe dispozitivul unui singur jucător, pentru input, cameră și meniuri pe ecran, iar schimbările lui la part-uri, valori și interfață rămân pe acel dispozitiv. Ghidul despre client și server (în engleză) le explică pe amândouă, plus ModuleScript.
Pot scrie scripturi în Roblox Studio pe telefon sau pe iPad?
Pagina de instalare Roblox descrie Studio ca o aplicație gratuită pentru Windows și Mac și nu numește versiuni pentru telefon sau tabletă, așa că pentru scripturi îți trebuie un calculator.
De ce scriptul meu nu face nimic și nu arată nicio eroare?
De obicei stă unde un astfel de script nu rulează (un LocalScript în Workspace sau un Script în StarterPlayerScripts), e dezactivat sau evenimentul pe care îl așteaptă nu se declanșează. Ghidul despre erori are o listă de verificare.
Cât timp durează să înveți scripting în Roblox?
Nimeni nu-ți poate da un număr cinstit: depinde cât construiești. Cel mai mult ajută să scrii des scripturi mici în propriul place. Schimbă cele patru scripturi de aici, încearcă exercițiile, apoi parcurge ghidul despre primul joc și adaugă câte un sistem.
Surse și lecturi suplimentare
- Roblox Creator Docs: Luau (în engleză). ce e Luau și de unde vine
- Roblox Creator Docs: Roblox Studio setup (în engleză). Windows și Mac, cerințe de sistem
- Roblox Creator Docs: Output (în engleză). deschiderea Output, filtre, Show Context și Show Source
- Roblox Creator Docs: Studio testing modes (în engleză). Play, Run, Stop, comutatorul Client/Server și Server & Clients
- Roblox Creator Docs: Script Editor (în engleză). unde se deschid scripturile noi și Script Analysis
- Roblox Creator Docs: Script types and locations (în engleză). unde rulează fiecare tip de script și taguri în loc de scripturi în part-uri
- Roblox Creator Docs: Script (în engleză). când începe să ruleze un Script
- Roblox Creator Docs: Control structures (în engleză). condiții, bucle și de ce o buclă infinită are nevoie de așteptare
- Roblox Creator Docs: Events (în engleză). Connect și ce îi transmite Touched funcției
- Roblox Creator Docs: Debounce patterns (în engleză). de ce Touched se declanșează de mai multe ori la o singură atingere
- Roblox Creator Docs: wait (în engleză). funcția globală wait() și task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (în engleză). ce poate face clientul cu propriul personaj
- Roblox Creator Docs: Coding fundamentals (în engleză). seria Roblox pentru începători
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.