Tutoriál · Základy skriptování

Jak psát skripty v Roblox Studiu: návod pro začátečníky

Skriptování, neboli programování, v Roblox Studiu znamená psát v Luau, verzi jazyka Lua od Robloxu, ve skriptech, které přidáte do place. Tento návod začíná s prázdným Baseplate: otevřete okno Output, napíšete první skript, změníte part z kódu, zareagujete na hráče, který stoupl na plošinu, a vyzkoušíte LocalScript, a cestou pochopíte proměnné, funkce, podmínky, smyčky a události.

Aktualizováno 20. listopadu 202618 min čteníAutor:

Ve zkratce

Chcete-li napsat skript v Roblox Studiu, najeďte myší na ServerScriptService v Exploreru, klikněte na + a vložte Script. Studio ho otevře ve Script Editoru. Napište Luau, například print("Hello"), klikněte na Play (F5) a výsledek si přečtěte v okně Output (menu Window nebo karta Script). Script běží na serveru a mění všechno pro všechny; LocalScript ve StarterPlayerScripts běží na zařízení jednoho hráče.

  • Nejdřív se naučte čtyři myšlenky: proměnné (local coins = 3), funkce (local function name() ... end), podmínky if a události (part.Touched:Connect(...)). Čtyři skripty tohoto návodu jsou postavené z nich, plus smyčky a tabulky.
  • Používejte task.wait(), ne wait(). Referenční příručka Robloxu označuje globální wait() jako zastaralý a nahrazený task.wait().
  • V nastavení zobrazení okna Output zapněte Show Context, aby každý řádek ukazoval, jestli přišel ze Serveru, nebo z Clientu.
Na této stránce
  1. Než začnete
  2. 1. První skript
  3. 2. Změnit part
  4. 3. Události
  5. 4. První LocalScript
  6. 5. Test
  7. Kam skripty dávat
  8. Čtení chyb
  9. Starší tutoriály
  10. Praxe
  11. Co dál
  12. Common errors
  13. S RoCode
  14. Časté otázky
  15. Zdroje a další čtení

Než začnete: Studio, Baseplate a okno Output

IlustraceČtyři skripty v jednom playtestu: part ColourChanger mění barvu každou sekundu, krok na Pad ho na 2 sekundy zbarví žlutě pro všechny hráče a napíše vaše jméno do Output a E udělá Pad průhlednějším jen na této obrazovce.

Potřebujete Roblox Studio a účet Roblox a nic víc: žádný editor kódu ani plugin. Každý skript tohoto návodu napíšete ve vlastním Script Editoru Studia.

  1. Nainstalujte Roblox Studio, bezplatnou aplikaci Robloxu pro Windows a Mac, a přihlaste se účtem Roblox.
  2. Otevřete Studio. Na úvodní stránce jsou šablony: vyberte Baseplate. Dostanete podlahu s texturou mřížky 4x4 a SpawnLocation, místo, kde se při hraní objeví váš avatar.
  3. Pokud nejsou vidět okna Explorer a Properties, otevřete je z menu Window nebo karty Home. Explorer vypisuje všechny objekty place; Properties ukazuje nastavení vybraného.
  4. Otevřete Output z menu Window nebo karty Script. Tady se objevují zprávy a chyby vašich skriptů.
  5. V nastavení zobrazení okna Output zapněte Show Context, který každou zprávu označí jako Client nebo Server, a Show Source, který ukáže skript a číslo řádku, odkud přišla.
Čtyři skripty, které napíšete
SkriptTypKde ležíCo učí
FirstScriptScriptServerScriptServiceProměnné, funkce, podmínka if, smyčky a tabulka
ColourChangerScriptUvnitř Part ve WorkspaceZměna vlastností, script.Parent a smyčka s čekáním
TouchPadScriptUvnitř Part s názvem PadUdálosti, hledání hráče, který se partu dotkl, a debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts, uvnitř StarterPlayerKód na zařízení jednoho hráče, stisky kláves a co zůstává na tomto zařízení
Explorer na konci (jen objekty tohoto 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: napište první skript

  1. V Exploreru najeďte myší na ServerScriptService, klikněte na + a vyberte Script (zkratka Ctrl+I nebo ⌘I na Macu). Studio skript vytvoří a otevře ho ve Script Editoru.
  2. Klikněte na nový skript pravým tlačítkem, vyberte Rename a pojmenujte ho FirstScript. Název nemění to, co skript dělá, ale říká, který skript co vypsal.
  3. Nové skripty začínají jedním řádkem, print("Hello world!"). Smažte ho a vložte kód níže.
  4. Klikněte na Play (F5), se zvoleným Test v seznamu vlevo od něj. Studio spustí playtest a postaví avatara na SpawnLocation.
  5. Přečtěte si řádky v Output a pak klikněte na Stop (Shift+F5). Stop také vrátí všechny objekty do stavu před kliknutím na Play, takže všechno, co jste během hry posunuli nebo přebarvili, se vrátí.
Script v ServerScriptService s názvem FirstScript
-- Script v ServerScriptService s názvem FirstScript.
-- Váš první Luau: proměnné, funkce, podmínka if, smyčka a tabulka.
-- Klikněte na Play (F5) a výsledek si přečtěte v okně Output.

-- Proměnná je název, který uchovává hodnotu
local gameName = "Coin Run"
local coinsToWin = 3

-- Funkce je pojmenovaný blok kódu, který lze spustit, kolikrát chcete.
-- name a goal jsou její parametry; return vrátí hodnotu tomu, kdo ji 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

-- Podmínka if spustí kód, jen když je podmínka 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

-- Smyčka for opakuje kód zadaný počet krát
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- Tabulka uchovává seznam hodnot; tato smyčka je prochází popořadě
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red, pak 2 Green, pak 3 Blue
end

Všechno za -- na řádku je komentář: Luau ho přeskočí, takže si můžete nechávat poznámky. Komentáře --> ukazují, co řádek vypíše.

Output má ukázat těchto osm řádků promíchaných se zprávami samotného Studia. Když print dostane několik hodnot, dá mezi ně mezeru. Se zapnutými Show Context a Show Source je každý řádek ještě označený Server a FirstScript s číslem řádku.

Output (očeká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ý řádek s kódem, který ho vypsal. Později budete totéž dělat s chybovými zprávami, takže se ten zvyk bude hodit.

FirstScript používá jen čistý Luau bez objektů Robloxu, takže funguje i v bezplatném pískovišti Luau v prohlížeči. Změňte tam hodnotu a spusťte znovu, abyste viděli, co se změní.

Co dělá každá část FirstScript
KódMyšlenkaCo to znamená
local gameName = "Coin Run"ProměnnáNázev, který uchovává hodnotu. local znamená, že ji smí používat jen tento skript nebo blok, ve kterém stojí. Text v uvozovkách je řetězec; 3 je číslo. Názvy rozlišují velikost písmen, takže coinsToWin a CoinsToWin jsou dvě různé proměnné.
local function describe(name: string, goal: number): stringFunkcePojmenovaný blok kódu, který lze spustit, kolikrát chcete. name a goal jsou její parametry: hodnoty, které se předávají při každém volání. : string a : number jsou volitelné anotace typů. Luau je používá k varováním ve Script Editoru; bez nich kód funguje stejně.
returnNávratová hodnotaPředá hodnotu kódu, který funkci zavolal. print(describe(gameName, coinsToWin)) vypíše to, co vrátí describe.
`{name}: collect {goal} coins to win`Interpolace řetězcůText ve zpětných uvozovkách může obsahovat hodnoty: Luau nahradí {name} a {goal} jejich aktuálními hodnotami.
if, elseif, else, endPodmínka ifLuau kontroluje podmínky shora dolů a provede jen první pravdivou. coinsToWin je 3, to není víc než 5, ale je to víc než 1, takže se vypíše jen „That is a short game“.
for count = 1, coinsToWin doČíselná smyčka forProvede kód uvnitř jednou pro každé číslo od 1 do coinsToWin, kde count je 1, pak 2, pak 3.
{ "Red", "Green", "Blue" } a for position, colour in colours doTabulka a smyčkaTabulka jako seznam, Luau tomu říká pole. Pozice začínají od 1, ne od 0. Smyčka projde každý prvek a dá jeho pozici a hodnotu.

Každý blok, který se otevírá slovem function, if, for nebo while, se zavírá slovem end. Jeden chybějící end zabrání spuštění celého skriptu; část čtení chyb ukazuje, jakou zprávu dostanete.

Krok 2: změňte part ze skriptu

Skripty začnou být užitečné, když mění něco ve světě. Nastavení, která vidíte v okně Properties, například Color, Transparency nebo Anchored u partu, jsou vlastnosti a skript je může nastavovat také.

  1. Na kartě Home klikněte na Part. Studio přidá kvádr do Workspace. Na jeho názvu nezáleží.
  2. V Exploreru najeďte myší na nový part, klikněte na + a vložte Script. Přejmenujte ho na ColourChanger a nahraďte obsah kódem níže.
  3. Klikněte na Play. Part zčervená, pak zmodrá, pak zezelená, mění se jednou za sekundu a začíná znovu.
Script v jakémkoli partu ve Workspace s názvem ColourChanger
-- Script uvnitř Part ve Workspace, s názvem ColourChanger.
-- Skripty mění stejné vlastnosti, jaké jsou vidět v okně Properties.
-- Tento dá svému partu každou sekundu novou barvu, pro všechny hráče.

local part = script.Parent :: BasePart -- part, ve kterém tento skript leží

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 zůstane tam, kam jste ho dali

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1, 2, 3, pak znovu 1
	task.wait(1) -- pauza na jednu sekundu (starý wait() je zastaralý)
end
  • script.Parent je objekt, ve kterém skript leží, tady part. Přetáhněte skript do jiného partu a bude měnit ten.
  • :: BasePart je přetypování. Řekne Script Editoru, že rodič je part, aby kontroloval použité vlastnosti. Luau používá typy jen na varování a nápovědu, takže přetypování nemění, co řádek dělá.
  • part.Color a part.Anchored jsou stejné vlastnosti jako v okně Properties, se stejnými názvy. Roblox používá americký pravopis, proto se vlastnost jmenuje Color, i když se skript jmenuje ColourChanger.
  • Anchored = true drží part na místě: referenční příručka Robloxu říká, že ukotvený part se nikdy nepohne kvůli gravitaci, kolizím ani jiné fyzice.
  • colours[index] přečte jeden prvek seznamu. #colours je délka seznamu, 3, a % dá zbytek po dělení, takže index % #colours + 1 počítá 1, 2, 3, 1, 2, 3.
  • while true do se opakuje donekonečna, proto je task.wait(1) uvnitř tak důležitý. Dokumentace Robloxu říká vždy dát do nekonečné smyčky prodlevu jako task.wait(): bez ní hra zamrzne a Studio spadne.

ColourChanger je Script, takže běží na serveru a všichni hráči vidí stejnou barvu ve stejnou chvíli. Krok 4 ukazuje jiný druh skriptu.

Krok 3: reagujte na hráče přes událost

Většina herního kódu čeká, až se něco stane: hráč přišel, part se někdo dotkl, tlačítko se stisklo. Roblox tomu říká události. Chcete-li spustit kód, když se událost spustí, připojíte k ní funkci.

  1. Vložte další Part a přejmenujte ho přesně na Pad, s velkým P. Nechte ho přímo ve Workspace, ne ve složce ani v modelu, protože LocalScript v kroku 4 ho hledá tam.
  2. Udělejte z něj plochou plošinu, na kterou se dá stoupnout, například v okně Properties nastavte Size na 6, 1, 6. Postavte ho na podlahu vedle SpawnLocation a zaškrtněte Anchored, aby se nehýbal.
  3. Najeďte myší na Pad, klikněte na +, vložte Script, přejmenujte ho na TouchPad a vložte kód níže.
  4. Klikněte na Play a stoupněte si na plošinu. Na 2 sekundy zežloutne a Output napíše vaše jméno.
Script v Workspace.Pad s názvem TouchPad
-- Script uvnitř Part ve Workspace s názvem Pad, skript s názvem TouchPad.
-- Události: když hráč stoupne na plošinu, rozsvítí se žlutě a Output napíše, kdo to byl.
-- Debounce zabrání tomu, aby se kód spouštěl mnohokrát za sekundu, dokud na ní 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 -- ještě běží cooldown po minulém dotyku
	end
	-- Postava je Model, ve kterém leží část těla (nebo klobouk), která se plošiny dotkla
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- dotkl se volný part nebo NPC, ne 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)
Jak se TouchPad dostane od dotyku k hráči
KódCo dělá
pad.Touched:Connect(onTouched)Připojí funkci k události Touched plošiny, takže Roblox spustí onTouched pokaždé, když se plošiny něco dotkne, a předá part, který se dotkl.
otherPartPart, který se plošiny dotkl: chodidlo, noha, ucho klobouku nebo nástroj v ruce hráče. Nikdy to není hráč sám, proto další dva řádky zjišťují, komu patří.
otherPart:FindFirstAncestorOfClass("Model")Vystoupá od tohoto partu k prvnímu předkovi, jehož třída je přesně Model, tedy k postavě. Protože se název třídy musí přesně shodovat, přeskočí klobouk (třída Accessory) i nástroj v ruce (třída Tool).
Players:GetPlayerFromCharacter(character)Vrátí Player, jehož je to postava, nebo nil, pokud to není postava žádného hráče, například NPC. character and na začátku volání přeskočí, pokud se model nenašel, a player zůstane nil.
if not player then return endZastaví se tady u všeho, co není hráč. return z funkce vystoupí předčasně.

Proč plošina potřebuje debounce

Stránka Robloxu o debounce varuje, že Touched se spouští několikrát za sebou, dokud se party dotýkají, a jdoucí postava má několik částí těla. Bez kontroly by jeden krok na plošinu mohl vypsat spoustu řádků a znovu a znovu restartovat žluté svícení.

Proměnná busy je právě debounce. První dotyk ji nastaví na true a každý dotyk během dalších 2 sekund dojde k if busy then return end a zastaví se. Po task.wait(COOLDOWN_SECONDS) plošina vrátí barvu a busy je znovu false. COOLDOWN_SECONDS je napsaný velkými písmeny, protože je to nastavení, které se během hry nemění: tak Roblox radí pojmenovávat konstanty.

Tato plošina má jeden debounce pro všechny, takže druhý hráč, který na ni během těch 2 sekund stoupne, se ignoruje. U svítící plošiny to nevadí. Plošina, která dává odměny, by měla mít cooldown pro každého hráče, jako plošina s mincemi v návodu k leaderboardu.

Krok 4: první LocalScript a v čem se liší

Běžící hra je jeden server plus jeden klient na každého hráče. Všechno doteď byl Script, který běží na serveru, takže jeho změny se dostanou ke všem hráčům. LocalScript běží na zařízení jednoho hráče. Stisky kláves, kamera a menu na obrazovce se zpracovávají tam, protože o nich ví jen toto zařízení.

  1. V Exploreru rozbalte StarterPlayer, najeďte myší na StarterPlayerScripts, klikněte na + a vložte LocalScript. Přejmenujte ho na MyFirstLocalScript a vložte kód níže.
  2. Klikněte na Play. Output ukáže Hello, a vaše jméno se štítkem Client.
  3. Klikněte do okna hry a stiskněte E. Plošina bude průhlednější. Stiskněte E znovu a vrátíte ji.
  4. Zatímco playtest běží, klikněte na přepínač Client/Server v ovládacích prvcích testování ve Studiu a přejděte na serverovou kopii hry. Tam je plošina neprůhledná: server se o změně nic nedozvěděl.
LocalScript v StarterPlayerScripts s názvem MyFirstLocalScript
-- LocalScript ve StarterPlayer > StarterPlayerScripts s názvem MyFirstLocalScript.
-- LocalScript běží na zařízení jednoho hráče. Stiskněte E: Pad bude průhlednější jen
-- na vaší obrazovce, protože změna partu odsud se nedostane na server ani k ostatním.

local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- objeví se v Output se štítkem Client

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- klávesa šla jinam, například na psaní textu v chatu
	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 jehož zařízení skript běží. Roblox ho určuje jen pro LocalScripty a ModuleScripty, které připojují, takže serverový kód ho použít nemůže.
  • UserInputService.InputBegan se spustí, když hráč začne stisk klávesy, kliknutí nebo dotyk. gameProcessed je true, když engine tento vstup už použil, například kliknutí na tlačítko nebo klávesu v řádku chatu, takže ho skript ignoruje.
  • workspace:FindFirstChild("Pad") vrátí potomka s názvem Pad, nebo nil, pokud neexistuje. pad:IsA("BasePart") ověří, že je to opravdu part, než mu skript změní Transparency.
  • if pad.Transparency == 0 then 0.6 else 0 je if výraz: vybere jednu ze dvou hodnot. Transparency 0 znamená zcela viditelný, 1 neviditelný.
  • Skript sprintu na Shift je dobrý jako druhý LocalScript: poslouchá klávesu a mění WalkSpeed postavy.
Script, LocalScript a ModuleScript
TypKde běžíKam se dostanou změnyK čemuObvykle leží v
ScriptNa serveruKe všem hráčůmPravidla hry: mince, poškození, dveře, kola, ukládáníServerScriptService, nebo uvnitř partu, dokud se učíte
LocalScriptNa zařízení jednoho hráčeJen na toto zařízení, kromě pohybu vlastní postavyVstup, kamera, menu na obrazovce, efekty pro jednoho hráčeStarterPlayerScripts nebo StarterGui
ModuleScriptNa straně, která pro něj volá require()Tam, kam i u skriptu, který ho připojilKód sdílený několika skriptyReplicatedStorage pro obě strany, ServerScriptService jen pro server

Co může podvodník změnit

Počítejte s tím, že podvodník ovládá všechno na svém zařízení. Může spouštět vlastní LocalScripty a měnit vaše, takže může udělat průhlednou plošinu nebo cokoli jiného na své obrazovce. Tady je to neškodné: průhlednost je jen na pohled a zůstává na jeho zařízení. Právě proto všechno důležité rozhoduje Script na serveru.

Ani serverový Script není automaticky bezpečný. TouchPad běží na serveru, ale zařízení každého hráče ovládá fyziku jeho postavy a dokumentace Robloxu k bezpečnosti mezi tím, co klient může dělat s party, které ovládá, uvádí řízení okamžiku spuštění Touched nebo jeho úplné zablokování. U svítící plošiny na tom nezáleží. U plošiny, která platí, kontrolujte ještě to, co server sleduje sám, jako pravidlo v návodu k obby, že checkpointy se počítají jen popořadě.

Krok 5: otestujte všechny čtyři skripty dohromady

  1. Smažte Output přes Ctrl+K (⌘K na Macu) a klikněte na Play (F5). Output ukáže osm řádků FirstScript se štítkem Server a váš řádek Hello se štítkem Client. Part ColourChanger mění barvu každou sekundu.
  2. Stoupněte si na plošinu. Na 2 sekundy zežloutne a Output jednou ukáže vaše jméno a „stepped on the pad“. Procházejte se po ní: nový řádek se objeví nejvýš jednou za 2 sekundy, ne při každém spuštění Touched.
  3. Stiskněte E. Plošina je poloprůhledná (Transparency 0.6). Stiskněte E znovu a je neprůhledná.
  4. Klikněte na Stop. V seznamu testování vyberte Server & Clients, nastavte 2 klienty a klikněte na Play (nebo F7). Studio otevře okno serveru a dvě okna klientů. V jednom klientu stiskněte E: plošina tam bude průhlednější, ale druhý klient i server ji ukážou neprůhlednou. Až skončíte, klikněte na End Session.
  5. Něco schválně rozbijte. Přejmenujte Pad na Pad2 a spusťte hru. Krok na plošinu ji pořád zbarví žlutě, protože TouchPad najde svůj part přes script.Parent, ne podle názvu. Stisk E teď nic nedělá a chyba není: FindFirstChild("Pad") vrátil nil a kontrola if pad and ... zbytek potichu přeskočila. Přidejte print(pad) na řádek za FindFirstChild, spusťte a stiskněte E: Output ukáže nil. Takový print je nejrychlejší způsob, jak zjistit, proč skript nic nedělá. Zastavte hru, smažte řádek s printem a vraťte partu název Pad.

Kam skripty dávat

Na tom, kde skript leží, závisí, jestli se vůbec spustí, a Studio vás nevaruje, pokud se nespustí nikdy. Pro vaše další skripty:

Kam dát každý druh skriptu
KontejnerCo tam dátProč
ServerScriptServiceSkripty s většinou pravidel hry: odměny, kola, ukládáníBěží na serveru a nic ze ServerScriptService se hráčům neposílá.
Uvnitř partu ve WorkspaceScript, který patří k jednomu partu, jako ColourChanger a TouchPadDokud se učíte, je to v pořádku: part je script.Parent. U skutečných projektů Roblox radí party místo toho označit tagy (viz níže).
StarterPlayerScripts, uvnitř StarterPlayerVětšina LocalScriptů: vstup, kamera, efekty pro jednoho hráčeKaždý hráč dostane při vstupu vlastní kopii.
StarterGuiLocalScripty uvnitř ScreenGui, které řídí menu na obrazovceKaždý hráč dostane vlastní kopii rozhraní.
ReplicatedStorageModuleScripty, které připojuje serverový i klientský kódVidí ho obě strany. LocalScript nebo Script s výchozím nastavením se tady nikdy nespustí.

Stránka Robloxu o umístění skriptů radí nedávat skripty přímo do partů ve Workspace vůbec: party označte tagy a pracujte s nimi z jednoho ModuleScriptu přes CollectionService. Skript uvnitř partu je stejně nejjednodušší začátek a pro jeden či dva objekty, dokud se učíte, je to v pořádku. Návod ke dveřím ukazuje vzor s tagy, s jedním skriptem na všechny dveře, a návod o klientu a serveru má úplnou tabulku, které kontejnery spouštějí které skripty.

Když se něco pokazí: čtěte Output

Chyby se v Output ukazují červeně. Každá začíná tím, kde k ní došlo, celým názvem skriptu a číslem řádku, a pak říká, co je špatně. Klikněte na chybu a Studio otevře skript na tomto řádku. Pokud například z TouchPad smažete kontrolu if not player a na plošinu spadne volný part, Output ukáže:

Output (příklad)
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'

Chyby v tom, jak je kód napsaný, například chybějící end, jsou vidět ještě před kliknutím na Play: Script Editor je podtrhává červeně a okno Script Analysis (tlačítko Analysis na kartě Script) je vypisuje. Skript s takovou chybou se nespustí vůbec, ani řádky nad ní.

Tři chyby, které stojí za to poznat
ZprávaCo znamenáJak opravit
Colour is not a valid member of Part "Workspace.Part"Tento objekt nemá nic s přesně tímto názvem. Tady se vlastnost píše Color.Porovnejte pravopis a velká písmena s oknem Properties nebo Explorerem. Víc o této chybě.
attempt to index nil with 'Name'Kód něco přečetl, tady .Name, z hodnoty nil. V příkladu výše byl player nil, protože se plošiny dotkl volný part.Zjistěte, proč je hodnota nil, a před použitím ji zkontrolujte přes if. Víc o této chybě.
Expected 'end' (to close 'then' at line 2), got <eof>if na řádku 2 nemá párový end. U funkce zpráva říká to close 'function' a <eof> znamená konec souboru.Přidejte chybějící end podle řádku v závorce, ne podle posledního. Někdy zpráva končí větou „did you forget to close ... at line N?“. To je odhad Luau podle odsazení a může ukazovat na jiný blok, proto nejdřív zkontrolujte řádek v závorce. Víc o syntaktických chybách.

Pokud skript nic nedělá a Output je také prázdný, obvykle skript leží tam, kde se nikdy nespustí, nebo čeká na událost, která se nespouští. Návod k chybám má kontrolní seznam pro mlčící skripty a víc o čtení Output.

Co starší tutoriály ke skriptování dělají jinak

Pokud se učíte i z videí a příspěvků na fórech, narazíte na starší vzory. Tady jsou ty důležité, s důvodem, proč je každý z nich problém.

Vzory ze starších tutoriálů a co místo nich dělá tento návod
TutoriálProblémTento návod
Dělá pauzu přes wait(1)Referenční příručka Robloxu označuje globální wait() jako zastaralý a uvádí, že ho nahradil task.wait().task.wait(1)
Hledá postavu přes otherPart.Parent, jako v lekci Robloxu o lávěKdyž se partu dotkne klobouk nebo nástroj v ruce, otherPart.Parent je Accessory nebo Tool, ne postava, takže se Humanoid nenajde a dotyk se ztratí.FindFirstAncestorOfClass("Model"), pak GetPlayerFromCharacter
Používá Touched bez debounceTouched se při jednom kroku spustí několikrát za sebou, takže se kód spouští znovu a znovu.Příznak busy a cooldown
Dává LocalScript dovnitř partu ve WorkspaceLocalScript se tam nikdy nespustí. Běží jen z míst, která patří jednomu hráči.LocalScript ve StarterPlayerScripts (proč)
Píše part.Touched:connect(...) nebo table.getn(list)Návod Robloxu k pojmenování říká, že API v camelCase jsou většinou zastaralá, a referenční příručka uvádí jen Connect. table.getn je zastaralý ve prospěch #list.:Connect(...) a #list
Mění mince nebo způsobuje poškození v LocalScriptuZměna zůstane na zařízení tohoto hráče, takže ji nikdo jiný nevidí a server ji nepočítá.Pravidla hry ve Scriptu na serveru

Praxe: tři změny, které stojí za to vyzkoušet

Upravovat kód naučí víc než ho číst. Vyzkoušejte to ve svém place po jednom a po každém klikněte na Play.

  • Ať plošina dává bod. Přidejte skript Leaderstats z kroku 1 návodu k leaderboardu. Pak v TouchPad za busy = true najděte složku hráče leaderstats a přičtěte 1 k hodnotě Coins. Nápověda: player:FindFirstChild("leaderstats"), pak leaderstats:FindFirstChild("Coins"), pak coins.Value += 1. Plošina s mincemi v návodu k leaderboardu je hotová verze, s cooldownem pro každého hráče.
  • Ať ColourChanger mění i průhlednost. Udělejte, aby ColourChanger každou sekundu měnil i Transparency partu. Nápověda: přidejte druhou tabulku čísel od 0 do 1, například { 0, 0.3, 0.6 }, a nastavujte z ní part.Transparency na řádku za part.Color, se stejným index.
  • Vypište barvu plošiny. Ať MyFirstLocalScript při stisku E vypíše Color plošiny. Nápověda: print(pad.Color) uvnitř bloku if pad and pad:IsA("BasePart"). Stiskněte E, zatímco je plošina žlutá: klient vidí barvu nastavenou serverem, protože změny na serveru se dostanou ke všem klientům.

Co se učit dál

Teď jste použili části, ze kterých je postavená většina herních skriptů. Dobré pořadí dál:

  1. LocalScript vs Script vs ModuleScript: kde běží každý typ skriptu a co může měnit, hlouběji než krok 4.
  2. RemoteEvents: jak LocalScript požádá server, aby něco udělal, a jak server požadavek ověří.
  3. Leaderboard: vaše první statistiky vytvořené a měněné na serveru.
  4. Vaše první hra: krátká trať s lávou, mincemi a cílovou plošinou na dvou serverových skriptech, pak publikování.
  5. Pak si vyberte systém: GUI obchodu, systém kol, checkpointy v obby, načítací obrazovka nebo animace po stisku klávesy. Když se něco rozbije, návod k chybám ve skriptech pomůže zprávu přečíst. Návod ke checkpointům je zatím anglicky.

Vlastní tutoriály Robloxu Coding fundamentals (anglicky) tento návod dobře doplňují: šest sérií od proměnných a funkcí přes podmínky, smyčky, pole a slovníky až po organizaci kódu v ModuleScriptu, s malými projekty ve Studiu.

Časté chyby a řešení

Většina problémů s prvními skripty je nesedící název, skript na špatném místě nebo smyčka bez čekání. Během testu mějte otevřený Output.

Studio po kliknutí na Play zamrzne nebo přestane reagovat

Ve smyčce while true do chybí čekání, takže nic jiného nemůže běžet. Dokumentace Robloxu říká, že nekonečná smyčka bez prodlevy jako task.wait() hru zasekne a Studio shodí. Do každé nekonečné smyčky dávejte task.wait(), jako v ColourChanger.

Když stoupnu na plošinu, nic se nestane

Ověřte, že TouchPad je Script, ne LocalScript, leží přímo uvnitř partu Pad, není vypnutý a že plošina má zaškrtnutou vlastnost CanTouch. Pak dejte print("touched", otherPart.Name) jako první řádek uvnitř onTouched. Pokud se nevypíše, událost se nespouští; pokud ano, problém je níž.

Stisk E nic nedělá

MyFirstLocalScript musí být LocalScript uvnitř StarterPlayerScripts: LocalScript ve Workspace nebo ServerScriptService se nikdy nespustí. Part se musí jmenovat přesně Pad a ležet přímo ve Workspace. Nejdřív klikněte do okna hry a ujistěte se, že nepíšete v chatu, protože skript ignoruje klávesy, které hra už použila.

Part se mění na mé obrazovce, ale ne u ostatních hráčů

Změnu udělal LocalScript, takže zůstala na vašem zařízení. Udělejte ji v serverovém Scriptu, nebo ať LocalScript požádá server přes RemoteEvent.

ColourChanger funguje uvnitř partu, ale v ServerScriptService se rozbije

Používá script.Parent jako svůj part. V ServerScriptService je rodičem ServerScriptService, který nemá Anchored ani Color, takže Output ukáže chybu „not a valid member“. Nechte ho uvnitř partu, nebo partu dejte název a hledejte ho podle názvu, například local part = workspace:WaitForChild("ColourPart") :: BasePart.

Output neukazuje vůbec nic

Ověřte, že je okno Output otevřené (menu Window nebo karta Script) a nemá nastavený filtr: Output se dá filtrovat podle typu zpráv, podle Client nebo Server a podle textu. Pokud je otevřené a pořád prázdné, skript se nejspíš nespustil. Viz kontrolní seznam pro skripty, které nic nedělají.

Když se zaseknete: RoCode

Pokud jste se zasekli na skriptu ve svém place, RoCode ho s vámi může rozebrat. RoCode je nezávislý AI agent pro Roblox Studio, ne od Robloxu: píšete ve webovém chatu a jeho plugin pro Studio vytváří a upravuje skripty ve vašem Exploreru.

Dokud se učíte, hodí se režim Ask: skripty píšete vy a RoCode čte, co už existuje, a odpovídá na otázky.

Napíšete

Vysvětli řádek po řádku, co dělá skript TouchPad uvnitř partu Pad a proč se v něm používá debounce.

RoCode udělá
  • V režimu Ask používá jen nástroje pro čtení, například Search Scripts a Read Script, a v place nic nemění
  • Pokud je potřeba něco opravit, řekne, co a kde by změnil, a navrhne přepnout na Build
  • V režimu Build upravuje skripty na místě a pak každý ověří přes Check Script. Je to kontrola kompilace, ne kontrola typů ani playtest
  • Čte Output Studia nástrojem Check Output, včetně řádků Server a Client z vašeho posledního playtestu, i po kliknutí na Stop

V režimu Build s pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby a s 3.9.11 nebo novějším ovládat testovací postavu, ale během hry nedělá snímky obrazovky, takže na plošinu si stejně stoupnete sami. Jak se RoCode připojuje ke Studiu.

Časté otázky

Kde se v Roblox Studiu píšou skripty?

V Exploreru najeďte myší na kontejner, například ServerScriptService, klikněte na + a vyberte Script. Studio ho otevře ve Script Editoru, kde píšete Luau. Serverové skripty obvykle leží v ServerScriptService; LocalScripty ve StarterPlayerScripts nebo StarterGui.

Jak spustit skript v Roblox Studiu?

Klikněte na Play (F5). Studio spustí playtest a každý zapnutý Script v ServerScriptService nebo Workspace se provede hned při startu hry; LocalScripty ve StarterPlayerScripts se provedou, když vstoupíte do playtestu. Run (vyberte v seznamu vedle Play nebo stiskněte F8) spustí hru bez avatara, proto pro tento návod používejte Play. Stop (Shift+F5) test ukončí. Chcete-li otevřít existující skript, dvakrát na něj klikněte v Exploreru.

Jaký programovací jazyk Roblox používá?

Luau. Roblox ho popisuje jako rychlý, malý, bezpečný skriptovací jazyk s postupným typováním, odvozený z Lua 5.1, takže většina tutoriálů k Lua je pořád užitečná. Luau přidává funkce jako interpolaci řetězců ve zpětných uvozovkách a volitelné anotace typů a Roblox přidává vlastní knihovny a objekty, například task.wait.

Čím se Script liší od LocalScriptu?

Script běží na serveru a jeho změny se dostanou ke všem hráčům. LocalScript běží na zařízení jednoho hráče, pro vstup, kameru a menu na obrazovce, a jeho změny partů, hodnot a rozhraní zůstávají na tomto zařízení. Návod o klientu a serveru (anglicky) rozebírá oba, plus ModuleScript.

Dají se skripty v Roblox Studiu psát na telefonu nebo iPadu?

Instalační stránka Robloxu popisuje Studio jako bezplatnou aplikaci pro Windows a Mac a neuvádí verzi pro telefon ani tablet, takže na skripty potřebujete počítač.

Proč můj skript nic nedělá a neukazuje chybu?

Obvykle leží tam, kde se takový skript nespouští (LocalScript ve Workspace nebo Script ve StarterPlayerScripts), je vypnutý, nebo se událost, na kterou čeká, nespouští. Návod k chybám má kontrolní seznam.

Jak dlouho trvá naučit se skriptovat v Robloxu?

Poctivé číslo vám nikdo neřekne: záleží na tom, kolik toho stavíte. Nejvíc pomáhá často psát malé skripty ve vlastním place. Upravujte čtyři skripty odsud, vyzkoušejte úkoly na procvičení a pak projděte návod k první hře a přidávejte po jednom systému.

Zdroje a další čtení

Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.

Vyzkoušejte RoCode ve své hře.

Kredity zdarma každý den, bez karty. Nainstalujte plugin, popište funkci a podívejte se, co se objeví ve Studiu.