Ce guide et la vidéo qui l'accompagne vous expliquent comment connecter un environnement de codage activé par l'IA à 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 Studio directement, 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 l'IA - Les options les plus populaires sont Visual Studio Code et Cursor. Cursor a son assistant IA intégré, tandis que VS Code nécessite 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 sont similaires.
- 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 valide que les parties de votre projet qui comptent. La plupart de la configuration manuelle est déjà 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, choisissez Fichier → Ouvrir le dossier et sélectionnez 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 client qui s'exécutent pour chaque joueur.
Les fichiers .gitkeep à l'intérieur de chaque dossier sont des espaces réservés afin que Git suive les dossiers tant qu'ils sont encore vides.
Étape 4 : Créez un projet vierge dans Roblox Studio
- Ouvrez Roblox Studio et cliquez sur Nouvelle expérience.
- Choisissez Fichier → Enregistrer sous, naviguez jusqu'à votre dossier WaveSurvival, et enregistrez l'endroit 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 vous y êtes invité.
É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 niveau supérieur WaveSurvival, pas les dossiers à l'intérieur. Comme les dossiers ont déjà les bons noms, Script Sync associe automatiquement chaque service au bon.
Tous les fichiers .luau que vous créez dans ces dossiers apparaissent 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 une vérification plus approfondie, pilotée par l'agent, après la connexion de MCP.
Étape 8 : Activez la connexion MCP
Le serveur MCP de Studio permet à votre agent IA 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 la sortie. 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 en haut à droite.
- Cliquez sur ⋯ → Gérer les serveurs MCP.
- Confirmez que MCP est activé.
- Sous Connexion rapide, activez Cursor ou Visual Studio Code.
Si vous avez installé votre éditeur pendant 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, consultez Connectez-vous 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 de 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 blanche. Pour un modèle de Baseplate frais, 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 encore d'autre contenu.
Étape 10 : Effectuez une vérification 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 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 :
git add .
git commit -m "Synchronisation de script connectée et MCP vérifié"Prochaines étapes
Votre projet est maintenant synchronisé avec Studio, votre agent IA peut lui parler directement, et vous avez 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 par vagues. Suivez la vidéo compagnon pour construire le jeu une phase testée à la fois.