Ce guide et la vidéo qui l'accompagne vous expliquent comment connecter un support de codage activé par AI à Roblox Studio via MCP, afin que votre agent puisse lire, écrire et tester des jeux en votre nom.
À la fin, vous disposerez d'un dossier de projet qui se synchronise avec Studio via Script Sync (une fonctionnalité qui vous permet d'utiliser votre propre éditeur pour écrire du code), d'une connexion MCP qui permet à votre agent de contrôler directement Studio, et d'un dépôt Git prêt pour le développement.
Étape 1 : Installer les prérequis
Vous aurez besoin des composants suivants avant de commencer :
- Un éditeur de texte activé par AI - Les options les plus populaires sont Visual Studio Code et Cursor. Cursor a son assistant AI intégré, tandis que VS Code a besoin d'une extension comme Claude Code. Les deux fonctionnent bien ici, donc utilisez celui que vous préférez.
- Roblox Studio - Téléchargez-le depuis create.roblox.com.
- Git - Installez-le depuis git-scm.com.
Étape 2 : Connectez-vous à tout
- Votre éditeur de texte :
- VS Code — La connexion varie selon l'extension. Pour Claude Code, cliquez sur l'icône Claude dans la barre d'activité, connectez-vous avec votre compte Anthropic, et confirmez que le panneau de chat s'ouvre. D'autres fournisseurs fonctionnent de manière similaire.
- Cursor — Ouvrez Cursor, connectez-vous avec votre compte Cursor, et confirmez que le panneau de chat s'ouvre. Vous pouvez utiliser n'importe quel modèle que vous préférez.
- Roblox Studio — Ouvrez Studio, connectez-vous avec votre compte Roblox, et confirmez que vous pouvez créer un nouvel endroit.
Étape 3 : Téléchargez le dépôt de démarrage
Le dépôt de démarrage vous fournit la structure de dossier et un fichier .gitignore afin que Git ne commette que les parties de votre projet qui comptent. La plupart de la configuration manuelle est faite pour vous.
- Téléchargez le dépôt de démarrage et décompressez-le. Il contient déjà un dossier nommé WaveSurvival.
- Dans votre éditeur, sélectionnez Fichier → Ouvrir le dossier et choisissez WaveSurvival. Vous devriez voir trois dossiers à l'intérieur :
- ServerScriptService/ contient des scripts serveur, tels que la logique du jeu, l'IA des ennemis et la gestion des vagues.
- ReplicatedStorage/ contient des modules partagés que le serveur et le client peuvent utiliser.
- StarterPlayerScripts/ contient des scripts clients qui s'exécutent pour chaque joueur.
Les fichiers .gitkeep dans chaque dossier sont des espaces réservés pour que Git suive les dossiers lorsqu'ils sont encore vides.
Étape 4 : Créez un projet vide dans Roblox Studio
- Ouvrez Roblox Studio et cliquez sur Nouvelle expérience.
- Choisissez Fichier → Enregistrer sous, naviguez jusqu'à votre dossier WaveSurvival, et enregistrez l'emplacement sous le nom WaveSurvival.rbxlx. Le fichier .gitignore du dépôt de démarrage exclut déjà les fichiers .rbxlx de Git.
- Gardez Studio ouvert. Vous en aurez besoin pour Script Sync et MCP.
Étape 5 : Activez la version bêta de Script Sync
Script Sync est une fonctionnalité bêta, donc vous devez l'activer avant de pouvoir l'utiliser.
Studio se met à jour souvent. Si vous ne voyez pas Script Sync dans la liste, installez la dernière version de Studio et réessayez.
- Dans Studio, choisissez Fichier → Fonctionnalités bêta.
- Trouvez Script Sync, activez-le, et cliquez sur Enregistrer.
- Redémarrez Studio lorsque cela est demandé.
Étape 6 : Connectez Script Sync
Vous connectez Script Sync une fois par projet en liant chaque service de Studio à son dossier correspondant sur le disque.
- Dans l'Explorateur, faites un clic droit sur ServerScriptService.
- Choisissez Script Sync → Synchroniser avec, puis parcourez jusqu'à votre dossier WaveSurvival.
- Répétez pour ReplicatedStorage et StarterPlayerScripts.
Sélectionnez le dossier de premier niveau WaveSurvival, pas les dossiers à l'intérieur. Comme les dossiers portent déjà les bons noms, Script Sync associe automatiquement chaque service au bon.
Tous les fichiers .luau que vous créez dans ces dossiers apparaîtront maintenant automatiquement comme des scripts dans Studio.
Étape 7 : Vérifiez Script Sync
Dans le panneau de chat de votre éditeur, demandez à votre agent :
Créez un script de test à ServerScriptService/Test.server.luau qui imprime 'Hello from Script Sync!' dans la sortie.
Dans Studio, vérifiez l'Explorateur. Vous devriez voir Test apparaître sous ServerScriptService. Vous effectuerez un contrôle plus approfondi, piloté par l'agent, une fois que le MCP sera connecté.
Étape 8 : Activez la connexion MCP
Le serveur MCP de Studio permet à votre agent AI d'interagir directement avec Studio, de lire l'arbre du jeu, de créer des objets, d'exécuter des scripts et de vérifier les sorties. Il couvre tout ce que Script Sync ne peut pas atteindre, comme StarterGui et StarterPack.
- Dans Studio, ouvrez la fenêtre Assistant en utilisant le bouton Assistant dans le coin supérieur droit.
- Cliquez sur ⋯ → Gérer les serveurs MCP.
- Confirmez que le MCP est activé.
- Sous Connexion rapide, activez Cursor ou Visual Studio Code.
Si vous avez installé votre éditeur alors que Studio était ouvert, vous devrez peut-être redémarrer Studio, votre éditeur, ou les deux pour établir la connexion. Pour plus de détails, voir Connecter au serveur MCP de Roblox Studio.
Étape 9 : Vérifiez la connexion MCP
Demandez à votre agent :
Utilisez le MCP de Roblox pour lire l'arbre du jeu actuel dans Roblox Studio. Listez ce qu'il y a dans Workspace.
Vous devrez peut-être approuver la commande ou ajouter l'outil MCP à une liste d'autorisation. Pour un nouveau modèle Baseplate, la réponse décrit la Camera, le Terrain, la Baseplate et le SpawnLocation par défaut et confirme qu'il n'y a pas d'autre contenu pour le moment.
Étape 10 : Exécutez un contrôle de bout en bout
Demandez à votre agent de vérifier toute la configuration en une seule fois :
Utilisez la connexion MCP de Roblox pour vérifier que Script Sync fonctionne correctement. Apportez quelques modifications à Test.server.luau, ajoutez de nouveaux scripts dans les deux autres dossiers, et vérifiez la sortie de chacun. Exécutez game:GetService("InstanceFileSyncService"):GetStatus(instance) dans chaque script pour vérifier l'état de la synchronisation. Lorsque vous avez terminé, supprimez les trois scripts.
Regardez dans Studio et vous verrez l'agent commencer un test de jeu pour confirmer la sortie.
Étape 11 : Engagez-vous dans Git
Vous avez maintenant une configuration propre et fonctionnelle, ce qui en fait un bon moment pour vous engager. Depuis votre terminal :
Étapes suivantes
Votre projet est maintenant synchronisé avec Studio, votre agent AI peut communiquer directement avec lui, et vous disposez d'un dépôt Git pour suivre les modifications et les progrès.
À partir de là, vous pouvez utiliser le fichier WAVE_SURVIVAL.md du projet de démarrage comme contexte pour que votre agent construise un jeu de survie des vagues. Suivez la vidéo compagnon pour construire le jeu une phase testée à la fois.