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(), newait(). 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
Než začnete: Studio, Baseplate a okno Output
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.
- Nainstalujte Roblox Studio, bezplatnou aplikaci Robloxu pro Windows a Mac, a přihlaste se účtem Roblox.
- 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.
- 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.
- Otevřete Output z menu Window nebo karty Script. Tady se objevují zprávy a chyby vašich skriptů.
- 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.
| Skript | Typ | Kde leží | Co učí |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Proměnné, funkce, podmínka if, smyčky a tabulka |
ColourChanger | Script | Uvnitř Part ve Workspace | Změna vlastností, script.Parent a smyčka s čekáním |
TouchPad | Script | Uvnitř Part s názvem Pad | Události, hledání hráče, který se partu dotkl, a debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, uvnitř StarterPlayer | Kód na zařízení jednoho hráče, stisky kláves a co zůstává na tomto zařízení |
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
- 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.
- 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. - Nové skripty začínají jedním řádkem,
print("Hello world!"). Smažte ho a vložte kód níže. - Klikněte na Play (F5), se zvoleným Test v seznamu vlevo od něj. Studio spustí playtest a postaví avatara na SpawnLocation.
- 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.
-- 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.
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í.
| Kód | Myšlenka | Co 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): string | Funkce | Pojmenovaný 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ě. |
return | Návratová hodnota | Př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, end | Podmínka if | Luau 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 for | Provede 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 do | Tabulka a smyčka | Tabulka 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é.
- Na kartě Home klikněte na Part. Studio přidá kvádr do Workspace. Na jeho názvu nezáleží.
- V Exploreru najeďte myší na nový part, klikněte na + a vložte Script. Přejmenujte ho na
ColourChangera nahraďte obsah kódem níže. - Klikněte na Play. Part zčervená, pak zmodrá, pak zezelená, mění se jednou za sekundu a začíná znovu.
-- 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.Parentje objekt, ve kterém skript leží, tady part. Přetáhněte skript do jiného partu a bude měnit ten.:: BasePartje 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.Colorapart.Anchoredjsou stejné vlastnosti jako v okně Properties, se stejnými názvy. Roblox používá americký pravopis, proto se vlastnost jmenujeColor, i když se skript jmenuje ColourChanger.Anchored = truedrží 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.#coloursje délka seznamu, 3, a%dá zbytek po dělení, takžeindex % #colours + 1počítá 1, 2, 3, 1, 2, 3.while true dose opakuje donekonečna, proto jetask.wait(1)uvnitř tak důležitý. Dokumentace Robloxu říká vždy dát do nekonečné smyčky prodlevu jakotask.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.
- 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. - Udělejte z něj plochou plošinu, na kterou se dá stoupnout, například v okně Properties nastavte
Sizena6, 1, 6. Postavte ho na podlahu vedle SpawnLocation a zaškrtněte Anchored, aby se nehýbal. - Najeďte myší na Pad, klikněte na +, vložte Script, přejmenujte ho na
TouchPada vložte kód níže. - 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 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)
| Kód | Co 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. |
otherPart | Part, 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 end | Zastaví 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í.
- V Exploreru rozbalte StarterPlayer, najeďte myší na StarterPlayerScripts, klikněte na + a vložte LocalScript. Přejmenujte ho na
MyFirstLocalScripta vložte kód níže. - Klikněte na Play. Output ukáže
Hello,a vaše jméno se štítkem Client. - Klikněte do okna hry a stiskněte E. Plošina bude průhlednější. Stiskněte E znovu a vrátíte ji.
- 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 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.LocalPlayerje 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.InputBeganse spustí, když hráč začne stisk klávesy, kliknutí nebo dotyk.gameProcessedjetrue, 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, nebonil, 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 0je 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.
| Typ | Kde běží | Kam se dostanou změny | K čemu | Obvykle leží v |
|---|---|---|---|---|
| Script | Na serveru | Ke všem hráčům | Pravidla hry: mince, poškození, dveře, kola, ukládání | ServerScriptService, nebo uvnitř partu, dokud se učíte |
| LocalScript | Na zařízení jednoho hráče | Jen na toto zařízení, kromě pohybu vlastní postavy | Vstup, kamera, menu na obrazovce, efekty pro jednoho hráče | StarterPlayerScripts nebo StarterGui |
| ModuleScript | Na straně, která pro něj volá require() | Tam, kam i u skriptu, který ho připojil | Kód sdílený několika skripty | ReplicatedStorage 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
- 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.
- 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.
- Stiskněte E. Plošina je poloprůhledná (Transparency 0.6). Stiskněte E znovu a je neprůhledná.
- 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.
- Něco schválně rozbijte. Přejmenujte Pad na
Pad2a spusťte hru. Krok na plošinu ji pořád zbarví žlutě, protože TouchPad najde svůj part přesscript.Parent, ne podle názvu. Stisk E teď nic nedělá a chyba není:FindFirstChild("Pad")vrátilnila kontrolaif pad and ...zbytek potichu přeskočila. Přidejteprint(pad)na řádek zaFindFirstChild, spusťte a stiskněte E: Output ukáženil. 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:
| Kontejner | Co tam dát | Proč |
|---|---|---|
| ServerScriptService | Skripty 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 Workspace | Script, který patří k jednomu partu, jako ColourChanger a TouchPad | Dokud 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ř StarterPlayer | Většina LocalScriptů: vstup, kamera, efekty pro jednoho hráče | Každý hráč dostane při vstupu vlastní kopii. |
| StarterGui | LocalScripty uvnitř ScreenGui, které řídí menu na obrazovce | Každý hráč dostane vlastní kopii rozhraní. |
| ReplicatedStorage | ModuleScripty, které připojuje serverový i klientský kód | Vidí 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:
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í.
| Zpráva | Co 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.
| Tutoriál | Problém | Tento 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 debounce | Touched 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 Workspace | LocalScript 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 LocalScriptu | Změ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 = truenajděte složku hráčeleaderstatsa přičtěte 1 k hodnotěCoins. Nápověda:player:FindFirstChild("leaderstats"), pakleaderstats:FindFirstChild("Coins"), pakcoins.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
Transparencypartu. Nápověda: přidejte druhou tabulku čísel od 0 do 1, například{ 0, 0.3, 0.6 }, a nastavujte z nípart.Transparencyna řádku zapart.Color, se stejnýmindex. - Vypište barvu plošiny. Ať MyFirstLocalScript při stisku E vypíše
Colorplošiny. Nápověda:print(pad.Color)uvnitř blokuif 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:
- LocalScript vs Script vs ModuleScript: kde běží každý typ skriptu a co může měnit, hlouběji než krok 4.
- RemoteEvents: jak LocalScript požádá server, aby něco udělal, a jak server požadavek ověří.
- Leaderboard: vaše první statistiky vytvořené a měněné na serveru.
- Vaše první hra: krátká trať s lávou, mincemi a cílovou plošinou na dvou serverových skriptech, pak publikování.
- 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.
Vysvětli řádek po řádku, co dělá skript TouchPad uvnitř partu Pad a proč se v něm používá debounce.
- 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í
- Roblox Creator Docs: Luau (anglicky). co je Luau a odkud pochází
- Roblox Creator Docs: Roblox Studio setup (anglicky). Windows a Mac, systémové požadavky
- Roblox Creator Docs: Output (anglicky). otevření Output, filtry, Show Context a Show Source
- Roblox Creator Docs: Studio testing modes (anglicky). Play, Run, Stop, přepínač Client/Server a Server & Clients
- Roblox Creator Docs: Script Editor (anglicky). kde se otevírají nové skripty a Script Analysis
- Roblox Creator Docs: Script types and locations (anglicky). kde běží každý typ skriptu a tagy místo skriptů v partech
- Roblox Creator Docs: Script (anglicky). kdy Script začne běžet
- Roblox Creator Docs: Control structures (anglicky). podmínky, smyčky a proč nekonečná smyčka potřebuje čekání
- Roblox Creator Docs: Events (anglicky). Connect a co Touched předává funkci
- Roblox Creator Docs: Debounce patterns (anglicky). proč se Touched při jednom dotyku spustí několikrát
- Roblox Creator Docs: wait (anglicky). globální wait() a task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (anglicky). co klient může dělat se svou postavou
- Roblox Creator Docs: Coding fundamentals (anglicky). série Robloxu pro začátečníky
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.