V skratke
Ak chcete napísať skript v Roblox Studiu, prejdite myšou na ServerScriptService v Exploreri, kliknite na + a vložte Script. Studio ho otvorí v Script Editore. Napíšte Luau, napríklad print("Hello"), kliknite na Play (F5) a výsledok si prečítajte v okne Output (menu Window alebo karta Script). Script beží na serveri a mení všetko pre všetkých; LocalScript v StarterPlayerScripts beží na zariadení jedného hráča.
- Najprv sa naučte štyri myšlienky: premenné (
local coins = 3), funkcie (local function name() ... end), podmienky if a udalosti (part.Touched:Connect(...)). Štyri skripty tohto návodu sú postavené z nich, plus cykly a tabuľky. - Používajte
task.wait(), niewait(). Referenčná príručka Robloxu označuje globálnywait()ako zastaraný a nahradenýtask.wait(). - V nastaveniach zobrazenia okna Output zapnite Show Context, aby každý riadok ukazoval, či prišiel zo Servera, alebo z Clienta.
Na tejto stránke
Skôr ako začnete: Studio, Baseplate a okno Output
Potrebujete Roblox Studio a účet Roblox a nič viac: žiadny editor kódu ani plugin. Každý skript tohto návodu napíšete vo vlastnom Script Editore Studia.
- Nainštalujte Roblox Studio, bezplatnú aplikáciu Robloxu pre Windows a Mac, a prihláste sa účtom Roblox.
- Otvorte Studio. Na úvodnej stránke sú šablóny: vyberte Baseplate. Dostanete podlahu s textúrou mriežky 4x4 a SpawnLocation, miesto, kde sa pri hraní objaví váš avatar.
- Ak nevidno okná Explorer a Properties, otvorte ich z menu Window alebo karty Home. Explorer vypisuje všetky objekty place; Properties ukazuje nastavenia vybraného.
- Otvorte Output z menu Window alebo karty Script. Tu sa objavujú správy a chyby vašich skriptov.
- V nastaveniach zobrazenia okna Output zapnite Show Context, ktorý každú správu označí ako Client alebo Server, a Show Source, ktorý ukáže skript a číslo riadka, odkiaľ prišla.
| Skript | Typ | Kde leží | Čo učí |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Premenné, funkcie, podmienka if, cykly a tabuľka |
ColourChanger | Script | Vnútri Part vo Workspace | Zmena vlastností, script.Parent a cyklus s čakaním |
TouchPad | Script | Vnútri Part s názvom Pad | Udalosti, hľadanie hráča, ktorý sa partu dotkol, a debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, vnútri StarterPlayer | Kód na zariadení jedného hráča, stlačenia klávesov a čo zostáva na tomto zariadení |
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
Krok 1: napíšte prvý skript
- V Exploreri prejdite myšou na ServerScriptService, kliknite na + a vyberte Script (skratka Ctrl+I alebo ⌘I na Macu). Studio skript vytvorí a otvorí ho v Script Editore.
- Kliknite na nový skript pravým tlačidlom, vyberte Rename a pomenujte ho
FirstScript. Názov nemení to, čo skript robí, ale hovorí, ktorý skript čo vypísal. - Nové skripty začínajú jedným riadkom,
print("Hello world!"). Zmažte ho a vložte kód nižšie. - Kliknite na Play (F5), so zvoleným Test v zozname vľavo od neho. Studio spustí playtest a postaví avatara na SpawnLocation.
- Prečítajte si riadky v Output a potom kliknite na Stop (Shift+F5). Stop tiež vráti všetky objekty do stavu pred kliknutím na Play, takže všetko, čo ste počas hry posunuli alebo prefarbili, sa vráti.
-- Script v ServerScriptService s názvom FirstScript.
-- Váš prvý Luau: premenné, funkcia, podmienka if, cyklus a tabuľka.
-- Stlačte Play (F5) a prečítajte si výsledok v okne Output.
-- Premenná je názov, ktorý uchováva hodnotu
local gameName = "Coin Run"
local coinsToWin = 3
-- Funkcia je pomenovaný blok kódu, ktorý sa dá spustiť, koľkokrát chcete.
-- name a goal sú jej parametre; return vráti hodnotu tomu, kto ju zavolal.
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
-- Podmienka if vykoná kód, len keď je podmienka pravdivá
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
-- Cyklus for opakuje kód zadaný počet ráz
for count = 1, coinsToWin do
print("Coin number", count)
end
-- Tabuľka uchováva zoznam hodnôt; tento cyklus ich prechádza po poradí
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
print(position, colour) --> 1 Red, potom 2 Green, potom 3 Blue
end
Všetko za -- na riadku je komentár: Luau ho preskočí, takže si môžete nechávať poznámky. Komentáre --> ukazujú, čo riadok vypíše.
Output má ukázať týchto osem riadkov pomiešaných so správami samotného Studia. Keď print dostane niekoľko hodnôt, dá medzi ne medzeru. So zapnutými Show Context a Show Source je každý riadok ešte označený Server a FirstScript s číslom riadka.
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
Spárujte každý riadok s kódom, ktorý ho vypísal. Neskôr budete to isté robiť s chybovými správami, takže sa ten zvyk zíde.
FirstScript používa len čistý Luau bez objektov Robloxu, takže funguje aj v bezplatnom pieskovisku Luau v prehliadači. Zmeňte tam hodnotu a spustite znova, aby ste videli, čo sa zmení.
| Kód | Myšlienka | Čo to znamená |
|---|---|---|
local gameName = "Coin Run" | Premenná | Názov, ktorý uchováva hodnotu. local znamená, že ju smie používať len tento skript alebo blok, v ktorom stojí. Text v úvodzovkách je reťazec; 3 je číslo. Názvy rozlišujú veľkosť písmen, takže coinsToWin a CoinsToWin sú dve rôzne premenné. |
local function describe(name: string, goal: number): string | Funkcia | Pomenovaný blok kódu, ktorý sa dá spustiť, koľkokrát chcete. name a goal sú jej parametre: hodnoty, ktoré sa odovzdávajú pri každom volaní. : string a : number sú voliteľné anotácie typov. Luau ich používa na varovania v Script Editore; bez nich kód funguje rovnako. |
return | Návratová hodnota | Odovzdá hodnotu kódu, ktorý funkciu zavolal. print(describe(gameName, coinsToWin)) vypíše to, čo vráti describe. |
`{name}: collect {goal} coins to win` | Interpolácia reťazcov | Text v spätných úvodzovkách môže obsahovať hodnoty: Luau nahradí {name} a {goal} ich aktuálnymi hodnotami. |
if, elseif, else, end | Podmienka if | Luau kontroluje podmienky zhora nadol a vykoná len prvú pravdivú. coinsToWin je 3, to nie je viac ako 5, ale je to viac ako 1, takže sa vypíše len „That is a short game“. |
for count = 1, coinsToWin do | Číselný cyklus for | Vykoná kód vnútri raz pre každé číslo od 1 do coinsToWin, kde count je 1, potom 2, potom 3. |
{ "Red", "Green", "Blue" } a for position, colour in colours do | Tabuľka a cyklus | Tabuľka ako zoznam, Luau tomu hovorí pole. Pozície začínajú od 1, nie od 0. Cyklus prejde každý prvok a dá jeho pozíciu a hodnotu. |
Každý blok, ktorý sa otvára slovom function, if, for alebo while, sa zatvára slovom end. Jeden chýbajúci end zabráni spusteniu celého skriptu; časť čítanie chýb ukazuje, akú správu dostanete.
Krok 2: zmeňte part zo skriptu
Skripty začnú byť užitočné, keď menia niečo vo svete. Nastavenia, ktoré vidíte v okne Properties, napríklad Color, Transparency alebo Anchored pri parte, sú vlastnosti a skript ich môže nastavovať tiež.
- Na karte Home kliknite na Part. Studio pridá kváder do Workspace. Na jeho názve nezáleží.
- V Exploreri prejdite myšou na nový part, kliknite na + a vložte Script. Premenujte ho na
ColourChangera nahraďte obsah kódom nižšie. - Kliknite na Play. Part sčervenie, potom zmodrie, potom zozelenie, mení sa raz za sekundu a začína znova.
-- Script vnútri Part vo Workspace, s názvom ColourChanger.
-- Skripty menia tie isté vlastnosti, ktoré vidno v okne Properties.
-- Tento dáva svojmu partu novú farbu každú sekundu, pre všetkých hráčov.
local part = script.Parent :: BasePart -- part, vnútri ktorého leží tento skript
local colours = {
Color3.fromRGB(255, 85, 85), -- červená
Color3.fromRGB(85, 170, 255), -- modrá
Color3.fromRGB(85, 255, 127), -- zelená
}
part.Anchored = true -- ukotvený part zostane tam, kde ste ho postavili
local index = 1
while true do
part.Color = colours[index]
index = index % #colours + 1 -- 1, 2, 3, potom znova 1
task.wait(1) -- pauza na jednu sekundu (starý wait() je zastaraný)
end
script.Parentje objekt, v ktorom skript leží, tu part. Potiahnite skript do iného partu a bude meniť ten.:: BasePartje pretypovanie. Povie Script Editoru, že rodič je part, aby kontroloval použité vlastnosti. Luau používa typy len na varovania a nápovedu, takže pretypovanie nemení, čo riadok robí.part.Colorapart.Anchoredsú tie isté vlastnosti ako v okne Properties, s rovnakými názvami. Roblox používa americký pravopis, preto sa vlastnosť voláColor, hoci sa skript volá ColourChanger.Anchored = truedrží part na mieste: referenčná príručka Robloxu hovorí, že ukotvený part sa nikdy nepohne kvôli gravitácii, kolíziám ani inej fyzike.colours[index]prečíta jeden prvok zoznamu.#coloursje dĺžka zoznamu, 3, a%dá zvyšok po delení, takžeindex % #colours + 1počíta 1, 2, 3, 1, 2, 3.while true dosa opakuje donekonečna, preto jetask.wait(1)vnútri taký dôležitý. Dokumentácia Robloxu hovorí vždy dať do nekonečného cyklu oneskorenie akotask.wait(): bez neho hra zamrzne a Studio spadne.
ColourChanger je Script, takže beží na serveri a všetci hráči vidia rovnakú farbu v rovnakej chvíli. Krok 4 ukazuje iný druh skriptu.
Krok 3: reagujte na hráča cez udalosť
Väčšina herného kódu čaká, kým sa niečo stane: hráč prišiel, partu sa niekto dotkol, tlačidlo sa stlačilo. Roblox tomu hovorí udalosti. Ak chcete spustiť kód, keď sa udalosť spustí, pripojíte k nej funkciu.
- Vložte ďalší Part a premenujte ho presne na
Pad, s veľkým P. Nechajte ho priamo vo Workspace, nie v priečinku ani v modeli, pretože LocalScript v kroku 4 ho hľadá tam. - Urobte z neho plochú plošinu, na ktorú sa dá stúpiť, napríklad v okne Properties nastavte
Sizena6, 1, 6. Postavte ho na podlahu vedľa SpawnLocation a zaškrtnite Anchored, aby sa nehýbal. - Prejdite myšou na Pad, kliknite na +, vložte Script, premenujte ho na
TouchPada vložte kód nižšie. - Kliknite na Play a stúpte si na plošinu. Na 2 sekundy zožltne a Output napíše vaše meno.
-- Script vnútri Part vo Workspace s názvom Pad, skript s názvom TouchPad.
-- Udalosti: keď hráč stúpi na plošinu, rozsvieti sa nažlto a Output napíše, kto to bol.
-- Debounce nedovolí kódu spúšťať sa veľakrát za sekundu, kým na nej hráč stojí.
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 -- ešte beží cooldown po minulom dotyku
end
-- Postava je Model, v ktorom leží časť tela (alebo klobúk), ktorá sa dotkla plošiny
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player then
return -- dotkol sa voľný part alebo NPC, nie hráč
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)
| Kód | Čo robí |
|---|---|
pad.Touched:Connect(onTouched) | Pripojí funkciu k udalosti Touched plošiny, takže Roblox spustí onTouched zakaždým, keď sa plošiny niečo dotkne, a odovzdá part, ktorý sa dotkol. |
otherPart | Part, ktorý sa plošiny dotkol: chodidlo, noha, okraj klobúka alebo nástroj v ruke hráča. Nikdy to nie je hráč sám, preto ďalšie dva riadky zisťujú, komu patrí. |
otherPart:FindFirstAncestorOfClass("Model") | Vystúpi od tohto partu k prvému predkovi, ktorého trieda je presne Model, teda k postave. Keďže sa názov triedy musí presne zhodovať, preskočí klobúk (trieda Accessory) aj nástroj v ruke (trieda Tool). |
Players:GetPlayerFromCharacter(character) | Vráti Player, ktorého je to postava, alebo nil, ak to nie je postava žiadneho hráča, napríklad NPC. character and na začiatku volanie preskočí, ak sa model nenašiel, a player zostane nil. |
if not player then return end | Zastaví sa tu pri všetkom, čo nie je hráč. return z funkcie vystúpi predčasne. |
Prečo plošina potrebuje debounce
Stránka Robloxu o debounce varuje, že Touched sa spúšťa niekoľkokrát za sebou, kým sa party dotýkajú, a kráčajúca postava má niekoľko častí tela. Bez kontroly by jeden krok na plošinu mohol vypísať kopu riadkov a znova a znova reštartovať žlté svietenie.
Premenná busy je práve debounce. Prvý dotyk ju nastaví na true a každý dotyk počas ďalších 2 sekúnd dôjde k if busy then return end a zastaví sa. Po task.wait(COOLDOWN_SECONDS) plošina vráti farbu a busy je znova false. COOLDOWN_SECONDS je napísaný veľkými písmenami, pretože je to nastavenie, ktoré sa počas hry nemení: tak Roblox radí pomenúvať konštanty.
Táto plošina má jeden debounce pre všetkých, takže druhý hráč, ktorý na ňu počas tých 2 sekúnd stúpi, sa ignoruje. Pri svietiacej plošine to nevadí. Plošina, ktorá dáva odmeny, by mala mať cooldown pre každého hráča, ako plošina s mincami v návode k leaderboardu.
Krok 4: prvý LocalScript a v čom sa líši
Bežiaca hra je jeden server plus jeden klient na každého hráča. Všetko doteraz bol Script, ktorý beží na serveri, takže jeho zmeny sa dostanú ku všetkým hráčom. LocalScript beží na zariadení jedného hráča. Stlačenia klávesov, kamera a menu na obrazovke sa spracúvajú tam, pretože o nich vie len toto zariadenie.
- V Exploreri rozbaľte StarterPlayer, prejdite myšou na StarterPlayerScripts, kliknite na + a vložte LocalScript. Premenujte ho na
MyFirstLocalScripta vložte kód nižšie. - Kliknite na Play. Output ukáže
Hello,a vaše meno so štítkom Client. - Kliknite do okna hry a stlačte E. Plošina bude priehľadnejšia. Stlačte E znova a vrátite ju.
- Kým playtest beží, kliknite na prepínač Client/Server v ovládacích prvkoch testovania v Studiu a prejdite na serverovú kópiu hry. Tam je plošina nepriehľadná: server sa o zmene nič nedozvedel.
-- LocalScript v StarterPlayer > StarterPlayerScripts s názvom MyFirstLocalScript.
-- LocalScript beží na zariadení jedného hráča. Stlačte E: Pad bude priehľadnejší len
-- na vašej obrazovke, pretože zmena partu odtiaľto sa nedostane ani na server, ani k ostatným.
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")
local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- objaví sa v Output so štítkom Client
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- kláves sa použil na niečo iné, napríklad na písanie v chate
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.LocalPlayerje hráč, na ktorého zariadení skript beží. Roblox ho určuje len pre LocalScripty a ModuleScripty, ktoré pripájajú, takže serverový kód ho použiť nemôže.UserInputService.InputBegansa spustí, keď hráč začne stlačenie klávesu, kliknutie alebo dotyk.gameProcessedjetrue, keď engine tento vstup už použil, napríklad kliknutie na tlačidlo alebo kláves v riadku chatu, takže ho skript ignoruje.workspace:FindFirstChild("Pad")vráti potomka s názvom Pad, alebonil, ak neexistuje.pad:IsA("BasePart")overí, že je to naozaj part, skôr ako mu skript zmeníTransparency.if pad.Transparency == 0 then 0.6 else 0je if výraz: vyberie jednu z dvoch hodnôt. Transparency 0 znamená úplne viditeľný, 1 neviditeľný.- Skript šprintu na Shift je dobrý ako druhý LocalScript: počúva kláves a mení WalkSpeed postavy.
| Typ | Kde beží | Kam sa dostanú zmeny | Na čo | Zvyčajne leží v |
|---|---|---|---|---|
| Script | Na serveri | Ku všetkým hráčom | Pravidlá hry: mince, poškodenie, dvere, kolá, ukladanie | ServerScriptService, alebo vnútri partu, kým sa učíte |
| LocalScript | Na zariadení jedného hráča | Len na toto zariadenie, okrem pohybu vlastnej postavy | Vstup, kamera, menu na obrazovke, efekty pre jedného hráča | StarterPlayerScripts alebo StarterGui |
| ModuleScript | Na strane, ktorá preň volá require() | Tam, kam aj pri skripte, ktorý ho pripojil | Kód zdieľaný viacerými skriptmi | ReplicatedStorage pre obe strany, ServerScriptService len pre server |
Čo môže podvodník zmeniť
Počítajte s tým, že podvodník ovláda všetko na svojom zariadení. Môže spúšťať vlastné LocalScripty a meniť vaše, takže môže urobiť priehľadnú plošinu alebo čokoľvek iné na svojej obrazovke. Tu je to neškodné: priehľadnosť je len na pohľad a zostáva na jeho zariadení. Práve preto všetko dôležité rozhoduje Script na serveri.
Ani serverový Script nie je automaticky bezpečný. TouchPad beží na serveri, ale zariadenie každého hráča ovláda fyziku jeho postavy a dokumentácia Robloxu k bezpečnosti medzi tým, čo klient môže robiť s partmi, ktoré ovláda, uvádza riadenie okamihu spustenia Touched alebo jeho úplné zablokovanie. Pri svietiacej plošine na tom nezáleží. Pri plošine, ktorá platí, kontrolujte ešte to, čo server sleduje sám, ako pravidlo v návode k obby, že checkpointy sa počítajú len po poradí.
Krok 5: otestujte všetky štyri skripty spolu
- Vymažte Output cez Ctrl+K (⌘K na Macu) a kliknite na Play (F5). Output ukáže osem riadkov FirstScript so štítkom Server a váš riadok Hello so štítkom Client. Part ColourChanger mení farbu každú sekundu.
- Stúpte si na plošinu. Na 2 sekundy zožltne a Output raz ukáže vaše meno a „stepped on the pad“. Prechádzajte sa po nej: nový riadok sa objaví najviac raz za 2 sekundy, nie pri každom spustení Touched.
- Stlačte E. Plošina je polopriehľadná (Transparency 0.6). Stlačte E znova a je nepriehľadná.
- Kliknite na Stop. V zozname testovania vyberte Server & Clients, nastavte 2 klientov a kliknite na Play (alebo F7). Studio otvorí okno servera a dve okná klientov. V jednom klientovi stlačte E: plošina tam bude priehľadnejšia, ale druhý klient aj server ju ukážu nepriehľadnú. Keď skončíte, kliknite na End Session.
- Niečo schválne pokazte. Premenujte Pad na
Pad2a spustite hru. Krok na plošinu ju stále zafarbí nažlto, pretože TouchPad nájde svoj part cezscript.Parent, nie podľa názvu. Stlačenie E teraz nič nerobí a chyba nie je:FindFirstChild("Pad")vrátilnila kontrolaif pad and ...zvyšok potichu preskočila. Pridajteprint(pad)na riadok zaFindFirstChild, spustite a stlačte E: Output ukáženil. Takýto print je najrýchlejší spôsob, ako zistiť, prečo skript nič nerobí. Zastavte hru, zmažte riadok s printom a vráťte partu názov Pad.
Kam skripty dávať
Od toho, kde skript leží, závisí, či sa vôbec spustí, a Studio vás neupozorní, ak sa nespustí nikdy. Pre vaše ďalšie skripty:
| Kontajner | Čo tam dať | Prečo |
|---|---|---|
| ServerScriptService | Skripty s väčšinou pravidiel hry: odmeny, kolá, ukladanie | Bežia na serveri a nič zo ServerScriptService sa hráčom neposiela. |
| Vnútri partu vo Workspace | Script, ktorý patrí k jednému partu, ako ColourChanger a TouchPad | Kým sa učíte, je to v poriadku: part je script.Parent. Pri skutočných projektoch Roblox radí party namiesto toho označiť tagmi (pozrite nižšie). |
| StarterPlayerScripts, vnútri StarterPlayer | Väčšina LocalScriptov: vstup, kamera, efekty pre jedného hráča | Každý hráč dostane pri vstupe vlastnú kópiu. |
| StarterGui | LocalScripty vnútri ScreenGui, ktoré riadia menu na obrazovke | Každý hráč dostane vlastnú kópiu rozhrania. |
| ReplicatedStorage | ModuleScripty, ktoré pripája serverový aj klientsky kód | Vidia ho obe strany. LocalScript alebo Script s predvoleným nastavením sa tu nikdy nespustí. |
Stránka Robloxu o umiestnení skriptov radí nedávať skripty priamo do partov vo Workspace vôbec: party označte tagmi a pracujte s nimi z jedného ModuleScriptu cez CollectionService. Skript vnútri partu je aj tak najjednoduchší začiatok a pre jeden či dva objekty, kým sa učíte, je to v poriadku. Návod k dverám ukazuje vzor s tagmi, s jedným skriptom na všetky dvere, a návod o klientovi a serveri má úplnú tabuľku, ktoré kontajnery spúšťajú ktoré skripty.
Keď sa niečo pokazí: čítajte Output
Chyby sa v Output ukazujú načerveno. Každá začína tým, kde k nej došlo, celým názvom skriptu a číslom riadka, a potom hovorí, čo je zle. Kliknite na chybu a Studio otvorí skript na tomto riadku. Ak napríklad z TouchPad zmažete kontrolu if not player a na plošinu spadne voľný part, Output ukáže:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
Chyby v tom, ako je kód napísaný, napríklad chýbajúci end, vidno ešte pred kliknutím na Play: Script Editor ich podčiarkuje načerveno a okno Script Analysis (tlačidlo Analysis na karte Script) ich vypisuje. Skript s takou chybou sa nespustí vôbec, ani riadky nad ňou.
| Správa | Čo znamená | Ako opraviť |
|---|---|---|
Colour is not a valid member of Part "Workspace.Part" | Tento objekt nemá nič s presne týmto názvom. Tu sa vlastnosť píše Color. | Porovnajte pravopis a veľké písmená s oknom Properties alebo Explorerom. Viac o tejto chybe. |
attempt to index nil with 'Name' | Kód niečo prečítal, tu .Name, z hodnoty nil. V príklade vyššie bol player nil, pretože sa plošiny dotkol voľný part. | Zistite, prečo je hodnota nil, a pred použitím ju skontrolujte cez if. Viac o tejto chybe. |
Expected 'end' (to close 'then' at line 2), got <eof> | if na riadku 2 nemá párový end. Pri funkcii správa hovorí to close 'function' a <eof> znamená koniec súboru. | Pridajte chýbajúci end podľa riadka v zátvorke, nie podľa posledného. Niekedy správa končí vetou „did you forget to close ... at line N?“. To je odhad Luau podľa odsadenia a môže ukazovať na iný blok, preto najprv skontrolujte riadok v zátvorke. Viac o syntaktických chybách. |
Ak skript nič nerobí a Output je tiež prázdny, zvyčajne skript leží tam, kde sa nikdy nespustí, alebo čaká na udalosť, ktorá sa nespúšťa. Návod k chybám má kontrolný zoznam pre mlčiace skripty a viac o čítaní Output.
Čo staršie tutoriály k skriptovaniu robia inak
Ak sa učíte aj z videí a príspevkov na fórach, narazíte na staršie vzory. Tu sú tie dôležité, s dôvodom, prečo je každý z nich problém.
| Tutoriál | Problém | Tento návod |
|---|---|---|
Robí pauzu cez wait(1) | Referenčná príručka Robloxu označuje globálny wait() ako zastaraný a uvádza, že ho nahradil task.wait(). | task.wait(1) |
Hľadá postavu cez otherPart.Parent, ako v lekcii Robloxu o láve | Keď sa partu dotkne klobúk alebo nástroj v ruke, otherPart.Parent je Accessory alebo Tool, nie postava, takže sa Humanoid nenájde a dotyk sa stratí. | FindFirstAncestorOfClass("Model"), potom GetPlayerFromCharacter |
Používa Touched bez debounce | Touched sa pri jednom kroku spustí niekoľkokrát za sebou, takže sa kód spúšťa znova a znova. | Príznak busy a cooldown |
| Dáva LocalScript dovnútra partu vo Workspace | LocalScript sa tam nikdy nespustí. Beží len z miest, ktoré patria jednému hráčovi. | LocalScript v StarterPlayerScripts (prečo) |
Píše part.Touched:connect(...) alebo table.getn(list) | Návod Robloxu k pomenúvaniu hovorí, že API v camelCase sú väčšinou zastarané, a referenčná príručka uvádza len Connect. table.getn je zastaraný v prospech #list. | :Connect(...) a #list |
| Mení mince alebo spôsobuje poškodenie v LocalScripte | Zmena zostane na zariadení tohto hráča, takže ju nikto iný nevidí a server ju nepočíta. | Pravidlá hry v Scripte na serveri |
Prax: tri zmeny, ktoré sa oplatí vyskúšať
Upravovať kód naučí viac ako ho čítať. Vyskúšajte to vo svojom place po jednom a po každom kliknite na Play.
- Nech plošina dáva bod. Pridajte skript Leaderstats z kroku 1 návodu k leaderboardu. Potom v TouchPad za
busy = truenájdite priečinok hráčaleaderstatsa pripočítajte 1 k hodnoteCoins. Nápoveda:player:FindFirstChild("leaderstats"), potomleaderstats:FindFirstChild("Coins"), potomcoins.Value += 1. Plošina s mincami v návode k leaderboardu je hotová verzia, s cooldownom pre každého hráča. - Nech ColourChanger mení aj priehľadnosť. Urobte, aby ColourChanger každú sekundu menil aj
Transparencypartu. Nápoveda: pridajte druhú tabuľku čísel od 0 do 1, napríklad{ 0, 0.3, 0.6 }, a nastavujte z nejpart.Transparencyna riadku zapart.Color, s tým istýmindex. - Vypíšte farbu plošiny. Nech MyFirstLocalScript pri stlačení E vypíše
Colorplošiny. Nápoveda:print(pad.Color)vnútri blokuif pad and pad:IsA("BasePart"). Stlačte E, kým je plošina žltá: klient vidí farbu nastavenú serverom, pretože zmeny na serveri sa dostanú ku všetkým klientom.
Čo sa učiť ďalej
Teraz ste použili časti, z ktorých je postavená väčšina herných skriptov. Dobré poradie ďalej:
- LocalScript vs Script vs ModuleScript: kde beží každý typ skriptu a čo môže meniť, hlbšie ako krok 4.
- RemoteEvents: ako LocalScript požiada server, aby niečo urobil, a ako server požiadavku overí.
- Leaderboard: vaše prvé štatistiky vytvorené a menené na serveri.
- Vaša prvá hra: krátka trať s lávou, mincami a cieľovou plošinou na dvoch serverových skriptoch, potom publikovanie.
- Potom si vyberte systém: GUI obchodu, systém kôl, checkpointy v obby, načítavacia obrazovka alebo animácia po stlačení klávesu. Keď sa niečo pokazí, návod k chybám v skriptoch pomôže správu prečítať. Návod k checkpointom je zatiaľ po anglicky.
Vlastné tutoriály Robloxu Coding fundamentals (po anglicky) tento návod dobre dopĺňajú: šesť sérií od premenných a funkcií cez podmienky, cykly, polia a slovníky až po organizáciu kódu v ModuleScripte, s malými projektmi v Studiu.
Časté chyby a riešenia
Väčšina problémov s prvými skriptmi je nesediaci názov, skript na nesprávnom mieste alebo cyklus bez čakania. Počas testu majte otvorený Output.
Studio po kliknutí na Play zamrzne alebo prestane reagovať
V cykle while true do chýba čakanie, takže nič iné nemôže bežať. Dokumentácia Robloxu hovorí, že nekonečný cyklus bez oneskorenia ako task.wait() hru zasekne a Studio zhodí. Do každého nekonečného cyklu dávajte task.wait(), ako v ColourChanger.
Keď stúpim na plošinu, nič sa nestane
Overte, že TouchPad je Script, nie LocalScript, leží priamo vnútri partu Pad, nie je vypnutý a že plošina má zaškrtnutú vlastnosť CanTouch. Potom dajte print("touched", otherPart.Name) ako prvý riadok vnútri onTouched. Ak sa nevypíše, udalosť sa nespúšťa; ak áno, problém je nižšie.
Stlačenie E nič nerobí
MyFirstLocalScript musí byť LocalScript vnútri StarterPlayerScripts: LocalScript vo Workspace alebo ServerScriptService sa nikdy nespustí. Part sa musí volať presne Pad a ležať priamo vo Workspace. Najprv kliknite do okna hry a uistite sa, že nepíšete v chate, pretože skript ignoruje klávesy, ktoré hra už použila.
Part sa mení na mojej obrazovke, ale nie u ostatných hráčov
Zmenu urobil LocalScript, takže zostala na vašom zariadení. Urobte ju v serverovom Scripte, alebo nech LocalScript požiada server cez RemoteEvent.
ColourChanger funguje vnútri partu, ale v ServerScriptService sa pokazí
Používa script.Parent ako svoj part. V ServerScriptService je rodičom ServerScriptService, ktorý nemá Anchored ani Color, takže Output ukáže chybu „not a valid member“. Nechajte ho vnútri partu, alebo partu dajte názov a hľadajte ho podľa názvu, napríklad local part = workspace:WaitForChild("ColourPart") :: BasePart.
Output neukazuje vôbec nič
Overte, že okno Output je otvorené (menu Window alebo karta Script) a nemá nastavený filter: Output sa dá filtrovať podľa typu správ, podľa Client alebo Server a podľa textu. Ak je otvorené a stále prázdne, skript sa najskôr nespustil. Pozrite kontrolný zoznam pre skripty, ktoré nič nerobia.
Keď sa zaseknete: RoCode
Ak ste sa zasekli na skripte vo svojom place, RoCode ho s vami môže rozobrať. RoCode je nezávislý AI agent pre Roblox Studio, nie od Robloxu: píšete vo webovom chate a jeho plugin pre Studio vytvára a upravuje skripty vo vašom Exploreri.
Kým sa učíte, hodí sa režim Ask: skripty píšete vy a RoCode číta, čo už existuje, a odpovedá na otázky.
Vysvetli riadok po riadku, čo robí skript TouchPad vnútri partu Pad a prečo sa v ňom používa debounce.
- V režime Ask používa len nástroje na čítanie, napríklad Search Scripts a Read Script, a v place nič nemení
- Ak treba niečo opraviť, povie, čo a kde by zmenil, a navrhne prepnúť na Build
- V režime Build upravuje skripty na mieste a potom každý overí cez Check Script. Je to kontrola kompilácie, nie kontrola typov ani playtest
- Číta Output Studia nástrojom Check Output, vrátane riadkov Server a Client z vášho posledného playtestu, aj po kliknutí na Stop
V režime Build s pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s 3.9.11 alebo novším ovládať testovaciu postavu, ale počas hry nerobí snímky obrazovky, takže na plošinu si aj tak stúpnete sami. Ako sa RoCode pripája k Studiu.
Časté otázky
Kde sa v Roblox Studiu píšu skripty?
V Exploreri prejdite myšou na kontajner, napríklad ServerScriptService, kliknite na + a vyberte Script. Studio ho otvorí v Script Editore, kde píšete Luau. Serverové skripty zvyčajne ležia v ServerScriptService; LocalScripty v StarterPlayerScripts alebo StarterGui.
Ako spustiť skript v Roblox Studiu?
Kliknite na Play (F5). Studio spustí playtest a každý zapnutý Script v ServerScriptService alebo Workspace sa vykoná hneď pri štarte hry; LocalScripty v StarterPlayerScripts sa vykonajú, keď vstúpite do playtestu. Run (vyberte v zozname vedľa Play alebo stlačte F8) spustí hru bez avatara, preto pre tento návod používajte Play. Stop (Shift+F5) test ukončí. Ak chcete otvoriť existujúci skript, dvakrát naň kliknite v Exploreri.
Aký programovací jazyk Roblox používa?
Luau. Roblox ho opisuje ako rýchly, malý, bezpečný skriptovací jazyk s postupným typovaním, odvodený z Lua 5.1, takže väčšina tutoriálov k Lua je stále užitočná. Luau pridáva funkcie ako interpoláciu reťazcov v spätných úvodzovkách a voliteľné anotácie typov a Roblox pridáva vlastné knižnice a objekty, napríklad task.wait.
Čím sa Script líši od LocalScriptu?
Script beží na serveri a jeho zmeny sa dostanú ku všetkým hráčom. LocalScript beží na zariadení jedného hráča, pre vstup, kameru a menu na obrazovke, a jeho zmeny partov, hodnôt a rozhrania zostávajú na tomto zariadení. Návod o klientovi a serveri (po anglicky) rozoberá oba, plus ModuleScript.
Dajú sa skripty v Roblox Studiu písať na telefóne alebo iPade?
Inštalačná stránka Robloxu opisuje Studio ako bezplatnú aplikáciu pre Windows a Mac a neuvádza verziu pre telefón ani tablet, takže na skripty potrebujete počítač.
Prečo môj skript nič nerobí a neukazuje chybu?
Zvyčajne leží tam, kde sa taký skript nespúšťa (LocalScript vo Workspace alebo Script v StarterPlayerScripts), je vypnutý, alebo sa udalosť, na ktorú čaká, nespúšťa. Návod k chybám má kontrolný zoznam.
Ako dlho trvá naučiť sa skriptovať v Robloxe?
Poctivé číslo vám nikto nepovie: závisí od toho, koľko toho staviate. Najviac pomáha často písať malé skripty vo vlastnom place. Upravujte štyri skripty odtiaľto, vyskúšajte úlohy na precvičenie a potom prejdite návod k prvej hre a pridávajte po jednom systéme.
Zdroje a ďalšie čítanie
- Roblox Creator Docs: Luau (po anglicky). čo je Luau a odkiaľ pochádza
- Roblox Creator Docs: Roblox Studio setup (po anglicky). Windows a Mac, systémové požiadavky
- Roblox Creator Docs: Output (po anglicky). otvorenie Output, filtre, Show Context a Show Source
- Roblox Creator Docs: Studio testing modes (po anglicky). Play, Run, Stop, prepínač Client/Server a Server & Clients
- Roblox Creator Docs: Script Editor (po anglicky). kde sa otvárajú nové skripty a Script Analysis
- Roblox Creator Docs: Script types and locations (po anglicky). kde beží každý typ skriptu a tagy namiesto skriptov v partoch
- Roblox Creator Docs: Script (po anglicky). kedy Script začne bežať
- Roblox Creator Docs: Control structures (po anglicky). podmienky, cykly a prečo nekonečný cyklus potrebuje čakanie
- Roblox Creator Docs: Events (po anglicky). Connect a čo Touched odovzdáva funkcii
- Roblox Creator Docs: Debounce patterns (po anglicky). prečo sa Touched pri jednom dotyku spustí niekoľkokrát
- Roblox Creator Docs: wait (po anglicky). globálny wait() a task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (po anglicky). čo klient môže robiť so svojou postavou
- Roblox Creator Docs: Coding fundamentals (po anglicky). séria Robloxu pre začiatočníkov
Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.