Guia · Depuração

Como corrigir erros de script no Roblox Studio

Quando um script do Roblox quebra, o Studio quase sempre diz onde e por quê na janela Output. Este guia mostra como ler essa mensagem, o que os erros comuns significam e como corrigir cada um, o que conferir quando um script falha sem nenhum erro, e uma rotina que acha a causa em vez de chutar.

Atualizado em 14 de novembro de 202621 min de leituraEscrito por

Resumo

Abra a janela Output pelo menu Window ou pela aba Script, aperte Play e clique no primeiro erro vermelho. O Studio abre o script na linha que falhou. A mensagem diz o que deu errado ali: attempt to index nil with 'Humanoid' quer dizer que o valor logo antes de .Humanoid era nil. Corrija o motivo de esse valor estar faltando e jogue de novo.

  • Comece pelo primeiro erro da lista. Os erros mais abaixo muitas vezes são consequência dele.
  • Os erros comuns em execução vêm de três causas: um valor que é nil, um nome escrito errado ou que ainda não carregou, ou código rodando no lado errado (servidor ou cliente).
  • Nenhum erro quase sempre quer dizer que o código nunca rodou. Confira o tipo do script, onde ele está no Explorer, a propriedade Enabled dele e se o evento que ele espera chega a disparar.
  • Para ver o que um valor realmente é em uma linha, imprima ele com um rótulo ou pause naquela linha com um breakpoint.
Nesta página
  1. Ler o Output
  2. Rotina de depuração
  3. Erros comuns
  4. Sem erros, nada acontece
  5. Ferramentas de depuração
  6. Com o RoCode
  7. Perguntas frequentes
  8. Fontes e leitura extra

Abra o Output e leia um erro

IlustraçãoO exemplo de kill brick do guia, acelerado: a linha com problema dá erro, e depois do Stop, da correção e de um novo teste, a part cai sem erro.

A janela Output é onde o Roblox mostra erros de script, avisos do motor e tudo o que o seu código imprime. Ela nem sempre está aberta, então abra antes de testar. Se você nunca rodou um script, o guia de programação para iniciantes começa abrindo o Output e imprimindo uma primeira linha a partir de um script.

  1. Abra o Output pelo menu Window do Studio, ou pelo botão dele na aba Script.
  2. Limpe as mensagens antigas com Ctrl+K (⌘K no Mac) para ver só este teste.
  3. Aperte Play (F5) e faça a coisa que quebra.
  4. Procure a primeira linha vermelha. Erros são vermelhos. Avisos, como Infinite yield possible, aparecem em laranja.

Um erro de execução no Output fica assim. Dependendo das opções de exibição do Output, cada linha também pode trazer um horário, um rótulo Client ou Server e o nome do script.

Output (exemplo)
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 é onde o script está no Explorer: um script chamado CoinPad dentro do ServerScriptService.
  • :14 é a linha que falhou.
  • A mensagem depois do número da linha diz o que deu errado. A lista de erros comuns abaixo explica cada um.
  • A pilha (stack), entre Stack Begin e Stack End, lista as chamadas que levaram até ali, da mais recente para a mais antiga: a linha 14 dentro da função award, que foi chamada pela linha 27.

Clique no erro vermelho e o Studio abre aquele script com o cursor na linha que falhou. Em um teste solo, as mensagens do servidor e do seu próprio cliente ficam no mesmo Output, marcadas em verde para o servidor e em azul para o cliente. Os filtros no topo limitam a lista por tipo de mensagem (Error, Warning), por contexto (Client, Server) ou por texto.

Uma rotina de depuração que serve para qualquer script

Chutar, e mudar várias coisas de uma vez, é o jeito lento de consertar um script. Esta ordem vai fechando o problema passo a passo, com ou sem mensagem de erro.

  1. Reproduza. Limpe o Output, aperte Play e faça exatamente o que quebra. Anote o que você esperava e o que aconteceu no lugar.
  2. Pegue o primeiro erro. Leia a primeira linha vermelha nova: o caminho do script, o número da linha e a mensagem. Se não há erro, vá para scripts que rodam sem erros.
  3. Vá até a linha. Clique no erro. Leia a linha inteira e pergunte qual valor nela pode ser nil, estar escrito errado ou ser do tipo errado.
  4. Confira o valor em vez de supor. Adicione um print logo acima da linha, ou coloque um breakpoint nela e leia os valores na janela Watch. typeof(x) diz se você tem um number, uma string, uma Instance ou nil.
  5. Volte atrás dele. Se o valor está errado, ache onde ele foi definido: um FindFirstChild que não achou nada, uma função que não retornou nada, um argumento que quem chamou nunca mandou.
  6. Corrija a causa, uma mudança por vez. Corrija o nome, espere o objeto ou leve o código para o lado certo, e jogue de novo. Não envolva a linha em pcall para calar o erro: isso esconde o bug em vez de corrigir.
  7. Confirme. Repita o passo 1. O erro deve ter sumido e o recurso deve fazer o que você esperava. Para qualquer coisa que envolva outros jogadores, teste também com Server & Clients e dois clientes.
  8. Limpe. Remova ou desligue os seus prints de depuração para o próximo problema ficar fácil de ver.

Erros comuns de script no Roblox e como corrigir

Cada mensagem segue um padrão fixo com os seus próprios nomes no meio, então o próprio texto é a melhor pista. Os nomes entre aspas abaixo, como 'Health' ou "Workspace", são exemplos.

Erros comuns do Output. Clique em uma mensagem para ver a explicação completa.
O Output dizO que significaCorreção comum
attempt to index nil with 'Health'O valor antes de .Health era nil.Descubra por que ele é nil e confira com if antes de usar.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'O WaitForChild esperou 5 segundos e o objeto não apareceu.Corrija o nome ou o caminho, garanta que algo cria o objeto, ou adicione um tempo limite.
Bridge is not a valid member of Workspace "Workspace"Não existe ali, agora, nenhum filho ou propriedade com esse nome exato.Use a mesma grafia e as mesmas maiúsculas do Explorer. No cliente, use WaitForChild.
attempt to call a nil valueVocê chamou algo que não é uma função.Confira o nome da função e se ela está definida acima da chamada.
attempt to perform arithmetic (add) on Instance and numberConta com algo que não é um número.Use .Value em value objects e tonumber em texto.
attempt to concatenate string with nilO .. tentou juntar texto com nil ou com um objeto.Use tostring(), .Name ou interpolação de string.
Expected 'end' (to close 'function' at line 3), got <eof>Um erro de sintaxe. Nada do script roda.Corrija o sublinhado vermelho no Script Editor.
Requested module experienced an error while loadingO próprio ModuleScript deu erro enquanto rodava.Corrija o erro do módulo, que aparece logo acima no Output.
Argument 1 missing or nilUma função do Roblox recebeu nil onde precisa de um valor.Rastreie de onde esse argumento deveria ter vindo.
FireServer can only be called from the clientUm RemoteEvent foi disparado do lado errado.O servidor usa FireClient; LocalScripts usam FireServer.
Erro de data store 403, StudioAccessToApisNotAllowedO Studio não tem permissão para usar data stores neste jogo.Publique e ligue o Studio Access to API Services.

Cada mensagem daqui, e outras, tem uma página própria com cada causa, o código que provoca o erro e a correção: veja mensagens de erro do Roblox Studio (em inglês), por exemplo attempt to index nil (em inglês), Infinite yield possible (em inglês) e is not a valid member of (em inglês).

attempt to index nil with 'X'

Indexar quer dizer ler algo com um ponto ou com colchetes: part.Position, player.Character, list[1]. Este erro diz que a coisa à esquerda era nil, e o nome entre aspas é o que você tentou ler dela. Então, na linha player.Character.Humanoid, attempt to index nil with 'Humanoid' quer dizer que player.Character era nil. Quando a chave é um número, a mensagem termina com with number.

Os motivos comuns de o valor ser nil:

  • FindFirstChild, FindFirstChildOfClass ou FindFirstAncestor não acharam nada, porque o nome é diferente ou o objeto ainda não existe.
  • Players.LocalPlayer foi usado em um Script de servidor. Ele só existe em LocalScripts e nos ModuleScripts que eles carregam com require; no servidor ele é sempre nil. Use o player que o PlayerAdded ou um handler de RemoteEvent te dá.
  • player.Character foi lido antes de o personagem aparecer, ou enquanto ele estava renascendo.
  • Uma entrada de tabela nunca foi definida, como playerData[player] antes de os dados daquele jogador carregarem, ou uma função que você chamou não retornou nada.

Um kill brick é o caso clássico. A versão com problema supõe que tudo o que toca a part pertence a um personagem, o que não vale para tools largadas no chão, parts soltas ou acessórios.

Script em uma Part no Workspace chamado KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Versão com erro:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Quando a part que toca não é uma parte do corpo de um personagem, o FindFirstChild
	-- retorna nil e o Output mostra:
	--   attempt to index nil with 'Health'

	-- Corrigido: confere cada passo antes de usar
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Escrever hit.Parent.Humanoid no lugar falha com outra mensagem, Humanoid is not a valid member of ..., explicada mais abaixo. O FindFirstAncestorOfClass("Model") também acha o personagem quando a part que toca está dentro de um acessório ou de uma tool que o personagem está segurando, então uma tool na mão encostando no bloco também conta.

O padrão que corrige este erro: pegue o valor, confira e só então use. No servidor, FindFirstChild mais uma checagem com if serve para coisas que podem estar faltando de verdade. Em um LocalScript, use WaitForChild para coisas que o servidor cria, porque elas podem chegar depois que o seu script começa.

Infinite yield possible on ...

WaitForChild("Name") pausa o script até existir um filho com esse nome. Se ele esperou mais de 5 segundos e você não deu um tempo limite, o Roblox imprime este aviso. É um aviso, não um erro: o script continua esperando, e nada depois daquela linha roda até o filho aparecer, o que pode nunca acontecer. As causas comuns:

  • O nome ou o pai está errado. WaitForChild("leaderStats") nunca encontra uma pasta chamada leaderstats.
  • Nada cria o objeto: o script de servidor que faz ele está desativado, no lugar errado ou deu erro antes. Procure um erro anterior no Output.
  • Um LocalScript está esperando algo no ServerStorage ou no ServerScriptService. O conteúdo deles nunca é enviado aos jogadores, então a espera nunca termina.
  • Você está esperando uma propriedade, não um filho. player:WaitForChild("Character") é o caso comum: Character é uma propriedade do Player, não um objeto dentro dele.
  • O instance streaming (Workspace.StreamingEnabled) está ligado, e a part está longe demais do jogador para já ter sido enviada àquele cliente.
LocalScript em StarterPlayerScripts chamado DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Versão com erro:
--   local character = player:WaitForChild("Character")
-- Character é uma propriedade do Player, não um filho, então o Output avisa:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Com um tempo limite, o WaitForChild retorna nil em vez de esperar para sempre
	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

-- Cuida do personagem que talvez já exista, e depois de cada renascimento
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Um número como segundo argumento do WaitForChild é um tempo limite em segundos. Assim o script pode avisar o problema com warn e parar direito, em vez de travar em silêncio.

X is not a valid member of Y

Você usou um ponto para chegar a um filho ou propriedade que não existe naquele momento, como workspace.Bridge quando o Workspace não tem nenhuma part chamada Bridge. A mensagem diz o que você pediu, e depois a classe e o caminho completo do objeto onde ele procurou. Confira três coisas:

  • A grafia e as maiúsculas são exatamente as do Explorer. A pasta é leaderstats, tudo minúsculo, e humanoid não é Humanoid.
  • Os nomes de propriedades usam a grafia americana. part.Colour falha com Colour is not a valid member of Part "Workspace.Part"; a propriedade é Color.
  • O objeto já carregou. No cliente, objetos que o servidor cria podem chegar depois que o seu LocalScript começa, então use WaitForChild ali.
LocalScript em StarterPlayerScripts chamado CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Versão com erro:
--   local coins = player.leaderstats.Coins
-- O servidor cria o leaderstats, e ele pode chegar a este cliente depois que este
-- script começa. Aí o Output mostra:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- o servidor faz Coins como IntValue

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

Isto espera um script de servidor que crie o leaderstats com um IntValue chamado Coins, como o do guia de leaderboard.

attempt to call a nil value

O código colocou parênteses depois de algo que é nil, então não havia função para rodar. As causas comuns:

  • O nome da função está escrito errado ou as maiúsculas são diferentes. Um módulo define Format.clock e quem chama escreve Format.Clock(95).
  • Uma local function é chamada em uma linha acima da definição dela. Naquele ponto o nome ainda não existe, então suba a definição.
  • Um ModuleScript nunca adiciona a função à tabela que ele retorna.

Duas mensagens parecidas apontam para o mesmo tipo de erro. Chamar com dois pontos um método que não existe em uma tabela dá attempt to call missing method 'Kill' of table. Um método escrito errado em um objeto do Roblox, como part:Destory(), dá Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

O Luau tentou fazer uma conta (add, sub, mul, div e outras) em que um dos lados não era um número. Os nomes de tipo no fim da mensagem dizem qual é o seu caso:

  • on Instance and number: você fez conta com um value object em vez do número dele. coins + 10 deveria ser coins.Value + 10.
  • on nil and number: uma variável ou entrada de tabela nunca foi definida. Dê um valor inicial a ela, ou escreva (x or 0) onde um valor faltando realmente significa zero.
  • on string and number: texto que não é número, muitas vezes vindo de uma TextBox. Converta com tonumber(text) e confira se o resultado não é nil. Texto que contém um número, como "5", é convertido automaticamente.

Comparações falham do mesmo jeito, com attempt to compare nil < number. O Luau reescreve a > b como b < a, então a ordem na mensagem pode ser a inversa do seu código.

Script em ServerScriptService chamado 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
		-- Diz por que nada aconteceu, em vez de falhar em silêncio
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Versão com erro:
	--   coins = coins + amount
	-- coins é o objeto IntValue, não o número dele, então o Output mostra:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- A cada minuto, dá algumas moedas a cada jogador no servidor
while true do
	task.wait(INTERVAL_SECONDS)
	for _, player in Players:GetPlayers() do
		addCoins(player, REWARD)
	end
end

attempt to concatenate string with nil

O operador .. só junta strings e números. Juntar nil falha, e juntar um objeto também: "Hi " .. player dá attempt to concatenate string with Instance. Use player.Name, envolva o valor em tostring(), ou use interpolação de string com crases, print(`Coins: {coins}`), que imprime nil em vez de parar o script.

Expected 'end' e outros erros de sintaxe

Mensagens que começam com Expected são erros de sintaxe: o código não é Luau válido, então o Roblox não consegue compilar e nenhuma linha daquele script roda, nem as linhas acima do erro. O Script Editor sublinha esses erros em vermelho enquanto você digita, então dá para corrigir antes de apertar Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: uma function, if, for ou while que começa na linha 3 não tem o end correspondente. O número de linha antes da mensagem muitas vezes é o fim do arquivo, então olhe a linha citada entre parênteses.
  • Expected 'then' when parsing if statement, got '=': um = sozinho em uma condição. Comparações usam ==.
  • Expected ')' (to close '(' at line 1), got 'local': um parêntese nunca foi fechado.
  • Expected <eof>, got 'end': um end a mais.

Uma indentação consistente deixa um end faltando ou sobrando fácil de ver, porque cada bloco fica alinhado com o end que o fecha.

Requested module experienced an error while loading

O primeiro require() de um ModuleScript roda o código dele. Se o módulo dá erro enquanto roda, o script que fez o require recebe esta mensagem. O problema real é o erro do próprio módulo, uma ou duas linhas acima no Output: corrija esse. Duas mensagens parecidas:

  • Module code did not return exactly one value: o módulo não termina com um return. Um ModuleScript precisa retornar um valor que não seja nil, normalmente a tabela dele.
  • Requested module was required recursively: dois módulos fazem require um do outro. Leve a parte que eles compartilham para um terceiro módulo que os dois carregam.
ModuleScript em ReplicatedStorage chamado Format
local Format = {}

-- Transforma um número de segundos em minutos e segundos: 95 vira "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

-- O módulo precisa terminar retornando a tabela dele. Sem esta linha, todo
-- require dele falha com: Module code did not return exactly one value
return Format

Um script usa ele com local Format = require(ReplicatedStorage:WaitForChild("Format")) e depois Format.clock(95). Escrever Format.Clock(95) no lugar é o erro attempt to call a nil value.

Argument 1 missing or nil

Uma função do Roblox recebeu nil em um argumento de que ela precisa, e o número diz qual argumento. workspace:FindFirstChild(itemName) falha assim quando itemName é nil. O bug quase nunca está nesta linha. Ele está onde o valor deveria ter vindo: uma variável escrita errado, um atributo que nunca foi definido, ou um argumento de RemoteEvent que o cliente não mandou. Os argumentos de um RemoteEvent vêm do dispositivo do jogador, então o servidor deve conferi-los antes de usar. O guia de RemoteEvents mostra como.

FireServer can only be called from the client

RemoteEvents têm uma direção. Um LocalScript chama FireServer e um Script de servidor escuta com OnServerEvent. Um Script de servidor chama FireClient ou FireAllClients e os LocalScripts escutam com OnClientEvent. Chamar um método do lado errado dá este erro, ou o espelho dele, FireClient can only be called from the server. A correção normalmente é levar o código para o tipo certo de script: veja Script vs LocalScript vs ModuleScript (em inglês).

Erro 403 de data store no Studio

Chamadas de data store falham no Studio com o código de erro 403 (StudioAccessToApisNotAllowed) até você permitir. Publique o place, abra File, Experience Settings, Security, ligue Enable Studio Access to API Services e salve. O Studio passa a usar os mesmos data stores do jogo publicado, então a Roblox recomenda fazer isso em uma cópia de teste separada, não em um jogo que as pessoas já jogam. Envolva toda chamada de data store em pcall, porque essas chamadas podem falhar por motivos fora do seu código. O tutorial de DataStore mostra como salvar com segurança.

Quando um script roda sem erros, mas não faz nada

Um script silencioso quase sempre nunca rodou, ainda está esperando alguma coisa, ou rodou no lado errado. Antes de mudar qualquer código, faça a primeira linha dele ser print(script:GetFullName(), "started") e jogue. Se essa linha nunca aparece no Output, o problema é onde o script está ou como ele está configurado, não o que ele diz.

Por que um script pode não fazer nada sem dar erro
O que conferirO que dá erradoCorreção
Tipo e lugar do scriptUm LocalScript só roda se você colocar ele no StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack ou ReplicatedFirst (a partir dos containers Starter, ele roda como a cópia do jogador). Um colocado no Workspace, ServerScriptService ou ReplicatedStorage nunca roda. Um Script com o RunContext padrão só roda no Workspace ou no ServerScriptService.Mova ele, ou use o outro tipo de script. Código de interface e de controles vai em um LocalScript; regras do jogo vão em um Script no ServerScriptService.
EnabledUm script com a propriedade Enabled desmarcada não roda.Selecione ele e marque Enabled na janela Properties.
RunContextO RunContext de um Script decide onde ele roda. Legacy, o padrão, roda no servidor a partir do Workspace ou do ServerScriptService. Server roda no servidor; Client roda no dispositivo de cada jogador, por exemplo a partir do ReplicatedStorage.Defina de propósito. A documentação da Roblox sugere Scripts Client no ReplicatedStorage ou no ReplicatedFirst, e LocalScripts nos containers Starter.
O evento nunca disparaO Touched só dispara com movimento físico, precisa que pelo menos uma das duas parts não esteja ancorada, e precisa do CanTouch nas duas. O PlayerAdded não dispara para jogadores que já estavam no servidor quando você conectou. Um handler de RemoteEvent nunca roda se o outro lado nunca dispara o evento.Coloque um print dentro do handler para provar se ele roda, e depois corrija o que deveria disparar ele.
Código depois de um loop ou de uma esperaLinhas abaixo de um loop while true do nunca rodam, porque o loop nunca termina. Linhas abaixo de um WaitForChild que nunca acha o filho também nunca rodam.Conecte os eventos antes do loop, ou comece o loop com task.spawn. Dê um tempo limite às esperas.
Uma checagem que retorna em silêncioUma guarda como if not coins then return end para a função sem dizer nada quando o objeto está faltando.Adicione um warn com os detalhes antes do return.
Filtros do OutputO Output pode ser filtrado por tipo de mensagem, por Client ou Server, e por texto. Um filtro esquecido pode esconder o erro que você está procurando.Limpe os filtros e a caixa de busca.
Só você vêUm LocalScript fez a mudança, então só aquele jogador vê. O servidor e os outros jogadores não.Faça a mudança no servidor. Veja onde os scripts rodam (em inglês).

O caso do PlayerAdded pega muita gente, porque em um teste no Studio você entra quase assim que o servidor começa. Se qualquer coisa acima da linha do Connect espera, como um WaitForChild, um task.wait ou o require de um módulo que espera, você pode entrar antes de a conexão existir. Cuide tanto dos jogadores novos quanto dos que já estão lá:

Script em ServerScriptService chamado Welcome
local Players = game:GetService("Players")

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- Jogadores que já estavam aqui quando a linha acima rodou nunca disparam
-- o PlayerAdded para este script, então cuida deles agora
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Ferramentas de depuração no Roblox Studio

print escreve uma linha no Output e warn escreve um aviso. Eles são o jeito mais rápido de responder "isto rodou?" e "que valor é este?". Um print(x) sozinho é difícil de achar depois, então adicione um rótulo e os detalhes que importam. typeof(x) mostra se um valor é um number, uma string, uma Instance ou nil, e GetFullName() mostra exatamente qual objeto você tem.

Script em ServerScriptService chamado ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- mude para false quando terminar
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 e ClassName mostram o que um valor realmente é
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

A caixa de busca do Output filtra por texto, então uma tag consistente como [ShopServer] deixa você mostrar só as linhas daquele sistema. Se você precisa saber como o código chegou a uma linha, debug.traceback() retorna a pilha de chamadas atual como uma string.

Breakpoints e execução passo a passo

Um breakpoint pausa o jogo em uma linha para você inspecionar tudo naquele momento. No Script Editor, clique na margem logo à direita do número de uma linha (aparece um círculo vermelho) e comece um teste. Quando aquela linha é alcançada, o jogo pausa com uma seta amarela na próxima linha a rodar. Os botões de passo então andam pelo código:

  • Step Over (F10) roda a linha atual e para na próxima.
  • Step Into (F11) entra na função chamada nesta linha.
  • Step Out (Shift+F11) termina a função atual e para de volta em quem a chamou.
  • Resume Scripts continua até o próximo breakpoint.

Clique com o botão direito na margem para mais dois tipos úteis. Um conditional breakpoint só pausa quando uma expressão como amount < 0 é verdadeira. Um logpoint imprime uma mensagem no Output sem pausar, então você registra um valor sem editar o script.

Watch e Call Stack

Com o jogo pausado, passe o mouse sobre uma variável no Script Editor para ver o valor dela. A janela Watch lista toda variável em escopo na aba Variables, e na aba My Watches você pode digitar qualquer expressão, como coins.Value + amount, para ver o valor atual dela. A janela Call Stack mostra qual função chamou qual até chegar à linha pausada. As duas abrem pela aba Script ou pelo menu Window.

Script Analysis e modo strict

O Script Editor sublinha problemas enquanto você digita, e a janela Script Analysis, aberta com o botão Analysis na aba Script, lista os erros e avisos de todos os seus scripts. Ela pega erros de sintaxe e nomes desconhecidos antes de você apertar Play. Colocar --!strict como primeira linha de um script liga a checagem de tipos strict do Luau, que também aponta propriedades escritas errado, argumentos do tipo errado e valores que podem ser nil. Mas ela não enxerga o jogo rodando: uma part faltando no Workspace só aparece no Output.

A command bar

A command bar (na aba Script, ou Ctrl+9, ⌘9 no Mac) roda Luau na hora. Com o jogo rodando, ela é um jeito rápido de fazer uma pergunta: print(workspace:FindFirstChild("Bridge")) diz se a part existe, e print(#game:GetService("Players"):GetPlayers()) conta os jogadores. No modo de edição, o código da command bar muda o seu place de verdade, então tome cuidado com qualquer coisa que mova ou apague objetos.

Developer Console para jogos publicados

O Output do Studio só cobre o Studio. Em um jogo publicado, aperte F9 ou digite /console no chat para abrir o Developer Console. O Log dele mostra a saída do seu próprio dispositivo, e a saída do servidor se você é dono do jogo ou membro de um grupo com permissão para editá-lo.

O Assistant que já vem no Roblox também pode ajudar com uma mensagem específica: o próprio guia da Roblox sugere colar um erro do Output e pedir ao Assistant para diagnosticar. Se o Assistant para de responder ou diz que você chegou a um limite, veja limites e erros do Assistant.

Corrigindo erros com o RoCode

O RoCode é um agente de IA independente para Roblox Studio: você descreve o problema em um chat na web, e um plugin do Studio lê e edita o place que você tem aberto. Para erros, ele pode assumir os passos de leitura da rotina acima, trabalhando a partir de um teste que você já rodou.

Você digita

Apertei Play e clicar no botão da loja não faz nada. O Output mostra attempt to index nil with 'Coins'. Ache a causa e corrija.

O RoCode faz
  • Lê o Output do Studio com a ferramenta Check Output, incluindo as linhas Server e Client do seu último teste, mesmo depois de você apertar Stop
  • Abre o script citado no erro com Read Script e lê o código em volta daquela linha, e pode usar Search Scripts para achar onde o valor que falta deveria ter sido criado
  • Faz uma edição pontual com Edit Script, um buscar e substituir exato naquele script, e depois roda Check Script, que compila o script dentro do Studio (ele não checa tipos, não faz lint e não roda o seu código)
  • Envia as mudanças ao Studio em lotes, e cada lote é um ponto de desfazer no histórico do Studio

Aperte Play de novo e clique no botão da loja para confirmar a correção você mesmo: com o plugin 3.9 ou mais recente o RoCode pode rodar um teste curto e ler os erros, e com o plugin 3.9.15 ou mais recente o personagem de teste dele pode clicar em botões na tela, mas ele confere só o que escolheu testar, e uma checagem de compilação não diz se a lógica do jogo está certa. Ler erros faz parte de toda construção: o ciclo de construir, revisar e testar um jogo inteiro repete essa checagem depois de cada sistema. Como o RoCode se conecta ao Studio.

Perguntas frequentes

Por que meu script do Roblox não funciona se não aparece nenhum erro?

Normalmente o script nunca rodou (tipo de script ou container errado, ou Enabled desligado), ainda está esperando alguma coisa, ou o evento que ele escuta nunca dispara. Um print na primeira linha dele diz qual é o caso. Veja a lista acima.

O que significa "attempt to index nil" no Roblox?

O valor antes do ponto ou dos dois pontos era nil, então o Roblox não conseguiu olhar dentro dele. Na linha player.Character.Humanoid, attempt to index nil with 'Humanoid' quer dizer que player.Character era nil: faltando, ou ainda não carregado. Confira um valor com if antes de usar, e em um LocalScript espere com WaitForChild os objetos que o servidor cria. Mais sobre as causas.

O que significa "infinite yield possible" no Roblox?

O WaitForChild esperou mais de 5 segundos por um filho que não apareceu, e continua esperando. Muitas vezes o nome ou o pai está errado, ou nada cria o objeto. Mais sobre as causas.

Por que a janela Output está vazia ou não aparece?

Abra pelo menu Window ou pela aba Script. Se ela está aberta mas continua vazia durante um teste, limpe os filtros e a caixa de busca, e depois confira se os scripts que deveriam imprimir estão rodando.

Existe um verificador de erros de script no Roblox?

Sim, dentro do Studio: o Script Editor sublinha problemas enquanto você digita e a janela Script Analysis lista todos. Eles acham erros de sintaxe e de tipo, não objetos faltando nem lógica de jogo errada, que só aparecem quando o código roda.

Devo colocar meu código em um pcall para parar os erros?

Só chamadas que podem falhar por motivos fora do seu código, como pedidos de data store, HTTP ou MarketplaceService. Envolver um erro de nil em pcall esconde a mensagem, e o recurso continua sem funcionar.

Como ver erros de script em um jogo publicado?

Aperte F9 no jogo, ou digite /console no chat, para abrir o Developer Console. Ele mostra os erros do seu dispositivo, e os do servidor se você é dono do jogo ou membro de um grupo que pode editá-lo.

Fontes e leitura extra

Como o código foi verificado: todo script desta página passa no verificador de tipos estrito do Luau com as definições da API do Roblox (luau-lsp, 14 de novembro de 2026). A verificação de tipos pega APIs com nome errado e tipos incorretos, não a lógica do jogo, então teste no Studio antes de publicar.

Teste o RoCode no seu próprio jogo.

Créditos grátis todo dia, sem cartão. Instale o plugin, descreva o recurso e confira o que aparece no Studio.