Ръководство · Дебъгване

Как да поправиш грешки в скриптове в Roblox Studio

Когато скрипт в Roblox се счупи, Studio обикновено пише къде и защо в прозореца Output. В това ръководство ще видим как да четеш това съобщение, какво значат честите грешки и как да поправиш всяка, какво да провериш, ако скриптът изобщо не работи и няма грешки, и ред на действия, който намира причината, вместо да гадае.

Обновено 20 ноември 2026 г.19 мин четенеАвтор:

Накратко

Отвори прозореца Output от менюто Window или раздела Script, натисни Play и кликни върху първата червена грешка. Studio ще отвори скрипта на реда, където се е счупил. Съобщението казва какво се е объркало: attempt to index nil with 'Humanoid' значи, че стойността точно преди .Humanoid е била nil. Поправи причината, поради която тази стойност липсва, и пусни играта отново.

  • Започвай от първата грешка в списъка. Грешките под нея често са просто нейни последствия.
  • Честите грешки по време на игра се свеждат до три причини: стойността е nil, името е написано грешно или още не е заредено, или кодът се изпълнява от грешната страна (сървър или клиент).
  • Ако изобщо няма грешка, обикновено кодът просто не се е пуснал. Провери типа на скрипта, къде е в Explorer, свойството му Enabled и дали изобщо се задейства събитието, което чака.
  • За да разбереш на какво наистина е равна стойността на дадения ред, изведи я с print и етикет или сложи брейкпойнт на този ред.
На тази страница
  1. Четем Output
  2. Ред за дебъгване
  3. Чести грешки
  4. Няма грешки, нищо не става
  5. Инструменти за дебъгване
  6. С RoCode
  7. Често задавани въпроси
  8. Източници и какво да прочетеш

Как да отвориш Output и да прочетеш грешката

ИлюстрацияПримерът с убиващия блок от ръководството, ускорен: счупеният ред дава грешка, а след Stop, поправка и нов плейтест партът пада без грешка.

Прозорецът Output е мястото, където Roblox съобщава за грешки в скриптовете, предупреждения на енджина и всичко, което извежда кодът ти. Не винаги е отворен, затова го отвори преди теста. Ако още никога не си пускал скрипт, ръководството за скриптиране за начинаещи започва с отваряне на Output и извеждане на първия ред от скрипт.

  1. Отвори Output от менюто Window в Studio или с бутона в раздела Script.
  2. Изчисти старите съобщения с Ctrl+K (⌘K на Mac), за да виждаш само този тест.
  3. Натисни Play (F5) и направи това, което чупи играта.
  4. Намери първия червен ред. Грешките са червени. Предупрежденията, например Infinite yield possible, се показват в оранжево.

Грешка по време на игра в Output изглежда така. В зависимост от настройките за показване на Output всеки ред може да има още час, етикет Client или Server и името на скрипта.

Output (пример)
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 е мястото на скрипта в Explorer: скрипт с име CoinPad в ServerScriptService.
  • :14 е редът, на който е станала грешката.
  • Съобщението след номера на реда казва какво се е объркало. Всяко е разгледано в списъка с чести грешки по-долу.
  • Стекът между Stack Begin и Stack End показва извикванията, които са довели дотук, като започва от последното: ред 14 във функцията award, която е извикана от ред 27.

Кликни върху червената грешка и Studio ще отвори този скрипт с курсора на нужния ред. При соло тест съобщенията от сървъра и от твоя клиент отиват в един Output: сървърните са отбелязани в зелено, клиентските в синьо. Филтрите отгоре стесняват списъка по тип съобщение (Error, Warning), по контекст (Client, Server) или по текст.

Ред за дебъгване, който става за всеки скрипт

Да гадаеш и да сменяш няколко неща наведнъж е бавен начин да поправиш скрипт. Този ред стъпка по стъпка стеснява проблема, независимо дали има съобщение за грешка, или не.

  1. Повтори проблема. Изчисти Output, натисни Play и направи точно това, което чупи играта. Запиши какво си очаквал и какво е станало вместо това.
  2. Вземи първата грешка. Прочети първия нов червен ред: пътя на скрипта, номера на реда и съобщението. Ако няма грешка, премини към раздела скриптове, които работят без грешки.
  3. Отиди на реда. Кликни върху грешката. Прочети целия ред и се запитай коя стойност в него може да е nil, написана грешно или от грешен тип.
  4. Провери стойността, не гадай. Добави print точно над реда или сложи на него брейкпойнт и виж стойностите в прозореца Watch. typeof(x) ще ти каже какво имаш: число, низ, Instance или nil.
  5. Върви назад по следата. Ако стойността е грешна, намери къде е зададена: FindFirstChild, който не е намерил нищо, функция, която не е върнала нищо, аргумент, който извикващият код така и не е подал.
  6. Поправяй причината, по една промяна наведнъж. Поправи името, изчакай обекта или премести кода на правилната страна, после пусни играта отново. Не обвивай реда в pcall, за да замлъкне: така бъгът се скрива, а не се поправя.
  7. Увери се. Повтори стъпка 1. Грешката трябва да изчезне, а функцията трябва да прави това, което си очаквал. Ако става дума за други играчи, тествай още в режим Server & Clients с два клиента.
  8. Почисти след себе си. Изтрий или изключи дебъг print-овете, за да е лесно да забележиш следващия проблем.

Чести грешки в скриптове в Roblox и как да ги поправиш

Всяко съобщение се гради по един шаблон, в който се слагат твоите имена, затова самият текст на грешката е най-добрата подсказка. Имената в кавички по-долу, например 'Health' или "Workspace", са примери.

Чести грешки в Output. Избери съобщение, за да отвориш пълното обяснение.
Какво пише OutputКакво значиКак обикновено се поправя
attempt to index nil with 'Health'Стойността преди .Health е била nil.Разбери защо е nil и я проверявай с if, преди да я използваш.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild чака вече 5 секунди, а обектът така и не се е появил.Поправи името или пътя, увери се, че някой създава обекта, или добави таймаут.
Bridge is not a valid member of Workspace "Workspace"Дъщерен обект или свойство с точно това име в момента го няма там.Сравни изписването и главните букви с Explorer. На клиента използвай WaitForChild.
attempt to call a nil valueИзвикал си нещо, което не е функция.Провери името на функцията и че е декларирана над извикването.
attempt to perform arithmetic (add) on Instance and numberМатематика с нещо, което не е число.Използвай .Value на value обектите и tonumber за текст.
attempt to concatenate string with nil.. се е опитал да слепи текст с nil или обект.Използвай tostring(), .Name или интерполация на низове.
Expected 'end' (to close 'function' at line 3), got <eof>Синтактична грешка. Скриптът изобщо не се изпълнява.Поправи това, което е подчертано в червено в Script Editor.
Requested module experienced an error while loadingСамият ModuleScript е гръмнал с грешка, докато се е изпълнявал.Поправи собствената грешка на модула, тя е показана малко по-горе в Output.
Argument 1 missing or nilФункция на Roblox е получила nil там, където ѝ трябва стойност.Проследи откъде е трябвало да дойде този аргумент.
FireServer can only be called from the clientRemoteEvent е извикан от грешната страна.Сървърът използва FireClient, LocalScript използват FireServer.
Грешка на дата стор 403, StudioAccessToApisNotAllowedНа Studio не е позволено да използва дата сторовете на тази игра.Публикувай играта и включи Studio Access to API Services.

Всяко съобщение оттук, и не само, има своя страница с всяка причина, кода, който я предизвиква, и поправката: виж съобщенията за грешки в Roblox Studio, например attempt to index nil, Infinite yield possible и is not a valid member of.

attempt to index nil with 'X'

Индексирането е четене на нещо през точка или квадратни скоби: part.Position, player.Character, list[1]. Тази грешка казва, че това, което е отляво, е било nil, а името в кавички е това, което си се опитал да прочетеш от него. Значи на реда player.Character.Humanoid грешката attempt to index nil with 'Humanoid' означава, че player.Character е бил nil. Ако ключът е число, съобщението завършва с with number.

Обичайните причини стойността да е nil:

  • FindFirstChild, FindFirstChildOfClass или FindFirstAncestor не е намерил нищо, защото името е различно или обектът още го няма.
  • Players.LocalPlayer е използван в сървърен Script. Той съществува само в LocalScript и в ModuleScript, които те зареждат с require; на сървъра винаги е nil. Използвай вместо него player, който дава PlayerAdded или обработчикът на RemoteEvent.
  • player.Character е прочетен, преди персонажът да се е появил, или докато се появява отново.
  • Записът в таблицата така и не е зададен, например playerData[player], преди да са се заредили данните на този играч, или извиканата функция не е върнала нищо.

Класическият случай е убиващият блок. Счупената версия смята, че всичко, което докосва парта, принадлежи на персонаж, а за изхвърлени инструменти, незакотвени партове и аксесоари това не е така.

Script в Part в Workspace с име KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Счупена версия:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Ако докосналият парт не е част от тялото на персонаж, FindFirstChild
	-- връща nil и Output показва:
	--   attempt to index nil with 'Health'

	-- Поправено: проверяваме всяка стъпка, преди да я използваме
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Ако напишеш hit.Parent.Humanoid, ще има друго съобщение, Humanoid is not a valid member of ..., то е разгледано по-долу. FindFirstAncestorOfClass("Model") намира персонажа и когато докосналият парт е в аксесоар или в инструмент в ръката на персонажа, така че инструмент в ръката, който закачи блока, също се брои.

Шаблонът, който поправя тази грешка: вземи стойността, провери я и чак тогава я използвай. На сървъра FindFirstChild с проверка if става за неща, които спокойно може да ги няма. В LocalScript използвай WaitForChild за това, което създава сървърът, защото то може да се появи чак след старта на скрипта.

Infinite yield possible on ...

WaitForChild("Name") слага скрипта на пауза, докато не се появи дъщерен обект с това име. Ако чака повече от 5 секунди, а не си задал таймаут, Roblox извежда това предупреждение. Това е предупреждение, а не грешка: скриптът все още чака и нищо след този ред няма да се изпълни, докато обектът не се появи, а това може никога да не стане. Обичайните причини:

  • Грешно име или родител. WaitForChild("leaderStats") никога няма да намери папката leaderstats.
  • Никой не създава обекта: сървърният скрипт, който го прави, е изключен, не е на правилното място или е гръмнал с грешка по-рано. Потърси по-ранна грешка в Output.
  • LocalScript чака нещо в ServerStorage или ServerScriptService. Съдържанието им никога не се изпраща на играчите, затова чакането няма да свърши.
  • Чакаш свойство, а не дъщерен обект. Чест пример е player:WaitForChild("Character"): Character е свойство на Player, а не обект в него.
  • Включен е стриймингът на обекти (Workspace.StreamingEnabled) и партът е твърде далеч от играча, затова още не е изпратен на този клиент.
LocalScript в StarterPlayerScripts с име DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Счупена версия:
--   local character = player:WaitForChild("Character")
-- Character е свойство на Player, а не дъщерен обект, затова Output предупреждава:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- С таймаут WaitForChild връща nil, вместо да чака вечно
	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

-- Обработваме персонажа, който може вече да съществува, а после всяко ново появяване
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Числото като втори аргумент на WaitForChild е таймаут в секунди. Тогава скриптът може да съобщи за проблема с warn и да спре спокойно, вместо да виси мълчаливо.

X is not a valid member of Y

През точка си се обърнал към дъщерен обект или свойство, което в този момент го няма, например workspace.Bridge, когато в Workspace няма парт с име Bridge. В съобщението първо е това, което си поискал, после класът и пълният път на обекта, в който е търсено. Провери три неща:

  • Изписването и главните букви съвпадат точно с Explorer. Папката се казва leaderstats, цялата с малки букви, а humanoid не е Humanoid.
  • Имената на свойствата се пишат по американски. part.Colour гърми с Colour is not a valid member of Part "Workspace.Part"; свойството се казва Color.
  • Обектът се е заредил. На клиента обектите, които създава сървърът, може да пристигнат чак след старта на LocalScript, затова там използвай WaitForChild.
LocalScript в StarterPlayerScripts с име CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Счупена версия:
--   local coins = player.leaderstats.Coins
-- leaderstats се създава от сървъра и може да стигне до този клиент чак след
-- старта на този скрипт. Тогава Output показва:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- сървърът прави Coins като IntValue

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

Тук трябва сървърен скрипт, който създава leaderstats с IntValue на име Coins, както в ръководството за класация.

attempt to call a nil value

Кодът е сложил скоби след нещо, което е nil, затова нямаше какво да се пусне. Обичайните причини:

  • Името на функцията е написано грешно или се различава по главните букви. Модулът декларира Format.clock, а извикващият код пише Format.Clock(95).
  • local function се извиква на ред над декларацията си. В този момент името още го няма, затова премести декларацията по-горе.
  • ModuleScript така и не добавя функцията в таблицата, която връща.

Две подобни съобщения сочат същата грешка. Извикване на несъществуващ метод на таблица през двоеточие дава attempt to call missing method 'Kill' of table. Печатна грешка в метод на обект на Roblox, например part:Destory(), дава Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau се е опитал да смята (add, sub, mul, div и така нататък), а едната страна не е била число. Имената на типовете в края на съобщението подсказват какъв е твоят случай:

  • on Instance and number: смятал си с value обект, а не с числото му. coins + 10 трябва да е coins.Value + 10.
  • on nil and number: променливата или записът в таблицата така и не са зададени. Дай ѝ начална стойност или пиши (x or 0) там, където липсата на стойност наистина значи нула.
  • on string and number: текст, който не е число, често от TextBox. Преобразувай го с tonumber(text) и провери, че резултатът не е nil. Текст, в който е записано число, например "5", се преобразува автоматично.

Сравненията се чупят по същия начин, с attempt to compare nil < number. Luau пренаписва a > b като b < a, затова редът в съобщението може да е обратен на кода ти.

Script в ServerScriptService с име 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
		-- Пишем защо нищо не е станало, вместо да мълчим
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Счупена версия:
	--   coins = coins + amount
	-- coins е обект IntValue, а не неговото число, затова Output показва:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Всяка минута даваме на всеки играч на сървъра малко монети
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

Операторът .. слепва само низове и числа. Не може да слепиш с nil, нито с обект: "Hi " .. player дава attempt to concatenate string with Instance. Използвай player.Name, обвий стойността в tostring() или използвай интерполация на низове с обратни кавички, print(`Coins: {coins}`), която ще изведе nil, вместо да спре скрипта.

Expected 'end' и други синтактични грешки

Съобщенията, които започват с Expected, са синтактични грешки: кодът не е правилен Luau, Roblox не може да го компилира и не се изпълнява нито един ред от този скрипт, дори тези над грешката. Script Editor ги подчертава в червено още докато пишеш, така че можеш да ги поправиш, преди да натиснеш Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: function, if, for или while, който започва на ред 3, няма свой end. Номерът на реда преди съобщението често сочи края на файла, затова гледай реда, посочен в скобите.
  • Expected 'then' when parsing if statement, got '=': единично = в условието. За сравнение трябва ==.
  • Expected ')' (to close '(' at line 1), got 'local': скобата така и не е затворена.
  • Expected <eof>, got 'end': един излишен end.

С равни отстъпи липсващ или излишен end се забелязва лесно, защото всеки блок стои на едно ниво с end, който го затваря.

Requested module experienced an error while loading

Първият require() на ModuleScript пуска кода му. Ако модулът гръмне с грешка по време на изпълнение, скриптът, който го е заредил, получава това съобщение. Истинският проблем е собствената грешка на модула ред или два по-горе в Output: поправяй нея. Две подобни съобщения:

  • Module code did not return exactly one value: модулът не завършва с return. ModuleScript трябва да връща една стойност, която не е nil, обикновено своята таблица.
  • Requested module was required recursively: два модула се зареждат един друг. Изнеси общата част в трети модул, който зареждат и двата.
ModuleScript в ReplicatedStorage с име Format
local Format = {}

-- Превръща брой секунди в минути и секунди: 95 става "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

-- Модулът трябва накрая да върне своята таблица. Без този ред всеки
-- require на този модул гърми с: Module code did not return exactly one value
return Format

Скриптът го зарежда с local Format = require(ReplicatedStorage:WaitForChild("Format")) и после извиква Format.clock(95). Ако напишеш Format.Clock(95), ще получиш грешката attempt to call a nil value.

Argument 1 missing or nil

Функция на Roblox е получила nil в аргумент, който ѝ трябва, а числото казва в кой точно. workspace:FindFirstChild(itemName) гърми така, когато itemName е nil. Бъгът рядко е на този ред. Той е там, откъдето е трябвало да дойде стойността: променлива с печатна грешка, атрибут, който така и не е зададен, или аргумент на RemoteEvent, който клиентът не е изпратил. Аргументите на RemoteEvent идват от устройството на играча, затова сървърът трябва да ги проверява, преди да ги използва. Как става това, показва ръководството за RemoteEvent.

FireServer can only be called from the client

RemoteEvent има посока. LocalScript извиква FireServer, а сървърен Script слуша с OnServerEvent. Сървърен Script извиква FireClient или FireAllClients, а LocalScript слушат с OnClientEvent. Извикване на метода от грешната страна дава тази грешка или огледалната ѝ, FireClient can only be called from the server. Обикновено поправката е да преместиш кода в скрипт от правилния тип: виж Script, LocalScript и ModuleScript.

Грешка 403 на дата стор в Studio

Извикванията към дата стор в Studio гърмят с код на грешка 403 (StudioAccessToApisNotAllowed), докато не ги разрешиш. Публикувай плейса, отвори File, Experience Settings, Security, включи Enable Studio Access to API Services и запази. След това Studio използва същите дата сторове като живата игра, затова Roblox съветва да го правиш в отделно тестово копие, а не в игра, която вече се играе. Обвивай всяко извикване към дата стор в pcall, защото такива извиквания може да гърмят по причини извън кода ти. Как да запазваш безопасно, е разгледано в туториала за DataStore.

Скриптът работи без грешки, но не прави нищо

Мълчащ скрипт обикновено изобщо не се е пуснал, още чака нещо или се е пуснал от грешната страна. Преди да сменяш кода, сложи като първи ред print(script:GetFullName(), "started") и пусни играта. Ако този ред така и не се появи в Output, проблемът е в това къде е скриптът или как е настроен, а не в това какво пише в него.

Защо скриптът може да не прави нищо без грешка
Какво да проверишКакво се объркваКак да поправиш
Тип и място на скриптаLocalScript се пуска само ако е в StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack или ReplicatedFirst (от Starter контейнерите се пуска като копие на играча). Ако го сложиш в Workspace, ServerScriptService или ReplicatedStorage, няма да се пусне никога. Script с RunContext по подразбиране се пуска само в Workspace или ServerScriptService.Премести го или вземи друг тип скрипт. Кодът за интерфейса и управлението отива в LocalScript, правилата на играта отиват в Script в ServerScriptService.
EnabledСкрипт с махната отметка Enabled не се пуска.Избери го и отметни Enabled в прозореца Properties.
RunContextRunContext на Script решава къде се пуска. Legacy, стойността по подразбиране, се пуска на сървъра от Workspace или ServerScriptService. Server се пуска на сървъра, Client се пуска на устройството на всеки играч, например от ReplicatedStorage.Задавай го съзнателно. Документацията на Roblox съветва Client Script да се слага в ReplicatedStorage или ReplicatedFirst, а LocalScript в Starter контейнерите.
Събитието не се задействаTouched се задейства само от физическо движение, поне един от двата парта трябва да не е закотвен и трябва CanTouch и на двата. PlayerAdded не се задейства за играчите, които вече са били на сървъра, когато си се свързал към събитието. Обработчикът на RemoteEvent няма да се пусне, ако другата страна никога не извиква събитието.Сложи print в обработчика, за да разбереш със сигурност дали се пуска, а после поправи това, което трябва да го извиква.
Код след цикъл или чаканеРедовете под цикъл while true do никога не се изпълняват, защото цикълът не свършва. Редовете под WaitForChild, който така и не намира обекта, също не се изпълняват.Свързвай събитията преди цикъла или пускай цикъла с task.spawn. Давай таймаут на чаканията.
Проверка, която тихо излизаЗащита като if not coins then return end мълчаливо спира функцията, когато обекта го няма.Добави warn с подробности преди return.
Филтри в OutputOutput може да се филтрира по тип съобщение, по Client или Server и по текст. Забравен филтър може да крие грешката, която търсиш.Изчисти филтрите и полето за търсене.
Виждаш го само тиПромяната е направена от LocalScript, затова я вижда само този играч. Сървърът и другите играчи не я виждат.Прави промяната на сървъра. Виж къде се изпълняват скриптовете.

На случая с PlayerAdded се хващат мнозина, защото при тест в Studio влизаш почти веднага след старта на сървъра. Ако нещо над реда с Connect чака, например WaitForChild, task.wait или require на модул, който чака, може да влезеш, преди да се появи връзката. Обработвай и новите, и вече влезлите играчи:

Script в ServerScriptService с име Welcome
local Players = game:GetService("Players")

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- За играчите, които вече са били тук, когато се е изпълнил редът по-горе,
-- PlayerAdded в този скрипт няма да се задейства, затова ги обработваме сега
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Инструменти за дебъгване в Roblox Studio

print пише ред в Output, а warn пише предупреждение. Това е най-бързият начин да отговориш на въпросите "пусна ли се това изобщо?" и "на какво е равна тази стойност?". Гол print(x) после трудно се намира, затова добавяй етикет и важните подробности. typeof(x) показва каква е стойността: число, низ, Instance или nil, а GetFullName() показва кой точно обект имаш.

Script в ServerScriptService с име ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- сложи false, когато приключиш
local TAG = "[ShopServer]"

local function debugPrint(...: any)
	if DEBUG then
		print(TAG, ...)
	end
end

Players.PlayerAdded:Connect(function(player: Player)
	debugPrint("joined:", player.Name, player.UserId)

	local leaderstats = player:WaitForChild("leaderstats", 10)
	if not leaderstats then
		warn(TAG, "no leaderstats for", player.Name, "after 10 seconds")
		return
	end

	local coins = leaderstats:FindFirstChild("Coins")
	-- typeof и ClassName показват каква е стойността всъщност
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

Полето за търсене в Output филтрира по текст, затова постоянен етикет като [ShopServer] ти позволява да покажеш само редовете на тази система. Ако трябва да разбереш как кодът е стигнал до реда, debug.traceback() връща текущия стек от извиквания като низ.

Брейкпойнти и изпълнение стъпка по стъпка

Брейкпойнтът слага играта на пауза на даден ред, за да можеш да разгледаш всичко в този момент. В Script Editor кликни в полето вдясно от номера на реда (ще се появи червено кръгче), после пусни плейтест. Когато изпълнението стигне този ред, играта ще спре на пауза, а жълта стрелка ще покаже следващия ред. Нататък по кода те водят бутоните за изпълнение стъпка по стъпка:

  • Step Over (F10) изпълнява текущия ред и спира на следващия.
  • Step Into (F11) влиза във функцията, която се извиква на този ред.
  • Step Out (Shift+F11) довършва текущата функция и спира в кода, който я е извикал.
  • Resume Scripts продължава до следващия брейкпойнт.

Десен клик в полето дава още два полезни вида. Условен брейкпойнт слага пауза само когато израз като amount < 0 е верен. Logpoint извежда съобщение в Output без пауза, така че можеш да логнеш стойност, без да променяш скрипта.

Watch и Call Stack

Докато играта е на пауза, задръж курсора върху променлива в Script Editor, за да видиш стойността ѝ. Прозорецът Watch в раздела Variables показва всички променливи в обхвата, а в раздела My Watches можеш да въведеш всеки израз, например coins.Value + amount, и да видиш текущата му стойност. Прозорецът Call Stack показва коя функция коя е извикала, за да се стигне до реда на пауза. И двата се отварят от раздела Script или менюто Window.

Script Analysis и строг режим

Script Editor подчертава проблемите още докато пишеш, а прозорецът Script Analysis, който се отваря с бутона Analysis в раздела Script, показва грешките и предупрежденията във всички скриптове. Той хваща синтактичните грешки и непознатите имена, преди да натиснеш Play. Ако първият ред на скрипта е --!strict, се включва строгата проверка на типовете в Luau, която съобщава и за печатни грешки в свойствата, грешни типове аргументи и стойности, които може да са nil. Но пусната игра тя не вижда: парт, който го няма в Workspace, ще покаже само Output.

Command bar

Command bar (в раздела Script или Ctrl+9, ⌘9 на Mac) веднага изпълнява Luau. Докато играта върви, това е бърз начин да зададеш въпрос: print(workspace:FindFirstChild("Bridge")) ще каже дали има такъв парт, а print(#game:GetService("Players"):GetPlayers()) ще преброи играчите. В режим на редактиране кодът от command bar променя плейса ти наистина, затова внимавай с всичко, което мести или трие обекти.

Developer Console в живата игра

Output в Studio работи само в Studio. В живата игра натисни F9 или напиши /console в чата, за да отвориш Developer Console. Нейният Log показва изхода от твоето устройство, а изхода от сървъра, ако си собственик на играта или член на група с право да я редактира.

Вграденият Assistant в Roblox също може да помогне с отделно съобщение: собственото ръководство на Roblox съветва да поставиш грешката от Output и да помолиш Assistant да я разгледа. Ако Assistant е спрял да отговаря или пише, че си стигнал лимита, виж лимитите и грешките на Assistant.

Поправка на грешки с RoCode

RoCode е независим ИИ агент за Roblox Studio: описваш проблема в уеб чата, а плъгинът за Studio чете и поправя плейса, който имаш отворен. При грешките той може да поеме стъпките за четене от реда по-горе, като се опира на плейтеста, който вече си пуснал.

Ти пишеш

Натиснах Play и кликът върху бутона на магазина не прави нищо. Output показва attempt to index nil with 'Coins'. Намери причината и я поправи.

RoCode прави
  • Чете Output в Studio със своя инструмент Check Output, включително редовете Server и Client от последния ти плейтест, дори след като си натиснал Stop
  • Отваря скрипта от грешката с Read Script и чете кода около този ред, а със Search Scripts може да намери къде е трябвало да се създаде липсващата стойност
  • Прави точкова редакция с Edit Script, точно търсене и замяна в този скрипт, после пуска Check Script, който компилира скрипта в Studio (не проверява типовете, не пуска линтер и не изпълнява кода ти)
  • Изпраща промените в Studio на групи и всяка група е точка за отмяна в историята на Studio

Натисни Play още веднъж и кликни бутона на магазина, за да се убедиш сам в поправката: с плъгин 3.9 или по-нов RoCode може да пусне кратък плейтест и да прочете грешките, а с плъгин 3.9.15 или по-нов тестовият му персонаж може да натиска бутони на екрана, но проверява само това, което сам е решил да тества, а проверката на компилацията не казва дали логиката на играта е правилна. Четенето на грешките е част от всяко изграждане: цикълът на изграждане, проверка и тест за цяла игра повтаря тази проверка след всяка система. Как RoCode се свързва със Studio.

Често задавани въпроси

Защо скриптът в Roblox не работи, въпреки че няма грешки?

Обикновено скриптът изобщо не се е пуснал (грешен тип скрипт или контейнер, или е изключен Enabled), още чака нещо или събитието, което слуша, никога не се задейства. Print на първия ред ще покаже кой е вариантът. Виж чеклиста по-горе.

Какво значи "attempt to index nil" в Roblox?

Стойността преди точката или двоеточието е била nil, затова Roblox не е могъл да надникне вътре. На реда player.Character.Humanoid грешката attempt to index nil with 'Humanoid' значи, че player.Character е бил nil: липсва или още не се е заредил. Проверявай стойността с if, преди да я използваш, а в LocalScript чакай обектите, които създава сървърът, с WaitForChild. Повече за причините.

Какво значи "infinite yield possible" в Roblox?

WaitForChild чака повече от 5 секунди дъщерен обект, който така и не се е появил, и продължава да чака. Често името или родителят са грешни или никой не създава обекта. Повече за причините.

Защо прозорецът Output е празен или не се показва?

Отвори го от менюто Window или раздела Script. Ако е отворен, но по време на теста остава празен, изчисти филтрите и полето за търсене, а после провери дали скриптовете, които трябва да извеждат нещо, се пускат.

Има ли в Roblox проверка на скриптовете за грешки?

Да, вградена е в Studio: Script Editor подчертава проблемите, докато пишеш, а прозорецът Script Analysis ги показва като списък. Те намират синтактичните грешки и грешките в типовете, но не и липсващите обекти или грешната логика на играта: това се вижда само когато кодът върви.

Трябва ли да обвивам кода в pcall, за да няма грешки?

Само извикванията, които може да гръмнат по причини извън кода ти, например заявки към дата сторове, HTTP или MarketplaceService. Ако обвиеш в pcall грешка с nil, съобщението ще изчезне, а функцията пак няма да заработи.

Как да видя грешките в скриптовете в живата игра?

Натисни F9 в играта или напиши /console в чата, за да отвориш Developer Console. Тя показва грешките от твоето устройство, а от сървъра, ако си собственик на играта или член на група, която може да я редактира.

Източници и какво да прочетеш

Как е проверен кодът: всеки скрипт на тази страница минава строга проверка на типовете в Luau с дефинициите на Roblox API (luau-lsp, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.