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
Enableda 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
Jak otevřít Output a přečíst chybu
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.
- Otevřete Output přes menu Window ve Studiu nebo tlačítkem na kartě Script.
- Smažte staré zprávy přes Ctrl+K (⌘K na Macu), abyste viděli jen tento test.
- Klikněte na Play (F5) a udělejte to, co hru rozbíjí.
- 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.
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.CoinPadje umístění skriptu v Exploreru: skript s názvem CoinPad uvnitř ServerScriptService.:14je řá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.
- 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.
- 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.
- 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. - Ověřte hodnotu, nehádejte. Přidejte
printpří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. - 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. - 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í. - 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.
- 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.
| Co píše Output | Co 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 value | Zavolali 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 number | Počí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 loading | Samotný ModuleScript při běhu spadl s chybou. | Opravte vlastní chybu modulu, je ukázaná kousek výš v Output. |
Argument 1 missing or nil | Funkce Robloxu dostala nil tam, kde potřebuje hodnotu. | Dohledejte, odkud měl tento argument přijít. |
FireServer can only be called from the client | RemoteEvent byl zavolán ze špatné strany. | Server používá FireClient, LocalScripty používají FireServer. |
Chyba data store 403, StudioAccessToApisNotAllowed | Studio 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,FindFirstChildOfClassneboFindFirstAncestornic nenašel, protože název je jiný nebo objekt ještě neexistuje.Players.LocalPlayerse 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žijteplayer, který dáváPlayerAddednebo handler RemoteEventu.player.Characterse 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í.
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žkuleaderstatsnikdy 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"):Characterje 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.
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, ahumanoidneníHumanoid. - Názvy vlastností se píšou americky.
part.Colourspadne sColour is not a valid member of Part "Workspace.Part"; vlastnost se jmenujeColor. - Objekt se načetl. Na klientu mohou objekty, které vytváří server, dorazit až po spuštění LocalScriptu, proto tam používejte
WaitForChild.
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íšeFormat.Clock(95). local functionse 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 + 10má býtcoins.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řestonumber(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.
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,fornebowhile, který začíná na řádku 3, nemá svůjend. Čí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': jedenendnaví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čí nareturn. 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.
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é.
| Co zkontrolovat | Co je špatně | Jak opravit |
|---|---|---|
| Typ a umístění skriptu | LocalScript 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. |
| Enabled | Skript s odškrtnutým Enabled se nespustí. | Vyberte ho a v okně Properties zaškrtněte Enabled. |
| RunContext | RunContext 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 Output | Output 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 vy | Změ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:
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 a warn s kontextem
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.
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.
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.
- 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í
- Roblox Creator Docs: Output (anglicky). kde je Output, jeho filtry a nastavení zobrazení
- Roblox Creator Docs: Debugging (anglicky). breakpointy, krokování, Watch, Call Stack, command bar a Developer Console
- Roblox Creator Docs: Script Editor (anglicky). okno Script Analysis
- Roblox Creator Docs: Studio interface (anglicky). kde se otevírá Output a command bar
- Roblox Creator Docs: Script types and locations (anglicky). kde se spouští každý typ skriptu a RunContext
- Roblox Creator Docs: Studio testing modes (anglicky). Play, pohledy Client a Server a testy Server & Clients
- Roblox Engine API: Instance (anglicky). WaitForChild, jeho časový limit a varování po 5 sekundách
- Roblox Creator Docs: Reuse code (anglicky). ModuleScript a rekurzivní require
- Roblox Creator Docs: Data store error codes and limits (anglicky). chyba 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (anglicky). zapnutí přístupu ze Studia a samostatná testovací kopie
- Roblox Engine API: BasePart (anglicky). kdy se spouští Touched a CanTouch
- Roblox Creator Docs: Type checking (anglicky). přísný režim
- Roblox Creator Docs: Developer Console (anglicky). kdo v živé hře vidí výstup serveru
- Roblox Creator Docs: Build your first game with Assistant (anglicky). vložení chyby z Output, aby ji Assistant rozebral
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.