Röviden
Nyisd meg az Output ablakot a Window menüből vagy a Script fülről, nyomd meg a Play gombot, és kattints az első piros hibára. A Studio megnyitja a scriptet azon a soron, ahol leállt. Az üzenet megmondja, mi romlott el: az attempt to index nil with 'Humanoid' azt jelenti, hogy a közvetlenül a .Humanoid előtti érték nil volt. Javítsd ki azt az okot, amiért ez az érték hiányzik, és indítsd újra a játékot.
- A lista első hibájával kezdd. Az alatta lévő hibák gyakran csak a következményei.
- A játék közbeni gyakori hibák három okra vezethetők vissza: az érték
nil, egy név el van írva vagy még nem töltődött be, vagy a kód a rossz oldalon fut (szerver vagy kliens). - Ha egyáltalán nincs hiba, a kód általában el sem indult. Ellenőrizd a script típusát, hol van az Explorerben, az
Enabledtulajdonságát, és hogy egyáltalán elsül-e az esemény, amelyre vár. - Ha meg szeretnéd tudni, mennyi valójában egy érték a kérdéses soron, írasd ki print-tel egy címkével, vagy tegyél arra a sorra egy töréspontot.
Ezen az oldalon
Hogyan nyisd meg az Outputot és olvasd el a hibát
Az Output ablak az a hely, ahol a Roblox jelzi a scripthibákat, a motor figyelmeztetéseit, és mindent, amit a kódod kiír. Nincs mindig nyitva, ezért a teszt előtt nyisd meg. Ha még soha nem futtattál scriptet, a scriptelés kezdőknek útmutató azzal kezdődik, hogy megnyitja az Outputot, és kiírja az első sort egy scriptből.
- Nyisd meg az Output ablakot a Studio Window menüjéből, vagy a Script fül gombjával.
- Töröld a régi üzeneteket a Ctrl+K (Macen ⌘K) billentyűkkel, hogy csak ezt a tesztet lásd.
- Nyomd meg a Play gombot (F5), és csináld azt, ami elrontja a játékot.
- Keresd meg az első piros sort. A hibák pirosak. A figyelmeztetések, például az
Infinite yield possible, narancssárgán jelennek meg.
Egy játék közbeni hiba így néz ki az Outputban. Az Output megjelenítési beállításaitól függően minden sorban szerepelhet még az idő, egy Client vagy Server címke és a script neve.
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
- A
ServerScriptService.CoinPada script helye az Explorerben: egy CoinPad nevű script a ServerScriptService-ben. - A
:14az a sor, amelyen a hiba történt. - A sorszám utáni üzenet megmondja, mi romlott el. Mindegyiket végigvesszük a lenti gyakori hibák listájában.
- A Stack Begin és Stack End közötti verem az ide vezető hívásokat mutatja, a legutóbbitól kezdve: a 14. sor az
awardfüggvényben, amelyet a 27. sorból hívtak meg.
Kattints a piros hibára, és a Studio megnyitja ezt a scriptet a kurzorral a megfelelő soron. Egyszemélyes tesztben a szerver és a kliensed üzenetei ugyanabba az Outputba kerülnek: a szerveroldaliak zöld, a kliensoldaliak kék jelölést kapnak. A felül lévő szűrők üzenettípus (Error, Warning), kontextus (Client, Server) vagy szöveg szerint szűkítik a listát.
Hibakeresési lépéssor, amely bármelyik scripthez illik
A találgatás és több dolog egyszerre változtatása lassú módja egy script megjavításának. Ez a lépéssor lépésről lépésre szűkíti a problémát, akár van hibaüzenet, akár nincs.
- Idézd elő újra a problémát. Töröld az Outputot, nyomd meg a Play gombot, és csináld pontosan azt, ami elrontja a játékot. Írd fel, mire számítottál, és mi történt helyette.
- Vedd az első hibát. Olvasd el az első új piros sort: a script elérési útját, a sorszámot és az üzenetet. Ha nincs hiba, lépj tovább a hiba nélkül futó scriptek részhez.
- Ugorj a sorra. Kattints a hibára. Olvasd el a teljes sort, és kérdezd meg magadtól, melyik érték lehet benne
nil, elírva, vagy rossz típusú. - Ellenőrizd az értéket, ne találgass. Tegyél egy
print-et közvetlenül a sor fölé, vagy tegyél rá egy töréspontot, és nézd meg az értékeket a Watch ablakban. Atypeof(x)megmondja, mi van nálad: szám, string, Instance vagy nil. - Kövesd visszafelé a nyomot. Ha az érték rossz, keresd meg, hol állították be: egy
FindFirstChild, amely nem talált semmit, egy függvény, amely nem adott vissza semmit, egy argumentum, amelyet a hívó kód sosem adott át. - Az okot javítsd, egyszerre egy változtatással. Javítsd a nevet, várd meg az objektumot, vagy vidd át a kódot a megfelelő oldalra, aztán indítsd újra a játékot. Ne csomagold a sort
pcall-ba, hogy elhallgasson: így a hiba elbújik, nem javul ki. - Győződj meg róla. Ismételd meg az 1. lépést. A hibának el kell tűnnie, a funkciónak pedig azt kell csinálnia, amit vártál. Ha más játékosokról van szó, tesztelj Server & Clients módban is két klienssel.
- Takaríts el magad után. Töröld vagy kapcsold ki a hibakereső print-eket, hogy a következő problémát könnyű legyen észrevenni.
Gyakori Roblox scripthibák és a javításuk
Minden üzenet ugyanarra a mintára épül, amelybe a te neveid kerülnek, ezért maga a hibaszöveg a legjobb nyom. Az alábbi idézőjeles nevek, például a 'Health' vagy a "Workspace", példák.
| Mit ír az Output | Mit jelent | Hogyan javítod általában |
|---|---|---|
attempt to index nil with 'Health' | A .Health előtti érték nil volt. | Derítsd ki, miért nil, és használat előtt ellenőrizd egy if-fel. |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | A WaitForChild már 5 másodperce vár, és az objektum nem jelent meg. | Javítsd a nevet vagy az elérési utat, győződj meg róla, hogy valaki létrehozza az objektumot, vagy adj meg időkorlátot. |
Bridge is not a valid member of Workspace "Workspace" | Ilyen pontos nevű gyermekobjektum vagy tulajdonság most nincs ott. | Vesd össze a helyesírást és a nagybetűket az Explorerrel. A kliensen használd a WaitForChild-ot. |
attempt to call a nil value | Olyasmit hívtál meg, ami nem függvény. | Ellenőrizd a függvény nevét, és hogy a hívás fölött van-e deklarálva. |
attempt to perform arithmetic (add) on Instance and number | Matematika valamivel, ami nem szám. | Value objektumoknál használd a .Value-t, szövegnél a tonumber-t. |
attempt to concatenate string with nil | A .. szöveget próbált összefűzni nil-lel vagy egy objektummal. | Használd a tostring()-ot, a .Name-et vagy a stringinterpolációt. |
Expected 'end' (to close 'function' at line 3), got <eof> | Szintaktikai hiba. A script egyáltalán nem fut. | Javítsd ki, amit a Script Editor pirossal aláhúz. |
Requested module experienced an error while loading | Maga a ModuleScript hibával leállt futás közben. | Javítsd a modul saját hibáját, amely kicsit feljebb látszik az Outputban. |
Argument 1 missing or nil | Egy Roblox függvény nil-t kapott ott, ahol értékre van szüksége. | Kövesd vissza, honnan kellett volna jönnie ennek az argumentumnak. |
FireServer can only be called from the client | A RemoteEventet a rossz oldalról hívták meg. | A szerver a FireClient-et használja, a LocalScriptek a FireServer-t. |
403-as adattár-hiba, StudioAccessToApisNotAllowed | A Studio nem használhatja ennek a játéknak az adattárait. | Publikáld a játékot, és kapcsold be a Studio Access to API Services beállítást. |
Az itt szereplő és más üzeneteknek is saját oldaluk van minden okkal, az azt kiváltó kóddal és a javítással: lásd a Roblox Studio hibaüzenetek oldalt, például az attempt to index nil, az Infinite yield possible és az is not a valid member of oldalakat.
attempt to index nil with 'X'
Az indexelés valaminek a kiolvasása ponttal vagy szögletes zárójellel: part.Position, player.Character, list[1]. Ez a hiba azt mondja, hogy ami balra van, az nil volt, az idézőjeles név pedig az, amit belőle próbáltál kiolvasni. Vagyis a player.Character.Humanoid soron az attempt to index nil with 'Humanoid' hiba azt jelenti, hogy a player.Character nil volt. Ha a kulcs szám, az üzenet with number-re végződik.
A szokásos okok, amiért az érték nil volt:
- A
FindFirstChild, aFindFirstChildOfClassvagy aFindFirstAncestornem talált semmit, mert a név más, vagy az objektum még nincs meg. - A
Players.LocalPlayer-t egy szerveroldali Scriptben használták. Csak LocalScriptben és az általuk require-ral betöltött ModuleScriptekben létezik; a szerveren mindig nil. Helyette azt aplayer-t használd, amelyet aPlayerAddedvagy a RemoteEvent kezelője ad. - A
player.Character-t azelőtt olvasták ki, hogy a karakter megjelent volna, vagy miközben újraéled. - A tábla bejegyzését sosem állították be, például a
playerData[player]-t azelőtt, hogy a játékos adatai betöltődtek volna, vagy a meghívott függvény nem adott vissza semmit.
A klasszikus eset az ölő blokk. A hibás változat azt feltételezi, hogy minden, ami a partot megérinti, egy karakterhez tartozik, az eldobott eszközökre, a nem rögzített partokra és a kiegészítőkre viszont ez nem igaz.
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- Hibás változat:
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- Ha a hozzáérő part nem egy karakter testrésze, a FindFirstChild
-- nil-t ad vissza, és az Output ezt mutatja:
-- attempt to index nil with 'Health'
-- Javítva: használat előtt minden lépést ellenőrzünk
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
Ha hit.Parent.Humanoid-ot írsz, más üzenetet kapsz, a Humanoid is not a valid member of ... üzenetet, amelyet lentebb veszünk végig. A FindFirstAncestorOfClass("Model") akkor is megtalálja a karaktert, ha a hozzáérő part egy kiegészítőben vagy a karakter kezében lévő eszközben van, így a kézben lévő eszköz, amely a blokkhoz ér, szintén számít.
A minta, amely ezt a hibát javítja: szerezd meg az értéket, ellenőrizd, és csak utána használd. A szerveren a FindFirstChild egy if ellenőrzéssel megfelel annak, ami simán hiányozhat is. A LocalScriptben a szerver által létrehozott dolgokra a WaitForChild-ot használd, mert azok a script indulása után is megjelenhetnek.
Infinite yield possible on ...
A WaitForChild("Name") szünetelteti a scriptet, amíg meg nem jelenik egy ilyen nevű gyermekobjektum. Ha 5 másodpercnél tovább vár, és nem adtál meg időkorlátot, a Roblox kiírja ezt a figyelmeztetést. Ez figyelmeztetés, nem hiba: a script még mindig vár, és a sor után semmi sem fut le, amíg az objektum meg nem jelenik, ami talán soha nem történik meg. A szokásos okok:
- Rossz név vagy szülő. A
WaitForChild("leaderStats")soha nem találja meg aleaderstatsmappát. - Senki sem hozza létre az objektumot: a szerverscript, amely elkészíti, ki van kapcsolva, rossz helyen van, vagy korábban hibával leállt. Keress egy korábbi hibát az Outputban.
- Egy LocalScript valamire vár a ServerStorage-ban vagy a ServerScriptService-ben. Ezek tartalmát a játékosok soha nem kapják meg, így a várakozás nem ér véget.
- Egy tulajdonságra vársz, nem gyermekobjektumra. Gyakori példa a
player:WaitForChild("Character"): aCharactera Player tulajdonsága, nem egy benne lévő objektum. - Be van kapcsolva az instance streaming (
Workspace.StreamingEnabled), és a part túl messze van a játékostól, ezért még nem küldték el ennek a kliensnek.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Hibás változat:
-- local character = player:WaitForChild("Character")
-- A Character a Player tulajdonsága, nem gyermekobjektum, ezért az Output figyelmeztet:
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- Időkorláttal a WaitForChild nil-t ad vissza, és nem vár örökké
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
-- Kezeljük a karaktert, amely talán már létezik, aztán minden újraéledést
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
A WaitForChild második argumentumaként megadott szám az időkorlát másodpercben. Így a script warn-nal jelezheti a problémát, és rendezetten leállhat, ahelyett hogy némán függene.
X is not a valid member of Y
Ponttal hivatkoztál egy gyermekobjektumra vagy tulajdonságra, amely abban a pillanatban nem létezik, például workspace.Bridge, amikor a Workspace-ben nincs Bridge nevű part. Az üzenetben először az áll, amit kértél, aztán annak az objektumnak az osztálya és teljes elérési útja, amelyben kerested. Három dolgot ellenőrizz:
- A helyesírás és a nagybetűk pontosan egyeznek az Explorerrel. A mappa neve
leaderstats, csupa kisbetűvel, ahumanoidpedig nem azonos aHumanoid-dal. - A tulajdonságnevek amerikai angol írásmóddal szerepelnek. A
part.Colourezzel áll le:Colour is not a valid member of Part "Workspace.Part"; a tulajdonság neveColor. - Az objektum betöltődött. A kliensen a szerver által létrehozott objektumok a LocalScript indulása után is megérkezhetnek, ezért ott a
WaitForChild-ot használd.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Hibás változat:
-- local coins = player.leaderstats.Coins
-- A leaderstatsot a szerver hozza létre, és ehhez a klienshez csak azután érhet el,
-- hogy ez a script elindult. Ekkor az Output ezt mutatja:
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- a szerver a Coinst IntValue-ként hozza létre
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
Ehhez egy szerverscript kell, amely létrehozza a leaderstats mappát egy Coins nevű IntValue-val, mint a ranglista útmutatóban.
attempt to call a nil value
A kód zárójelet tett valami után, ami nil, így nem volt mit futtatni. A szokásos okok:
- A függvény neve el van írva, vagy a nagybetűkben tér el. A modul
Format.clock-ot deklarál, a hívó kód pedigFormat.Clock(95)-öt ír. - Egy
local function-t a deklarációja fölötti sorban hívnak meg. Abban a pillanatban a név még nem létezik, ezért vidd feljebb a deklarációt. - A ModuleScript sosem teszi bele a függvényt abba a táblába, amelyet visszaad.
Két hasonló üzenet ugyanerre a hibára utal. Egy nem létező táblametódus kettősponttal való meghívása ezt adja: attempt to call missing method 'Kill' of table. Egy Roblox objektum metódusának elírása, például a part:Destory(), ezt adja: Destory is not a valid member of Part "Workspace.Part".
attempt to perform arithmetic (add) on ...
A Luau számolni próbált (add, sub, mul, div és így tovább), de az egyik oldal nem szám volt. Az üzenet végén lévő típusnevek megmutatják, melyik esetről van szó:
on Instance and number: egy value objektummal számoltál, nem a számával. Acoins + 10helyesencoins.Value + 10.on nil and number: a változót vagy a tábla bejegyzését sosem állították be. Adj neki kezdőértéket, vagy írd(x or 0)alakban ott, ahol az érték hiánya tényleg nullát jelent.on string and number: olyan szöveg, amely nem szám, gyakran egy TextBoxból. Alakítsd át atonumber(text)segítségével, és ellenőrizd, hogy az eredmény nem nil. Az a szöveg, amelyben szám áll, például az"5", automatikusan átalakul.
Az összehasonlítások ugyanígy romlanak el, ezzel: attempt to compare nil < number. A Luau az a > b-t b < a alakra írja át, ezért az üzenetben a sorrend fordított lehet a kódodhoz képest.
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
-- Kiírjuk, miért nem történt semmi, ahelyett hogy hallgatnánk
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- Hibás változat:
-- coins = coins + amount
-- A coins egy IntValue objektum, nem a száma, ezért az Output ezt mutatja:
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- Percenként adunk egy kis érmét minden játékosnak a szerveren
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
A .. operátor csak stringeket és számokat fűz össze. Nil-lel nem lehet összefűzni, és objektummal sem: a "Hi " .. player ezt adja: attempt to concatenate string with Instance. Használd a player.Name-et, csomagold az értéket tostring()-ba, vagy használj backtickes stringinterpolációt, print(`Coins: {coins}`), amely nil-t ír ki, és nem állítja le a scriptet.
Expected 'end' és más szintaktikai hibák
Az Expected szóval kezdődő üzenetek szintaktikai hibák: a kód nem érvényes Luau, a Roblox nem tudja lefordítani, és ennek a scriptnek egyetlen sora sem fut le, még a hiba fölöttiek sem. A Script Editor már gépelés közben pirossal aláhúzza őket, így a Play megnyomása előtt kijavíthatod őket.
Expected 'end' (to close 'function' at line 3), got <eof>: a 3. sorban kezdődőfunction,if,forvagywhileblokknak nincs meg a sajátend-je. Az üzenet előtti sorszám gyakran a fájl végére mutat, ezért a zárójelben megnevezett sort nézd.Expected 'then' when parsing if statement, got '=': egyetlen=a feltételben. Összehasonlításhoz==kell.Expected ')' (to close '(' at line 1), got 'local': a zárójelet sosem zárták be.Expected <eof>, got 'end': egy fölöslegesend.
Egyenletes behúzással a hiányzó vagy fölösleges end könnyen észrevehető, mert minden blokk egy szintre kerül azzal az end-del, amely lezárja.
Requested module experienced an error while loading
Egy ModuleScript első require()-ja lefuttatja a kódját. Ha a modul futás közben hibával leáll, az őt betöltő script ezt az üzenetet kapja. A valódi probléma a modul saját hibája egy-két sorral feljebb az Outputban: azt javítsd. Két hasonló üzenet:
Module code did not return exactly one value: a modul nemreturn-nel végződik. A ModuleScriptnek egy értéket kell visszaadnia, nem nil-t, általában a saját tábláját.Requested module was required recursively: két modul egymást tölti be. A közös részt tedd egy harmadik modulba, amelyet mindkettő betölt.
local Format = {}
-- A másodpercek számát percekre és másodpercekre alakítja: a 95-ből "1:35" lesz
function Format.clock(seconds: number): string
local whole = math.max(0, math.floor(seconds))
return string.format("%d:%02d", whole // 60, whole % 60)
end
-- A modulnak a végén vissza kell adnia a tábláját. E sor nélkül ennek a modulnak
-- minden require-ja ezzel áll le: Module code did not return exactly one value
return Format
Egy script a local Format = require(ReplicatedStorage:WaitForChild("Format")) segítségével tölti be, aztán meghívja a Format.clock(95)-öt. Ha Format.Clock(95)-öt írsz, attempt to call a nil value hibát kapsz.
Argument 1 missing or nil
Egy Roblox függvény nil-t kapott egy olyan argumentumban, amelyre szüksége van, a szám pedig megmondja, melyikben. A workspace:FindFirstChild(itemName) így áll le, ha az itemName nil. A hiba ritkán van ezen a soron. Ott van, ahonnan az értéknek jönnie kellett volna: egy elírt változó, egy sosem beállított attribútum, vagy egy RemoteEvent argumentum, amelyet a kliens nem küldött el. A RemoteEvent argumentumai a játékos eszközéről érkeznek, ezért a szervernek használat előtt ellenőriznie kell őket. Hogy hogyan, azt a RemoteEvent útmutató mutatja meg.
FireServer can only be called from the client
A RemoteEventnek iránya van. A LocalScript a FireServer-t hívja, a szerveroldali Script pedig az OnServerEvent-tel figyel. A szerveroldali Script a FireClient-et vagy a FireAllClients-et hívja, a LocalScriptek pedig az OnClientEvent-tel figyelnek. A metódus rossz oldalról való hívása ezt a hibát adja, vagy a tükörképét: FireClient can only be called from the server. A javítás általában az, hogy a kódot a megfelelő típusú scriptbe viszed át: lásd a Script, LocalScript és ModuleScript útmutatót.
403-as adattár-hiba a Studióban
Az adattár-hívások a Studióban 403-as hibakóddal (StudioAccessToApisNotAllowed) állnak le, amíg nem engedélyezed őket. Publikáld a place-t, nyisd meg a File, Experience Settings, Security részt, kapcsold be az Enable Studio Access to API Services beállítást, és mentsd. Ezután a Studio ugyanazokat az adattárakat használja, mint az élő játék, ezért a Roblox azt tanácsolja, hogy ezt egy külön tesztmásolatban csináld, ne abban a játékban, amellyel már játszanak. Minden adattár-hívást csomagolj pcall-ba, mert az ilyen hívások a kódodon kívüli okokból is meghiúsulhatnak. A biztonságos mentést a DataStore útmutató veszi végig.
A script hiba nélkül fut, de semmit sem csinál
Egy néma script általában el sem indult, még mindig vár valamire, vagy a rossz oldalon indult el. Mielőtt a kódot módosítanád, tedd az első sorává a print(script:GetFullName(), "started")-et, és indítsd el a játékot. Ha ez a sor nem jelenik meg az Outputban, a probléma az, hol van a script vagy hogyan van beállítva, nem az, ami benne áll.
| Mit ellenőrizz | Mi romlik el | Hogyan javítsd |
|---|---|---|
| A script típusa és helye | A LocalScript csak akkor indul el, ha a StarterPlayerScriptsbe, StarterCharacterScriptsbe, StarterGuiba, StarterPackbe vagy ReplicatedFirstbe teszed (a Starter tárolókból a játékos másolataként indul). Ha a Workspace-be, a ServerScriptService-be vagy a ReplicatedStorage-ba teszed, soha nem indul el. Az alapértelmezett RunContextű Script csak a Workspace-ben vagy a ServerScriptService-ben indul el. | Helyezd át, vagy használj másik scripttípust. A felület és az irányítás kódja LocalScriptbe kerül, a játékszabályok pedig a ServerScriptService-ben lévő Scriptbe. |
| Enabled | Az a script, amelynél nincs bejelölve az Enabled, nem indul el. | Jelöld ki, és jelöld be az Enabled beállítást a Properties ablakban. |
| RunContext | A Script RunContext tulajdonsága dönti el, hol indul el. A Legacy, az alapérték, a szerveren indul a Workspace-ből vagy a ServerScriptService-ből. A Server a szerveren indul, a Client minden játékos eszközén, például a ReplicatedStorage-ból. | Tudatosan állítsd be. A Roblox dokumentációja azt tanácsolja, hogy a Client Scriptet a ReplicatedStorage-ba vagy a ReplicatedFirstbe tedd, a LocalScriptet pedig a Starter tárolókba. |
| Az esemény nem sül el | A Touched csak fizikai mozgásra sül el, a két part közül legalább az egyiknek nem rögzítettnek kell lennie, és mindkettőnél kell a CanTouch. A PlayerAdded nem sül el azokra a játékosokra, akik már a szerveren voltak, amikor az eseményhez kapcsolódtál. A RemoteEvent kezelője nem indul el, ha a másik oldal soha nem hívja meg az eseményt. | Tegyél egy print-et a kezelőbe, hogy biztosan megtudd, elindul-e, aztán javítsd azt, aminek ki kellene váltania. |
| Kód egy ciklus vagy várakozás után | A while true do ciklus alatti sorok soha nem futnak le, mert a ciklus nem ér véget. Egy olyan WaitForChild alatti sorok sem futnak le, amely soha nem találja meg az objektumot. | Az eseményeket a ciklus előtt kösd be, vagy indítsd a ciklust a task.spawn-nal. Adj időkorlátot a várakozásoknak. |
| Egy ellenőrzés, amely csendben kilép | Egy olyan védelem, mint az if not coins then return end, némán leállítja a függvényt, ha az objektum hiányzik. | Adj hozzá egy részletes warn-t a return elé. |
| Output szűrők | Az Output szűrhető üzenettípus, Client vagy Server és szöveg szerint. Egy elfelejtett szűrő elrejtheti a keresett hibát. | Állítsd vissza a szűrőket, és ürítsd a keresőmezőt. |
| Csak te látod | A változtatást egy LocalScript végezte, ezért csak az a játékos látja. A szerver és a többi játékos nem. | A változtatást a szerveren végezd. Lásd: hol futnak a scriptek. |
A PlayerAdded esetébe sokan belefutnak, mert a Studio tesztben szinte közvetlenül a szerver indulása után lépsz be. Ha a Connect sor fölött valami vár, például egy WaitForChild, egy task.wait vagy egy váró modul require-ja, előbb beléphetsz, mint ahogy a kapcsolat létrejön. Kezeld az új és a már belépett játékosokat is:
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- Azokra a játékosokra, akik már itt voltak, amikor a fenti sor lefutott,
-- a PlayerAdded ebben a scriptben nem sül el, ezért most kezeljük őket
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Hibakereső eszközök a Roblox Studióban
print és warn kontextussal
A print egy sort ír az Outputba, a warn pedig figyelmeztetést. Ez a leggyorsabb módja annak, hogy választ kapj az olyan kérdésekre, mint "ez egyáltalán lefutott?" és "mennyi ez az érték?". Egy csupasz print(x)-et később nehéz megtalálni, ezért adj hozzá címkét és a fontos részleteket. A typeof(x) megmutatja, milyen az érték: szám, string, Instance vagy nil, a GetFullName() pedig azt, pontosan melyik objektumról van szó.
local Players = game:GetService("Players")
local DEBUG = true -- állítsd false-ra, ha végeztél
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")
-- A typeof és a ClassName megmutatja, mi az érték valójában
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Az Output keresőmezője szöveg szerint szűr, így egy állandó címke, például a [ShopServer], lehetővé teszi, hogy csak ennek a rendszernek a sorait mutasd. Ha tudni szeretnéd, hogyan jutott el a kód egy sorig, a debug.traceback() stringként adja vissza az aktuális hívási vermet.
Töréspontok és lépésenkénti végrehajtás
A töréspont szünetelteti a játékot egy soron, hogy abban a pillanatban mindent megnézhess. A Script Editorban kattints a sorszámtól jobbra lévő margóra (megjelenik egy piros kör), aztán indíts playtestet. Amikor a végrehajtás eléri ezt a sort, a játék szünetel, egy sárga nyíl pedig a következő sort mutatja. A kódban a lépésenkénti végrehajtás gombjaival haladhatsz tovább:
- A Step Over (F10) végrehajtja az aktuális sort, és a következőn megáll.
- A Step Into (F11) belép abba a függvénybe, amelyet ezen a soron hívnak meg.
- A Step Out (Shift+F11) végigfuttatja az aktuális függvényt, és az őt meghívó kódban áll meg.
- A Resume Scripts a következő töréspontig folytatja.
A margóra jobb gombbal kattintva még két hasznos fajtát kapsz. A feltételes töréspont csak akkor szüneteltet, ha egy kifejezés, például az amount < 0, igaz. A Logpoint szünet nélkül ír ki egy üzenetet az Outputba, így egy értéket naplózhatsz a script módosítása nélkül.
Watch és Call Stack
Amíg a játék szünetel, vidd az egeret egy változó fölé a Script Editorban, hogy lásd az értékét. A Watch ablak Variables füle a hatókörben lévő összes változót mutatja, a My Watches fülön pedig bármilyen kifejezést beírhatsz, például coins.Value + amount, és láthatod az aktuális értékét. A Call Stack ablak azt mutatja, melyik függvény melyiket hívta meg, hogy eljusson a szüneteltetett sorig. Mindkettő a Script fülről vagy a Window menüből nyílik.
Script Analysis és szigorú mód
A Script Editor már gépelés közben aláhúzza a problémákat, a Script Analysis ablak pedig, amely a Script fül Analysis gombjával nyílik, az összes script hibáit és figyelmeztetéseit mutatja. A Play megnyomása előtt elkapja a szintaktikai hibákat és az ismeretlen neveket. Ha egy script első sorába a --!strict-et írod, bekapcsol a Luau szigorú típusellenőrzése, amely a tulajdonságok elírását, a rossz típusú argumentumokat és a nil-lé válható értékeket is jelzi. A futó játékot viszont nem látja: azt a partot, amely nincs meg a Workspace-ben, csak az Output mutatja meg.
Command bar
A Command bar (a Script fülön, vagy Ctrl+9, Macen ⌘9) azonnal végrehajtja a Luau kódot. Amíg a játék fut, ez gyors módja egy kérdés feltevésének: a print(workspace:FindFirstChild("Bridge")) megmondja, van-e ilyen part, a print(#game:GetService("Players"):GetPlayers()) pedig megszámolja a játékosokat. Szerkesztő módban a command bar kódja ténylegesen megváltoztatja a place-edet, ezért légy óvatos mindennel, ami objektumokat mozgat vagy töröl.
Developer Console az élő játékban
A Studio Outputja csak a Studióban működik. Az élő játékban nyomd meg az F9-et, vagy írd be a chatbe a /console-t, hogy megnyisd a Developer Console-t. A Log része a saját eszközöd kimenetét mutatja, a szerver kimenetét pedig akkor, ha te vagy a játék tulajdonosa, vagy egy olyan csoport tagja, amely szerkesztheti.
A Roblox beépített Assistantja is segíthet egy-egy üzenettel: a Roblox saját útmutatója azt tanácsolja, hogy illeszd be a hibát az Outputból, és kérd meg az Assistantot, hogy elemezze. Ha az Assistant nem válaszol, vagy azt írja, hogy elérted a korlátot, nézd meg az Assistant korlátai és hibái oldalt.
Hibajavítás RoCode-dal
A RoCode egy független AI-ügynök a Roblox Studióhoz: a webes chatben leírod a problémát, a Studio plugin pedig kiolvassa és szerkeszti a nálad nyitott place-t. Hibáknál átvállalhatja a fenti lépéssor olvasási lépéseit, a már lefuttatott playtestedre támaszkodva.
Megnyomtam a Play gombot, és a bolt gombjára kattintás nem csinál semmit. Az Output ezt mutatja: attempt to index nil with 'Coins'. Keresd meg az okát, és javítsd ki.
- Kiolvassa a Studio Outputját a Check Output eszközével, beleértve a legutóbbi playtested Server és Client sorait, akkor is, ha már megnyomtad a Stop gombot
- A Read Script segítségével megnyitja a hibában szereplő scriptet, és elolvassa a sor körüli kódot, a Search Scripts segítségével pedig megkeresheti, hol kellett volna létrejönnie a hiányzó értéknek
- Célzott javítást végez az Edit Script segítségével, pontos keresés és csere a scriptben, aztán lefuttatja a Check Script-et, amely a Studióban lefordítja a scriptet (nem végez típusellenőrzést, nem futtat lintert, és nem hajtja végre a kódodat)
- A változtatásokat csomagokban küldi a Studióba, és minden csomag egy visszavonási pont a Studio előzményeiben
Nyomd meg újra a Play gombot, és kattints a bolt gombjára, hogy magad győződj meg a javításról: a 3.9-es vagy újabb pluginnal a RoCode rövid playtestet indíthat és kiolvashatja a hibákat, a 3.9.15-ös vagy újabb pluginnal pedig a tesztkaraktere gombokat nyomhat meg a képernyőn, de csak azt ellenőrzi, amit maga döntött el tesztelni, a fordítási ellenőrzés pedig nem mondja meg, helyes-e a játék logikája. A hibák kiolvasása minden építés része: az egész játék építési, ellenőrzési és tesztelési ciklusa minden rendszer után megismétli ezt az ellenőrzést. Hogyan kapcsolódik a RoCode a Studióhoz.
Gyakori kérdések
Miért nem működik a Roblox scriptem, ha nincs hiba?
Általában a script el sem indult (rossz scripttípus vagy tároló, vagy ki van kapcsolva az Enabled), még mindig vár valamire, vagy az esemény, amelyre figyel, soha nem sül el. Egy print az első sorban megmutatja, melyik eset áll fenn. Lásd a fenti ellenőrzőlistát.
Mit jelent az "attempt to index nil" Robloxban?
A pont vagy kettőspont előtti érték nil volt, ezért a Roblox nem tudott belenézni. A player.Character.Humanoid soron az attempt to index nil with 'Humanoid' hiba azt jelenti, hogy a player.Character nil volt: nem létezik, vagy még nem töltődött be. Használat előtt ellenőrizd az értéket egy if-fel, a LocalScriptben pedig a szerver által létrehozott objektumokat a WaitForChild-dal várd meg. Bővebben az okokról.
Mit jelent az "infinite yield possible" Robloxban?
A WaitForChild több mint 5 másodperce vár egy gyermekobjektumra, amely nem jelent meg, és tovább vár. Gyakran rossz a név vagy a szülő, vagy senki sem hozza létre az objektumot. Bővebben az okokról.
Miért üres az Output ablak, vagy miért nem jelenik meg?
Nyisd meg a Window menüből vagy a Script fülről. Ha nyitva van, de teszt közben üres marad, állítsd vissza a szűrőket és a keresőmezőt, aztán ellenőrizd, hogy elindulnak-e azok a scriptek, amelyeknek ki kellene írniuk valamit.
Van a Robloxban scriptellenőrző a hibákhoz?
Igen, be van építve a Studióba: a Script Editor gépelés közben aláhúzza a problémákat, a Script Analysis ablak pedig listában mutatja őket. Ezek megtalálják a szintaktikai és a típushibákat, de a hiányzó objektumokat és a hibás játéklogikát nem: ez csak akkor látszik, amikor a kód fut.
Csomagoljam a kódot pcall-ba, hogy ne legyenek hibák?
Csak azokat a hívásokat, amelyek a kódodon kívüli okokból meghiúsulhatnak, például az adattár-, HTTP- vagy MarketplaceService-kéréseket. Ha egy nil hibát pcall-ba csomagolsz, az üzenet eltűnik, a funkció viszont így sem fog működni.
Hogyan nézhetem meg a scripthibákat az élő játékban?
Nyomd meg az F9-et a játékban, vagy írd be a chatbe a /console-t, hogy megnyisd a Developer Console-t. A saját eszközöd hibáit mutatja, a szerverét pedig akkor, ha te vagy a játék tulajdonosa, vagy egy olyan csoport tagja, amely szerkesztheti.
Források és további olvasnivaló
- Roblox Creator Docs: Output (angolul). hol található az Output, a szűrői és a megjelenítési beállításai
- Roblox Creator Docs: Debugging (angolul). töréspontok, lépésenkénti végrehajtás, Watch, Call Stack, command bar és Developer Console
- Roblox Creator Docs: Script Editor (angolul). a Script Analysis ablak
- Roblox Creator Docs: Studio interface (angolul). hol nyílik az Output és a command bar
- Roblox Creator Docs: Script types and locations (angolul). hol indul el az egyes scripttípus, és a RunContext
- Roblox Creator Docs: Studio testing modes (angolul). Play, Client és Server nézetek, és Server & Clients tesztek
- Roblox Engine API: Instance (angolul). WaitForChild, az időkorlátja és a figyelmeztetés 5 másodperc után
- Roblox Creator Docs: Reuse code (angolul). ModuleScript és rekurzív require-ok
- Roblox Creator Docs: Data store error codes and limits (angolul). 403-as hiba, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (angolul). a Studióból való hozzáférés bekapcsolása és a külön tesztmásolat
- Roblox Engine API: BasePart (angolul). mikor sül el a Touched, és a CanTouch
- Roblox Creator Docs: Type checking (angolul). szigorú mód
- Roblox Creator Docs: Developer Console (angolul). ki látja a szerver kimenetét az élő játékban
- Roblox Creator Docs: Build your first game with Assistant (angolul). a hiba beillesztése az Outputból, hogy az Assistant elemezze
Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.