Гайд · Отладка

Как исправить ошибки скриптов в Roblox Studio

Когда скрипт в Roblox ломается, Studio обычно пишет, где и почему, в окне Output. В этом гайде разберём, как читать это сообщение, что значат частые ошибки и как исправить каждую, что проверять, если скрипт не работает вообще без ошибок, и порядок действий, который находит причину, а не гадает.

Обновлено 14 ноября 2026 г.18 мин чтенияАвтор:

Коротко

Откройте окно 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, StudioAccessToApisNotAllowedStudio не разрешено пользоваться дата-сторами этой игры.Опубликуйте игру и включите 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, 14 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.