W skrócie
Otwórz okno Output przez menu Window albo kartę Script, kliknij Play i kliknij pierwszy czerwony błąd. Studio otworzy skrypt na linii, w której się wywalił. Komunikat mówi, co poszło nie tak: attempt to index nil with 'Humanoid' oznacza, że wartość tuż przed .Humanoid była nil. Napraw przyczynę, dla której tej wartości nie ma, i uruchom grę ponownie.
- Zaczynaj od pierwszego błędu na liście. Błędy niżej to często tylko jego skutki.
- Częste błędy w trakcie gry sprowadzają się do trzech przyczyn: wartość jest
nil, nazwa jest napisana z błędem albo jeszcze się nie wczytała, albo kod wykonuje się po złej stronie (serwer czy klient). - Jeśli w ogóle nie ma błędu, zwykle kod po prostu się nie uruchomił. Sprawdź typ skryptu, gdzie leży w Explorerze, jego właściwość
Enabledi czy event, na który czeka, w ogóle się odpala. - Żeby dowiedzieć się, ile naprawdę wynosi wartość w danej linii, wypisz ją przez print z etykietą albo postaw na tej linii breakpoint.
Na tej stronie
Jak otworzyć Output i przeczytać błąd
Okno Output to miejsce, w którym Roblox zgłasza błędy skryptów, ostrzeżenia silnika i wszystko, co wypisuje twój kod. Nie zawsze jest otwarte, więc otwórz je przed testem. Jeśli jeszcze nigdy nie uruchamiałeś skryptu, poradnik skryptowania dla początkujących zaczyna od otwarcia Output i wypisania pierwszej linii ze skryptu.
- Otwórz Output przez menu Window w Studio albo przyciskiem na karcie Script.
- Wyczyść stare komunikaty przez Ctrl+K (⌘K na Macu), żeby widzieć tylko ten test.
- Kliknij Play (F5) i zrób to, co psuje grę.
- Znajdź pierwszą czerwoną linię. Błędy są czerwone. Ostrzeżenia, na przykład
Infinite yield possible, są pomarańczowe.
Błąd w trakcie gry w Output wygląda tak. Zależnie od ustawień wyświetlania Output każda linia może mieć jeszcze czas, etykietę Client albo Server i nazwę skryptu.
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.CoinPadto miejsce skryptu w Explorerze: skrypt o nazwie CoinPad w ServerScriptService.:14to linia, w której wystąpił błąd.- Komunikat po numerze linii mówi, co poszło nie tak. Każdy jest omówiony na liście częstych błędów niżej.
- Stos między Stack Begin a Stack End pokazuje wywołania, które tu doprowadziły, zaczynając od ostatniego: linia 14 w funkcji
award, którą wywołano z linii 27.
Kliknij czerwony błąd, a Studio otworzy ten skrypt z kursorem na właściwej linii. W teście solo komunikaty serwera i twojego klienta idą do jednego Output: serwerowe są oznaczone na zielono, klienckie na niebiesko. Filtry na górze zawężają listę według typu komunikatu (Error, Warning), kontekstu (Client, Server) albo tekstu.
Kolejność debugowania, która pasuje do każdego skryptu
Zgadywanie i zmienianie kilku rzeczy naraz to wolny sposób naprawiania skryptu. Ta kolejność krok po kroku zawęża problem, niezależnie od tego, czy jest komunikat o błędzie.
- Powtórz problem. Wyczyść Output, kliknij Play i zrób dokładnie to, co psuje grę. Zapisz, czego oczekiwałeś i co stało się zamiast tego.
- Weź pierwszy błąd. Przeczytaj pierwszą nową czerwoną linię: ścieżkę skryptu, numer linii i komunikat. Jeśli błędu nie ma, przejdź do sekcji skrypty, które działają bez błędów.
- Przejdź do linii. Kliknij błąd. Przeczytaj całą linię i zapytaj siebie, która wartość w niej może być
nil, napisana z błędem albo mieć zły typ. - Sprawdź wartość, nie zgaduj. Dodaj
printtuż nad linią albo postaw na niej breakpoint i obejrzyj wartości w oknie Watch.typeof(x)powie, co masz: liczbę, string, Instance czy nil. - Idź po śladach wstecz. Jeśli wartość jest zła, znajdź, gdzie ją ustawiono:
FindFirstChild, który nic nie znalazł, funkcja, która nic nie zwróciła, argument, którego wywołujący kod nigdy nie przekazał. - Naprawiaj przyczynę, po jednej zmianie naraz. Popraw nazwę, poczekaj na obiekt albo przenieś kod na właściwą stronę, potem uruchom grę ponownie. Nie owijaj linii w
pcall, żeby zamilkła: tak bug się ukrywa, a nie naprawia. - Upewnij się. Powtórz krok 1. Błąd powinien zniknąć, a funkcja powinna robić to, czego oczekiwałeś. Jeśli chodzi o innych graczy, przetestuj jeszcze w trybie Server & Clients z dwoma klientami.
- Posprzątaj po sobie. Usuń albo wyłącz printy debugujące, żeby następny problem było łatwo zauważyć.
Częste błędy skryptów Roblox i jak je naprawić
Każdy komunikat jest zbudowany według jednego szablonu, do którego wstawiane są twoje nazwy, więc sam tekst błędu to najlepsza wskazówka. Nazwy w cudzysłowach niżej, na przykład 'Health' albo "Workspace", to przykłady.
| Co pisze Output | Co to znaczy | Jak zwykle naprawić |
|---|---|---|
attempt to index nil with 'Health' | Wartość przed .Health była nil. | Ustal, dlaczego jest nil, i sprawdzaj ją przez if przed użyciem. |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | WaitForChild czeka już 5 sekund, a obiekt się nie pojawił. | Popraw nazwę albo ścieżkę, upewnij się, że ktoś tworzy obiekt, albo dodaj limit czasu. |
Bridge is not a valid member of Workspace "Workspace" | Dziecka albo właściwości o tej dokładnej nazwie tam teraz nie ma. | Porównaj pisownię i wielkie litery z Explorerem. Na kliencie używaj WaitForChild. |
attempt to call a nil value | Wywołałeś coś, co nie jest funkcją. | Sprawdź nazwę funkcji i czy jest zadeklarowana nad wywołaniem. |
attempt to perform arithmetic (add) on Instance and number | Matematyka na czymś, co nie jest liczbą. | Używaj .Value w obiektach wartości i tonumber dla tekstu. |
attempt to concatenate string with nil | .. próbował skleić tekst z nil albo obiektem. | Używaj tostring(), .Name albo interpolacji stringów. |
Expected 'end' (to close 'function' at line 3), got <eof> | Błąd składni. Skrypt w ogóle się nie wykonuje. | Popraw to, co jest podkreślone na czerwono w Script Editor. |
Requested module experienced an error while loading | Sam ModuleScript wywalił się z błędem podczas wykonywania. | Napraw własny błąd modułu, jest pokazany trochę wyżej w Output. |
Argument 1 missing or nil | Funkcja Roblox dostała nil tam, gdzie potrzebuje wartości. | Prześledź, skąd ten argument miał przyjść. |
FireServer can only be called from the client | RemoteEvent wywołano z niewłaściwej strony. | Serwer używa FireClient, LocalScripty używają FireServer. |
Błąd data store 403, StudioAccessToApisNotAllowed | Studio nie ma pozwolenia na korzystanie z data store tej gry. | Opublikuj grę i włącz Studio Access to API Services. |
Każdy komunikat stąd, i nie tylko, ma własną stronę z każdą przyczyną, kodem, który ją wywołuje, i poprawką: zobacz komunikaty o błędach Roblox Studio, na przykład attempt to index nil, Infinite yield possible i is not a valid member of.
attempt to index nil with 'X'
Indeksowanie to czytanie czegoś przez kropkę albo nawiasy kwadratowe: part.Position, player.Character, list[1]. Ten błąd mówi, że to, co po lewej, było nil, a nazwa w cudzysłowie to to, co próbowałeś z niego przeczytać. Czyli w linii player.Character.Humanoid błąd attempt to index nil with 'Humanoid' oznacza, że player.Character był nil. Jeśli kluczem jest liczba, komunikat kończy się na with number.
Zwykłe przyczyny, dla których wartość była nil:
FindFirstChild,FindFirstChildOfClassalboFindFirstAncestornic nie znalazł, bo nazwa jest inna albo obiektu jeszcze nie ma.Players.LocalPlayerużyto w serwerowym Script. Istnieje tylko w LocalScript i w ModuleScript, które one podłączają przez require; na serwerze zawsze jest nil. Zamiast niego użyjplayer, którego dajePlayerAddedalbo handler RemoteEvent.player.Characterprzeczytano, zanim postać się zespawnowała, albo gdy się respawnuje.- Wpisu w tabeli nigdy nie ustawiono, na przykład
playerData[player]przed wczytaniem danych tego gracza, albo wywołana funkcja nic nie zwróciła.
Klasyczny przypadek to kill brick. Zepsuta wersja zakłada, że wszystko, co dotyka partu, należy do postaci, a dla wyrzuconych narzędzi, niezakotwiczonych partów i akcesoriów to nieprawda.
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- Zepsuta wersja:
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- Jeśli dotykający part nie jest częścią ciała postaci, FindFirstChild
-- zwraca nil, a Output pokazuje:
-- attempt to index nil with 'Health'
-- Poprawione: sprawdzamy każdy krok przed użyciem
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
Jeśli napiszesz hit.Parent.Humanoid, będzie inny komunikat, Humanoid is not a valid member of ..., omówiony niżej. FindFirstAncestorOfClass("Model") znajduje postać także wtedy, gdy dotykający part leży w akcesorium albo w narzędziu w ręce postaci, więc narzędzie w ręce, które zahaczyło o blok, też się liczy.
Wzorzec, który naprawia ten błąd: pobierz wartość, sprawdź ją i dopiero potem użyj. Na serwerze FindFirstChild ze sprawdzeniem if pasuje do rzeczy, których może po prostu nie być. W LocalScript używaj WaitForChild dla tego, co tworzy serwer, bo może się pojawić już po uruchomieniu skryptu.
Infinite yield possible on ...
WaitForChild("Name") pauzuje skrypt, dopóki nie pojawi się dziecko o tej nazwie. Jeśli czeka dłużej niż 5 sekund, a limitu czasu nie ustawiłeś, Roblox wypisuje to ostrzeżenie. To ostrzeżenie, a nie błąd: skrypt wciąż czeka i nic po tej linii się nie wykona, dopóki obiekt się nie pojawi, a to może nigdy nie nastąpić. Zwykłe przyczyny:
- Zła nazwa albo rodzic.
WaitForChild("leaderStats")nigdy nie znajdzie folderuleaderstats. - Nikt nie tworzy obiektu: serwerowy skrypt, który go robi, jest wyłączony, leży nie tam albo wcześniej wywalił się z błędem. Poszukaj wcześniejszego błędu w Output.
- LocalScript czeka na coś w ServerStorage albo ServerScriptService. Ich zawartość nigdy nie jest wysyłana graczom, więc czekanie się nie skończy.
- Czekasz na właściwość, a nie na dziecko. Częsty przykład to
player:WaitForChild("Character"):Characterto właściwość Player, a nie obiekt w nim. - Włączony jest streaming obiektów (
Workspace.StreamingEnabled), a part jest za daleko od gracza, więc jeszcze nie został wysłany do tego klienta.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Zepsuta wersja:
-- local character = player:WaitForChild("Character")
-- Character to właściwość Player, a nie dziecko, więc Output ostrzega:
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- Z limitem czasu WaitForChild zwraca nil, zamiast czekać w nieskończoność
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
-- Obsługujemy postać, która może już istnieć, a potem każdy respawn
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
Liczba jako drugi argument WaitForChild to limit czasu w sekundach. Wtedy skrypt może zgłosić problem przez warn i grzecznie się zatrzymać, zamiast wisieć po cichu.
X is not a valid member of Y
Przez kropkę odwołałeś się do dziecka albo właściwości, której w tej chwili nie ma, na przykład workspace.Bridge, gdy w Workspace nie ma partu o nazwie Bridge. W komunikacie najpierw jest to, o co prosiłeś, potem klasa i pełna ścieżka obiektu, w którym szukano. Sprawdź trzy rzeczy:
- Pisownia i wielkie litery dokładnie zgadzają się z Explorerem. Folder nazywa się
leaderstats, cały małymi literami, ahumanoidto nieHumanoid. - Nazwy właściwości są po amerykańsku.
part.Colourwywala się zColour is not a valid member of Part "Workspace.Part"; właściwość nazywa sięColor. - Obiekt się wczytał. Na kliencie obiekty, które tworzy serwer, mogą przyjść już po uruchomieniu LocalScript, więc tam używaj
WaitForChild.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Zepsuta wersja:
-- local coins = player.leaderstats.Coins
-- leaderstats tworzy serwer i do tego klienta może dotrzeć już po
-- uruchomieniu tego skryptu. Wtedy Output pokazuje:
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- serwer robi Coins jako IntValue
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
Tu potrzebny jest serwerowy skrypt, który tworzy leaderstats z IntValue o nazwie Coins, jak w poradniku o leaderboardzie.
attempt to call a nil value
Kod postawił nawiasy po czymś, co jest nil, więc nie było czego uruchomić. Zwykłe przyczyny:
- Nazwa funkcji jest napisana z błędem albo różni się wielkimi literami. Moduł deklaruje
Format.clock, a wywołujący kod piszeFormat.Clock(95). local functionjest wywoływana w linii nad jej deklaracją. W tej chwili nazwy jeszcze nie ma, więc przenieś deklarację wyżej.- ModuleScript nigdy nie dodaje funkcji do tabeli, którą zwraca.
Dwa podobne komunikaty wskazują na ten sam błąd. Wywołanie nieistniejącej metody tabeli przez dwukropek daje attempt to call missing method 'Kill' of table. Literówka w metodzie obiektu Roblox, na przykład part:Destory(), daje Destory is not a valid member of Part "Workspace.Part".
attempt to perform arithmetic (add) on ...
Luau próbował liczyć (add, sub, mul, div i tak dalej), a jedna ze stron nie była liczbą. Nazwy typów na końcu komunikatu podpowiadają, jaki masz przypadek:
on Instance and number: liczyłeś z obiektem wartości, a nie z jego liczbą.coins + 10powinno byćcoins.Value + 10.on nil and number: zmiennej albo wpisu w tabeli nigdy nie ustawiono. Daj jej wartość początkową albo pisz(x or 0)tam, gdzie brak wartości naprawdę oznacza zero.on string and number: tekst, który nie jest liczbą, często z TextBox. Przelicz go przeztonumber(text)i sprawdź, czy wynik nie jest nil. Tekst, w którym zapisana jest liczba, na przykład"5", przelicza się automatycznie.
Porównania psują się tak samo, z attempt to compare nil < number. Luau przepisuje a > b jako b < a, więc kolejność w komunikacie może być odwrotna niż w twoim kodzie.
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
-- Piszemy, dlaczego nic się nie stało, zamiast milczeć
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- Zepsuta wersja:
-- coins = coins + amount
-- coins to obiekt IntValue, a nie jego liczba, więc Output pokazuje:
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- Co minutę dajemy każdemu graczowi na serwerze trochę monet
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
Operator .. skleja tylko stringi i liczby. Sklejenie z nil się nie uda, z obiektem też nie: "Hi " .. player daje attempt to concatenate string with Instance. Użyj player.Name, owiń wartość w tostring() albo użyj interpolacji stringów z odwrotnymi apostrofami, print(`Coins: {coins}`), która wypisze nil, zamiast zatrzymać skrypt.
Expected 'end' i inne błędy składni
Komunikaty, które zaczynają się od Expected, to błędy składni: kod nie jest poprawnym Luau, Roblox nie może go skompilować i nie wykonuje się ani jedna linia tego skryptu, nawet te nad błędem. Script Editor podkreśla je na czerwono już podczas pisania, więc można je naprawić przed kliknięciem Play.
Expected 'end' (to close 'function' at line 3), got <eof>:function,if,foralbowhile, które zaczyna się w linii 3, nie ma swojegoend. Numer linii przed komunikatem często wskazuje koniec pliku, więc patrz na linię podaną w nawiasie.Expected 'then' when parsing if statement, got '=': pojedyncze=w warunku. Do porównania potrzebne jest==.Expected ')' (to close '(' at line 1), got 'local': nawiasu nigdy nie zamknięto.Expected <eof>, got 'end': jeden zbędnyend.
Przy równych wcięciach brakujący albo zbędny end łatwo zauważyć, bo każdy blok stoi na jednym poziomie z end, który go zamyka.
Requested module experienced an error while loading
Pierwsze require() ModuleScript uruchamia jego kod. Jeśli moduł w trakcie wykonania wywali się z błędem, skrypt, który go podłączył, dostaje ten komunikat. Prawdziwy problem to własny błąd modułu linię albo dwie wyżej w Output: napraw właśnie jego. Dwa podobne komunikaty:
Module code did not return exactly one value: moduł nie kończy się nareturn. ModuleScript musi zwracać jedną wartość, nie nil, zwykle swoją tabelę.Requested module was required recursively: dwa moduły podłączają się nawzajem. Przenieś wspólną część do trzeciego modułu, który podłączają oba.
local Format = {}
-- Zamienia liczbę sekund na minuty i sekundy: 95 staje się "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
-- Moduł musi na końcu zwrócić swoją tabelę. Bez tej linii każde
-- require tego modułu wywala się z: Module code did not return exactly one value
return Format
Skrypt podłącza go przez local Format = require(ReplicatedStorage:WaitForChild("Format")), a potem wywołuje Format.clock(95). Jeśli napiszesz Format.Clock(95), dostaniesz błąd attempt to call a nil value.
Argument 1 missing or nil
Funkcja Roblox dostała nil w argumencie, którego potrzebuje, a liczba mówi, w którym dokładnie. workspace:FindFirstChild(itemName) wywala się tak, gdy itemName jest nil. Bug rzadko siedzi w tej linii. Jest tam, skąd wartość miała przyjść: zmienna z literówką, atrybut, którego nigdy nie ustawiono, albo argument RemoteEvent, którego klient nie wysłał. Argumenty RemoteEvent przychodzą z urządzenia gracza, więc serwer musi je sprawdzać przed użyciem. Jak to robić, pokazuje poradnik o RemoteEvent.
FireServer can only be called from the client
RemoteEvent ma kierunek. LocalScript wywołuje FireServer, a serwerowy Script nasłuchuje przez OnServerEvent. Serwerowy Script wywołuje FireClient albo FireAllClients, a LocalScripty nasłuchują przez OnClientEvent. Wywołanie metody z niewłaściwej strony daje ten błąd albo lustrzany, FireClient can only be called from the server. Zwykle poprawka polega na przeniesieniu kodu do skryptu właściwego typu: zobacz Script, LocalScript i ModuleScript.
Błąd data store 403 w Studio
Wywołania data store w Studio wywalają się z kodem błędu 403 (StudioAccessToApisNotAllowed), dopóki na nie nie pozwolisz. Opublikuj grę, otwórz File, Experience Settings, Security, włącz Enable Studio Access to API Services i zapisz. Od tej chwili Studio używa tych samych data store co opublikowana gra, więc Roblox radzi robić to w osobnej kopii testowej, a nie w grze, w którą już ktoś gra. Owijaj każde wywołanie data store w pcall, bo takie wywołania mogą się wywalić z przyczyn spoza twojego kodu. Jak zapisywać bezpiecznie, omawia poradnik o DataStore.
Skrypt działa bez błędów, ale nic nie robi
Milczący skrypt zwykle w ogóle się nie uruchomił, wciąż na coś czeka albo uruchomił się po złej stronie. Zanim zmienisz kod, zrób jego pierwszą linią print(script:GetFullName(), "started") i uruchom grę. Jeśli ta linia nigdy nie pojawi się w Output, problem jest w tym, gdzie leży skrypt albo jak jest ustawiony, a nie w tym, co w nim napisano.
| Co sprawdzić | Co idzie nie tak | Jak naprawić |
|---|---|---|
| Typ i miejsce skryptu | LocalScript uruchamia się tylko wtedy, gdy włożysz go do StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack albo ReplicatedFirst (z kontenerów Starter uruchamia się jako kopia gracza). Jeśli włożysz go do Workspace, ServerScriptService albo ReplicatedStorage, nigdy się nie uruchomi. Script z domyślnym RunContext uruchamia się tylko w Workspace albo ServerScriptService. | Przenieś go albo użyj innego typu skryptu. Kod interfejsu i sterowania idzie do LocalScript, reguły gry idą do Script w ServerScriptService. |
| Enabled | Skrypt, który ma odznaczone Enabled, się nie uruchamia. | Zaznacz go i zaznacz Enabled w oknie Properties. |
| RunContext | RunContext w Script decyduje, gdzie się uruchamia. Legacy, wartość domyślna, uruchamia się na serwerze z Workspace albo ServerScriptService. Server uruchamia się na serwerze, Client uruchamia się na urządzeniu każdego gracza, na przykład z ReplicatedStorage. | Ustawiaj go świadomie. Dokumentacja Roblox radzi wkładać Client Script do ReplicatedStorage albo ReplicatedFirst, a LocalScript do kontenerów Starter. |
| Event się nie odpala | Touched odpala się tylko od fizycznego ruchu, potrzebuje, żeby co najmniej jeden z dwóch partów nie był zakotwiczony, i potrzebuje CanTouch w obu. PlayerAdded nie odpala się dla graczy, którzy byli już na serwerze, gdy podłączyłeś się do eventu. Handler RemoteEvent się nie uruchomi, jeśli druga strona nigdy nie wywołuje eventu. | Postaw print w handlerze, żeby na pewno wiedzieć, czy się uruchamia, a potem napraw to, co ma go wywoływać. |
| Kod po pętli albo czekaniu | Linie pod pętlą while true do nigdy się nie wykonują, bo pętla się nie kończy. Linie pod WaitForChild, który nigdy nie znajduje obiektu, też się nie wykonują. | Podłączaj eventy przed pętlą albo uruchamiaj pętlę przez task.spawn. Dawaj czekaniom limit czasu. |
| Sprawdzenie, które cicho wychodzi | Strażnik w rodzaju if not coins then return end po cichu zatrzymuje funkcję, gdy obiektu nie ma. | Dodaj warn ze szczegółami przed return. |
| Filtry Output | Output można filtrować według typu komunikatu, według Client albo Server i według tekstu. Zapomniany filtr może ukrywać błąd, którego szukasz. | Zresetuj filtry i wyczyść pole wyszukiwania. |
| Widzisz tylko ty | Zmianę zrobił LocalScript, więc widzi ją tylko ten gracz. Serwer i inni gracze jej nie widzą. | Rób zmianę na serwerze. Zobacz, gdzie wykonują się skrypty. |
Na przypadek z PlayerAdded nabiera się wiele osób, bo w teście Studio wchodzisz prawie od razu po starcie serwera. Jeśli coś nad linią z Connect czeka, na przykład WaitForChild, task.wait albo require modułu, który czeka, możesz wejść, zanim pojawi się połączenie. Obsługuj zarówno nowych, jak i już obecnych graczy:
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- Dla graczy, którzy już tu byli, gdy wykonała się linia wyżej,
-- PlayerAdded w tym skrypcie się nie odpali, więc obsługujemy ich teraz
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Narzędzia do debugowania w Roblox Studio
print i warn z kontekstem
print pisze linię w Output, a warn pisze ostrzeżenie. To najszybszy sposób, żeby odpowiedzieć na pytania „czy to w ogóle się uruchomiło?” i „ile wynosi ta wartość?”. Goły print(x) trudno potem znaleźć, więc dodawaj etykietę i ważne szczegóły. typeof(x) pokazuje, czym jest wartość: liczbą, stringiem, Instance czy nil, a GetFullName() pokazuje, o który dokładnie obiekt chodzi.
local Players = game:GetService("Players")
local DEBUG = true -- ustaw false, gdy skończysz
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 i ClassName pokazują, czym wartość jest naprawdę
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Pole wyszukiwania w Output filtruje po tekście, więc stała etykieta w rodzaju [ShopServer] pozwala pokazać tylko linie tego systemu. Jeśli chcesz wiedzieć, jak kod doszedł do linii, debug.traceback() zwraca bieżący stos wywołań jako string.
Breakpointy i wykonywanie krok po kroku
Breakpoint pauzuje grę na linii, żeby można było obejrzeć wszystko w tej chwili. W Script Editor kliknij margines na prawo od numeru linii (pojawi się czerwone kółko), potem uruchom playtest. Gdy wykonanie dojdzie do tej linii, gra się zatrzyma, a żółta strzałka pokaże następną linię. Dalej po kodzie przesuwają cię przyciski wykonywania krok po kroku:
- Step Over (F10) wykonuje bieżącą linię i zatrzymuje się na następnej.
- Step Into (F11) wchodzi do funkcji wywoływanej w tej linii.
- Step Out (Shift+F11) dokańcza bieżącą funkcję i zatrzymuje się w kodzie, który ją wywołał.
- Resume Scripts kontynuuje do następnego breakpointu.
Prawy klik na marginesie daje jeszcze dwa przydatne rodzaje. Warunkowy breakpoint pauzuje tylko wtedy, gdy wyrażenie w rodzaju amount < 0 jest prawdziwe. Logpoint wypisuje komunikat w Output bez pauzy, więc możesz zalogować wartość, nie zmieniając skryptu.
Watch i Call Stack
Gdy gra jest zapauzowana, najedź kursorem na zmienną w Script Editor, żeby zobaczyć jej wartość. Okno Watch na karcie Variables pokazuje wszystkie zmienne w zasięgu, a na karcie My Watches możesz wpisać dowolne wyrażenie, na przykład coins.Value + amount, i zobaczyć jego bieżącą wartość. Okno Call Stack pokazuje, która funkcja którą wywołała, żeby dojść do zapauzowanej linii. Oba otwierają się przez kartę Script albo menu Window.
Script Analysis i tryb ścisły
Script Editor podkreśla problemy już podczas pisania, a okno Script Analysis, które otwiera przycisk Analysis na karcie Script, pokazuje błędy i ostrzeżenia ze wszystkich skryptów. Wyłapuje błędy składni i nieznane nazwy przed kliknięciem Play. Jeśli pierwszą linią skryptu będzie --!strict, włączy się ścisłe sprawdzanie typów Luau, które zgłasza też literówki we właściwościach, złe typy argumentów i wartości, które mogą być nil. Ale uruchomionej gry nie widzi: part, którego nie ma w Workspace, pokaże tylko Output.
Command bar
Command bar (na karcie Script albo Ctrl+9, ⌘9 na Macu) od razu wykonuje Luau. Gdy gra działa, to szybki sposób na zadanie pytania: print(workspace:FindFirstChild("Bridge")) powie, czy taki part istnieje, a print(#game:GetService("Players"):GetPlayers()) policzy graczy. W trybie edycji kod z command bar naprawdę zmienia twoją grę, więc uważaj na wszystko, co przesuwa albo usuwa obiekty.
Developer Console w opublikowanej grze
Output w Studio działa tylko w Studio. W opublikowanej grze naciśnij F9 albo wpisz /console na czacie, żeby otworzyć Developer Console. Jej Log pokazuje wyjście z twojego urządzenia, a wyjście serwera, jeśli jesteś właścicielem gry albo członkiem grupy z prawem do jej edycji.
Wbudowany Assistant w Roblox też może pomóc z pojedynczym komunikatem: własny poradnik Roblox radzi wkleić błąd z Output i poprosić Assistant o jego omówienie. Jeśli Assistant przestał odpowiadać albo pisze, że trafiłeś na limit, zobacz limity i błędy Assistant.
Naprawianie błędów z RoCode
RoCode to niezależny agent AI do Roblox Studio: opisujesz problem na czacie w przeglądarce, a plugin do Studio czyta i edytuje grę, którą masz otwartą. Przy błędach może przejąć kroki czytania z kolejności wyżej, opierając się na playteście, który już uruchomiłeś.
Kliknąłem Play i kliknięcie przycisku sklepu nic nie robi. Output pokazuje attempt to index nil with 'Coins'. Znajdź przyczynę i napraw.
- Czyta Output w Studio swoim narzędziem Check Output, łącznie z liniami Server i Client z twojego ostatniego playtestu, nawet po tym, jak kliknąłeś Stop
- Otwiera skrypt z błędu przez Read Script i czyta kod wokół tej linii, a przez Search Scripts może znaleźć, gdzie miała powstawać brakująca wartość
- Robi punktową poprawkę przez Edit Script, dokładne wyszukaj i zamień w tym skrypcie, potem uruchamia Check Script, który kompiluje skrypt wewnątrz Studio (nie sprawdza typów, nie uruchamia lintera i nie wykonuje twojego kodu)
- Wysyła zmiany do Studio paczkami, a każda paczka to punkt cofania w historii Studio
Kliknij Play jeszcze raz i kliknij przycisk sklepu, żeby samemu upewnić się co do poprawki: z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.15 lub nowszym jego testowa postać może klikać przyciski na ekranie, ale sprawdza tylko to, co sam postanowił przetestować, a sprawdzenie kompilacji nie powie, czy logika gry jest poprawna. Czytanie błędów jest częścią każdej budowy: cykl budowy, sprawdzania i testu dla całej gry powtarza to sprawdzenie po każdym systemie. Jak RoCode łączy się ze Studio.
Najczęstsze pytania
Dlaczego skrypt w Roblox nie działa, choć nie ma błędów?
Zwykle skrypt w ogóle się nie uruchomił (zły typ skryptu albo kontener, albo wyłączone Enabled), wciąż na coś czeka albo event, którego nasłuchuje, nigdy się nie odpala. Print w pierwszej linii pokaże, która to opcja. Zobacz listę kontrolną wyżej.
Co znaczy "attempt to index nil" w Roblox?
Wartość przed kropką albo dwukropkiem była nil, więc Roblox nie mógł zajrzeć do środka. W linii player.Character.Humanoid błąd attempt to index nil with 'Humanoid' oznacza, że player.Character był nil: nie ma go albo jeszcze się nie wczytał. Sprawdzaj wartość przez if przed użyciem, a w LocalScript czekaj na obiekty tworzone przez serwer przez WaitForChild. Więcej o przyczynach.
Co znaczy "infinite yield possible" w Roblox?
WaitForChild czeka dłużej niż 5 sekund na dziecko, które się nie pojawiło, i dalej czeka. Często zła nazwa albo rodzic, albo nikt nie tworzy obiektu. Więcej o przyczynach.
Dlaczego okno Output jest puste albo się nie pokazuje?
Otwórz je przez menu Window albo kartę Script. Jeśli jest otwarte, ale w trakcie testu zostaje puste, zresetuj filtry i pole wyszukiwania, a potem sprawdź, czy skrypty, które powinny coś wypisywać, się uruchamiają.
Czy Roblox ma sprawdzanie skryptów pod kątem błędów?
Tak, jest wbudowane w Studio: Script Editor podkreśla problemy podczas pisania, a okno Script Analysis pokazuje je listą. Znajdują błędy składni i typów, ale nie brakujące obiekty ani złą logikę gry: to widać tylko wtedy, gdy kod działa.
Czy trzeba owijać kod w pcall, żeby nie było błędów?
Tylko wywołania, które mogą się wywalić z przyczyn spoza twojego kodu, na przykład zapytania do data store, HTTP albo MarketplaceService. Jeśli owiniesz w pcall błąd z nil, komunikat zniknie, a funkcja i tak nie zadziała.
Jak zobaczyć błędy skryptów w opublikowanej grze?
Naciśnij F9 w grze albo wpisz /console na czacie, żeby otworzyć Developer Console. Pokazuje błędy z twojego urządzenia, a z serwera, jeśli jesteś właścicielem gry albo członkiem grupy, który może ją edytować.
Źródła i dalsza lektura
- Roblox Creator Docs: Output (po angielsku). gdzie jest Output, jego filtry i ustawienia wyświetlania
- Roblox Creator Docs: Debugging (po angielsku). breakpointy, wykonywanie krok po kroku, Watch, Call Stack, command bar i Developer Console
- Roblox Creator Docs: Script Editor (po angielsku). okno Script Analysis
- Roblox Creator Docs: Studio interface (po angielsku). gdzie otwierają się Output i command bar
- Roblox Creator Docs: Script types and locations (po angielsku). gdzie uruchamia się każdy typ skryptu i RunContext
- Roblox Creator Docs: Studio testing modes (po angielsku). Play, widoki Client i Server oraz testy Server & Clients
- Roblox Engine API: Instance (po angielsku). WaitForChild, jego limit czasu i ostrzeżenie po 5 sekundach
- Roblox Creator Docs: Reuse code (po angielsku). ModuleScript i rekurencyjne require
- Roblox Creator Docs: Data store error codes and limits (po angielsku). błąd 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (po angielsku). włączanie dostępu ze Studio i osobna kopia testowa
- Roblox Engine API: BasePart (po angielsku). kiedy odpala się Touched i CanTouch
- Roblox Creator Docs: Type checking (po angielsku). tryb ścisły
- Roblox Creator Docs: Developer Console (po angielsku). kto widzi wyjście serwera w opublikowanej grze
- Roblox Creator Docs: Build your first game with Assistant (po angielsku). wklejanie błędu z Output, żeby Assistant go omówił
Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.