Tutoriál · Základy skriptovania

Ako písať skripty v Roblox Studiu: návod pre začiatočníkov

Skriptovanie, čiže programovanie, v Roblox Studiu znamená písať v Luau, verzii jazyka Lua od Robloxu, v skriptoch, ktoré pridáte do place. Tento návod začína s prázdnym Baseplate: otvoríte okno Output, napíšete prvý skript, zmeníte part z kódu, zareagujete na hráča, ktorý stúpil na plošinu, a vyskúšate LocalScript, a popri tom pochopíte premenné, funkcie, podmienky, cykly a udalosti.

Aktualizované 20. novembra 202618 min čítaniaAutor:

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(), nie wait(). Referenčná príručka Robloxu označuje globálny wait() 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
  1. Skôr ako začnete
  2. 1. Prvý skript
  3. 2. Zmeniť part
  4. 3. Udalosti
  5. 4. Prvý LocalScript
  6. 5. Test
  7. Kam skripty dávať
  8. Čítanie chýb
  9. Staršie tutoriály
  10. Prax
  11. Čo ďalej
  12. Common errors
  13. S RoCode
  14. Časté otázky
  15. Zdroje a ďalšie čítanie

Skôr ako začnete: Studio, Baseplate a okno Output

IlustráciaŠtyri skripty v jednom playteste: part ColourChanger mení farbu každú sekundu, krok na Pad ho na 2 sekundy zafarbí nažlto pre všetkých hráčov a napíše vaše meno do Output a E urobí Pad priehľadnejším len na tejto obrazovke.

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.

  1. Nainštalujte Roblox Studio, bezplatnú aplikáciu Robloxu pre Windows a Mac, a prihláste sa účtom Roblox.
  2. 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.
  3. 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.
  4. Otvorte Output z menu Window alebo karty Script. Tu sa objavujú správy a chyby vašich skriptov.
  5. 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.
Štyri skripty, ktoré napíšete
SkriptTypKde ležíČo učí
FirstScriptScriptServerScriptServicePremenné, funkcie, podmienka if, cykly a tabuľka
ColourChangerScriptVnútri Part vo WorkspaceZmena vlastností, script.Parent a cyklus s čakaním
TouchPadScriptVnútri Part s názvom PadUdalosti, hľadanie hráča, ktorý sa partu dotkol, a debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts, vnútri StarterPlayerKód na zariadení jedného hráča, stlačenia klávesov a čo zostáva na tomto zariadení
Explorer na konci (len objekty tohto návodu)
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

  1. 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.
  2. 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.
  3. Nové skripty začínajú jedným riadkom, print("Hello world!"). Zmažte ho a vložte kód nižšie.
  4. Kliknite na Play (F5), so zvoleným Test v zozname vľavo od neho. Studio spustí playtest a postaví avatara na SpawnLocation.
  5. 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
-- 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.

Output (očakávaný)
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í.

Čo robí každá časť FirstScript
KódMyš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): stringFunkciaPomenovaný 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.
returnNávratová hodnotaOdovzdá 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ťazcovText v spätných úvodzovkách môže obsahovať hodnoty: Luau nahradí {name} a {goal} ich aktuálnymi hodnotami.
if, elseif, else, endPodmienka ifLuau 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 forVykoná 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 doTabuľka a cyklusTabuľ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ž.

  1. Na karte Home kliknite na Part. Studio pridá kváder do Workspace. Na jeho názve nezáleží.
  2. V Exploreri prejdite myšou na nový part, kliknite na + a vložte Script. Premenujte ho na ColourChanger a nahraďte obsah kódom nižšie.
  3. Kliknite na Play. Part sčervenie, potom zmodrie, potom zozelenie, mení sa raz za sekundu a začína znova.
Script v akomkoľvek parte vo Workspace s názvom ColourChanger
-- 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.Parent je objekt, v ktorom skript leží, tu part. Potiahnite skript do iného partu a bude meniť ten.
  • :: BasePart je 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.Color a part.Anchored sú 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 = true drží 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. #colours je dĺžka zoznamu, 3, a % dá zvyšok po delení, takže index % #colours + 1 počíta 1, 2, 3, 1, 2, 3.
  • while true do sa opakuje donekonečna, preto je task.wait(1) vnútri taký dôležitý. Dokumentácia Robloxu hovorí vždy dať do nekonečného cyklu oneskorenie ako task.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.

  1. 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.
  2. Urobte z neho plochú plošinu, na ktorú sa dá stúpiť, napríklad v okne Properties nastavte Size na 6, 1, 6. Postavte ho na podlahu vedľa SpawnLocation a zaškrtnite Anchored, aby sa nehýbal.
  3. Prejdite myšou na Pad, kliknite na +, vložte Script, premenujte ho na TouchPad a vložte kód nižšie.
  4. Kliknite na Play a stúpte si na plošinu. Na 2 sekundy zožltne a Output napíše vaše meno.
Script v Workspace.Pad s názvom TouchPad
-- 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)
Ako sa TouchPad dostane od dotyku k hráčovi
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.
otherPartPart, 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 endZastaví 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.

  1. V Exploreri rozbaľte StarterPlayer, prejdite myšou na StarterPlayerScripts, kliknite na + a vložte LocalScript. Premenujte ho na MyFirstLocalScript a vložte kód nižšie.
  2. Kliknite na Play. Output ukáže Hello, a vaše meno so štítkom Client.
  3. Kliknite do okna hry a stlačte E. Plošina bude priehľadnejšia. Stlačte E znova a vrátite ju.
  4. 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 StarterPlayerScripts s názvom MyFirstLocalScript
-- 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.LocalPlayer je 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.InputBegan sa spustí, keď hráč začne stlačenie klávesu, kliknutie alebo dotyk. gameProcessed je true, 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, alebo nil, 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 0 je 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.
Script, LocalScript a ModuleScript
TypKde bežíKam sa dostanú zmenyNa čoZvyčajne leží v
ScriptNa serveriKu všetkým hráčomPravidlá hry: mince, poškodenie, dvere, kolá, ukladanieServerScriptService, alebo vnútri partu, kým sa učíte
LocalScriptNa zariadení jedného hráčaLen na toto zariadenie, okrem pohybu vlastnej postavyVstup, kamera, menu na obrazovke, efekty pre jedného hráčaStarterPlayerScripts alebo StarterGui
ModuleScriptNa strane, ktorá preň volá require()Tam, kam aj pri skripte, ktorý ho pripojilKód zdieľaný viacerými skriptmiReplicatedStorage 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

  1. 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.
  2. 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.
  3. Stlačte E. Plošina je polopriehľadná (Transparency 0.6). Stlačte E znova a je nepriehľadná.
  4. 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.
  5. Niečo schválne pokazte. Premenujte Pad na Pad2 a spustite hru. Krok na plošinu ju stále zafarbí nažlto, pretože TouchPad nájde svoj part cez script.Parent, nie podľa názvu. Stlačenie E teraz nič nerobí a chyba nie je: FindFirstChild("Pad") vrátil nil a kontrola if pad and ... zvyšok potichu preskočila. Pridajte print(pad) na riadok za FindFirstChild, spustite a stlačte E: Output ukáže nil. 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:

Kam dať každý druh skriptu
KontajnerČo tam daťPrečo
ServerScriptServiceSkripty s väčšinou pravidiel hry: odmeny, kolá, ukladanieBežia na serveri a nič zo ServerScriptService sa hráčom neposiela.
Vnútri partu vo WorkspaceScript, ktorý patrí k jednému partu, ako ColourChanger a TouchPadKý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 StarterPlayerVäčšina LocalScriptov: vstup, kamera, efekty pre jedného hráčaKaždý hráč dostane pri vstupe vlastnú kópiu.
StarterGuiLocalScripty vnútri ScreenGui, ktoré riadia menu na obrazovkeKaždý hráč dostane vlastnú kópiu rozhrania.
ReplicatedStorageModuleScripty, ktoré pripája serverový aj klientsky kódVidia 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:

Output (príklad)
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.

Tri chyby, ktoré sa oplatí poznať
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.

Vzory zo starších tutoriálov a čo namiesto nich robí tento návod
TutoriálProblémTento 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áveKeď 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 debounceTouched 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 WorkspaceLocalScript 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 LocalScripteZmena 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 = true nájdite priečinok hráča leaderstats a pripočítajte 1 k hodnote Coins. Nápoveda: player:FindFirstChild("leaderstats"), potom leaderstats:FindFirstChild("Coins"), potom coins.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 Transparency partu. Nápoveda: pridajte druhú tabuľku čísel od 0 do 1, napríklad { 0, 0.3, 0.6 }, a nastavujte z nej part.Transparency na riadku za part.Color, s tým istým index.
  • Vypíšte farbu plošiny. Nech MyFirstLocalScript pri stlačení E vypíše Color plošiny. Nápoveda: print(pad.Color) vnútri bloku if 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:

  1. LocalScript vs Script vs ModuleScript: kde beží každý typ skriptu a čo môže meniť, hlbšie ako krok 4.
  2. RemoteEvents: ako LocalScript požiada server, aby niečo urobil, a ako server požiadavku overí.
  3. Leaderboard: vaše prvé štatistiky vytvorené a menené na serveri.
  4. Vaša prvá hra: krátka trať s lávou, mincami a cieľovou plošinou na dvoch serverových skriptoch, potom publikovanie.
  5. 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.

Napíšete

Vysvetli riadok po riadku, čo robí skript TouchPad vnútri partu Pad a prečo sa v ňom používa debounce.

RoCode urobí
  • 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

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.

Vyskúšajte RoCode vo svojej hre.

Kredity zadarmo každý deň, bez karty. Nainštalujte plugin, opíšte funkciu a pozrite sa, čo sa objaví v Studiu.