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
Enableddele 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
Abra o Output e leia um 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.
- Abra o Output pelo menu Window do Studio, ou pelo botão dele na aba Script.
- Limpe as mensagens antigas com Ctrl+K (⌘K no Mac) para ver só este teste.
- Aperte Play (F5) e faça a coisa que quebra.
- 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.
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.
- Reproduza. Limpe o Output, aperte Play e faça exatamente o que quebra. Anote o que você esperava e o que aconteceu no lugar.
- 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.
- 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. - Confira o valor em vez de supor. Adicione um
printlogo 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. - Volte atrás dele. Se o valor está errado, ache onde ele foi definido: um
FindFirstChildque não achou nada, uma função que não retornou nada, um argumento que quem chamou nunca mandou. - 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
pcallpara calar o erro: isso esconde o bug em vez de corrigir. - 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.
- 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.
| O Output diz | O que significa | Correçã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 value | Você 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 number | Conta com algo que não é um número. | Use .Value em value objects e tonumber em texto. |
attempt to concatenate string with nil | O .. 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 loading | O próprio ModuleScript deu erro enquanto rodava. | Corrija o erro do módulo, que aparece logo acima no Output. |
Argument 1 missing or nil | Uma 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 client | Um RemoteEvent foi disparado do lado errado. | O servidor usa FireClient; LocalScripts usam FireServer. |
Erro de data store 403, StudioAccessToApisNotAllowed | O 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,FindFirstChildOfClassouFindFirstAncestornão acharam nada, porque o nome é diferente ou o objeto ainda não existe.Players.LocalPlayerfoi 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 oplayerque oPlayerAddedou um handler de RemoteEvent te dá.player.Characterfoi 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.
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 chamadaleaderstats. - 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.
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, ehumanoidnão éHumanoid. - Os nomes de propriedades usam a grafia americana.
part.Colourfalha comColour 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
WaitForChildali.
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.clocke quem chama escreveFormat.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 + 10deveria sercoins.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 comtonumber(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.
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>: umafunction,if,forouwhileque começa na linha 3 não tem oendcorrespondente. 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': umenda 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 umreturn. 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.
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.
| O que conferir | O que dá errado | Correção |
|---|---|---|
| Tipo e lugar do script | Um 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. |
| Enabled | Um script com a propriedade Enabled desmarcada não roda. | Selecione ele e marque Enabled na janela Properties. |
| RunContext | O 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 dispara | O 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 espera | Linhas 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êncio | Uma 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 Output | O 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á:
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 e warn, com contexto
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.
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.
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.
- 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
- Roblox Creator Docs: Output (em inglês). onde fica o Output, os filtros e as opções de exibição dele
- Roblox Creator Docs: Debugging (em inglês). breakpoints, execução passo a passo, Watch, Call Stack, command bar e Developer Console
- Roblox Creator Docs: Script Editor (em inglês). a janela Script Analysis
- Roblox Creator Docs: Studio interface (em inglês). onde o Output e a command bar abrem
- Roblox Creator Docs: Script types and locations (em inglês). onde cada tipo de script roda, e o RunContext
- Roblox Creator Docs: Studio testing modes (em inglês). Play, as visões Client e Server, e testes Server & Clients
- Roblox Engine API: Instance (em inglês). WaitForChild, o tempo limite dele e o aviso de 5 segundos
- Roblox Creator Docs: Reuse code (em inglês). ModuleScripts e requires recursivos
- Roblox Creator Docs: Data store error codes and limits (em inglês). erro 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs: Data stores (em inglês). ligar o acesso do Studio, e usar uma cópia de teste separada
- Roblox Engine API: BasePart (em inglês). quando o Touched dispara, e o CanTouch
- Roblox Creator Docs: Type checking (em inglês). modo strict
- Roblox Creator Docs: Developer Console (em inglês). quem pode ver a saída do servidor em um jogo publicado
- Roblox Creator Docs: Build your first game with Assistant (em inglês). colar um erro do Output para o Assistant diagnosticar
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.