Návod · Ladění

Jak opravit chyby ve skriptech v Roblox Studiu

Když se skript v Robloxu rozbije, Studio obvykle v okně Output napíše, kde a proč. V tomto návodu rozebereme, jak tuto zprávu číst, co znamenají časté chyby a jak opravit každou z nich, co kontrolovat, když skript vůbec nefunguje a žádnou chybu nehlásí, a postup, který najde příčinu, místo aby hádal.

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

Ve zkratce

Otevřete okno Output přes menu Window nebo kartu Script, klikněte na Play a klikněte na první červenou chybu. Studio otevře skript na řádku, kde spadl. Zpráva říká, co se pokazilo: attempt to index nil with 'Humanoid' znamená, že hodnota přímo před .Humanoid byla nil. Opravte důvod, proč tato hodnota chybí, a spusťte hru znovu.

  • Začínejte první chybou v seznamu. Chyby pod ní jsou často jen její následky.
  • Časté chyby během hry se dají shrnout do tří příčin: hodnota je nil, název je napsaný s chybou nebo se ještě nenačetl, nebo kód běží na špatné straně (server nebo klient).
  • Pokud žádná chyba není, kód se obvykle prostě nespustil. Zkontrolujte typ skriptu, kde leží v Exploreru, jeho vlastnost Enabled a jestli se událost, na kterou čeká, vůbec spouští.
  • Chcete-li zjistit, čemu se hodnota na daném řádku doopravdy rovná, vypište ji přes print s popiskem, nebo na ten řádek dejte breakpoint.
Na této stránce
  1. Čteme Output
  2. Postup ladění
  3. Časté chyby
  4. Bez chyb, nic se neděje
  5. Nástroje pro ladění
  6. S RoCode
  7. Časté otázky
  8. Zdroje a další čtení

Jak otevřít Output a přečíst chybu

IlustracePříklad s kill brickem z návodu, zrychleně: rozbitý řádek hodí chybu a po Stop, opravě a novém playtestu part spadne bez chyby.

Okno Output je místo, kde Roblox hlásí chyby skriptů, varování enginu a všechno, co vypisuje váš kód. Není vždycky otevřené, proto ho otevřete před testem. Pokud jste skript ještě nikdy nespustili, návod ke skriptování pro začátečníky začíná tím, že otevře Output a vypíše první řádek ze skriptu.

  1. Otevřete Output přes menu Window ve Studiu nebo tlačítkem na kartě Script.
  2. Smažte staré zprávy přes Ctrl+K (⌘K na Macu), abyste viděli jen tento test.
  3. Klikněte na Play (F5) a udělejte to, co hru rozbíjí.
  4. Najděte první červený řádek. Chyby jsou červené. Varování, například Infinite yield possible, se ukazují oranžově.

Chyba během hry vypadá v Output takto. Podle nastavení zobrazení Output může mít každý řádek ještě čas, štítek Client nebo Server a název skriptu.

Output (příklad)
ServerScriptService.CoinPad:14: attempt to index nil with 'Coins'
Stack Begin
Script 'ServerScriptService.CoinPad', Line 14 - function award
Script 'ServerScriptService.CoinPad', Line 27
Stack End
  • ServerScriptService.CoinPad je umístění skriptu v Exploreru: skript s názvem CoinPad uvnitř ServerScriptService.
  • :14 je řádek, na kterém k chybě došlo.
  • Zpráva za číslem řádku říká, co se pokazilo. Každá je rozebraná v seznamu častých chyb níže.
  • Zásobník mezi Stack Begin a Stack End ukazuje volání, která sem vedla, od posledního: řádek 14 uvnitř funkce award, kterou zavolal řádek 27.

Klikněte na červenou chybu a Studio otevře daný skript s kurzorem na správném řádku. V sólo testu jdou zprávy serveru i vašeho klienta do jednoho Output: serverové jsou označené zeleně, klientské modře. Filtry nahoře zúží seznam podle typu zprávy (Error, Warning), podle kontextu (Client, Server) nebo podle textu.

Postup ladění, který se hodí pro každý skript

Hádat a měnit několik věcí najednou je pomalý způsob, jak skript opravit. Tento postup problém krok za krokem zužuje, ať chybová zpráva je, nebo ne.

  1. Zopakujte problém. Smažte Output, klikněte na Play a udělejte přesně to, co hru rozbíjí. Zapište si, co jste čekali a co se stalo místo toho.
  2. Vezměte první chybu. Přečtěte si první nový červený řádek: cestu skriptu, číslo řádku a zprávu. Pokud chyba není, přejděte do části skripty, které běží bez chyb.
  3. Přejděte na řádek. Klikněte na chybu. Přečtěte si celý řádek a zeptejte se, která hodnota v něm může být nil, napsaná s chybou nebo špatného typu.
  4. Ověřte hodnotu, nehádejte. Přidejte print přímo nad řádek, nebo na něj dejte breakpoint a podívejte se na hodnoty v okně Watch. typeof(x) řekne, co máte: číslo, řetězec, Instance, nebo nil.
  5. Jděte po stopě zpět. Pokud je hodnota špatně, najděte, kde se nastavila: FindFirstChild, který nic nenašel, funkce, která nic nevrátila, argument, který volající kód nikdy nepředal.
  6. Opravujte příčinu, jednu změnu najednou. Opravte název, počkejte na objekt nebo kód přesuňte na správnou stranu a pak hru spusťte znovu. Neobalujte řádek do pcall, aby zmlkl: chyba se tím schová, ne opraví.
  7. Ověřte. Zopakujte krok 1. Chyba má zmizet a funkce má dělat, co jste čekali. Pokud jde o ostatní hráče, otestujte ještě v režimu Server & Clients se dvěma klienty.
  8. Ukliďte po sobě. Smažte nebo vypněte ladicí printy, aby se další problém dal snadno najít.

Časté chyby ve skriptech Robloxu a jak je opravit

Každá zpráva se staví podle jedné šablony, do které se dosazují vaše názvy, takže samotný text chyby je nejlepší nápověda. Názvy v uvozovkách níže, například 'Health' nebo "Workspace", jsou příklady.

Časté chyby v Output. Vyberte zprávu a otevře se celé vysvětlení.
Co píše OutputCo to znamenáJak to obvykle opravit
attempt to index nil with 'Health'Hodnota před .Health byla nil.Zjistěte, proč je nil, a před použitím ji zkontrolujte přes if.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild čeká už 5 sekund a objekt se pořád neobjevil.Opravte název nebo cestu, ujistěte se, že objekt někdo vytváří, nebo přidejte časový limit.
Bridge is not a valid member of Workspace "Workspace"Podřízený objekt nebo vlastnost s přesně tímto názvem tam teď není.Porovnejte pravopis a velká písmena s Explorerem. Na klientu používejte WaitForChild.
attempt to call a nil valueZavolali jste něco, co není funkce.Zkontrolujte název funkce a to, že je deklarovaná nad voláním.
attempt to perform arithmetic (add) on Instance and numberPočítání s něčím, co není číslo.U value objektů používejte .Value a u textu tonumber.
attempt to concatenate string with nil.. se snažil spojit text s nil nebo objektem.Použijte tostring(), .Name nebo interpolaci řetězců.
Expected 'end' (to close 'function' at line 3), got <eof>Syntaktická chyba. Skript se vůbec nespustí.Opravte to, co je ve Script Editoru podtržené červeně.
Requested module experienced an error while loadingSamotný ModuleScript při běhu spadl s chybou.Opravte vlastní chybu modulu, je ukázaná kousek výš v Output.
Argument 1 missing or nilFunkce Robloxu dostala nil tam, kde potřebuje hodnotu.Dohledejte, odkud měl tento argument přijít.
FireServer can only be called from the clientRemoteEvent byl zavolán ze špatné strany.Server používá FireClient, LocalScripty používají FireServer.
Chyba data store 403, StudioAccessToApisNotAllowedStudio nemá povolené používat data store této hry.Publikujte hru a zapněte Studio Access to API Services.

Každá zpráva odtud, a nejen ona, má vlastní stránku s každou příčinou, kódem, který ji vyvolá, a opravou: viz chybové zprávy Roblox Studia, například attempt to index nil, Infinite yield possible a is not a valid member of.

attempt to index nil with 'X'

Indexování je čtení něčeho přes tečku nebo hranaté závorky: part.Position, player.Character, list[1]. Tato chyba říká, že to, co je vlevo, bylo nil, a název v uvozovkách je to, co jste se z toho pokusili přečíst. Na řádku player.Character.Humanoid tedy chyba attempt to index nil with 'Humanoid' znamená, že player.Character bylo nil. Pokud je klíčem číslo, zpráva končí na with number.

Obvyklé důvody, proč byla hodnota nil:

  • FindFirstChild, FindFirstChildOfClass nebo FindFirstAncestor nic nenašel, protože název je jiný nebo objekt ještě neexistuje.
  • Players.LocalPlayer se použil v serverovém Scriptu. Existuje jen v LocalScriptech a v ModuleScriptech, které připojují přes require; na serveru je vždy nil. Místo něj použijte player, který dává PlayerAdded nebo handler RemoteEventu.
  • player.Character se přečetl dřív, než se postava spawnula, nebo zatímco se respawnuje.
  • Záznam v tabulce se nikdy nenastavil, například playerData[player] dřív, než se načetla data tohoto hráče, nebo volaná funkce nic nevrátila.

Klasický případ je kill brick. Rozbitá verze počítá s tím, že všechno, co se partu dotkne, patří postavě, a u zahozených nástrojů, neukotvených partů a doplňků to neplatí.

Script v Partu ve Workspace s názvem KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Rozbitá verze:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Pokud part, který se dotkl, není část těla postavy, FindFirstChild
	-- vrátí nil a Output ukáže:
	--   attempt to index nil with 'Health'

	-- Opraveno: každý krok před použitím zkontrolujeme
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Pokud napíšete hit.Parent.Humanoid, bude zpráva jiná, Humanoid is not a valid member of ..., rozebraná níže. FindFirstAncestorOfClass("Model") najde postavu i tehdy, když part, který se dotkl, leží uvnitř doplňku nebo nástroje v ruce postavy, takže se počítá i nástroj v ruce, který blok zavadí.

Vzor, který tuto chybu opraví: hodnotu získejte, zkontrolujte a teprve pak použijte. Na serveru se FindFirstChild s kontrolou if hodí pro něco, co tam klidně nemusí být. V LocalScriptu používejte WaitForChild pro to, co vytváří server, protože se to může objevit až po spuštění skriptu.

Infinite yield possible on ...

WaitForChild("Name") pozastaví skript, dokud se neobjeví podřízený objekt s tímto názvem. Pokud čeká déle než 5 sekund a časový limit jste nenastavili, Roblox vypíše toto varování. Je to varování, ne chyba: skript pořád čeká a nic za tímto řádkem se neprovede, dokud se objekt neobjeví, což se nemusí stát nikdy. Obvyklé příčiny:

  • Špatný název nebo rodič. WaitForChild("leaderStats") složku leaderstats nikdy nenajde.
  • Objekt nikdo nevytváří: serverový skript, který ho dělá, je vypnutý, leží jinde nebo dřív spadl s chybou. Hledejte v Output dřívější chybu.
  • LocalScript čeká na něco ve ServerStorage nebo ServerScriptService. Jejich obsah se hráčům nikdy neposílá, takže čekání neskončí.
  • Čekáte na vlastnost, ne na podřízený objekt. Častý příklad je player:WaitForChild("Character"): Character je vlastnost Player, ne objekt uvnitř.
  • Je zapnutý streaming objektů (Workspace.StreamingEnabled) a part je od hráče příliš daleko, takže ještě nebyl tomuto klientovi poslán.
LocalScript v StarterPlayerScripts s názvem DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Rozbitá verze:
--   local character = player:WaitForChild("Character")
-- Character je vlastnost Player, ne podřízený objekt, proto Output varuje:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- S časovým limitem WaitForChild vrátí nil, místo aby čekal věčně
	local humanoid = character:WaitForChild("Humanoid", 10)
	if not (humanoid and humanoid:IsA("Humanoid")) then
		warn(`[DeathMessage] no Humanoid in {character:GetFullName()} after 10 seconds`)
		return
	end
	humanoid.Died:Connect(function()
		print(`[DeathMessage] {player.Name} died`)
	end)
end

-- Zpracujeme postavu, která už může existovat, a pak každý respawn
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Číslo jako druhý argument WaitForChild je časový limit v sekundách. Skript pak může problém nahlásit přes warn a úhledně se zastavit, místo aby potichu visel.

X is not a valid member of Y

Přes tečku jste sáhli na podřízený objekt nebo vlastnost, která v tu chvíli neexistuje, například workspace.Bridge, když ve Workspace není part s názvem Bridge. Zpráva uvádí nejdřív to, o co jste žádali, pak třídu a celou cestu objektu, ve kterém se hledalo. Zkontrolujte tři věci:

  • Pravopis a velká písmena přesně odpovídají Exploreru. Složka se jmenuje leaderstats, celá malými písmeny, a humanoid není Humanoid.
  • Názvy vlastností se píšou americky. part.Colour spadne s Colour is not a valid member of Part "Workspace.Part"; vlastnost se jmenuje Color.
  • Objekt se načetl. Na klientu mohou objekty, které vytváří server, dorazit až po spuštění LocalScriptu, proto tam používejte WaitForChild.
LocalScript v StarterPlayerScripts s názvem CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Rozbitá verze:
--   local coins = player.leaderstats.Coins
-- leaderstats vytváří server a k tomuto klientovi se mohou dostat až po
-- spuštění tohoto skriptu. Pak Output ukáže:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- server dělá Coins jako IntValue

print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
	print(`[CoinsWatcher] coins changed to {newValue}`)
end)

Tady je potřeba serverový skript, který vytvoří leaderstats s IntValue jménem Coins, jako v návodu k leaderboardu.

attempt to call a nil value

Kód dal závorky za něco, co je nil, takže nebylo co spustit. Obvyklé příčiny:

  • Název funkce je napsaný s chybou nebo se liší velkými písmeny. Modul deklaruje Format.clock, ale volající kód píše Format.Clock(95).
  • local function se volá na řádku nad svou deklarací. V tu chvíli název ještě neexistuje, proto deklaraci přesuňte výš.
  • ModuleScript funkci nikdy nepřidá do tabulky, kterou vrací.

Dvě podobné zprávy ukazují na stejnou chybu. Volání neexistující metody tabulky přes dvojtečku dá attempt to call missing method 'Kill' of table. Překlep v metodě objektu Robloxu, například part:Destory(), dá Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau se pokusil počítat (add, sub, mul, div a tak dále) a jedna ze stran nebyla číslo. Názvy typů na konci zprávy napoví, o který případ jde:

  • on Instance and number: počítali jste s value objektem, ne s jeho číslem. coins + 10 má být coins.Value + 10.
  • on nil and number: proměnná nebo záznam v tabulce se nikdy nenastavil. Dejte mu počáteční hodnotu, nebo pište (x or 0) tam, kde chybějící hodnota opravdu znamená nulu.
  • on string and number: text, který není číslo, často z TextBoxu. Převeďte ho přes tonumber(text) a ověřte, že výsledek není nil. Text, ve kterém je zapsané číslo, například "5", se převede automaticky.

Porovnání se rozbíjejí stejně, s attempt to compare nil < number. Luau přepisuje a > b jako b < a, takže pořadí ve zprávě může být opačné než ve vašem kódu.

Script v ServerScriptService s názvem CoinDrip
local Players = game:GetService("Players")

local REWARD = 5
local INTERVAL_SECONDS = 60

local function addCoins(player: Player, amount: number)
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	if not (coins and coins:IsA("IntValue")) then
		-- Napíšeme, proč se nic nestalo, místo abychom mlčeli
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Rozbitá verze:
	--   coins = coins + amount
	-- coins je objekt IntValue, ne jeho číslo, proto Output ukáže:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Každou minutu dáme každému hráči na serveru pár mincí
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

Operátor .. spojuje jen řetězce a čísla. S nil spojit nejde, s objektem také ne: "Hi " .. player dá attempt to concatenate string with Instance. Použijte player.Name, obalte hodnotu do tostring(), nebo použijte interpolaci řetězců se zpětnými uvozovkami, print(`Coins: {coins}`), která vypíše nil, místo aby skript zastavila.

Expected 'end' a další syntaktické chyby

Zprávy, které začínají na Expected, jsou syntaktické chyby: kód není správný Luau, Roblox ho nemůže zkompilovat a neprovede se ani jeden řádek tohoto skriptu, ani ty nad chybou. Script Editor je podtrhává červeně už během psaní, takže je můžete opravit ještě před kliknutím na Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: function, if, for nebo while, který začíná na řádku 3, nemá svůj end. Číslo řádku před zprávou často ukazuje na konec souboru, proto se dívejte na řádek uvedený v závorce.
  • Expected 'then' when parsing if statement, got '=': jednoduché = v podmínce. Na porovnání je potřeba ==.
  • Expected ')' (to close '(' at line 1), got 'local': závorka se nikdy nezavřela.
  • Expected <eof>, got 'end': jeden end navíc.

S rovným odsazením je chybějící nebo přebývající end snadno vidět, protože každý blok stojí na stejné úrovni jako end, který ho uzavírá.

Requested module experienced an error while loading

První require() ModuleScriptu spustí jeho kód. Pokud modul během běhu spadne s chybou, skript, který ho připojil, dostane tuto zprávu. Skutečný problém je vlastní chyba modulu o řádek nebo dva výš v Output: tu opravte. Dvě podobné zprávy:

  • Module code did not return exactly one value: modul nekončí na return. ModuleScript musí vrátit jednu hodnotu, ne nil, obvykle svou tabulku.
  • Requested module was required recursively: dva moduly se připojují navzájem. Společnou část přesuňte do třetího modulu, který připojí oba.
ModuleScript v ReplicatedStorage s názvem Format
local Format = {}

-- Převede počet sekund na minuty a sekundy: z 95 je "1:35"
function Format.clock(seconds: number): string
	local whole = math.max(0, math.floor(seconds))
	return string.format("%d:%02d", whole // 60, whole % 60)
end

-- Modul musí na konci vrátit svou tabulku. Bez tohoto řádku každý
-- require tohoto modulu spadne s: Module code did not return exactly one value
return Format

Skript ho připojí přes local Format = require(ReplicatedStorage:WaitForChild("Format")) a pak zavolá Format.clock(95). Pokud napíšete Format.Clock(95), dostanete chybu attempt to call a nil value.

Argument 1 missing or nil

Funkce Robloxu dostala nil v argumentu, který potřebuje, a číslo říká, ve kterém. workspace:FindFirstChild(itemName) takto spadne, když je itemName nil. Chyba málokdy sedí na tomto řádku. Je tam, odkud měla hodnota přijít: proměnná s překlepem, atribut, který se nikdy nenastavil, nebo argument RemoteEventu, který klient neposlal. Argumenty RemoteEventu přicházejí ze zařízení hráče, proto je server musí před použitím ověřit. Jak to dělat, ukazuje návod k RemoteEvent.

FireServer can only be called from the client

RemoteEvent má směr. LocalScript volá FireServer a serverový Script poslouchá přes OnServerEvent. Serverový Script volá FireClient nebo FireAllClients a LocalScripty poslouchají přes OnClientEvent. Volání metody ze špatné strany dá tuto chybu nebo zrcadlovou, FireClient can only be called from the server. Oprava je obvykle v tom, přesunout kód do skriptu správného typu: viz Script, LocalScript a ModuleScript.

Chyba data store 403 ve Studiu

Volání data store ve Studiu padají s chybovým kódem 403 (StudioAccessToApisNotAllowed), dokud je nepovolíte. Publikujte place, otevřete File, Experience Settings, Security, zapněte Enable Studio Access to API Services a uložte. Potom Studio používá stejné data store jako živá hra, proto Roblox radí dělat to v samostatné testovací kopii, ne ve hře, kterou už lidé hrají. Každé volání data store obalte do pcall, protože taková volání mohou selhat z důvodů mimo váš kód. Jak ukládat bezpečně, rozebírá tutoriál k DataStore.

Skript běží bez chyb, ale nic nedělá

Mlčící skript se obvykle vůbec nespustil, pořád na něco čeká, nebo se spustil na špatné straně. Než začnete měnit kód, dejte mu jako první řádek print(script:GetFullName(), "started") a spusťte hru. Pokud se tento řádek v Output nikdy neobjeví, problém je v tom, kde skript leží nebo jak je nastavený, ne v tom, co je v něm napsané.

Proč může skript nic nedělat bez chyby
Co zkontrolovatCo je špatněJak opravit
Typ a umístění skriptuLocalScript se spustí, jen když ho dáte do StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack nebo ReplicatedFirst (ze Starter kontejnerů se spouští jako kopie hráče). Pokud ho dáte do Workspace, ServerScriptService nebo ReplicatedStorage, nespustí se nikdy. Script s výchozím RunContext se spouští jen ve Workspace nebo ServerScriptService.Přesuňte ho, nebo použijte jiný typ skriptu. Kód rozhraní a ovládání patří do LocalScriptu, pravidla hry do Scriptu v ServerScriptService.
EnabledSkript s odškrtnutým Enabled se nespustí.Vyberte ho a v okně Properties zaškrtněte Enabled.
RunContextRunContext u Scriptu rozhoduje, kde se spustí. Legacy, výchozí hodnota, se spouští na serveru z Workspace nebo ServerScriptService. Server se spouští na serveru, Client se spouští na zařízení každého hráče, například z ReplicatedStorage.Nastavujte ho vědomě. Dokumentace Robloxu radí dávat Client Script do ReplicatedStorage nebo ReplicatedFirst a LocalScript do Starter kontejnerů.
Událost se nespouštíTouched se spouští jen fyzickým pohybem, alespoň jeden ze dvou partů musí být neukotvený a oba potřebují CanTouch. PlayerAdded se nespustí pro hráče, kteří už byli na serveru, když jste se k události připojili. Handler RemoteEventu se nespustí, pokud druhá strana událost nikdy nevyvolá.Dejte print dovnitř handleru, abyste přesně zjistili, jestli se spouští, a pak opravte to, co ho má vyvolat.
Kód za smyčkou nebo čekánímŘádky pod smyčkou while true do se nikdy neprovedou, protože smyčka nekončí. Řádky pod WaitForChild, který objekt nikdy nenajde, se také neprovedou.Události připojujte před smyčkou, nebo smyčku spusťte přes task.spawn. Čekáním dávejte časový limit.
Kontrola, která potichu skončíOchrana jako if not coins then return end funkci potichu zastaví, když objekt chybí.Před return přidejte warn s podrobnostmi.
Filtry OutputOutput se dá filtrovat podle typu zprávy, podle Client nebo Server a podle textu. Zapomenutý filtr může schovávat chybu, kterou hledáte.Resetujte filtry a vyčistěte pole hledání.
Vidíte jen vyZměnu udělal LocalScript, takže ji vidí jen tento hráč. Server a ostatní hráči ji nevidí.Změnu dělejte na serveru. Viz kde skripty běží.

Na případ s PlayerAdded naletí hodně lidí, protože v testu ve Studiu vstupujete skoro hned po startu serveru. Pokud něco nad řádkem s Connect čeká, například WaitForChild, task.wait nebo require modulu, který čeká, můžete přijít dřív, než se připojení objeví. Zpracujte nové i už připojené hráče:

Script v ServerScriptService s názvem Welcome
local Players = game:GetService("Players")

local function onPlayerAdded(player: Player)
	print(`[Welcome] {player.Name} joined`)
end

Players.PlayerAdded:Connect(onPlayerAdded)

-- Pro hráče, kteří tu už byli, když se provedl řádek výše,
-- se PlayerAdded v tomto skriptu nespustí, proto je zpracujeme teď
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Nástroje pro ladění v Roblox Studiu

print zapíše řádek do Output a warn zapíše varování. Je to nejrychlejší způsob, jak odpovědět na otázky "spustilo se to vůbec?" a "čemu se tahle hodnota rovná?". Holé print(x) se později těžko hledá, proto přidejte popisek a důležité podrobnosti. typeof(x) ukáže, jaká je to hodnota: číslo, řetězec, Instance, nebo nil, a GetFullName() ukáže, o který přesně objekt jde.

Script v ServerScriptService s názvem ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- až skončíte, nastavte false
local TAG = "[ShopServer]"

local function debugPrint(...: any)
	if DEBUG then
		print(TAG, ...)
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	debugPrint("joined:", player.Name, player.UserId)

	local leaderstats = player:WaitForChild("leaderstats", 10)
	if not leaderstats then
		warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
		return
	end

	local coins = leaderstats:FindFirstChild("Coins")
	-- typeof a ClassName ukážou, jaká hodnota doopravdy je
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Pole hledání v Output filtruje podle textu, takže stálá značka jako [ShopServer] vám dovolí ukázat jen řádky tohoto systému. Pokud potřebujete zjistit, jak se kód k řádku dostal, debug.traceback() vrátí aktuální zásobník volání jako řetězec.

Breakpointy a krokování

Breakpoint pozastaví hru na řádku, abyste si v tu chvíli mohli všechno prohlédnout. Ve Script Editoru klikněte do okraje vpravo od čísla řádku (objeví se červené kolečko), pak spusťte playtest. Když běh k tomuto řádku dojde, hra se pozastaví a žlutá šipka ukáže další řádek. Dál kódem posouvají tlačítka krokování:

  • Step Over (F10) provede aktuální řádek a zastaví se na dalším.
  • Step Into (F11) vstoupí do funkce, která se na tomto řádku volá.
  • Step Out (Shift+F11) dokončí aktuální funkci a zastaví se v kódu, který ji zavolal.
  • Resume Scripts pokračuje k dalšímu breakpointu.

Pravé kliknutí do okraje nabídne ještě dva užitečné druhy. Podmíněný breakpoint pozastaví, jen když je výraz jako amount < 0 pravdivý. Logpoint vypíše zprávu do Output bez pozastavení, takže můžete zalogovat hodnotu, aniž byste měnili skript.

Watch a Call Stack

Když je hra pozastavená, najeďte ve Script Editoru myší na proměnnou a uvidíte její hodnotu. Okno Watch na kartě Variables ukazuje všechny proměnné v dosahu a na kartě My Watches můžete zadat jakýkoli výraz, například coins.Value + amount, a vidět jeho aktuální hodnotu. Okno Call Stack ukazuje, která funkce kterou zavolala, aby se došlo k pozastavenému řádku. Obě se otevírají přes kartu Script nebo menu Window.

Script Analysis a přísný režim

Script Editor podtrhává problémy už během psaní a okno Script Analysis, které se otevírá tlačítkem Analysis na kartě Script, ukazuje chyby a varování ve všech skriptech. Chytá syntaktické chyby a neznámé názvy ještě před kliknutím na Play. Pokud dáte jako první řádek skriptu --!strict, zapne se přísná kontrola typů Luau, která hlásí také překlepy ve vlastnostech, špatné typy argumentů a hodnoty, které mohou být nil. Spuštěnou hru ale nevidí: part, který ve Workspace chybí, ukáže jen Output.

Command bar

Command bar (na kartě Script nebo Ctrl+9, ⌘9 na Macu) hned spustí Luau. Když hra běží, je to rychlý způsob, jak se zeptat: print(workspace:FindFirstChild("Bridge")) řekne, jestli takový part existuje, a print(#game:GetService("Players"):GetPlayers()) spočítá hráče. V režimu úprav kód z command baru mění váš place doopravdy, proto buďte opatrní se vším, co objekty posouvá nebo maže.

Developer Console v živé hře

Output ve Studiu funguje jen ve Studiu. V živé hře stiskněte F9 nebo napište do chatu /console a otevře se Developer Console. Její Log ukazuje výstup z vašeho zařízení a výstup serveru, pokud jste majitel hry nebo člen skupiny s právem ji upravovat.

Vestavěný Assistant v Robloxu také může pomoct s jednotlivou zprávou: vlastní návod Robloxu radí vložit chybu z Output a požádat Assistant, aby ji rozebral. Pokud Assistant přestal odpovídat nebo píše, že jste narazili na limit, viz limity a chyby Assistant.

Oprava chyb s RoCode

RoCode je nezávislý AI agent pro Roblox Studio: problém popíšete ve webovém chatu a plugin pro Studio čte a upravuje váš otevřený place. U chyb za vás může převzít čtecí kroky z postupu výše a opřít se o playtest, který jste už spustili.

Napíšete

Klikl jsem na Play a kliknutí na tlačítko obchodu nic nedělá. Output ukazuje attempt to index nil with 'Coins'. Najdi příčinu a oprav ji.

RoCode udělá
  • Přečte Output ve Studiu svým nástrojem Check Output, včetně řádků Server a Client z vašeho posledního playtestu, i poté, co jste klikli na Stop
  • Otevře skript z chyby přes Read Script a přečte kód kolem tohoto řádku a přes Search Scripts může najít, kde se měla chybějící hodnota vytvořit
  • Udělá cílenou úpravu přes Edit Script, přesné hledání a nahrazení v tomto skriptu, pak spustí Check Script, který skript zkompiluje uvnitř Studia (nekontroluje typy, nespouští linter a váš kód nespouští)
  • Posílá změny do Studia po dávkách a každá dávka je bod pro vrácení v historii Studia

Klikněte znovu na Play a na tlačítko obchodu a o opravě se přesvědčte sami: s pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby a s pluginem 3.9.15 nebo novějším jeho testovací postava umí mačkat tlačítka na obrazovce, ale kontroluje jen to, co se sám rozhodl otestovat, a kontrola kompilace neřekne, jestli je logika hry správná. Čtení chyb patří ke každé stavbě: smyčka stavby, kontroly a testu pro celou hru tuto kontrolu opakuje po každém systému. Jak se RoCode připojuje ke Studiu.

Časté otázky

Proč skript v Robloxu nefunguje, i když chyby nejsou?

Obvykle se skript vůbec nespustil (špatný typ skriptu nebo kontejner, nebo vypnuté Enabled), pořád na něco čeká, nebo se událost, kterou poslouchá, nikdy nespustí. Print na prvním řádku ukáže, o kterou možnost jde. Viz kontrolní seznam výše.

Co v Robloxu znamená "attempt to index nil"?

Hodnota před tečkou nebo dvojtečkou byla nil, takže Roblox nemohl nahlédnout dovnitř. Na řádku player.Character.Humanoid chyba attempt to index nil with 'Humanoid' znamená, že player.Character bylo nil: neexistuje nebo se ještě nenačetlo. Před použitím hodnotu zkontrolujte přes if a v LocalScriptu čekejte na objekty, které vytváří server, přes WaitForChild. Víc o příčinách.

Co v Robloxu znamená "infinite yield possible"?

WaitForChild čeká víc než 5 sekund na podřízený objekt, který se nikdy neobjevil, a čeká dál. Často je to špatný název nebo rodič, nebo objekt nikdo nevytváří. Víc o příčinách.

Proč je okno Output prázdné nebo se neukazuje?

Otevřete ho přes menu Window nebo kartu Script. Pokud je otevřené, ale během testu zůstává prázdné, resetujte filtry a pole hledání a pak ověřte, že se skripty, které mají něco vypisovat, spouštějí.

Má Roblox kontrolu skriptů na chyby?

Ano, je vestavěná ve Studiu: Script Editor podtrhává problémy během psaní a okno Script Analysis je ukazuje jako seznam. Najdou syntaktické chyby a chyby typů, ale ne chybějící objekty ani špatnou logiku hry: ty jsou vidět, jen když kód běží.

Mám obalovat kód do pcall, aby nebyly chyby?

Jen volání, která mohou selhat z důvodů mimo váš kód, například požadavky na data store, HTTP nebo MarketplaceService. Pokud do pcall obalíte chybu s nil, zpráva zmizí, ale funkce stejně nebude fungovat.

Jak se podívat na chyby ve skriptech v živé hře?

Stiskněte ve hře F9 nebo napište do chatu /console a otevře se Developer Console. Ukazuje chyby z vašeho zařízení a ze serveru, pokud jste majitel hry nebo člen skupiny, který ji může upravovat.

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.