Návod · Ladenie

Ako opraviť chyby v skriptoch v Roblox Studiu

Keď sa skript v Robloxe pokazí, Studio zvyčajne napíše, kde a prečo, v okne Output. V tomto návode rozoberieme, ako túto správu čítať, čo znamenajú časté chyby a ako opraviť každú z nich, čo kontrolovať, ak skript vôbec nefunguje a nehlási chybu, a postup, ktorý nájde príčinu namiesto hádania.

Aktualizované 20. novembra 202618 min čítaniaAutor:

V skratke

Otvorte okno Output cez menu Window alebo kartu Script, stlačte Play a kliknite na prvú červenú chybu. Studio otvorí skript na riadku, kde spadol. Správa hovorí, čo sa pokazilo: attempt to index nil with 'Humanoid' znamená, že hodnota tesne pred .Humanoid bola nil. Opravte dôvod, prečo táto hodnota chýba, a spustite hru znova.

  • Začnite prvou chybou v zozname. Chyby pod ňou sú často len jej dôsledky.
  • Časté chyby počas hry sa dajú zhrnúť do troch príčin: hodnota je nil, názov je napísaný chybne alebo sa ešte nenačítal, alebo kód beží na nesprávnej strane (server alebo klient).
  • Ak chyba vôbec nie je, kód sa zvyčajne jednoducho nespustil. Skontrolujte typ skriptu, kde leží v Exploreri, jeho vlastnosť Enabled a či sa udalosť, na ktorú čaká, vôbec spúšťa.
  • Ak chcete zistiť, akú hodnotu má niečo naozaj na danom riadku, vypíšte ju cez print s popisom alebo na tento riadok dajte breakpoint.
Na tejto stránke
  1. Čítame Output
  2. Postup ladenia
  3. Časté chyby
  4. Bez chýb, nič sa nedeje
  5. Nástroje na ladenie
  6. S RoCode
  7. Časté otázky
  8. Zdroje a ďalšie čítanie

Ako otvoriť Output a prečítať chybu

IlustráciaPríklad s kill brickom z návodu, zrýchlené: pokazený riadok vyhodí chybu a po Stop, oprave a novom playteste part spadne bez chyby.

Okno Output je miesto, kde Roblox hlási chyby skriptov, varovania enginu a všetko, čo vypisuje váš kód. Nie je otvorené vždy, preto ho otvorte pred testom. Ak ste ešte nikdy nespúšťali skript, návod na skriptovanie pre začiatočníkov začína otvorením Output a vypísaním prvého riadku zo skriptu.

  1. Otvorte Output cez menu Window v Studiu alebo tlačidlom na karte Script.
  2. Vymažte staré správy cez Ctrl+K (⌘K na Macu), aby ste videli len tento test.
  3. Stlačte Play (F5) a urobte to, čo hru pokazí.
  4. Nájdite prvý červený riadok. Chyby sú červené. Varovania, napríklad Infinite yield possible, sa zobrazujú oranžovo.

Chyba počas hry vyzerá v Output takto. Podľa nastavení zobrazenia Output môže mať každý riadok aj čas, štítok Client alebo Server a názov skriptu.

Output (prí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 umiestnenie skriptu v Exploreri: skript s názvom CoinPad vnútri ServerScriptService.
  • :14 je riadok, na ktorom chyba nastala.
  • Správa za číslom riadku hovorí, čo sa pokazilo. Každá je rozobraná v zozname častých chýb nižšie.
  • Stack medzi Stack Begin a Stack End ukazuje volania, ktoré viedli sem, od posledného: riadok 14 vnútri funkcie award, ktorú zavolal riadok 27.

Kliknite na červenú chybu a Studio otvorí tento skript s kurzorom na správnom riadku. Pri teste osamote idú správy servera aj vášho klienta do jedného Output: serverové sú označené zelenou, klientske modrou. Filtre hore zúžia zoznam podľa typu správy (Error, Warning), podľa kontextu (Client, Server) alebo podľa textu.

Postup ladenia, ktorý sa hodí na akýkoľvek skript

Hádať a meniť naraz viac vecí je pomalý spôsob, ako skript opraviť. Tento postup krok za krokom zužuje problém, či už chybové hlásenie je, alebo nie.

  1. Zopakujte problém. Vymažte Output, stlačte Play a urobte presne to, čo hru pokazí. Zapíšte si, čo ste čakali a čo sa stalo namiesto toho.
  2. Vezmite prvú chybu. Prečítajte si prvý nový červený riadok: cestu skriptu, číslo riadku a správu. Ak chyba nie je, prejdite na časť skripty, ktoré bežia bez chýb.
  3. Prejdite na riadok. Kliknite na chybu. Prečítajte si celý riadok a opýtajte sa, ktorá hodnota v ňom môže byť nil, napísaná chybne alebo nesprávneho typu.
  4. Skontrolujte hodnotu, nehádajte. Pridajte print priamo nad riadok alebo naň dajte breakpoint a pozrite si hodnoty v okne Watch. typeof(x) povie, čo máte: číslo, reťazec, Instance alebo nil.
  5. Choďte po stope späť. Ak je hodnota nesprávna, nájdite, kde sa nastavila: FindFirstChild, ktorý nič nenašiel, funkcia, ktorá nič nevrátila, argument, ktorý volajúci kód nikdy neodovzdal.
  6. Opravte príčinu, jednu zmenu naraz. Opravte názov, počkajte na objekt alebo presuňte kód na správnu stranu a potom hru spustite znova. Neobaľujte riadok do pcall, aby stíchol: tak sa chyba skryje, nie opraví.
  7. Overte to. Zopakujte krok 1. Chyba musí zmiznúť a funkcia musí robiť to, čo ste čakali. Ak ide o ďalších hráčov, otestujte to aj v režime Server & Clients s dvoma klientmi.
  8. Upracte po sebe. Vymažte alebo vypnite ladiace printy, aby sa ďalší problém dal ľahko zbadať.

Časté chyby v skriptoch Roblox a ako ich opraviť

Každá správa je postavená podľa jednej šablóny, do ktorej sa dosadia vaše názvy, preto je samotný text chyby najlepšou nápovedou. Názvy v úvodzovkách nižšie, napríklad 'Health' alebo "Workspace", sú príklady.

Časté chyby v Output. Vyberte správu a otvoríte celé vysvetlenie.
Čo píše OutputČo to znamenáAko to zvyčajne opraviť
attempt to index nil with 'Health'Hodnota pred .Health bola nil.Zistite, prečo je nil, a pred použitím ju skontrolujte cez if.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild čaká už 5 sekúnd a objekt sa stále neobjavil.Opravte názov alebo cestu, uistite sa, že objekt niekto vytvára, alebo pridajte časový limit.
Bridge is not a valid member of Workspace "Workspace"Podradený objekt alebo vlastnosť s presne týmto názvom tam práve nie je.Porovnajte pravopis a veľké písmená s Explorerom. Na klientovi použite WaitForChild.
attempt to call a nil valueZavolali ste niečo, čo nie je funkcia.Skontrolujte názov funkcie a to, že je deklarovaná nad volaním.
attempt to perform arithmetic (add) on Instance and numberMatematika s niečím, čo nie je číslo.Pri value objektoch použite .Value a pre text tonumber.
attempt to concatenate string with nil.. sa pokúsil spojiť text s nil alebo objektom.Použite tostring(), .Name alebo interpoláciu reťazcov.
Expected 'end' (to close 'function' at line 3), got <eof>Syntaktická chyba. Skript sa vôbec nespustí.Opravte to, čo je v Script Editore podčiarknuté červenou.
Requested module experienced an error while loadingSamotný ModuleScript spadol s chybou, keď bežal.Opravte vlastnú chybu modulu, je zobrazená o kúsok vyššie v Output.
Argument 1 missing or nilFunkcia Robloxu dostala nil tam, kde potrebuje hodnotu.Vystopujte, odkiaľ mal tento argument prísť.
FireServer can only be called from the clientRemoteEvent bol zavolaný z nesprávnej strany.Server používa FireClient, LocalScripty používajú FireServer.
Chyba data store 403, StudioAccessToApisNotAllowedStudio nemá povolené používať data store tejto hry.Publikujte hru a zapnite Studio Access to API Services.

Každá správa odtiaľto, aj ďalšie, má vlastnú stránku s každou príčinou, kódom, ktorý ju spôsobuje, a opravou: pozrite si chybové hlásenia Roblox Studia, napríklad attempt to index nil, Infinite yield possible a is not a valid member of.

attempt to index nil with 'X'

Indexovanie je čítanie niečoho cez bodku alebo hranaté zátvorky: part.Position, player.Character, list[1]. Táto chyba hovorí, že to, čo bolo vľavo, bolo nil, a názov v úvodzovkách je to, čo ste sa z toho pokúsili prečítať. Takže na riadku player.Character.Humanoid chyba attempt to index nil with 'Humanoid' znamená, že player.Character bol nil. Ak je kľúčom číslo, správa končí na with number.

Bežné dôvody, prečo bola hodnota nil:

  • FindFirstChild, FindFirstChildOfClass alebo FindFirstAncestor nič nenašiel, pretože názov je iný alebo objekt ešte neexistuje.
  • Players.LocalPlayer bol použitý v serverovom Script. Existuje len v LocalScript a v ModuleScript, ktoré si načítajú cez require; na serveri je vždy nil. Namiesto neho použite player, ktorého dáva PlayerAdded alebo handler RemoteEvent.
  • player.Character sa čítal skôr, než sa postava spawnla, alebo kým sa respawnuje.
  • Záznam v tabuľke sa nikdy nenastavil, napríklad playerData[player] predtým, než sa načítali dáta tohto hráča, alebo volaná funkcia nič nevrátila.

Klasickým prípadom je kill brick. Pokazená verzia predpokladá, že všetko, čo sa dotkne partu, patrí postave, a pri odhodených nástrojoch, neukotvených partoch a doplnkoch to neplatí.

Script v Part vo Workspace s názvom KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Pokazená verzia:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Ak part, ktorý sa dotkol, nie je časťou tela postavy, FindFirstChild
	-- vráti nil a Output ukáže:
	--   attempt to index nil with 'Health'

	-- Opravené: každý krok pred použitím skontrolujeme
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Ak napíšete hit.Parent.Humanoid, dostanete inú správu, Humanoid is not a valid member of ..., ktorá je rozobraná nižšie. FindFirstAncestorOfClass("Model") nájde postavu aj vtedy, keď part, ktorý sa dotkol, leží vnútri doplnku alebo nástroja v ruke postavy, takže sa počíta aj nástroj v ruke, ktorý zavadil o blok.

Vzor, ktorý túto chybu opravuje: získajte hodnotu, skontrolujte ju a až potom ju použite. Na serveri sa FindFirstChild s kontrolou if hodí na to, čo tam pokojne nemusí byť. V LocalScript použite WaitForChild pre to, čo vytvára server, pretože sa to môže objaviť až po spustení skriptu.

Infinite yield possible on ...

WaitForChild("Name") pozastaví skript, kým sa neobjaví podradený objekt s týmto názvom. Ak čaká dlhšie než 5 sekúnd a časový limit ste nenastavili, Roblox vypíše toto varovanie. Je to varovanie, nie chyba: skript stále čaká a nič za týmto riadkom sa nevykoná, kým sa objekt neobjaví, čo sa nemusí stať nikdy. Bežné príčiny:

  • Nesprávny názov alebo rodič. WaitForChild("leaderStats") nikdy nenájde priečinok leaderstats.
  • Objekt nikto nevytvára: serverový skript, ktorý ho robí, je vypnutý, leží na nesprávnom mieste alebo skôr spadol s chybou. Hľadajte skoršiu chybu v Output.
  • LocalScript čaká na niečo v ServerStorage alebo ServerScriptService. Ich obsah sa hráčom nikdy neposiela, preto čakanie neskončí.
  • Čakáte na vlastnosť, nie na podradený objekt. Častý príklad je player:WaitForChild("Character"): Character je vlastnosť Player, nie objekt vnútri neho.
  • Je zapnutý streaming objektov (Workspace.StreamingEnabled) a part je od hráča príliš ďaleko, preto ešte nebol poslaný tomuto klientovi.
LocalScript v StarterPlayerScripts s názvom DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Pokazená verzia:
--   local character = player:WaitForChild("Character")
-- Character je vlastnosť Player, nie podradený objekt, preto Output varuje:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- S časovým limitom WaitForChild vráti nil a nečaká večne
	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

-- Spracujeme postavu, ktorá už môže existovať, a potom každý respawn
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Číslo ako druhý argument WaitForChild je časový limit v sekundách. Skript potom môže o probléme oznámiť cez warn a úhľadne skončiť, namiesto toho, aby potichu visel.

X is not a valid member of Y

Cez bodku ste siahli na podradený objekt alebo vlastnosť, ktorá v tej chvíli neexistuje, napríklad workspace.Bridge, keď vo Workspace nie je part s názvom Bridge. Správa najprv uvádza to, čo ste žiadali, potom triedu a celú cestu objektu, v ktorom sa hľadalo. Skontrolujte tri veci:

  • Pravopis a veľké písmená sa presne zhodujú s Explorerom. Priečinok sa volá leaderstats, celý malými písmenami, a humanoid nie je Humanoid.
  • Názvy vlastností sa píšu po americky. part.Colour spadne s Colour is not a valid member of Part "Workspace.Part"; vlastnosť sa volá Color.
  • Objekt sa načítal. Na klientovi môžu objekty, ktoré vytvára server, prísť až po spustení LocalScriptu, preto tam použite WaitForChild.
LocalScript v StarterPlayerScripts s názvom CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Pokazená verzia:
--   local coins = player.leaderstats.Coins
-- leaderstats vytvára server a k tomuto klientovi sa môže dostať až po
-- spustení tohto skriptu. Potom 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 vytvára Coins ako IntValue

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

Tu potrebujete serverový skript, ktorý vytvorí leaderstats s IntValue s názvom Coins, ako v návode na leaderboard.

attempt to call a nil value

Kód dal zátvorky za niečo, čo je nil, takže nebolo čo spustiť. Bežné príčiny:

  • Názov funkcie je napísaný chybne alebo sa líši veľkými písmenami. Modul deklaruje Format.clock, ale volajúci kód píše Format.Clock(95).
  • local function sa volá na riadku nad jej deklaráciou. V tej chvíli názov ešte neexistuje, preto deklaráciu presuňte vyššie.
  • ModuleScript nikdy nepridá funkciu do tabuľky, ktorú vracia.

Dve podobné správy ukazujú na tú istú chybu. Volanie neexistujúcej metódy tabuľky cez dvojbodku dáva attempt to call missing method 'Kill' of table. Preklep v metóde objektu Robloxu, napríklad part:Destory(), dáva Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau sa pokúsil počítať (add, sub, mul, div a tak ďalej) a jedna zo strán nebola číslo. Názvy typov na konci správy napovedia, aký prípad máte:

  • on Instance and number: počítali ste s value objektom, nie s jeho číslom. coins + 10 má byť coins.Value + 10.
  • on nil and number: premenná alebo záznam v tabuľke sa nikdy nenastavil. Dajte jej počiatočnú hodnotu alebo píšte (x or 0) tam, kde chýbajúca hodnota naozaj znamená nulu.
  • on string and number: text, ktorý nie je číslo, často z TextBoxu. Preveďte ho cez tonumber(text) a skontrolujte, že výsledok nie je nil. Text, v ktorom je zapísané číslo, napríklad "5", sa prevedie automaticky.

Porovnania sa lámu rovnako, s attempt to compare nil < number. Luau prepisuje a > b ako b < a, preto môže byť poradie v správe opačné ako vo vašom kóde.

Script v ServerScriptService s názvom 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, prečo sa nič nestalo, namiesto mlčania
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

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

-- Každú minútu dáme každému hráčovi na serveri trochu 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 .. spája len reťazce a čísla. S nil to nepôjde a s objektom tiež nie: "Hi " .. player dáva attempt to concatenate string with Instance. Použite player.Name, obaľte hodnotu do tostring() alebo použite interpoláciu reťazcov so spätnými úvodzovkami, print(`Coins: {coins}`), ktorá vypíše nil a skript nezastaví.

Expected 'end' a ďalšie syntaktické chyby

Správy, ktoré začínajú na Expected, sú syntaktické chyby: kód nie je správne Luau, Roblox ho nevie skompilovať a nevykoná sa ani jeden riadok tohto skriptu, ani tie nad chybou. Script Editor ich podčiarkuje červenou priamo počas písania, takže ich môžete opraviť pred stlačením Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: function, if, for alebo while, ktorý začína na riadku 3, nemá svoj end. Číslo riadku pred správou často ukazuje na koniec súboru, preto sa pozrite na riadok uvedený v zátvorke.
  • Expected 'then' when parsing if statement, got '=': jedno = v podmienke. Na porovnanie treba ==.
  • Expected ')' (to close '(' at line 1), got 'local': zátvorka sa nikdy nezatvorila.
  • Expected <eof>, got 'end': jeden end navyše.

S rovnomerným odsadením sa chýbajúci alebo nadbytočný end ľahko zbadá, pretože každý blok stojí na rovnakej úrovni ako end, ktorý ho uzatvára.

Requested module experienced an error while loading

Prvé require() ModuleScriptu spustí jeho kód. Ak modul počas behu spadne s chybou, skript, ktorý ho načítal, dostane túto správu. Skutočný problém je vlastná chyba modulu o riadok alebo dva vyššie v Output: opravte ju. Dve podobné správy:

  • Module code did not return exactly one value: modul nekončí na return. ModuleScript musí vracať jednu hodnotu, nie nil, zvyčajne svoju tabuľku.
  • Requested module was required recursively: dva moduly sa načítavajú navzájom. Spoločnú časť presuňte do tretieho modulu, ktorý načítajú oba.
ModuleScript v ReplicatedStorage s názvom Format
local Format = {}

-- Prevedie počet sekúnd na minúty a sekundy: 95 sa zmení na "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átiť svoju tabuľku. Bez tohto riadku každý
-- require tohto modulu spadne s: Module code did not return exactly one value
return Format

Skript ho načíta cez local Format = require(ReplicatedStorage:WaitForChild("Format")) a potom zavolá Format.clock(95). Ak napíšete Format.Clock(95), dostanete chybu attempt to call a nil value.

Argument 1 missing or nil

Funkcia Robloxu dostala nil v argumente, ktorý potrebuje, a číslo hovorí, v ktorom. workspace:FindFirstChild(itemName) takto spadne, keď je itemName nil. Chyba málokedy sedí na tomto riadku. Je tam, odkiaľ mala hodnota prísť: premenná s preklepom, atribút, ktorý sa nikdy nenastavil, alebo argument RemoteEvent, ktorý klient neposlal. Argumenty RemoteEvent prichádzajú zo zariadenia hráča, preto ich server musí pred použitím kontrolovať. Ako na to, ukazuje návod na RemoteEvent.

FireServer can only be called from the client

RemoteEvent má smer. LocalScript volá FireServer a serverový Script počúva cez OnServerEvent. Serverový Script volá FireClient alebo FireAllClients a LocalScripty počúvajú cez OnClientEvent. Volanie metódy z nesprávnej strany dá túto chybu alebo zrkadlovú, FireClient can only be called from the server. Oprava zvyčajne spočíva v presunutí kódu do skriptu správneho typu: pozrite si Script, LocalScript a ModuleScript.

Chyba data store 403 v Studiu

Volania data store v Studiu padajú s kódom chyby 403 (StudioAccessToApisNotAllowed), kým ich nepovolíte. Publikujte place, otvorte File, Experience Settings, Security, zapnite Enable Studio Access to API Services a uložte. Potom Studio používa tie isté data store ako živá hra, preto Roblox radí robiť to v samostatnej testovacej kópii, nie v hre, ktorú už ľudia hrajú. Každé volanie data store obaľte do pcall, pretože takéto volania môžu zlyhať z dôvodov mimo vášho kódu. Ako ukladať bezpečne, rozoberá návod na DataStore.

Skript beží bez chýb, ale nič nerobí

Mlčiaci skript sa zvyčajne vôbec nespustil, stále na niečo čaká alebo sa spustil na nesprávnej strane. Skôr než budete meniť kód, dajte mu ako prvý riadok print(script:GetFullName(), "started") a spustite hru. Ak sa tento riadok v Output nikdy neobjaví, problém je v tom, kde skript leží alebo ako je nastavený, nie v tom, čo je v ňom napísané.

Prečo skript môže nič nerobiť bez chyby
Čo skontrolovaťČo ide zleAko to opraviť
Typ a umiestnenie skriptuLocalScript sa spustí, len ak ho dáte do StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack alebo ReplicatedFirst (zo Starter kontajnerov sa spúšťa ako kópia hráča). Ak ho dáte do Workspace, ServerScriptService alebo ReplicatedStorage, nespustí sa nikdy. Script s predvoleným RunContext sa spúšťa len vo Workspace alebo ServerScriptService.Presuňte ho alebo použite iný typ skriptu. Kód rozhrania a ovládania patrí do LocalScript, pravidlá hry patria do Script v ServerScriptService.
EnabledSkript, ktorý má zrušené zaškrtnutie Enabled, sa nespustí.Označte ho a zaškrtnite Enabled v okne Properties.
RunContextRunContext pri Script rozhoduje, kde sa spustí. Legacy, predvolená hodnota, sa spúšťa na serveri z Workspace alebo ServerScriptService. Server sa spúšťa na serveri, Client sa spúšťa na zariadení každého hráča, napríklad z ReplicatedStorage.Nastavujte ho vedome. Dokumentácia Robloxu radí dávať Client Script do ReplicatedStorage alebo ReplicatedFirst a LocalScript do Starter kontajnerov.
Udalosť sa nespúšťaTouched sa spúšťa len pri fyzickom pohybe, aspoň jeden z dvoch partov musí byť neukotvený a oba potrebujú CanTouch. PlayerAdded sa nespustí pre hráčov, ktorí už boli na serveri, keď ste sa k udalosti pripojili. Handler RemoteEvent sa nespustí, ak druhá strana udalosť nikdy nezavolá.Dajte print dovnútra handlera, aby ste presne zistili, či sa spúšťa, a potom opravte to, čo ho má vyvolať.
Kód za cyklom alebo čakanímRiadky pod cyklom while true do sa nevykonajú nikdy, pretože cyklus nekončí. Riadky pod WaitForChild, ktorý objekt nikdy nenájde, sa tiež nevykonajú.Pripojte udalosti pred cyklom alebo spustite cyklus cez task.spawn. Čakaniam dávajte časový limit.
Kontrola, ktorá potichu skončíOchrana ako if not coins then return end potichu zastaví funkciu, keď objekt chýba.Pred return pridajte warn s podrobnosťami.
Filtre OutputOutput sa dá filtrovať podľa typu správy, podľa Client alebo Server a podľa textu. Zabudnutý filter môže skrývať chybu, ktorú hľadáte.Zrušte filtre a vymažte pole vyhľadávania.
Vidíte to len vyZmenu urobil LocalScript, preto ju vidí len tento hráč. Server ani ostatní hráči ju nevidia.Urobte zmenu na serveri. Pozrite si, kde sa skripty spúšťajú.

Na prípad s PlayerAdded narazí veľa ľudí, pretože pri teste v Studiu sa pripojíte takmer hneď po štarte servera. Ak niečo nad riadkom s Connect čaká, napríklad WaitForChild, task.wait alebo require modulu, ktorý čaká, môžete sa pripojiť skôr, než pripojenie vznikne. Spracujte nových aj už pripojených hráčov:

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

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- Pre hráčov, ktorí už tu boli, keď sa vykonal riadok vyššie,
-- sa PlayerAdded v tomto skripte nespustí, preto ich spracujeme teraz
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Nástroje na ladenie v Roblox Studiu

print napíše riadok do Output a warn napíše varovanie. Je to najrýchlejší spôsob, ako odpovedať na otázky "spustilo sa to vôbec?" a "akú hodnotu má toto?". Holý print(x) sa potom ťažko hľadá, preto pridajte popis a dôležité podrobnosti. typeof(x) ukáže, aká je to hodnota: číslo, reťazec, Instance alebo nil, a GetFullName() ukáže, aký presne objekt máte.

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

local DEBUG = true -- nastavte false, keď skončíte
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ážu, aká hodnota to naozaj je
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Pole vyhľadávania v Output filtruje podľa textu, preto stály štítok ako [ShopServer] umožní zobraziť len riadky tohto systému. Ak potrebujete zistiť, ako sa kód dostal k riadku, debug.traceback() vráti aktuálny stack volaní ako reťazec.

Breakpointy a krokovanie

Breakpoint pozastaví hru na riadku, aby ste si mohli pozrieť všetko v tej chvíli. V Script Editore kliknite na okraj napravo od čísla riadku (objaví sa červený krúžok), potom spustite playtest. Keď vykonávanie dôjde k tomuto riadku, hra sa pozastaví a žltá šípka ukáže ďalší riadok. Ďalej sa po kóde posúvate tlačidlami krokovania:

  • Step Over (F10) vykoná aktuálny riadok a zastaví sa na ďalšom.
  • Step Into (F11) vojde dovnútra funkcie, ktorá sa na tomto riadku volá.
  • Step Out (Shift+F11) dokončí aktuálnu funkciu a zastaví sa v kóde, ktorý ju zavolal.
  • Resume Scripts pokračuje po ďalší breakpoint.

Pravý klik na okraj ponúka ďalšie dva užitočné druhy. Podmienený breakpoint pozastaví len vtedy, keď je výraz ako amount < 0 pravdivý. Logpoint vypíše správu do Output bez pozastavenia, takže môžete zalogovať hodnotu bez úpravy skriptu.

Watch a Call Stack

Keď je hra pozastavená, prejdite kurzorom na premennú v Script Editore a uvidíte jej hodnotu. Okno Watch na karte Variables ukazuje všetky premenné v rozsahu a na karte My Watches môžete zadať akýkoľvek výraz, napríklad coins.Value + amount, a vidieť jeho aktuálnu hodnotu. Okno Call Stack ukazuje, ktorá funkcia zavolala ktorú, aby sa dostala k pozastavenému riadku. Obe otvoríte cez kartu Script alebo menu Window.

Script Analysis a prísny režim

Script Editor podčiarkuje problémy priamo počas písania a okno Script Analysis, ktoré otvoríte tlačidlom Analysis na karte Script, ukazuje chyby a varovania vo všetkých skriptoch. Zachytí syntaktické chyby a neznáme názvy pred stlačením Play. Ak ako prvý riadok skriptu dáte --!strict, zapne sa prísna kontrola typov Luau, ktorá hlási aj preklepy vo vlastnostiach, nesprávne typy argumentov a hodnoty, ktoré môžu byť nil. Spustenú hru však nevidí: part, ktorý vo Workspace nie je, ukáže len Output.

Command bar

Command bar (na karte Script alebo Ctrl+9, ⌘9 na Macu) hneď vykoná Luau. Kým hra beží, je to rýchly spôsob, ako sa niečo opýtať: print(workspace:FindFirstChild("Bridge")) povie, či taký part existuje, a print(#game:GetService("Players"):GetPlayers()) spočíta hráčov. V režime úprav kód z command baru mení váš place naozaj, preto buďte opatrní so všetkým, čo presúva alebo maže objekty.

Developer Console v živej hre

Output v Studiu funguje len v Studiu. V živej hre stlačte F9 alebo napíšte /console do chatu a otvorí sa Developer Console. Jej Log ukazuje výstup z vášho zariadenia a výstup servera, ak ste vlastník hry alebo člen skupiny s právom ju upravovať.

Vstavaný Assistant v Robloxe tiež môže pomôcť s jednotlivou správou: vlastný návod Robloxu radí vložiť chybu z Output a požiadať Assistant, aby ju rozobral. Ak Assistant prestal odpovedať alebo píše, že ste narazili na limit, pozrite si limity a chyby Assistantu.

Oprava chýb s RoCode

RoCode je nezávislý AI agent pre Roblox Studio: problém opíšete vo webovom chate a plugin pre Studio číta a upravuje váš otvorený place. Pri chybách môže prevziať kroky čítania z postupu vyššie, pričom vychádza z playtestu, ktorý ste už spustili.

Napíšete

Stlačil som Play a klik na tlačidlo obchodu nič nerobí. Output ukazuje attempt to index nil with 'Coins'. Nájdi príčinu a oprav ju.

RoCode urobí
  • Číta Output v Studiu svojím nástrojom Check Output, vrátane riadkov Server a Client z vášho posledného playtestu, aj potom, čo ste stlačili Stop
  • Otvorí skript z chyby cez Read Script a prečíta kód okolo tohto riadku a cez Search Scripts môže nájsť, kde sa mala chýbajúca hodnota vytvárať
  • Urobí cielenú úpravu cez Edit Script, presné vyhľadanie a nahradenie v tomto skripte, potom spustí Check Script, ktorý skript skompiluje v Studiu (nekontroluje typy, nespúšťa linter a nevykonáva váš kód)
  • Posiela zmeny do Studia v dávkach a každá dávka je bod na vrátenie v histórii Studia

Stlačte znova Play a kliknite na tlačidlo obchodu, aby ste sa o oprave presvedčili sami: s pluginom 3.9 alebo novším môže RoCode spustiť krátky playtest a prečítať chyby a s pluginom 3.9.15 alebo novším jeho testovacia postava dokáže stláčať tlačidlá na obrazovke, ale overuje len to, čo sa sám rozhodol otestovať, a kontrola kompilácie nepovie, či je logika hry správna. Čítanie chýb je súčasťou každej stavby: cyklus stavby, kontroly a testu pre celú hru opakuje túto kontrolu po každom systéme. Ako sa RoCode pripája k Studiu.

Časté otázky

Prečo skript v Robloxe nefunguje, hoci nie sú žiadne chyby?

Skript sa zvyčajne vôbec nespustil (nesprávny typ skriptu alebo kontajner, alebo je vypnuté Enabled), stále na niečo čaká, alebo sa udalosť, ktorú počúva, nikdy nespustí. Print na prvom riadku ukáže, o ktorú možnosť ide. Pozrite si kontrolný zoznam vyššie.

Čo znamená "attempt to index nil" v Robloxe?

Hodnota pred bodkou alebo dvojbodkou bola nil, preto Roblox nemohol nazrieť dovnútra. Na riadku player.Character.Humanoid chyba attempt to index nil with 'Humanoid' znamená, že player.Character bol nil: neexistuje alebo sa ešte nenačítal. Pred použitím hodnotu skontrolujte cez if a v LocalScript čakajte na objekty, ktoré vytvára server, cez WaitForChild. Viac o príčinách.

Čo znamená "infinite yield possible" v Robloxe?

WaitForChild čaká viac než 5 sekúnd na podradený objekt, ktorý sa stále neobjavil, a čaká ďalej. Často ide o nesprávny názov alebo rodiča, alebo objekt nikto nevytvára. Viac o príčinách.

Prečo je okno Output prázdne alebo sa nezobrazuje?

Otvorte ho cez menu Window alebo kartu Script. Ak je otvorené, ale počas testu zostáva prázdne, zrušte filtre a pole vyhľadávania a potom skontrolujte, že skripty, ktoré majú niečo vypisovať, sa spúšťajú.

Má Roblox kontrolu skriptov na chyby?

Áno, je vstavaná v Studiu: Script Editor podčiarkuje problémy počas písania a okno Script Analysis ich ukazuje v zozname. Nájdu syntaktické chyby a chyby typov, ale nie chýbajúce objekty ani nesprávnu logiku hry: to je vidieť, len keď kód beží.

Treba obaľovať kód do pcall, aby neboli chyby?

Len volania, ktoré môžu zlyhať z dôvodov mimo vášho kódu, napríklad požiadavky na data store, HTTP alebo MarketplaceService. Ak obalíte do pcall chybu s nil, správa zmizne, ale funkcia aj tak nebude fungovať.

Ako si pozrieť chyby skriptov v živej hre?

Stlačte v hre F9 alebo napíšte /console do chatu a otvorí sa Developer Console. Ukazuje chyby z vášho zariadenia a zo servera, ak ste vlastník hry alebo člen skupiny, ktorý ju môže upravovať.

Zdroje a ďalšie čítanie

Ako bol kód overený: každý skript na tejto stránke prechádza prísnou kontrolou typov Luau s definíciami Roblox API (luau-lsp, 20. novembra 2026). Kontrola typov zachytí chyby v názvoch API a nesprávne typy, ale nie chyby v hernej logike, preto všetko pred publikovaním otestujte v Studiu.

Vyskúšajte RoCode vo svojej hre.

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