En bref
Ouvre la fenêtre Output depuis le menu Window ou l'onglet Script, appuie sur Play et clique sur la première erreur rouge. Studio ouvre le script à la ligne qui a échoué. Le message dit ce qui n'a pas marché à cet endroit : attempt to index nil with 'Humanoid' veut dire que la valeur juste avant .Humanoid était nil. Corrige la raison pour laquelle cette valeur manque, puis relance le jeu.
- Commence par la première erreur de la liste. Les erreurs plus bas sont souvent des conséquences de celle-là.
- Les erreurs d'exécution courantes viennent de trois causes : une valeur qui vaut
nil, un nom mal écrit ou pas encore chargé, ou du code qui tourne du mauvais côté (serveur ou client). - Aucune erreur du tout veut souvent dire que le code n'a jamais tourné. Vérifie le type de script, sa place dans l'Explorer, sa propriété
Enabled, et si l'événement qu'il attend se déclenche vraiment. - Pour voir ce que vaut vraiment une valeur à une ligne donnée, affiche-la avec un print et une étiquette, ou mets le jeu en pause sur cette ligne avec un breakpoint.
Sur cette page
Ouvrir l'Output et lire une erreur
La fenêtre Output est l'endroit où Roblox signale les erreurs de script, les avertissements du moteur et tout ce que ton code affiche. Elle n'est pas toujours ouverte, donc ouvre-la avant de tester. Si tu n'as jamais lancé de script, le guide de scripting pour débutants commence par ouvrir l'Output et afficher une première ligne depuis un script.
- Ouvre Output depuis le menu Window de Studio, ou avec son bouton dans l'onglet Script.
- Efface les anciens messages avec Ctrl+K (⌘K sur Mac) pour ne voir que ce test.
- Appuie sur Play (F5) et fais ce qui casse.
- Cherche la première ligne rouge. Les erreurs sont en rouge. Les avertissements, comme
Infinite yield possible, sont en orange.
Une erreur d'exécution dans l'Output ressemble à ça. Selon les options d'affichage de l'Output, chaque ligne peut aussi porter une heure, une étiquette Client ou Server, et le nom du 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.CoinPadest la place du script dans l'Explorer : un script nommé CoinPad dans ServerScriptService.:14est la ligne qui a échoué.- Le message après le numéro de ligne dit ce qui n'a pas marché. La liste des erreurs courantes plus bas explique chacune.
- La pile, entre Stack Begin et Stack End, liste les appels qui ont mené là, du plus récent au plus ancien : la ligne 14 dans la fonction
award, appelée depuis la ligne 27.
Clique sur l'erreur rouge et Studio ouvre ce script avec le curseur sur la ligne qui a échoué. Dans un test solo, les messages du serveur et de ton propre client partagent le même Output, marqués en vert pour le serveur et en bleu pour le client. Les filtres en haut le réduisent par type de message (Error, Warning), par contexte (Client, Server) ou par texte.
Une méthode de débogage qui marche pour tous les scripts
Deviner, et changer plusieurs choses à la fois, c'est la façon lente de réparer un script. Cet ordre réduit le problème étape par étape, qu'il y ait un message d'erreur ou non.
- Reproduis le problème. Efface l'Output, appuie sur Play et fais exactement ce qui casse. Note ce que tu attendais et ce qui s'est passé à la place.
- Prends la première erreur. Lis la première nouvelle ligne rouge : le chemin du script, le numéro de ligne et le message. S'il n'y a pas d'erreur, va aux scripts qui tournent sans erreur.
- Va à la ligne. Clique sur l'erreur. Lis toute la ligne et demande-toi quelle valeur pourrait y valoir
nil, être mal écrite ou avoir le mauvais type. - Vérifie la valeur au lieu de la supposer. Ajoute un
printjuste au-dessus de la ligne, ou mets un breakpoint dessus et lis les valeurs dans la fenêtre Watch.typeof(x)te dit si tu as un nombre, une chaîne, une Instance ou nil. - Remonte à la source. Si la valeur est fausse, trouve où elle a été définie : un
FindFirstChildqui n'a rien trouvé, une fonction qui n'a rien renvoyé, un argument que l'appelant n'a jamais envoyé. - Corrige la cause, un changement à la fois. Corrige le nom, attends l'objet, ou déplace le code du bon côté, puis relance. N'entoure pas la ligne d'un
pcallpour la faire taire : ça cache le bug au lieu de le corriger. - Confirme. Refais l'étape 1. L'erreur doit avoir disparu et la fonctionnalité doit faire ce que tu attendais. Pour tout ce qui implique d'autres joueurs, teste aussi avec Server & Clients et deux clients.
- Fais le ménage. Supprime ou désactive tes prints de débogage pour que le prochain problème soit facile à repérer.
Les erreurs de script Roblox courantes et leurs solutions
Chaque message suit un modèle fixe rempli avec tes propres noms, donc la formulation elle-même est le meilleur indice. Les noms entre guillemets ci-dessous, comme 'Health' ou "Workspace", sont des exemples.
| L'Output dit | Ce que ça veut dire | Solution habituelle |
|---|---|---|
attempt to index nil with 'Health' | La valeur avant .Health était nil. | Trouve pourquoi elle vaut nil, et vérifie-la avec if avant de l'utiliser. |
Infinite yield possible on 'Players.YourName:WaitForChild("Character")' | WaitForChild a attendu 5 secondes et l'objet n'est pas apparu. | Corrige le nom ou le chemin, assure-toi que quelque chose crée l'objet, ou ajoute un délai maximal. |
Bridge is not a valid member of Workspace "Workspace" | Aucun enfant ni aucune propriété ne porte exactement ce nom à cet endroit en ce moment. | Respecte l'orthographe et les majuscules de l'Explorer. Côté client, utilise WaitForChild. |
attempt to call a nil value | Tu as appelé quelque chose qui n'est pas une fonction. | Vérifie le nom de la fonction, et qu'elle est définie au-dessus de l'appel. |
attempt to perform arithmetic (add) on Instance and number | Un calcul sur quelque chose qui n'est pas un nombre. | Utilise .Value sur les objets valeur, et tonumber sur le texte. |
attempt to concatenate string with nil | .. a essayé de coller du texte avec nil ou un objet. | Utilise tostring(), .Name ou l'interpolation de chaînes. |
Expected 'end' (to close 'function' at line 3), got <eof> | Une erreur de syntaxe. Rien du script ne tourne. | Corrige le soulignement rouge dans le Script Editor. |
Requested module experienced an error while loading | Le ModuleScript lui-même a planté pendant qu'il tournait. | Corrige l'erreur du module, affichée juste au-dessus dans l'Output. |
Argument 1 missing or nil | Une fonction Roblox a reçu nil là où il lui faut une valeur. | Remonte jusqu'à l'endroit d'où cet argument aurait dû venir. |
FireServer can only be called from the client | Un RemoteEvent a été déclenché du mauvais côté. | Le serveur utilise FireClient ; les LocalScripts utilisent FireServer. |
Erreur de data store 403, StudioAccessToApisNotAllowed | Studio n'a pas le droit d'utiliser les data stores pour ce jeu. | Publie le jeu, puis active Studio Access to API Services. |
Chaque message ici, et d'autres encore, a sa propre page avec chaque cause, le code qui la provoque et la solution : vois les messages d'erreur de Roblox Studio (en anglais), par exemple attempt to index nil (en anglais), Infinite yield possible (en anglais) et is not a valid member of (en anglais).
attempt to index nil with 'X'
Indexer veut dire lire quelque chose avec un point ou des crochets : part.Position, player.Character, list[1]. Cette erreur dit que la chose à gauche valait nil, et le nom entre guillemets est ce que tu as essayé d'y lire. Donc à la ligne player.Character.Humanoid, attempt to index nil with 'Humanoid' veut dire que player.Character valait nil. Quand la clé est un nombre, le message finit par with number à la place.
Les raisons habituelles pour lesquelles la valeur valait nil :
FindFirstChild,FindFirstChildOfClassouFindFirstAncestorn'a rien trouvé, parce que le nom est différent ou que l'objet n'existe pas encore.Players.LocalPlayera été utilisé dans un Script serveur. Il n'existe que dans les LocalScripts et les ModuleScripts qu'ils chargent avec require ; sur le serveur, il vaut toujours nil. Utilise à la place leplayerque te donnePlayerAddedou un gestionnaire de RemoteEvent.player.Charactera été lu avant l'apparition du personnage, ou pendant sa réapparition.- Une entrée de table n'a jamais été définie, comme
playerData[player]avant le chargement des données de ce joueur, ou une fonction que tu as appelée n'a rien renvoyé.
Un kill brick est le cas classique. La version cassée suppose que tout ce qui touche la part appartient à un personnage, ce qui est faux pour les outils lâchés, les parts libres ou les accessoires.
local part = script.Parent :: BasePart
part.Touched:Connect(function(hit: BasePart)
-- Version cassée :
-- hit.Parent:FindFirstChild("Humanoid").Health = 0
-- Quand la part qui touche n'est pas une partie du corps d'un personnage, FindFirstChild
-- renvoie nil et l'Output affiche :
-- attempt to index nil with 'Health'
-- Corrigé : vérifier chaque étape avant de l'utiliser
local model = hit:FindFirstAncestorOfClass("Model")
local humanoid = model and model:FindFirstChildOfClass("Humanoid")
if humanoid then
humanoid.Health = 0
end
end)
Écrire hit.Parent.Humanoid à la place échoue avec un autre message, Humanoid is not a valid member of ..., expliqué plus bas. FindFirstAncestorOfClass("Model") trouve aussi le personnage quand la part qui touche est dans un accessoire ou un outil que le personnage tient, donc un outil tenu qui touche la brique compte aussi.
La méthode qui corrige cette erreur : récupère la valeur, vérifie-la, et seulement ensuite utilise-la. Sur le serveur, FindFirstChild avec une vérification if convient aux choses qui peuvent vraiment manquer. Dans un LocalScript, utilise WaitForChild pour les choses que crée le serveur, parce qu'elles peuvent arriver après le démarrage de ton script.
Infinite yield possible on ...
WaitForChild("Name") met le script en pause jusqu'à ce qu'un enfant de ce nom existe. S'il a attendu plus de 5 secondes et que tu n'as pas donné de délai maximal, Roblox affiche cet avertissement. C'est un avertissement, pas une erreur : le script attend toujours, et rien après cette ligne ne tourne tant que l'enfant n'apparaît pas, ce qui peut ne jamais arriver. Les causes habituelles :
- Le nom ou le parent est faux.
WaitForChild("leaderStats")ne trouvera jamais un dossier nomméleaderstats. - Rien ne crée l'objet : le script serveur qui le fabrique est désactivé, au mauvais endroit, ou a planté avant. Cherche une erreur plus ancienne dans l'Output.
- Un LocalScript attend quelque chose dans ServerStorage ou ServerScriptService. Leur contenu n'est jamais envoyé aux joueurs, donc l'attente ne finit jamais.
- Tu attends une propriété, pas un enfant.
player:WaitForChild("Character")est le cas courant :Characterest une propriété de Player, pas un objet à l'intérieur. - Le streaming d'instances (
Workspace.StreamingEnabled) est activé, et la part est trop loin du joueur pour avoir déjà été envoyée à ce client.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Version cassée :
-- local character = player:WaitForChild("Character")
-- Character est une propriété de Player, pas un enfant, donc l'Output avertit :
-- Infinite yield possible on 'Players.YourName:WaitForChild("Character")'
local function onCharacterAdded(character: Model)
-- Avec un délai maximal, WaitForChild renvoie nil au lieu d'attendre pour toujours
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
-- Gérer le personnage qui existe peut-être déjà, puis chaque réapparition
local current = player.Character
if current then
onCharacterAdded(current)
end
player.CharacterAdded:Connect(onCharacterAdded)
Un nombre en deuxième argument de WaitForChild est un délai maximal en secondes. Le script peut alors signaler le problème avec warn et s'arrêter proprement, au lieu de rester bloqué sans rien dire.
X is not a valid member of Y
Tu as utilisé un point pour atteindre un enfant ou une propriété qui n'existe pas à ce moment-là, comme workspace.Bridge quand Workspace n'a aucune part nommée Bridge. Le message donne ce que tu as demandé, puis la classe et le chemin complet de l'objet où il a cherché. Vérifie trois choses :
- L'orthographe et les majuscules correspondent exactement à l'Explorer. Le dossier s'appelle
leaderstats, tout en minuscules, ethumanoidn'est pasHumanoid. - Les noms de propriétés suivent l'orthographe américaine.
part.Colouréchoue avecColour is not a valid member of Part "Workspace.Part"; la propriété s'appelleColor. - L'objet est chargé. Côté client, les objets que crée le serveur peuvent arriver après le démarrage de ton LocalScript, donc utilise
WaitForChildlà.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Version cassée :
-- local coins = player.leaderstats.Coins
-- Le serveur crée leaderstats, et il peut arriver sur ce client après le démarrage
-- de ce script. L'Output affiche alors :
-- leaderstats is not a valid member of Player "Players.YourName"
local leaderstats = player:WaitForChild("leaderstats")
local coins = leaderstats:WaitForChild("Coins") :: IntValue -- le serveur fait de Coins une IntValue
print(`[CoinsWatcher] starting coins: {coins.Value}`)
coins.Changed:Connect(function(newValue: number)
print(`[CoinsWatcher] coins changed to {newValue}`)
end)
Ce script attend un script serveur qui crée leaderstats avec une IntValue nommée Coins, comme celui du guide du leaderboard.
attempt to call a nil value
Le code a mis des parenthèses après quelque chose qui vaut nil, donc il n'y avait aucune fonction à lancer. Les causes habituelles :
- Le nom de la fonction est mal écrit ou ses majuscules diffèrent. Un module définit
Format.clocket l'appelant écritFormat.Clock(95). - Une
local functionest appelée sur une ligne au-dessus de sa définition. À ce moment, le nom n'existe pas encore, donc remonte la définition. - Un ModuleScript n'ajoute jamais la fonction à la table qu'il renvoie.
Deux messages proches désignent le même genre d'erreur. Appeler avec deux-points une méthode absente d'une table donne attempt to call missing method 'Kill' of table. Une méthode mal écrite sur un objet Roblox, comme part:Destory(), donne Destory is not a valid member of Part "Workspace.Part".
attempt to perform arithmetic (add) on ...
Luau a essayé de faire un calcul (add, sub, mul, div et ainsi de suite) alors qu'un des deux côtés n'était pas un nombre. Les noms de types à la fin du message te disent dans quel cas tu es :
on Instance and number: tu as fait un calcul sur un objet valeur au lieu de son nombre.coins + 10devrait êtrecoins.Value + 10.on nil and number: une variable ou une entrée de table n'a jamais été définie. Donne-lui une valeur de départ, ou écris(x or 0)quand une valeur absente veut vraiment dire zéro.on string and number: du texte qui n'est pas un nombre, souvent venu d'une TextBox. Convertis-le avectonumber(text)et vérifie que le résultat n'est pas nil. Un texte qui contient un nombre, comme"5", est converti automatiquement.
Les comparaisons échouent de la même façon, avec attempt to compare nil < number. Luau réécrit a > b en b < a, donc l'ordre dans le message peut être l'inverse de ton code.
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
-- Dire pourquoi rien ne s'est passé, au lieu d'échouer en silence
warn(`[CoinDrip] {player.Name} has no leaderstats.Coins yet`)
return
end
-- Version cassée :
-- coins = coins + amount
-- coins est l'objet IntValue, pas son nombre, donc l'Output affiche :
-- attempt to perform arithmetic (add) on Instance and number
coins.Value += amount
end
-- Chaque minute, donner quelques pièces à chaque joueur du serveur
while true do
task.wait(INTERVAL_SECONDS)
for _, player in Players:GetPlayers() do
addCoins(player, REWARD)
end
end
attempt to concatenate string with nil
L'opérateur .. ne colle que des chaînes et des nombres. Coller nil échoue, et coller un objet aussi : "Hi " .. player donne attempt to concatenate string with Instance. Utilise player.Name, entoure la valeur de tostring(), ou utilise l'interpolation de chaînes avec des backticks, print(`Coins: {coins}`), qui affiche nil au lieu d'arrêter le script.
Expected 'end' et autres erreurs de syntaxe
Les messages qui commencent par Expected sont des erreurs de syntaxe : le code n'est pas du Luau valide, donc Roblox ne peut pas le compiler et aucune ligne de ce script ne tourne, pas même les lignes au-dessus de la faute. Le Script Editor les souligne en rouge pendant que tu tapes, donc tu peux les corriger avant d'appuyer sur Play.
Expected 'end' (to close 'function' at line 3), got <eof>: unfunction,if,forouwhilequi commence à la ligne 3 n'a pas deendcorrespondant. Le numéro de ligne avant le message est souvent la fin du fichier, donc regarde la ligne indiquée entre parenthèses.Expected 'then' when parsing if statement, got '=': un seul=dans une condition. Les comparaisons utilisent==.Expected ')' (to close '(' at line 1), got 'local': une parenthèse n'a jamais été fermée.Expected <eof>, got 'end': unendde trop.
Une indentation régulière rend un end manquant ou en trop facile à repérer, parce que chaque bloc s'aligne avec le end qui le ferme.
Requested module experienced an error while loading
Le premier require() d'un ModuleScript lance son code. Si le module plante pendant qu'il tourne, le script qui l'a chargé reçoit ce message. Le vrai problème est l'erreur du module lui-même, une ou deux lignes plus haut dans l'Output : corrige celle-là. Deux messages proches :
Module code did not return exactly one value: le module ne finit pas par unreturn. Un ModuleScript doit renvoyer une seule valeur qui n'est pas nil, en général sa table.Requested module was required recursively: deux modules se chargent l'un l'autre. Déplace la partie qu'ils partagent dans un troisième module que les deux chargent.
local Format = {}
-- Transforme un nombre de secondes en minutes et secondes : 95 devient "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
-- Le module doit finir en renvoyant sa table. Sans cette ligne, chaque
-- require de ce module échoue avec : Module code did not return exactly one value
return Format
Un script l'utilise avec local Format = require(ReplicatedStorage:WaitForChild("Format")) puis Format.clock(95). Écrire Format.Clock(95) à la place, c'est l'erreur attempt to call a nil value.
Argument 1 missing or nil
Une fonction Roblox a reçu nil pour un argument dont elle a besoin, et le numéro dit lequel. workspace:FindFirstChild(itemName) échoue comme ça quand itemName vaut nil. Le bug est rarement sur cette ligne. Il est là d'où la valeur aurait dû venir : une variable mal écrite, un attribut jamais défini, ou un argument de RemoteEvent que le client n'a pas envoyé. Les arguments d'un RemoteEvent viennent de l'appareil du joueur, donc le serveur doit les vérifier avant de les utiliser. Le guide des RemoteEvents montre comment.
FireServer can only be called from the client
Les RemoteEvents ont un sens. Un LocalScript appelle FireServer et un Script serveur écoute avec OnServerEvent. Un Script serveur appelle FireClient ou FireAllClients et les LocalScripts écoutent avec OnClientEvent. Appeler une méthode du mauvais côté donne cette erreur, ou son inverse, FireClient can only be called from the server. La solution est en général de déplacer le code dans le bon type de script : vois Script vs LocalScript vs ModuleScript (en anglais).
Erreur de data store 403 dans Studio
Les appels aux data stores échouent dans Studio avec le code d'erreur 403 (StudioAccessToApisNotAllowed) tant que tu ne les autorises pas. Publie le jeu, ouvre File, Experience Settings, Security, active Enable Studio Access to API Services et enregistre. Studio utilise alors les mêmes data stores que le jeu en ligne, donc Roblox conseille de le faire dans une copie de test séparée, pas dans un jeu auquel des gens jouent déjà. Entoure chaque appel aux data stores d'un pcall, parce que ces appels peuvent échouer pour des raisons extérieures à ton code. Le tutoriel DataStore explique comment sauvegarder sans risque.
Quand un script tourne sans erreur mais ne fait rien
Un script muet n'a en général jamais tourné, attend encore quelque chose, ou a tourné du mauvais côté. Avant de changer le moindre code, fais de print(script:GetFullName(), "started") sa première ligne et lance le jeu. Si cette ligne n'apparaît jamais dans l'Output, le problème vient de l'endroit où se trouve le script ou de sa configuration, pas de ce qu'il contient.
| À vérifier | Ce qui ne va pas | Solution |
|---|---|---|
| Type et place du script | Un LocalScript ne tourne que si tu le mets dans StarterPlayerScripts, StarterCharacterScripts, StarterGui, StarterPack ou ReplicatedFirst (depuis les conteneurs Starter, c'est la copie du joueur qui tourne). Un LocalScript placé dans Workspace, ServerScriptService ou ReplicatedStorage ne tourne jamais. Un Script avec le RunContext par défaut ne tourne que dans Workspace ou ServerScriptService. | Déplace-le, ou utilise l'autre type de script. Le code d'interface et de saisie va dans un LocalScript ; les règles du jeu vont dans un Script dans ServerScriptService. |
| Enabled | Un script dont la propriété Enabled est décochée ne tourne pas. | Sélectionne-le et coche Enabled dans la fenêtre Properties. |
| RunContext | Le RunContext d'un Script décide où il tourne. Legacy, la valeur par défaut, tourne sur le serveur depuis Workspace ou ServerScriptService. Server tourne sur le serveur ; Client tourne sur l'appareil de chaque joueur, par exemple depuis ReplicatedStorage. | Règle-le exprès. La doc de Roblox conseille les Scripts Client dans ReplicatedStorage ou ReplicatedFirst, et les LocalScripts dans les conteneurs Starter. |
| L'événement ne se déclenche jamais | Touched ne se déclenche qu'avec un mouvement physique, demande qu'au moins une des deux parts ne soit pas ancrée, et demande CanTouch sur les deux. PlayerAdded ne se déclenche pas pour les joueurs déjà sur le serveur au moment où tu t'es connecté. Un gestionnaire de RemoteEvent ne tourne jamais si l'autre côté ne déclenche jamais l'événement. | Mets un print dans le gestionnaire pour prouver s'il tourne, puis corrige ce qui devrait le déclencher. |
| Du code après une boucle ou une attente | Les lignes sous une boucle while true do ne tournent jamais, parce que la boucle ne finit jamais. Les lignes sous un WaitForChild qui ne trouve jamais son enfant ne tournent jamais non plus. | Connecte les événements avant la boucle, ou lance la boucle avec task.spawn. Donne un délai maximal aux attentes. |
| Une vérification qui sort en silence | Une garde comme if not coins then return end arrête la fonction sans rien dire quand l'objet manque. | Ajoute un warn avec les détails avant le return. |
| Filtres de l'Output | L'Output peut être filtré par type de message, par Client ou Server, et par texte. Un filtre oublié peut cacher l'erreur que tu cherches. | Réinitialise les filtres et vide le champ de recherche. |
| Toi seul le vois | Un LocalScript a fait le changement, donc seul ce joueur le voit. Le serveur et les autres joueurs non. | Fais le changement sur le serveur. Vois où tournent les scripts (en anglais). |
Le cas de PlayerAdded piège beaucoup de monde, parce que dans un test Studio tu rejoins presque dès que le serveur démarre. Si quelque chose au-dessus de la ligne Connect attend, comme un WaitForChild, un task.wait ou un require d'un module qui attend, tu peux rejoindre avant que la connexion existe. Gère à la fois les nouveaux joueurs et ceux déjà là :
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
print(`[Welcome] {player.Name} joined`)
end
Players.PlayerAdded:Connect(onPlayerAdded)
-- Les joueurs déjà là quand la ligne ci-dessus a tourné ne déclenchent jamais
-- PlayerAdded pour ce script, donc on les gère maintenant
for _, player in Players:GetPlayers() do
task.spawn(onPlayerAdded, player)
end
Les outils de débogage de Roblox Studio
print et warn, avec du contexte
print écrit une ligne dans l'Output et warn écrit un avertissement. C'est le moyen le plus rapide de répondre à « est-ce que ça a tourné ? » et « que vaut cette valeur ? ». Un print(x) tout seul est dur à retrouver plus tard, donc ajoute une étiquette et les détails qui comptent. typeof(x) montre si une valeur est un nombre, une chaîne, une Instance ou nil, et GetFullName() montre exactement quel objet tu as.
local Players = game:GetService("Players")
local DEBUG = true -- mets false quand tu as fini
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 et ClassName montrent ce qu'est vraiment une valeur
debugPrint("Coins is", typeof(coins), if coins then coins.ClassName else "missing")
end)
Le champ de recherche de l'Output filtre par texte, donc une étiquette constante comme [ShopServer] te permet de n'afficher que les lignes de ce système. Si tu as besoin de savoir comment le code est arrivé à une ligne, debug.traceback() renvoie la pile d'appels actuelle sous forme de chaîne.
Breakpoints et exécution pas à pas
Un breakpoint met le jeu en pause sur une ligne pour que tu puisses tout examiner à ce moment-là. Dans le Script Editor, clique dans la marge juste à droite d'un numéro de ligne (un cercle rouge apparaît), puis lance un test. Quand cette ligne est atteinte, le jeu se met en pause avec une flèche jaune sur la prochaine ligne à exécuter. Les boutons pas à pas avancent alors dans le code :
- Step Over (F10) exécute la ligne actuelle et s'arrête sur la suivante.
- Step Into (F11) entre dans la fonction appelée sur cette ligne.
- Step Out (Shift+F11) termine la fonction actuelle et s'arrête de retour chez son appelant.
- Resume Scripts continue jusqu'au prochain breakpoint.
Un clic droit dans la marge donne deux autres types utiles. Un breakpoint conditionnel ne met en pause que quand une expression comme amount < 0 est vraie. Un logpoint écrit un message dans l'Output sans mettre en pause, donc tu peux noter une valeur sans modifier le script.
Watch et Call Stack
Pendant que le jeu est en pause, passe la souris sur une variable dans le Script Editor pour voir sa valeur. La fenêtre Watch liste toutes les variables visibles à cet endroit dans son onglet Variables, et dans son onglet My Watches tu peux taper n'importe quelle expression, comme coins.Value + amount, pour voir sa valeur actuelle. La fenêtre Call Stack montre quelle fonction a appelé quelle autre pour arriver à la ligne en pause. Les deux s'ouvrent depuis l'onglet Script ou le menu Window.
Script Analysis et mode strict
Le Script Editor souligne les problèmes pendant que tu tapes, et la fenêtre Script Analysis, qui s'ouvre avec le bouton Analysis de l'onglet Script, liste les erreurs et les avertissements de tous tes scripts. Elle repère les erreurs de syntaxe et les noms inconnus avant que tu appuies sur Play. Ajouter --!strict en première ligne d'un script active la vérification stricte des types de Luau, qui signale aussi les propriétés mal écrites, les mauvais types d'arguments et les valeurs qui pourraient valoir nil. Elle ne voit pas le jeu en train de tourner, par contre : une part absente de Workspace n'apparaît que dans l'Output.
La barre de commande
La barre de commande (dans l'onglet Script, ou Ctrl+9, ⌘9 sur Mac) exécute du Luau tout de suite. Pendant que le jeu tourne, c'est un moyen rapide de poser une question : print(workspace:FindFirstChild("Bridge")) te dit si la part existe, et print(#game:GetService("Players"):GetPlayers()) compte les joueurs. En mode édition, le code de la barre de commande modifie vraiment ton jeu, donc fais attention à tout ce qui déplace ou supprime des objets.
La Developer Console pour les jeux en ligne
L'Output de Studio ne couvre que Studio. Dans un jeu en ligne, appuie sur F9 ou tape /console dans le chat pour ouvrir la Developer Console. Son Log montre ce qu'affiche ton propre appareil, et ce qu'affiche le serveur si le jeu t'appartient ou si tu es membre d'un groupe avec le droit de le modifier.
L'Assistant intégré de Roblox peut aussi aider sur un message précis : le guide de Roblox lui-même conseille de coller une erreur de l'Output et de demander à Assistant de la diagnostiquer. Si Assistant ne répond plus ou dit que tu as atteint une limite, vois les limites et erreurs d'Assistant.
Corriger les erreurs avec RoCode
RoCode est un agent IA indépendant pour Roblox Studio : tu décris le problème dans un chat web, et un plugin pour Studio lit et modifie le jeu que tu as ouvert. Pour les erreurs, il peut prendre en charge les étapes de lecture de la méthode ci-dessus, à partir d'un test que tu as déjà lancé.
J'ai appuyé sur Play et cliquer sur le bouton de la boutique ne fait rien. L'Output affiche attempt to index nil with 'Coins'. Trouve la cause et corrige-la.
- Lit l'Output de Studio avec son outil Check Output, y compris les lignes Server et Client de ton dernier test, même après que tu as appuyé sur Stop
- Ouvre le script nommé dans l'erreur avec Read Script et lit le code autour de cette ligne, et peut utiliser Search Scripts pour trouver où la valeur manquante aurait dû être créée
- Fait une modification ciblée avec Edit Script, un rechercher-remplacer exact dans ce script, puis lance Check Script, qui le compile dans Studio (il ne vérifie pas les types, ne fait pas de lint et ne lance pas ton code)
- Envoie ses changements à Studio par lots, et chaque lot est un point d'annulation dans l'historique de Studio
Appuie de nouveau sur Play et clique sur le bouton de la boutique pour confirmer la correction toi-même : avec le plugin 3.9 ou plus récent, RoCode peut lancer un court test et lire les erreurs, et avec le plugin 3.9.15 ou plus récent son personnage de test peut cliquer sur les boutons à l'écran, mais il ne vérifie que ce qu'il a choisi de tester, et une vérification de compilation ne peut pas dire si la logique du jeu est juste. Lire les erreurs fait partie de chaque construction : la boucle construire, relire et tester pour un jeu entier refait cette vérification après chaque système. Comment RoCode se connecte à Studio.
Questions fréquentes
Pourquoi mon script Roblox ne marche pas alors qu'il n'y a aucune erreur ?
En général, le script n'a jamais tourné (mauvais type de script ou mauvais conteneur, ou Enabled décoché), il attend encore quelque chose, ou l'événement qu'il écoute ne se déclenche jamais. Un print sur sa première ligne te dit lequel. Vois la liste de vérification plus haut.
Que veut dire « attempt to index nil » sur Roblox ?
La valeur avant le point ou les deux-points valait nil, donc Roblox ne pouvait pas regarder dedans. À la ligne player.Character.Humanoid, attempt to index nil with 'Humanoid' veut dire que player.Character valait nil : absent, ou pas encore chargé. Vérifie une valeur avec if avant de l'utiliser, et dans un LocalScript attends les objets que crée le serveur avec WaitForChild. Plus de détails sur les causes.
Que veut dire « infinite yield possible » sur Roblox ?
WaitForChild attend depuis plus de 5 secondes un enfant qui n'est pas apparu, et il attend toujours. Souvent le nom ou le parent est faux, ou rien ne crée l'objet. Plus de détails sur les causes.
Pourquoi la fenêtre Output est vide ou ne s'affiche pas ?
Ouvre-la depuis le menu Window ou l'onglet Script. Si elle est ouverte mais reste vide pendant un test, réinitialise ses filtres et son champ de recherche, puis vérifie que les scripts censés afficher quelque chose tournent bien.
Existe-t-il un vérificateur d'erreurs pour les scripts Roblox ?
Oui, intégré à Studio : le Script Editor souligne les problèmes pendant que tu tapes et la fenêtre Script Analysis les liste. Ils trouvent les fautes de syntaxe et de types, pas les objets manquants ni la mauvaise logique de jeu, qui n'apparaissent que quand le code tourne.
Faut-il entourer mon code d'un pcall pour arrêter les erreurs ?
Seulement les appels qui peuvent échouer pour des raisons extérieures à ton code, comme les requêtes vers les data stores, HTTP ou MarketplaceService. Entourer une erreur nil d'un pcall cache le message, et la fonctionnalité ne marche toujours pas.
Comment voir les erreurs de script dans un jeu en ligne ?
Appuie sur F9 dans le jeu, ou tape /console dans le chat, pour ouvrir la Developer Console. Elle montre les erreurs de ton appareil, et celles du serveur si le jeu t'appartient ou si tu es membre d'un groupe qui peut le modifier.
Sources et lectures
- Roblox Creator Docs : Output (en anglais). où se trouve l'Output, ses filtres et ses options d'affichage
- Roblox Creator Docs : Debugging (en anglais). breakpoints, pas à pas, Watch, Call Stack, barre de commande et Developer Console
- Roblox Creator Docs : Script Editor (en anglais). la fenêtre Script Analysis
- Roblox Creator Docs : Studio interface (en anglais). où s'ouvrent l'Output et la barre de commande
- Roblox Creator Docs : Script types and locations (en anglais). où tourne chaque type de script, et RunContext
- Roblox Creator Docs : Studio testing modes (en anglais). Play, les vues Client et Server, et les tests Server & Clients
- Roblox Engine API : Instance (en anglais). WaitForChild, son délai maximal et l'avertissement après 5 secondes
- Roblox Creator Docs : Reuse code (en anglais). les ModuleScripts et les require récursifs
- Roblox Creator Docs : Data store error codes and limits (en anglais). l'erreur 403, StudioAccessToApisNotAllowed
- Roblox Creator Docs : Data stores (en anglais). activer l'accès depuis Studio, et utiliser une copie de test séparée
- Roblox Engine API : BasePart (en anglais). quand Touched se déclenche, et CanTouch
- Roblox Creator Docs : Type checking (en anglais). le mode strict
- Roblox Creator Docs : Developer Console (en anglais). qui peut voir la sortie du serveur dans un jeu en ligne
- Roblox Creator Docs : Build your first game with Assistant (en anglais). coller une erreur de l'Output pour qu'Assistant la diagnostique
Comment le code a été vérifié : chaque script de cette page passe le vérificateur de types strict de Luau avec les définitions de l'API Roblox (luau-lsp, 14 novembre 2026). Une vérification de types repère les API mal écrites et les mauvais types, pas la logique du jeu : teste dans Studio avant de publier.