Deze gids en de bijbehorende video begeleiden je bij het verbinden van een AI-gestuurde code-harnas met Roblox Studio via MCP, zodat je agent namens jou kan lezen, schrijven en playtesten.
Aan het einde heb je een projectmap die synchroniseert met Studio via Script Sync (een functie waarmee je je eigen editor kunt gebruiken om code te schrijven), een MCP-verbinding waarmee je agent Studio direct kan aansturen, en een Git-repository die klaar is voor ontwikkeling.
Stap 1: Installeer de vereisten
Je hebt de volgende componenten nodig voordat je begint:
- Een AI-gestuurde teksteditor - De meest populaire opties zijn Visual Studio Code en Cursor. Cursor heeft zijn AI-assistent ingebouwd, terwijl VS Code een extensie zoals Claude Code nodig heeft. Beide werken hier goed, dus gebruik degene die je verkiest.
- Roblox Studio - Download het van create.roblox.com.
- Git - Installeer het van git-scm.com.
Stap 2: Meld je aan bij alles
- Je teksteditor:
- VS Code — Aanmelden varieert per extensie. Voor Claude Code, klik op het Claude-pictogram in de activiteitsbalk, meld je aan met je Anthropic-account en bevestig dat het chatpaneel opent. Andere aanbieders zijn vergelijkbaar.
- Cursor — Open Cursor, meld je aan met je Cursor-account en bevestig dat het chatpaneel opent. Je kunt elk model gebruiken dat je verkiest.
- Roblox Studio — Open Studio, meld je aan met je Roblox-account en bevestig dat je een nieuwe plaats kunt maken.
Stap 3: Download de starterrepository
De starterrepository geeft je de mapindeling en een .gitignore-bestand zodat Git alleen de delen van je project commit die belangrijk zijn. Het meeste handmatige werk is al voor je gedaan.
- Download de starterrepository en pak deze uit. Het bevat al een map genaamd WaveSurvival.
- Kies in je editor Bestand → Map openen en selecteer WaveSurvival. Je zou drie mappen binnenin moeten zien:
- ServerScriptService/ bevat serverscripts, zoals game-logica, vijand-AI en golfbeheer.
- ReplicatedStorage/ bevat gedeelde modules die zowel de server als de client kunnen gebruiken.
- StarterPlayerScripts/ bevat clientscripts die voor elke speler draaien.
De .gitkeep-bestanden in elke map zijn tijdelijke bestanden zodat Git de mappen bijhoudt terwijl ze nog leeg zijn.
Stap 4: Maak een leeg project in Roblox Studio
- Open Roblox Studio en klik op Nieuwe ervaring.
- Kies Bestand → Opslaan naar bestand, navigeer naar je WaveSurvival-map en sla de plaats op als WaveSurvival.rbxlx. Het .gitignore-bestand van de starterrepository sluit al .rbxlx-bestanden uit van Git.
- Houd Studio open. Je hebt het nodig voor Script Sync en MCP.
Stap 5: Schakel de Script Sync-bèta in
Script Sync is een bètafunctie, dus je moet deze inschakelen voordat je deze kunt gebruiken.
- Kies in Studio Bestand → Bèta-functies.
- Zoek Script Sync, schakel het in en klik op Opslaan.
- Herstart Studio wanneer daarom wordt gevraagd.
Stap 6: Verbind Script Sync
Je verbindt Script Sync één keer per project door elke Studio-service te koppelen aan de bijbehorende map op de schijf.
- Klik met de rechtermuisknop op ServerScriptService in de Verkenner.
- Kies Script Sync → Synchroniseren naar, en blader naar je WaveSurvival-map.
- Herhaal dit voor ReplicatedStorage en StarterPlayerScripts.
Alle .luau-bestanden die je in die mappen maakt, verschijnen nu automatisch als scripts in Studio.
Stap 7: Verifieer Script Sync
Vraag je agent in het chatpaneel van je editor:
Maak een testscript aan in ServerScriptService/Test.server.luau dat 'Hallo van Script Sync!' naar de uitvoer print.
Controleer in Studio de Verkenner. Je zou Test onder ServerScriptService moeten zien verschijnen. Je zult een diepere, agent-gestuurde controle uitvoeren nadat MCP is verbonden.
Stap 8: Schakel de MCP-verbinding in
De Studio MCP-server stelt je AI-agent in staat om direct met Studio te communiceren, de gameboom te lezen, objecten te maken, scripts uit te voeren en de uitvoer te controleren. Het dekt alles wat Script Sync niet kan bereiken, zoals StarterGui en StarterPack.
- Open in Studio het Assistent-venster met de Assistent-knop rechtsboven.
- Klik op ⋯ → Beheer MCP-servers.
- Bevestig dat MCP is ingeschakeld.
- Onder Snelle verbinding, schakel Cursor of Visual Studio Code in.
Als je je editor hebt geïnstalleerd terwijl Studio open was, moet je mogelijk Studio, je editor of beide opnieuw opstarten om de verbinding tot stand te brengen. Voor meer details, zie Verbind met de Roblox Studio MCP-server.
Stap 9: Verifieer de MCP-verbinding
Vraag je agent:
Gebruik de Roblox MCP om de huidige gameboom in Roblox Studio te lezen. Lijst wat er in Workspace staat.
Je moet mogelijk het commando goedkeuren of de MCP-tool aan een whitelist toevoegen. Voor een vers Baseplate-sjabloon beschrijft de reactie de standaard Camera, Terrain, Baseplate en SpawnLocation en bevestigt dat er nog geen andere inhoud is.
Stap 10: Voer een end-to-end controle uit
Vraag je agent om de volledige setup in één keer te verifiëren:
Gebruik de Roblox MCP-verbinding om te verifiëren of Script Sync goed werkt. Maak enkele wijzigingen in Test.server.luau, voeg nieuwe scripts toe in de andere twee mappen en verifieer de uitvoer van elk. Voer game:GetService("InstanceFileSyncService"):GetStatus(instance) uit in elk script om de synchronisatiestatus te verifiëren. Wanneer je klaar bent, verwijder je alle drie de scripts.
Kijk in Studio en je zult zien dat de agent een playtest start om de uitvoer te bevestigen.
Stap 11: Commit naar Git
Je hebt nu een schone, werkende configuratie, wat dit een goed moment maakt om te committen. Voer vanuit je terminal uit:
git add .
git commit -m "Script sync verbonden en MCP geverifieerd"Volgende stappen
Je project is nu gesynchroniseerd met Studio, je AI-agent kan er direct mee communiceren, en je hebt een Git-repository om wijzigingen en voortgang bij te houden.
Van hieruit kun je het WAVE_SURVIVAL.md-bestand van het starterproject gebruiken als context voor je agent om een golfoverlevingsspel te bouwen. Volg de bijbehorende video om het spel fase voor fase te bouwen.