Коротко
Відкрийте вікно Output через меню Window або вкладку Script, натисніть Play і клікніть по першій червоній помилці. Studio відкриє скрипт на рядку, де він упав. Повідомлення каже, що пішло не так: attempt to index nil with 'Humanoid' означає, що значення просто перед .Humanoid було nil. Виправте причину, через яку цього значення немає, і запустіть гру знову.
- Починайте з першої помилки в списку. Помилки нижче часто лише її наслідки.
- Часті помилки під час гри зводяться до трьох причин: значення дорівнює
nil, ім'я написано з помилкою або ще не завантажилося, або код виконується не на тому боці (сервер чи клієнт). - Якщо помилки немає зовсім, зазвичай код просто не запускався. Перевірте тип скрипта, де він лежить в Explorer, його властивість
Enabledі чи спрацьовує взагалі подія, на яку він чекає. - Щоб дізнатися, чому насправді дорівнює значення на потрібному рядку, виведіть його через print з підписом або поставте на цьому рядку брейкпоінт.
На цій сторінці
Як відкрити Output і прочитати помилку
Вікно Output це місце, де Roblox повідомляє про помилки скриптів, попередження рушія і все, що виводить ваш код. Воно відкрите не завжди, тому відкрийте його до тесту. Якщо ви ще жодного разу не запускали скрипт, гайд зі скриптингу для початківців починається з того, що відкриває Output і виводить перший рядок зі скрипта.
- Відкрийте Output через меню Window у Studio або кнопкою на вкладці Script.
- Очистіть старі повідомлення через Ctrl+K (⌘K на Mac), щоб бачити лише цей тест.
- Натисніть Play (F5) і зробіть те, що ламає гру.
- Знайдіть перший червоний рядок. Помилки червоні. Попередження, наприклад
Infinite yield possible, показуються помаранчевим.
Помилка під час гри в Output виглядає так. Залежно від налаштувань відображення Output кожен рядок може мати ще час, мітку Client або Server та ім'я скрипта.
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) або за текстом.
Порядок налагодження, який підходить для будь-якого скрипта
Вгадувати й змінювати одразу кілька речей це повільний спосіб полагодити скрипт. Цей порядок крок за кроком звужує проблему, є повідомлення про помилку чи ні.
- Повторіть проблему. Очистіть Output, натисніть Play і зробіть рівно те, що ламає гру. Запишіть, чого ви очікували і що сталося натомість.
- Візьміть першу помилку. Прочитайте перший новий червоний рядок: шлях скрипта, номер рядка й повідомлення. Якщо помилки немає, переходьте до розділу скрипти, які працюють без помилок.
- Перейдіть до рядка. Клікніть по помилці. Прочитайте весь рядок і запитайте себе, яке значення в ньому може бути
nil, написане з помилкою або мати не той тип. - Перевірте значення, а не вгадуйте. Додайте
printпросто над рядком або поставте на ньому брейкпоінт і подивіться значення у вікні Watch.typeof(x)скаже, що у вас: число, рядок, Instance чи nil. - Ідіть назад по сліду. Якщо значення неправильне, знайдіть, де його задали:
FindFirstChild, який нічого не знайшов, функція, яка нічого не повернула, аргумент, який код, що викликає, так і не передав. - Виправляйте причину, по одній зміні за раз. Виправте ім'я, зачекайте на об'єкт або перенесіть код на потрібний бік, потім запустіть гру знову. Не обгортайте рядок у
pcall, щоб він замовк: так баг ховається, а не виправляється. - Переконайтеся. Повторіть крок 1. Помилка має зникнути, а функція має робити те, чого ви очікували. Якщо йдеться про інших гравців, протестуйте ще в режимі Server & Clients з двома клієнтами.
- Приберіть за собою. Видаліть або вимкніть налагоджувальні print, щоб наступну проблему було легко помітити.
Часті помилки скриптів Roblox і як їх виправити
Кожне повідомлення будується за одним шаблоном, у який підставляються ваші імена, тому сам текст помилки найкраща підказка. Імена в лапках нижче, наприклад 'Health' або "Workspace", це приклади.
| Що пише 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 client | RemoteEvent викликали не з того боку. | Сервер використовує 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]до того, як завантажилися дані цього гравця, або викликана функція нічого не повернула.
Класичний випадок це блок, що вбиває. Зламана версія вважає, що все, що торкається парта, належить персонажу, а для викинутих інструментів, незакріплених партів і аксесуарів це не так.
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), і парт надто далеко від гравця, тому ще не надісланий цьому клієнту.
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.
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, тому порядок у повідомленні може бути зворотним до вашого коду.
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: два модулі підключають один одного. Винесіть спільну частину в третій модуль, який підключають обидва.
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. |
| RunContext | RunContext у 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. |
| Фільтри Output | Output можна фільтрувати за типом повідомлення, за Client або Server і за текстом. Забутий фільтр може ховати помилку, яку ви шукаєте. | Скиньте фільтри й очистіть поле пошуку. |
| Бачите лише ви | Зміну зробив LocalScript, тому її бачить лише цей гравець. Сервер та інші гравці її не бачать. | Робіть зміну на сервері. Дивіться, де виконуються скрипти. |
На випадку з PlayerAdded потрапляють багато хто, бо в тесті Studio ви заходите майже одразу після старту сервера. Якщо щось вище за рядок із Connect чекає, наприклад WaitForChild, task.wait або require модуля, який чекає, ви можете зайти раніше, ніж з'явиться підключення. Обробляйте і нових гравців, і тих, хто вже зайшов:
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 і warn з контекстом
print пише рядок в Output, а warn пише попередження. Це найшвидший спосіб відповісти на питання "це взагалі запускалося?" і "чому дорівнює це значення?". Голий print(x) потім важко знайти, тому додавайте підпис і важливі подробиці. typeof(x) показує, що це за значення: число, рядок, Instance чи nil, а GetFullName() показує, який саме у вас об'єкт.
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'. Знайди причину й виправ.
- Читає 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. Вона показує помилки з вашого пристрою, а із сервера, якщо ви власник гри або учасник групи, який може її редагувати.
Джерела та що почитати
- Roblox Creator Docs: Output (англійською). де розташований Output, його фільтри й налаштування відображення
- Roblox Creator Docs: Debugging (англійською). брейкпоінти, покрокове виконання, Watch, Call Stack, command bar і Developer Console
- Roblox Creator Docs: Script Editor (англійською). вікно Script Analysis
- Roblox Creator Docs: Studio interface (англійською). де відкриваються Output і command bar
- Roblox Creator Docs: Script types and locations (англійською). де запускається кожен тип скрипта і RunContext
- Roblox Creator Docs: Studio testing modes (англійською). Play, види Client і Server і тести Server & Clients
- Roblox Engine API: Instance (англійською). WaitForChild, його тайм-аут і попередження через 5 секунд
- Roblox Creator Docs: Reuse code (англійською). ModuleScript і рекурсивні require
- Roblox Creator Docs: Data store error codes and limits (англійською). помилка 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (англійською). увімкнення доступу зі Studio й окрема тестова копія
- Roblox Engine API: BasePart (англійською). коли спрацьовує Touched і CanTouch
- Roblox Creator Docs: Type checking (англійською). строгий режим
- Roblox Creator Docs: Developer Console (англійською). хто бачить вивід сервера в живій грі
- Roblox Creator Docs: Build your first game with Assistant (англійською). вставлення помилки з Output, щоб Assistant її розібрав
Як перевірявся код: кожен скрипт на цій сторінці проходить сувору перевірку типів Luau з визначеннями Roblox API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.