Guía · Depuración

Cómo arreglar errores de scripts en Roblox Studio

Cuando un script de Roblox se rompe, Studio casi siempre dice dónde y por qué en la ventana Output. Esta guía te enseña a leer ese mensaje, qué significan los errores más comunes y cómo arreglar cada uno, qué revisar cuando un script falla sin ningún error, y una rutina que encuentra la causa en vez de adivinarla.

Actualizado el 14 de noviembre de 202622 min de lecturaEscrito por

La respuesta corta

Abre la ventana Output desde el menú Window o la pestaña Script, pulsa Play y haz clic en el primer error rojo. Studio abre el script en la línea que falla. El mensaje dice qué salió mal ahí: attempt to index nil with 'Humanoid' significa que el valor justo antes de .Humanoid era nil. Arregla el motivo por el que falta ese valor y vuelve a jugar.

  • Empieza por el primer error de la lista. Los errores que salen más abajo muchas veces son consecuencia de ese.
  • Los errores comunes al ejecutar se reducen a tres causas: un valor que es nil, un nombre mal escrito o que todavía no ha cargado, o código que corre en el lado equivocado (servidor o cliente).
  • Si no hay ningún error, casi siempre el código nunca se ejecutó. Revisa el tipo de script, dónde está en el Explorer, su propiedad Enabled y si el evento que espera llega a dispararse.
  • Para ver qué es de verdad un valor en una línea, imprímelo con una etiqueta o pausa en esa línea con un breakpoint.
En esta página
  1. Leer Output
  2. Rutina de depuración
  3. Errores comunes
  4. Sin errores, no pasa nada
  5. Herramientas de depuración
  6. Con RoCode
  7. Preguntas frecuentes
  8. Fuentes y lecturas

Abre Output y lee un error

IlustraciónEl ejemplo del kill brick de la guía, acelerado: la línea rota da error, y después de Stop, el arreglo y una nueva prueba, la parte cae sin error.

La ventana Output es donde Roblox muestra los errores de los scripts, las advertencias del motor y todo lo que imprime tu código. No siempre está abierta, así que ábrela antes de probar. Si nunca has ejecutado un script, la guía de programación para principiantes empieza abriendo Output e imprimiendo una primera línea desde un script.

  1. Abre Output desde el menú Window de Studio, o con su botón en la pestaña Script.
  2. Borra los mensajes viejos con Ctrl+K (⌘K en Mac) para ver solo esta prueba.
  3. Pulsa Play (F5) y haz lo que provoca el fallo.
  4. Busca la primera línea roja. Los errores son rojos. Las advertencias, como Infinite yield possible, salen en naranja.

Un error de ejecución en Output se ve así. Según las opciones de visualización de Output, cada línea también puede llevar la hora, una etiqueta Client o Server y el nombre del script.

Output (ejemplo)
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 es dónde está el script en el Explorer: un script llamado CoinPad dentro de ServerScriptService.
  • :14 es la línea que falló.
  • El mensaje después del número de línea dice qué salió mal. La lista de errores comunes de abajo explica cada uno.
  • El stack, entre Stack Begin y Stack End, lista las llamadas que llevaron hasta ahí, de la más reciente a la más antigua: la línea 14 dentro de la función award, que se llamó desde la línea 27.

Haz clic en el error rojo y Studio abre ese script con el cursor en la línea que falla. En una prueba en solitario, los mensajes del servidor y los de tu propio cliente comparten un solo Output, marcados en verde para el servidor y en azul para el cliente. Los filtros de arriba lo reducen por tipo de mensaje (Error, Warning), por contexto (Client, Server) o por texto.

Una rutina de depuración que sirve para cualquier script

Adivinar, y cambiar varias cosas a la vez, es la forma lenta de arreglar un script. Este orden va acotando el problema paso a paso, haya o no un mensaje de error.

  1. Reprodúcelo. Borra Output, pulsa Play y haz exactamente lo que lo rompe. Anota qué esperabas y qué pasó en su lugar.
  2. Toma el primer error. Lee la primera línea roja nueva: la ruta del script, el número de línea y el mensaje. Si no hay error, ve a scripts que corren sin errores.
  3. Ve a la línea. Haz clic en el error. Lee la línea entera y pregúntate qué valor de ella podría ser nil, estar mal escrito o ser del tipo equivocado.
  4. Comprueba el valor en vez de suponerlo. Añade un print justo encima de la línea, o pon un breakpoint en ella y lee los valores en la ventana Watch. typeof(x) te dice si tienes un número, un string, una Instance o nil.
  5. Síguelo hacia atrás. Si el valor está mal, busca dónde se asignó: un FindFirstChild que no encontró nada, una función que no devolvió nada, un argumento que quien llama nunca envió.
  6. Arregla la causa, un cambio cada vez. Corrige el nombre, espera al objeto o mueve el código al lado correcto, y vuelve a jugar. No envuelvas la línea en pcall para silenciarla: eso esconde el bug en vez de arreglarlo.
  7. Confírmalo. Repite el paso 1. El error debería desaparecer y la función debería hacer lo que esperabas. Para todo lo que tenga que ver con otros jugadores, prueba también con Server & Clients y dos clientes.
  8. Limpia. Quita o apaga tus prints de depuración para que el siguiente problema sea fácil de ver.

Errores comunes de scripts en Roblox y cómo arreglarlos

Cada mensaje sigue un patrón fijo con tus propios nombres dentro, así que el texto mismo es la mejor pista. Los nombres entre comillas de abajo, como 'Health' o "Workspace", son ejemplos.

Errores comunes de Output. Elige un mensaje para ver la explicación completa.
Output diceQué significaArreglo habitual
attempt to index nil with 'Health'El valor antes de .Health era nil.Averigua por qué es nil y compruébalo con if antes de usarlo.
Infinite yield possible on 'Players.YourName:WaitForChild("Character")'WaitForChild lleva 5 segundos esperando y el objeto no ha aparecido.Corrige el nombre o la ruta, asegúrate de que algo crea el objeto, o añade un tiempo límite.
Bridge is not a valid member of Workspace "Workspace"Ahí no existe ahora mismo ningún hijo ni propiedad con ese nombre exacto.Copia la escritura y las mayúsculas del Explorer. En el cliente, usa WaitForChild.
attempt to call a nil valueLlamaste a algo que no es una función.Revisa el nombre de la función, y que esté definida encima de la llamada.
attempt to perform arithmetic (add) on Instance and numberUna operación matemática con algo que no es un número.Usa .Value en los objetos de valor, y tonumber en el texto.
attempt to concatenate string with nil.. intentó unir texto con nil o con un objeto.Usa tostring(), .Name o interpolación de strings.
Expected 'end' (to close 'function' at line 3), got <eof>Un error de sintaxis. No se ejecuta nada del script.Arregla el subrayado rojo en el Script Editor.
Requested module experienced an error while loadingEl propio ModuleScript dio error al ejecutarse.Arregla el error del módulo, que sale justo encima en Output.
Argument 1 missing or nilUna función de Roblox recibió nil donde necesita un valor.Sigue de dónde debería haber salido ese argumento.
FireServer can only be called from the clientSe disparó un RemoteEvent desde el lado equivocado.El servidor usa FireClient; los LocalScripts usan FireServer.
Error de data store 403, StudioAccessToApisNotAllowedStudio no tiene permiso para usar data stores en este juego.Publica y luego activa Studio Access to API Services.

Cada mensaje de aquí, y más, tiene su propia página con cada causa, el código que lo provoca y el arreglo: consulta Roblox Studio error messages (en inglés), por ejemplo attempt to index nil, Infinite yield possible e is not a valid member of.

attempt to index nil with 'X'

Indexar significa leer algo con un punto o con corchetes: part.Position, player.Character, list[1]. Este error dice que lo que estaba a la izquierda era nil, y el nombre entre comillas es lo que intentaste leer de ello. Así que en la línea player.Character.Humanoid, attempt to index nil with 'Humanoid' significa que player.Character era nil. Cuando la clave es un número, el mensaje termina en with number.

Los motivos habituales por los que el valor era nil:

  • FindFirstChild, FindFirstChildOfClass o FindFirstAncestor no encontró nada, porque el nombre es distinto o el objeto todavía no existe.
  • Se usó Players.LocalPlayer en un Script del servidor. Solo existe en los LocalScripts y en los ModuleScripts que estos cargan con require; en el servidor siempre es nil. Usa en su lugar el player que te da PlayerAdded o un manejador de RemoteEvent.
  • Se leyó player.Character antes de que apareciera el personaje, o mientras reaparecía.
  • Una entrada de una tabla nunca se asignó, como playerData[player] antes de que cargaran los datos de ese jugador, o una función que llamaste no devolvió nada.

Un kill brick es el caso clásico. La versión rota supone que todo lo que toca la parte pertenece a un personaje, y eso no es verdad para tools tiradas, partes sueltas o accesorios.

Script en una Part en Workspace llamado KillBrick
local part = script.Parent :: BasePart

part.Touched:Connect(function(hit: BasePart)
	-- Versión rota:
	--   hit.Parent:FindFirstChild("Humanoid").Health = 0
	-- Cuando la parte que toca no es una parte del cuerpo de un personaje, FindFirstChild
	-- devuelve nil y Output muestra:
	--   attempt to index nil with 'Health'

	-- Arreglado: comprueba cada paso antes de usarlo
	local model = hit:FindFirstAncestorOfClass("Model")
	local humanoid = model and model:FindFirstChildOfClass("Humanoid")
	if humanoid then
		humanoid.Health = 0
	end
end)

Si escribes hit.Parent.Humanoid, falla con otro mensaje, Humanoid is not a valid member of ..., que se explica más abajo. FindFirstAncestorOfClass("Model") también encuentra al personaje cuando la parte que toca está dentro de un accesorio o de una tool que el personaje lleva en la mano, así que una tool en la mano que toca el bloque también cuenta.

El patrón que arregla este error: obtén el valor, compruébalo y solo entonces úsalo. En el servidor, FindFirstChild más una comprobación con if sirve para cosas que de verdad pueden faltar. En un LocalScript, usa WaitForChild para las cosas que crea el servidor, porque pueden llegar después de que empiece tu script.

Infinite yield possible on ...

WaitForChild("Name") pausa el script hasta que existe un hijo con ese nombre. Si lleva más de 5 segundos esperando y no le diste un tiempo límite, Roblox imprime esta advertencia. Es una advertencia, no un error: el script sigue esperando, y nada de lo que va después de esa línea se ejecuta hasta que aparece el hijo, que puede ser nunca. Las causas habituales:

  • El nombre o el padre está mal. WaitForChild("leaderStats") nunca coincide con una carpeta llamada leaderstats.
  • Nada crea el objeto: el script del servidor que lo crea está desactivado, en el lugar equivocado, o dio un error antes. Busca un error anterior en Output.
  • Un LocalScript está esperando algo de ServerStorage o ServerScriptService. Su contenido nunca se envía a los jugadores, así que la espera nunca termina.
  • Estás esperando una propiedad, no un hijo. player:WaitForChild("Character") es el caso típico: Character es una propiedad de Player, no un objeto dentro de él.
  • El streaming de instancias (Workspace.StreamingEnabled) está activado, y la parte está demasiado lejos del jugador como para haberse enviado ya a ese cliente.
LocalScript en StarterPlayerScripts llamado DeathMessage
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Versión rota:
--   local character = player:WaitForChild("Character")
-- Character es una propiedad de Player, no un hijo, así que Output avisa:
--   Infinite yield possible on 'Players.YourName:WaitForChild("Character")'

local function onCharacterAdded(character: Model)
	-- Con un tiempo límite, WaitForChild devuelve nil en vez de esperar para siempre
	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

-- Atiende al personaje que puede existir ya, y luego a cada reaparición
local current = player.Character
if current then
	onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)

Un número como segundo argumento de WaitForChild es un tiempo límite en segundos. Así el script puede avisar del problema con warn y parar limpiamente, en vez de quedarse colgado sin decir nada.

X is not a valid member of Y

Usaste un punto para llegar a un hijo o propiedad que no existe en ese momento, como workspace.Bridge cuando Workspace no tiene ninguna parte llamada Bridge. El mensaje nombra lo que pediste, y luego la clase y la ruta completa del objeto donde buscó. Revisa tres cosas:

  • La escritura y las mayúsculas coinciden exactamente con el Explorer. La carpeta es leaderstats, todo en minúsculas, y humanoid no es Humanoid.
  • Los nombres de las propiedades usan la ortografía estadounidense. part.Colour falla con Colour is not a valid member of Part "Workspace.Part"; la propiedad es Color.
  • El objeto ya cargó. En el cliente, los objetos que crea el servidor pueden llegar después de que empiece tu LocalScript, así que ahí usa WaitForChild.
LocalScript en StarterPlayerScripts llamado CoinsWatcher
local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Versión rota:
--   local coins = player.leaderstats.Coins
-- El servidor crea leaderstats, y puede llegar a este cliente después de que
-- empiece este script. Entonces Output muestra:
--   leaderstats is not a valid member of Player "Players.YourName"

local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- el servidor crea Coins como IntValue

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

Esto espera un script del servidor que cree leaderstats con un IntValue llamado Coins, como el de la guía del leaderboard.

attempt to call a nil value

El código puso paréntesis después de algo que es nil, así que no había ninguna función que ejecutar. Las causas habituales:

  • El nombre de la función está mal escrito o sus mayúsculas no coinciden. Un módulo define Format.clock y quien lo llama escribe Format.Clock(95).
  • Una local function se llama en una línea que está encima de su definición. En ese punto el nombre todavía no existe, así que sube la definición.
  • Un ModuleScript nunca añade la función a la tabla que devuelve.

Dos mensajes parecidos apuntan al mismo tipo de error. Llamar con dos puntos a un método que no existe en una tabla da attempt to call missing method 'Kill' of table. Un método mal escrito en un objeto de Roblox, como part:Destory(), da Destory is not a valid member of Part "Workspace.Part".

attempt to perform arithmetic (add) on ...

Luau intentó hacer una operación matemática (add, sub, mul, div, etc.) donde uno de los lados no era un número. Los nombres de tipo al final del mensaje te dicen qué caso tienes:

  • on Instance and number: hiciste la operación con un objeto de valor en vez de con su número. coins + 10 debería ser coins.Value + 10.
  • on nil and number: una variable o una entrada de tabla nunca se asignó. Dale un valor inicial, o escribe (x or 0) donde un valor que falta de verdad significa cero.
  • on string and number: texto que no es un número, muchas veces de un TextBox. Conviértelo con tonumber(text) y comprueba que el resultado no sea nil. El texto que contiene un número, como "5", se convierte automáticamente.

Las comparaciones fallan igual, con attempt to compare nil < number. Luau reescribe a > b como b < a, así que el orden del mensaje puede ser el contrario al de tu código.

Script en ServerScriptService llamado 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
		-- Di por qué no pasó nada, en vez de fallar en silencio
		warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
		return
	end

	-- Versión rota:
	--   coins = coins + amount
	-- coins es el objeto IntValue, no su número, así que Output muestra:
	--   attempt to perform arithmetic (add) on Instance and number
	coins.Value += amount
end

-- Cada minuto, da unas monedas a cada jugador del 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

El operador .. solo une strings y números. Unir nil falla, y unir un objeto también: "Hi " .. player da attempt to concatenate string with Instance. Usa player.Name, envuelve el valor en tostring(), o usa interpolación de strings con comillas invertidas, print(`Coins: {coins}`), que imprime nil en vez de detener el script.

Expected 'end' y otros errores de sintaxis

Los mensajes que empiezan por Expected son errores de sintaxis: el código no es Luau válido, así que Roblox no puede compilarlo y no se ejecuta ninguna línea de ese script, ni siquiera las que están encima del error. El Script Editor los subraya en rojo mientras escribes, así que puedes arreglarlos antes de pulsar Play.

  • Expected 'end' (to close 'function' at line 3), got <eof>: un function, if, for o while que empieza en la línea 3 no tiene su end. El número de línea antes del mensaje muchas veces es el final del archivo, así que mira la línea que se nombra entre paréntesis.
  • Expected 'then' when parsing if statement, got '=': un solo = en una condición. Las comparaciones usan ==.
  • Expected ')' (to close '(' at line 1), got 'local': un paréntesis que nunca se cerró.
  • Expected <eof>, got 'end': un end de más.

Indentar de forma constante hace que un end que falta o que sobra se vea fácil, porque cada bloque queda alineado con el end que lo cierra.

Requested module experienced an error while loading

El primer require() de un ModuleScript ejecuta su código. Si el módulo da un error mientras corre, el script que lo cargó recibe este mensaje. El problema real es el error del propio módulo, una o dos líneas más arriba en Output: arregla ese. Dos mensajes relacionados:

  • Module code did not return exactly one value: el módulo no termina con un return. Un ModuleScript debe devolver un valor que no sea nil, normalmente su tabla.
  • Requested module was required recursively: dos módulos se cargan el uno al otro. Pasa la parte que comparten a un tercer módulo que carguen los dos.
ModuleScript en ReplicatedStorage llamado Format
local Format = {}

-- Convierte un número de segundos en minutos y segundos: 95 pasa a ser "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

-- El módulo debe terminar devolviendo su tabla. Sin esta línea, cada
-- require del módulo falla con: Module code did not return exactly one value
return Format

Un script lo usa con local Format = require(ReplicatedStorage:WaitForChild("Format")) y luego Format.clock(95). Escribir Format.Clock(95) en su lugar es el error attempt to call a nil value.

Argument 1 missing or nil

Una función de Roblox recibió nil en un argumento que necesita, y el número dice qué argumento es. workspace:FindFirstChild(itemName) falla así cuando itemName es nil. El bug casi nunca está en esta línea. Está donde debería haber salido el valor: una variable mal escrita, un atributo que nunca se puso, o un argumento de RemoteEvent que el cliente no envió. Los argumentos de un RemoteEvent vienen del dispositivo del jugador, así que el servidor debería comprobarlos antes de usarlos. La guía de RemoteEvents muestra cómo.

FireServer can only be called from the client

Los RemoteEvents tienen una dirección. Un LocalScript llama a FireServer y un Script del servidor escucha con OnServerEvent. Un Script del servidor llama a FireClient o FireAllClients y los LocalScripts escuchan con OnClientEvent. Llamar a un método desde el lado equivocado da este error, o su reflejo, FireClient can only be called from the server. El arreglo suele ser mover el código al tipo de script correcto: consulta Script vs LocalScript vs ModuleScript (en inglés).

Error 403 de data store en Studio

Las llamadas a data stores fallan en Studio con el código de error 403 (StudioAccessToApisNotAllowed) hasta que las permites. Publica el place, abre File, Experience Settings, Security, activa Enable Studio Access to API Services y guarda. Desde ahí Studio usa los mismos data stores que el juego en vivo, así que Roblox recomienda hacerlo en una copia de prueba aparte, no en un juego en el que ya juega gente. Envuelve cada llamada a data store en pcall, porque estas llamadas pueden fallar por motivos que no dependen de tu código. El tutorial de DataStore explica cómo guardar de forma segura.

Cuando un script corre sin errores pero no hace nada

Un script que no dice nada casi siempre nunca se ejecutó, sigue esperando algo, o corrió en el lado equivocado. Antes de cambiar el código, pon como primera línea print(script:GetFullName(), "started") y juega. Si esa línea nunca sale en Output, el problema está en dónde está el script o en cómo está configurado, no en lo que dice.

Por qué un script puede no hacer nada sin dar error
RevisaQué fallaArreglo
Tipo de script y lugarUn LocalScript solo se ejecuta si lo pones en StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack o ReplicatedFirst (desde los contenedores Starter, se ejecuta como la copia del jugador). Uno puesto en Workspace, ServerScriptService o ReplicatedStorage nunca se ejecuta. Un Script con el RunContext por defecto solo se ejecuta en Workspace o ServerScriptService.Muévelo, o usa el otro tipo de script. El código de interfaz y de controles va en un LocalScript; las reglas del juego van en un Script en ServerScriptService.
EnabledUn script con la propiedad Enabled desmarcada no se ejecuta.Selecciónalo y marca Enabled en la ventana Properties.
RunContextEl RunContext de un Script decide dónde se ejecuta. Legacy, el valor por defecto, corre en el servidor desde Workspace o ServerScriptService. Server corre en el servidor; Client corre en el dispositivo de cada jugador, por ejemplo desde ReplicatedStorage.Ponlo a propósito. La documentación de Roblox sugiere Scripts con Client en ReplicatedStorage o ReplicatedFirst, y LocalScripts en los contenedores Starter.
El evento nunca se disparaTouched solo se dispara con movimiento físico, necesita que al menos una de las dos partes no esté anclada, y necesita CanTouch en las dos. PlayerAdded no se dispara para los jugadores que ya estaban en el servidor cuando lo conectaste. Un manejador de RemoteEvent nunca se ejecuta si el otro lado nunca dispara el evento.Pon un print dentro del manejador para comprobar si se ejecuta, y luego arregla lo que debería dispararlo.
Código después de un bucle o una esperaLas líneas debajo de un bucle while true do nunca se ejecutan, porque el bucle nunca termina. Las líneas debajo de un WaitForChild que nunca encuentra su hijo tampoco.Conecta los eventos antes del bucle, o empieza el bucle con task.spawn. Dale un tiempo límite a las esperas.
Una comprobación que sale sin avisarUna guarda como if not coins then return end detiene la función sin decir nada cuando falta el objeto.Añade un warn con los detalles antes del return.
Filtros de OutputOutput se puede filtrar por tipo de mensaje, por Client o Server, y por texto. Un filtro que se quedó puesto puede esconder el error que buscas.Quita los filtros y vacía el cuadro de búsqueda.
Solo lo ves túEl cambio lo hizo un LocalScript, así que solo lo ve ese jugador. El servidor y los demás jugadores no.Haz el cambio en el servidor. Consulta dónde se ejecutan los scripts (en inglés).

El caso de PlayerAdded le pasa a mucha gente, porque en una prueba de Studio entras casi en cuanto arranca el servidor. Si algo encima de la línea Connect espera, como un WaitForChild, un task.wait o un require de un módulo que espera, puedes entrar antes de que exista la conexión. Atiende tanto a los jugadores nuevos como a los que ya están:

Script en ServerScriptService llamado Welcome
local Players = game:GetService("Players")

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

Players.PlayerAdded:Connect(onPlayerAdded)

-- Los jugadores que ya estaban aquí cuando se ejecutó la línea de arriba nunca disparan
-- PlayerAdded para este script, así que atiéndelos ahora
for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAdded, player)
end

Herramientas de depuración en Roblox Studio

print escribe una línea en Output y warn escribe una advertencia. Son la forma más rápida de responder "¿se ejecutó esto?" y "¿qué vale esto?". Un print(x) a secas es difícil de encontrar después, así que añade una etiqueta y los detalles que importan. typeof(x) muestra si un valor es un número, un string, una Instance o nil, y GetFullName() muestra exactamente qué objeto tienes.

Script en ServerScriptService llamado ShopDebug
local Players = game:GetService("Players")

local DEBUG = true -- ponlo en false cuando termines
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 y ClassName muestran qué es de verdad un valor
	debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)

El cuadro de búsqueda de Output filtra por texto, así que una etiqueta constante como [ShopServer] te deja ver solo las líneas de ese sistema. Si necesitas saber cómo llegó el código a una línea, debug.traceback() devuelve la pila de llamadas actual como string.

Breakpoints y ejecución paso a paso

Un breakpoint pausa el juego en una línea para que puedas revisar todo en ese momento. En el Script Editor, haz clic en el margen justo a la derecha del número de línea (aparece un círculo rojo) y empieza una prueba de juego. Cuando se llega a esa línea, el juego se pausa con una flecha amarilla en la siguiente línea que se va a ejecutar. Los botones de paso recorren entonces el código:

  • Step Over (F10) ejecuta la línea actual y se detiene en la siguiente.
  • Step Into (F11) entra en la función que se llama en esta línea.
  • Step Out (Shift+F11) termina la función actual y se detiene de vuelta en quien la llamó.
  • Resume Scripts sigue hasta el siguiente breakpoint.

Haz clic derecho en el margen para dos tipos más que son útiles. Un breakpoint condicional solo pausa cuando una expresión como amount < 0 es verdadera. Un logpoint imprime un mensaje en Output sin pausar, así que puedes registrar un valor sin editar el script.

Watch y Call Stack

Con el juego en pausa, pasa el ratón sobre una variable en el Script Editor para ver su valor. La ventana Watch lista todas las variables al alcance en su pestaña Variables, y en su pestaña My Watches puedes escribir cualquier expresión, como coins.Value + amount, para ver su valor actual. La ventana Call Stack muestra qué función llamó a cuál hasta llegar a la línea pausada. Las dos se abren desde la pestaña Script o el menú Window.

Script Analysis y modo estricto

El Script Editor subraya los problemas mientras escribes, y la ventana Script Analysis, que se abre con el botón Analysis de la pestaña Script, lista los errores y advertencias de todos tus scripts. Detecta errores de sintaxis y nombres desconocidos antes de que pulses Play. Poner --!strict como primera línea de un script activa la comprobación de tipos estricta de Luau, que además avisa de propiedades mal escritas, tipos de argumento equivocados y valores que podrían ser nil. Pero no puede ver el juego en marcha: una parte que falta en Workspace solo aparece en Output.

La barra de comandos

La barra de comandos (en la pestaña Script, o Ctrl+9, ⌘9 en Mac) ejecuta Luau al momento. Con el juego en marcha es una forma rápida de hacer una pregunta: print(workspace:FindFirstChild("Bridge")) te dice si la parte existe, y print(#game:GetService("Players"):GetPlayers()) cuenta los jugadores. En modo edición, el código de la barra de comandos cambia tu place de verdad, así que ten cuidado con todo lo que mueva o borre objetos.

Developer Console para juegos en vivo

El Output de Studio solo cubre Studio. En un juego en vivo, pulsa F9 o escribe /console en el chat para abrir la Developer Console. Su Log muestra la salida de tu propio dispositivo, y la del servidor si eres el dueño del juego o miembro de un grupo con permiso para editarlo.

El Assistant que trae Roblox también puede ayudar con un mensaje concreto: la propia guía de Roblox sugiere pegar un error de Output y pedirle a Assistant que lo diagnostique. Si Assistant deja de responder o dice que llegaste a un límite, consulta límites y errores de Assistant.

Arreglar errores con RoCode

RoCode es un agente de IA independiente para Roblox Studio: describes el problema en un chat web y un plugin de Studio lee y edita el place que tienes abierto. Con los errores, puede encargarse de los pasos de lectura de la rutina de arriba, partiendo de una prueba de juego que ya hiciste.

Tú escribes

Pulsé Play y hacer clic en el botón de la tienda no hace nada. Output muestra attempt to index nil with 'Coins'. Encuentra la causa y arréglala.

RoCode hace
  • Lee el Output de Studio con su herramienta Check Output, incluidas las líneas de Server y Client de tu última prueba, incluso después de pulsar Stop
  • Abre el script que nombra el error con Read Script y lee el código alrededor de esa línea, y puede usar Search Scripts para encontrar dónde debería haberse creado el valor que falta
  • Hace una edición precisa con Edit Script, una búsqueda y reemplazo exacto en ese script, y luego ejecuta Check Script, que lo compila dentro de Studio (no comprueba tipos, no hace lint ni ejecuta tu código)
  • Envía sus cambios a Studio por lotes, y cada lote es un punto de deshacer en el historial de Studio

Pulsa Play otra vez y haz clic en el botón de la tienda para confirmar tú mismo el arreglo: con el plugin 3.9 o posterior RoCode puede hacer una prueba corta y leer los errores, y con el plugin 3.9.15 o posterior su personaje de prueba puede hacer clic en botones de la pantalla, pero solo comprueba lo que eligió probar, y una comprobación de compilación no puede saber si la lógica del juego está bien. Leer errores es parte de cada construcción: el ciclo de construir, revisar y probar un juego entero (en inglés) repite esta comprobación después de cada sistema. Cómo se conecta RoCode a Studio.

Preguntas frecuentes

¿Por qué mi script de Roblox no funciona si no da errores?

Casi siempre el script nunca se ejecutó (tipo de script o contenedor equivocado, o Enabled apagado), sigue esperando algo, o el evento que escucha nunca se dispara. Un print en su primera línea te dice cuál es. Consulta la lista de arriba.

¿Qué significa "attempt to index nil" en Roblox?

El valor antes del punto o de los dos puntos era nil, así que Roblox no pudo mirar dentro. En la línea player.Character.Humanoid, attempt to index nil with 'Humanoid' significa que player.Character era nil: no existía o todavía no había cargado. Comprueba un valor con if antes de usarlo, y en un LocalScript espera a los objetos que crea el servidor con WaitForChild. Más sobre las causas.

¿Qué significa "infinite yield possible" en Roblox?

WaitForChild lleva más de 5 segundos esperando un hijo que no ha aparecido, y sigue esperando. Muchas veces el nombre o el padre está mal, o nada crea el objeto. Más sobre las causas.

¿Por qué la ventana Output está vacía o no aparece?

Ábrela desde el menú Window o la pestaña Script. Si está abierta pero sigue vacía durante una prueba, quita sus filtros y vacía el cuadro de búsqueda, y luego comprueba que los scripts que esperas que impriman se están ejecutando.

¿Hay un verificador de errores de scripts en Roblox?

Sí, viene en Studio: el Script Editor subraya los problemas mientras escribes y la ventana Script Analysis los lista. Encuentran errores de sintaxis y de tipos, no objetos que faltan ni lógica de juego equivocada, que solo aparecen cuando el código se ejecuta.

¿Debería envolver mi código en pcall para evitar errores?

Solo las llamadas que pueden fallar por motivos ajenos a tu código, como las peticiones a data stores, HTTP o MarketplaceService. Envolver un error de nil en pcall esconde el mensaje, y la función sigue sin funcionar.

¿Cómo veo los errores de scripts en un juego en vivo?

Pulsa F9 en el juego, o escribe /console en el chat, para abrir la Developer Console. Muestra los errores de tu dispositivo, y los del servidor si eres el dueño del juego o miembro de un grupo que puede editarlo.

Fuentes y lecturas

Cómo se comprobó el código: cada script de esta página pasa el verificador de tipos estricto de Luau con las definiciones de la API de Roblox (luau-lsp, 14 de noviembre de 2026). Una verificación de tipos detecta APIs mal escritas y tipos incorrectos, no la lógica del juego, así que pruébalo en Studio antes de publicar.

Prueba RoCode en tu propio juego.

Créditos gratis cada día, sin tarjeta. Instala el plugin, describe la función y revisa lo que aparece en Studio.