Poradnik · Debugowanie

Jak naprawić błędy skryptów w Roblox Studio

Gdy skrypt w Roblox się psuje, Studio zwykle pisze gdzie i dlaczego w oknie Output. W tym poradniku omówimy, jak czytać ten komunikat, co znaczą częste błędy i jak naprawić każdy, co sprawdzać, gdy skrypt w ogóle nie działa i nie ma błędów, oraz kolejność kroków, która znajduje przyczynę zamiast zgadywać.

Zaktualizowano 20 listopada 202618 min czytaniaAutor:

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ść Enabled i 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
  1. Czytamy Output
  2. Kolejność debugowania
  3. Częste błędy
  4. Błędów brak, nic się nie dzieje
  5. Narzędzia debugowania
  6. Z RoCode
  7. Najczęstsze pytania
  8. Źródła i dalsza lektura

Jak otworzyć Output i przeczytać błąd

IlustracjaPrzykład z kill brickiem z poradnika, przyspieszony: zepsuta linia daje błąd, a po Stop, poprawce i nowym playteście part spada bez błędu.

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.

  1. Otwórz Output przez menu Window w Studio albo przyciskiem na karcie Script.
  2. Wyczyść stare komunikaty przez Ctrl+K (⌘K na Macu), żeby widzieć tylko ten test.
  3. Kliknij Play (F5) i zrób to, co psuje grę.
  4. 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.

Output (przykład)
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 to miejsce skryptu w Explorerze: skrypt o nazwie CoinPad w ServerScriptService.
  • :14 to 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.

  1. 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.
  2. 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.
  3. 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.
  4. Sprawdź wartość, nie zgaduj. Dodaj print tuż nad linią albo postaw na niej breakpoint i obejrzyj wartości w oknie Watch. typeof(x) powie, co masz: liczbę, string, Instance czy nil.
  5. 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ł.
  6. 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.
  7. 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.
  8. 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.

Częste błędy w Output. Wybierz komunikat, żeby otworzyć pełne wyjaśnienie.
Co pisze OutputCo to znaczyJak 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 valueWywoł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 numberMatematyka 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 loadingSam 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 nilFunkcja Roblox dostała nil tam, gdzie potrzebuje wartości.Prześledź, skąd ten argument miał przyjść.
FireServer can only be called from the clientRemoteEvent wywołano z niewłaściwej strony.Serwer używa FireClient, LocalScripty używają FireServer.
Błąd data store 403, StudioAccessToApisNotAllowedStudio 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, FindFirstChildOfClass albo FindFirstAncestor nic nie znalazł, bo nazwa jest inna albo obiektu jeszcze nie ma.
  • Players.LocalPlayer uż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żyj player, którego daje PlayerAdded albo handler RemoteEvent.
  • player.Character przeczytano, 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.

Script w Part w Workspace o nazwie KillBrick
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 folderu leaderstats.
  • 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"): Character to 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.
LocalScript w StarterPlayerScripts o nazwie DeathMessage
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, a humanoid to nie Humanoid.
  • Nazwy właściwości są po amerykańsku. part.Colour wywala się z Colour 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.
LocalScript w StarterPlayerScripts o nazwie CoinsWatcher
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 pisze Format.Clock(95).
  • local function jest 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 + 10 powinno 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 przez tonumber(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.

Script w ServerScriptService o nazwie 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
		-- 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, for albo while, które zaczyna się w linii 3, nie ma swojego end. 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ędny end.

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ę na return. 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.
ModuleScript w ReplicatedStorage o nazwie Format
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.

Dlaczego skrypt może nic nie robić bez błędu
Co sprawdzićCo idzie nie takJak naprawić
Typ i miejsce skryptuLocalScript 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.
EnabledSkrypt, który ma odznaczone Enabled, się nie uruchamia.Zaznacz go i zaznacz Enabled w oknie Properties.
RunContextRunContext 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 odpalaTouched 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 czekaniuLinie 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 wychodziStraż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 OutputOutput 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 tyZmianę 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:

Script w ServerScriptService o nazwie Welcome
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 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.

Script w ServerScriptService o nazwie ShopDebug
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ś.

Ty piszesz

Kliknąłem Play i kliknięcie przycisku sklepu nic nie robi. Output pokazuje attempt to index nil with 'Coins'. Znajdź przyczynę i napraw.

RoCode robi
  • 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

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ą.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.