요약
Window 메뉴나 Script 탭에서 Output 창을 열고 Play를 누른 뒤 첫 번째 빨간 오류를 클릭하세요. Studio가 스크립트를 멈춘 줄에서 열어 줍니다. 메시지는 무엇이 잘못됐는지 알려 줍니다. attempt to index nil with 'Humanoid'는 .Humanoid 바로 앞의 값이 nil이었다는 뜻입니다. 그 값이 없는 원인을 고친 뒤 게임을 다시 실행하세요.
- 목록의 첫 번째 오류부터 보세요. 그 아래 오류는 대개 첫 오류의 결과일 뿐입니다.
- 게임 실행 중 자주 나는 오류는 세 가지 원인으로 정리됩니다. 값이
nil이거나, 이름에 오타가 있거나 아직 로드되지 않았거나, 코드가 잘못된 쪽(서버 또는 클라이언트)에서 실행되는 경우입니다. - 오류가 전혀 없다면 대개 코드가 아예 실행되지 않은 것입니다. 스크립트 종류, Explorer에서의 위치,
Enabled속성, 그리고 스크립트가 기다리는 이벤트가 실제로 발생하는지 확인하세요. - 해당 줄에서 값이 실제로 무엇인지 알고 싶다면 이름표를 붙여 print로 출력하거나 그 줄에 중단점을 거세요.
Output을 열고 오류를 읽는 방법
Output 창은 Roblox가 스크립트 오류, 엔진 경고, 그리고 코드가 출력하는 모든 것을 알려 주는 곳입니다. 항상 열려 있는 것은 아니므로 테스트 전에 열어 두세요. 아직 스크립트를 한 번도 실행해 본 적이 없다면 초보자를 위한 스크립팅 가이드가 Output을 열고 스크립트에서 첫 줄을 출력하는 것부터 시작합니다.
- Studio의 Window 메뉴나 Script 탭의 버튼으로 Output을 엽니다.
- Ctrl+K(Mac에서는 ⌘K)로 이전 메시지를 지워 이번 테스트의 메시지만 보이게 합니다.
- 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에서 스크립트의 위치입니다. ServerScriptService 안에 있는 CoinPad라는 스크립트입니다.:14는 오류가 난 줄입니다.- 줄 번호 뒤의 메시지가 무엇이 잘못됐는지 알려 줍니다. 각 메시지는 아래 자주 나는 오류 목록에서 설명합니다.
- Stack Begin과 Stack End 사이의 스택은 여기까지 이어진 호출을 가장 최근 것부터 보여 줍니다. 27번 줄에서 호출한
award함수 안의 14번 줄입니다.
빨간 오류를 클릭하면 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를, 텍스트에는 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와 그것이 require로 불러오는 ModuleScript에만 있고, 서버에서는 항상 nil입니다. 대신PlayerAdded나 RemoteEvent 핸들러가 넘겨 주는player를 쓰세요.- 캐릭터가 스폰되기 전이나 리스폰되는 동안
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)
여기에는 리더보드 가이드처럼 Coins라는 IntValue가 든 leaderstats를 만드는 서버 스크립트가 필요합니다.
attempt to call a nil value
코드가 nil인 것 뒤에 괄호를 붙였기 때문에 실행할 것이 없었습니다. 흔한 원인:
- 함수 이름에 오타가 있거나 대소문자가 다릅니다. 모듈은
Format.clock을 선언했는데 호출하는 코드는Format.Clock(95)라고 씁니다. local function을 선언보다 위쪽 줄에서 호출합니다. 그 시점에는 이름이 아직 없으므로 선언을 위로 옮기세요.- ModuleScript가 반환하는 테이블에 함수를 끝내 넣지 않습니다.
비슷한 메시지 두 개도 같은 실수를 가리킵니다. 존재하지 않는 테이블 메서드를 콜론으로 호출하면 attempt to call missing method 'Kill' of table이 나옵니다. part:Destory()처럼 Roblox 오브젝트 메서드에 오타가 있으면 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: 값 오브젝트의 숫자가 아니라 오브젝트 자체로 계산했습니다.coins + 10은coins.Value + 10이어야 합니다.on nil and number: 변수나 테이블 항목이 설정된 적이 없습니다. 초기값을 주거나, 값이 없는 것이 정말 0을 뜻하는 곳이라면(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
-- 1분마다 서버의 모든 플레이어에게 코인을 조금씩 줍니다
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>: 3번 줄에서 시작하는function,if,for,while에 짝이 되는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
ModuleScript를 처음 require()하면 그 코드가 실행됩니다. 모듈이 실행 중에 오류로 멈추면, 그 모듈을 불러온 스크립트가 이 메시지를 받습니다. 진짜 문제는 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이면 이렇게 멈춥니다. 버그는 이 줄에 있는 경우가 드뭅니다. 값이 와야 했던 곳에 있습니다. 오타가 난 변수, 설정된 적 없는 속성(Attribute), 클라이언트가 보내지 않은 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를 참고하세요.
Studio에서 데이터 스토어 오류 403
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에 넣으면 절대 실행되지 않습니다. 기본 RunContext의 Script는 Workspace나 ServerScriptService에서만 실행됩니다. | 옮기거나 다른 종류의 스크립트를 쓰세요. UI와 조작 코드는 LocalScript에, 게임 규칙은 ServerScriptService의 Script에 넣습니다. |
| Enabled | Enabled 체크가 해제된 스크립트는 실행되지 않습니다. | 스크립트를 선택하고 Properties 창에서 Enabled를 체크하세요. |
| RunContext | Script의 RunContext가 어디서 실행될지 정합니다. 기본값인 Legacy는 Workspace나 ServerScriptService에서 서버로 실행됩니다. Server는 서버에서, Client는 예를 들어 ReplicatedStorage에서 각 플레이어의 기기에서 실행됩니다. | 의도를 가지고 설정하세요. Roblox 문서는 Client Script는 ReplicatedStorage나 ReplicatedFirst에, LocalScript는 Starter 컨테이너에 두라고 권합니다. |
| 이벤트가 발생하지 않음 | Touched는 물리적인 움직임으로만 발생하며, 두 파트 중 적어도 하나는 고정(Anchored)되지 않아야 하고 둘 다 CanTouch가 켜져 있어야 합니다. PlayerAdded는 이벤트에 연결하기 전에 이미 서버에 있던 플레이어에게는 발생하지 않습니다. 상대편이 이벤트를 호출하지 않으면 RemoteEvent 핸들러는 실행되지 않습니다. | 핸들러 안에 print를 넣어 실행되는지 정확히 확인한 뒤, 핸들러를 호출해야 하는 쪽을 고치세요. |
| 루프나 대기 뒤의 코드 | while true do 루프 아래의 줄은 루프가 끝나지 않으므로 절대 실행되지 않습니다. 오브젝트를 끝내 찾지 못하는 WaitForChild 아래의 줄도 실행되지 않습니다. | 이벤트는 루프보다 먼저 연결하거나 루프를 task.spawn으로 실행하세요. 대기에는 타임아웃을 주세요. |
| 조용히 빠져나가는 확인 | if not coins then return end 같은 방어 코드는 오브젝트가 없을 때 아무 말 없이 함수를 멈춥니다. | return 앞에 자세한 내용을 담은 warn을 추가하세요. |
| 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와 strict 모드
Script Editor는 입력하는 동안 바로 문제에 밑줄을 긋고, Script 탭의 Analysis 버튼으로 여는 Script Analysis 창은 모든 스크립트의 오류와 경고를 보여 줍니다. Play를 누르기 전에 문법 오류와 알 수 없는 이름을 잡아냅니다. 스크립트 첫 줄에 --!strict를 넣으면 Luau의 엄격한 타입 검사가 켜져서 속성 오타, 잘못된 인수 타입, nil일 수 있는 값까지 알려 줍니다. 하지만 실행 중인 게임은 보지 못합니다. Workspace에 없는 파트는 Output만 알려 줍니다.
Command bar
Command bar(Script 탭, 또는 Ctrl+9, Mac에서는 ⌘9)는 Luau를 바로 실행합니다. 게임이 실행 중일 때 빠르게 질문하는 방법입니다. print(workspace:FindFirstChild("Bridge"))는 그 파트가 있는지 알려 주고, print(#game:GetService("Players"):GetPlayers())는 플레이어 수를 셉니다. 편집 모드에서는 command bar의 코드가 플레이스를 실제로 바꾸므로, 오브젝트를 옮기거나 지우는 코드는 조심하세요.
라이브 게임의 Developer Console
Studio의 Output은 Studio에서만 작동합니다. 라이브 게임에서는 F9를 누르거나 채팅에 /console을 입력해 Developer Console을 여세요. Log에는 내 기기의 출력이 나오고, 게임 소유자이거나 게임을 편집할 권한이 있는 그룹 멤버라면 서버 출력도 나옵니다.
Roblox에 내장된 Assistant도 개별 메시지에 도움이 될 수 있습니다. Roblox 자체 가이드는 Output의 오류를 붙여 넣고 Assistant에게 분석을 요청하라고 권합니다. Assistant가 응답하지 않거나 한도에 도달했다고 나온다면 Assistant 한도와 오류를 보세요.
RoCode로 오류 고치기
RoCode는 Roblox Studio용 독립 AI 에이전트입니다. 웹 채팅에서 문제를 설명하면 Studio 플러그인이 지금 열려 있는 플레이스를 읽고 수정합니다. 오류에 대해서는 이미 실행해 본 플레이테스트를 바탕으로 위 순서의 읽기 단계를 대신 맡을 수 있습니다.
Play를 눌렀는데 상점 버튼을 클릭해도 아무 일도 안 일어나. Output에 attempt to index nil with 'Coins'가 떠. 원인을 찾아서 고쳐 줘.
- Check Output 도구로 Studio의 Output을 읽습니다. 마지막 플레이테스트의 Server와 Client 줄도 포함되며, Stop을 누른 뒤에도 읽을 수 있습니다
- Read Script로 오류가 난 스크립트를 열어 그 줄 주변의 코드를 읽고, Search Scripts로 없는 값이 어디서 만들어졌어야 하는지 찾을 수 있습니다
- Edit Script로 그 스크립트에서 정확히 찾아 바꾸는 정밀한 수정을 한 뒤 Check Script를 실행합니다. Check Script는 Studio 안에서 스크립트를 컴파일합니다(타입 검사, 린트, 코드 실행은 하지 않습니다)
- 변경 사항을 묶음으로 Studio에 보내며, 묶음마다 Studio 기록에 실행 취소 지점이 됩니다
Play를 다시 누르고 상점 버튼을 클릭해 수정됐는지 직접 확인하세요. 플러그인 3.9 이상에서는 RoCode가 짧은 플레이테스트를 실행해 오류를 읽을 수 있고, 플러그인 3.9.15 이상에서는 테스트 캐릭터가 화면 버튼을 누를 수 있습니다. 하지만 RoCode는 스스로 테스트하기로 정한 부분만 확인하며, 컴파일 검사는 게임 로직이 올바른지 알려 주지 않습니다. 오류 읽기는 모든 빌드에 포함됩니다. 게임 전체를 위한 빌드, 검사, 테스트 루프는 시스템 하나를 만들 때마다 이 검사를 반복합니다. RoCode가 Studio에 연결되는 방식.
자주 묻는 질문
Roblox 스크립트가 오류도 없는데 왜 작동하지 않나요?
대개 스크립트가 아예 실행되지 않았거나(스크립트 종류나 컨테이너가 틀렸거나 Enabled가 꺼져 있음), 아직 무언가를 기다리고 있거나, 듣고 있는 이벤트가 절대 발생하지 않는 경우입니다. 첫 줄의 print로 어느 경우인지 알 수 있습니다. 위의 체크리스트를 보세요.
Roblox에서 "attempt to index nil"은 무슨 뜻인가요?
점이나 콜론 앞의 값이 nil이어서 Roblox가 그 안을 들여다볼 수 없었다는 뜻입니다. player.Character.Humanoid 줄에서 attempt to index nil with 'Humanoid' 오류가 났다면 player.Character가 nil이었던 것입니다. 없거나 아직 로드되지 않은 것이죠. 쓰기 전에 if로 값을 확인하고, LocalScript에서는 서버가 만드는 오브젝트를 WaitForChild로 기다리세요. 원인 자세히 보기.
Roblox에서 "infinite yield possible"은 무슨 뜻인가요?
WaitForChild가 나타나지 않는 자식 오브젝트를 5초 넘게 기다리고 있으며 계속 기다린다는 뜻입니다. 이름이나 부모가 틀렸거나 그 오브젝트를 아무도 만들지 않는 경우가 많습니다. 원인 자세히 보기.
Output 창이 비어 있거나 보이지 않는 이유는 무엇인가요?
Window 메뉴나 Script 탭에서 여세요. 열려 있는데 테스트 중에도 비어 있다면 필터와 검색 창을 초기화한 뒤, 무언가 출력해야 하는 스크립트가 실행되는지 확인하세요.
Roblox에 스크립트 오류 검사 기능이 있나요?
네, Studio에 내장되어 있습니다. Script Editor가 입력하는 동안 문제에 밑줄을 긋고, Script Analysis 창이 목록으로 보여 줍니다. 문법 오류와 타입 오류는 찾지만, 없는 오브젝트나 잘못된 게임 로직은 찾지 못합니다. 그런 것은 코드를 실행해야만 보입니다.
오류가 나지 않게 코드를 pcall로 감싸야 하나요?
데이터 스토어, HTTP, MarketplaceService 요청처럼 코드 바깥의 이유로 실패할 수 있는 호출만 감싸세요. nil 오류를 pcall로 감싸면 메시지는 사라지지만 기능은 여전히 작동하지 않습니다.
라이브 게임에서 스크립트 오류를 보려면 어떻게 하나요?
게임에서 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(영어). strict 모드
- Roblox Creator Docs: Developer Console(영어). 라이브 게임에서 서버 출력을 볼 수 있는 사람
- Roblox Creator Docs: Build your first game with Assistant(영어). Output의 오류를 붙여 넣어 Assistant에게 분석 요청
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.