Dieser Leitfaden und das begleitende Video führen Sie durch die Verbindung eines KI-unterstützten Codierungs-Harness mit Roblox Studio über MCP, sodass Ihr Agent in Ihrem Namen lesen, schreiben und testen kann.
Am Ende haben Sie einen Projektordner, der über Script Sync (eine Funktion, die es Ihnen ermöglicht, Ihren eigenen Editor zum Schreiben von Code zu verwenden) mit Studio synchronisiert, eine MCP-Verbindung, die es Ihrem Agenten ermöglicht, Studio direkt zu steuern, und ein Git-Repository, das bereit für die Entwicklung ist.
Schritt 1: Installieren Sie die Voraussetzungen
Sie benötigen die folgenden Komponenten, bevor Sie beginnen:
- Einen KI-unterstützten Texteditor - Die beliebtesten Optionen sind Visual Studio Code und Cursor. Cursor hat seinen KI-Assistenten integriert, während VS Code eine Erweiterung wie Claude Code benötigt. Beide funktionieren hier gut, also verwenden Sie, was Ihnen am besten gefällt.
- Roblox Studio - Laden Sie es von create.roblox.com herunter.
- Git - Installieren Sie es von git-scm.com.
Schritt 2: Melden Sie sich überall an
- Ihr Texteditor:
- VS Code — Die Anmeldung variiert je nach Erweiterung. Für Claude Code klicken Sie auf das Claude-Symbol in der Aktivitätsleiste, melden sich mit Ihrem Anthropic-Konto an und bestätigen, dass das Chatfenster geöffnet wird. Andere Anbieter sind ähnlich.
- Cursor — Öffnen Sie Cursor, melden Sie sich mit Ihrem Cursor-Konto an und bestätigen Sie, dass das Chatfenster geöffnet wird. Sie können jedes Modell verwenden, das Sie bevorzugen.
- Roblox Studio — Öffnen Sie Studio, melden Sie sich mit Ihrem Roblox-Konto an und bestätigen Sie, dass Sie einen neuen Ort erstellen können.
Schritt 3: Laden Sie das Starter-Repository herunter
Das Starter-Repository gibt Ihnen das Ordnerschema und eine .gitignore-Datei, sodass Git nur die Teile Ihres Projekts erfasst, die wichtig sind. Der Großteil der manuellen Einrichtung ist bereits für Sie erledigt.
- Laden Sie das Starter-Repository herunter und entpacken Sie es. Es enthält bereits einen Ordner namens WaveSurvival.
- Wählen Sie in Ihrem Editor Datei → Ordner öffnen und wählen Sie WaveSurvival. Sie sollten drei Ordner darin sehen:
- ServerScriptService/ enthält Server-Skripte, wie Spiel-Logik, Gegner-KI und Wellen-Management.
- ReplicatedStorage/ enthält gemeinsame Module, die sowohl vom Server als auch vom Client verwendet werden können.
- StarterPlayerScripts/ enthält Client-Skripte, die für jeden Spieler ausgeführt werden.
Die .gitkeep-Dateien in jedem Ordner sind Platzhalter, damit Git die Ordner verfolgt, während sie noch leer sind.
Schritt 4: Erstellen Sie ein leeres Projekt in Roblox Studio
- Öffnen Sie Roblox Studio und klicken Sie auf Neue Erfahrung.
- Wählen Sie Datei → In Datei speichern, navigieren Sie zu Ihrem WaveSurvival-Ordner und speichern Sie den Ort als WaveSurvival.rbxlx. Die .gitignore-Datei des Starter-Repositorys schließt bereits .rbxlx-Dateien von Git aus.
- Lassen Sie Studio geöffnet. Sie benötigen es für Script Sync und MCP.
Schritt 5: Aktivieren Sie die Script Sync-Beta
Script Sync ist eine Beta-Funktion, die Sie aktivieren müssen, bevor Sie sie verwenden können.
Studio wird häufig aktualisiert. Wenn Sie Script Sync nicht in der Liste sehen, installieren Sie die neueste Version von Studio und versuchen Sie es erneut.
- Wählen Sie in Studio Datei → Beta-Funktionen.
- Suchen Sie Script Sync, aktivieren Sie es und klicken Sie auf Speichern.
- Starten Sie Studio neu, wenn Sie dazu aufgefordert werden.
Schritt 6: Verbinden Sie Script Sync
Sie verbinden Script Sync einmal pro Projekt, indem Sie jeden Studio-Dienst mit dem entsprechenden Ordner auf der Festplatte verknüpfen.
- Klicken Sie im Explorer mit der rechten Maustaste auf ServerScriptService.
- Wählen Sie Script Sync → Synchronisieren mit, und durchsuchen Sie Ihren WaveSurvival-Ordner.
- Wiederholen Sie dies für ReplicatedStorage und StarterPlayerScripts.
Wählen Sie den obersten WaveSurvival-Ordner, nicht die Ordner darin. Da die Ordner bereits die richtigen Namen haben, ordnet Script Sync jeden Dienst automatisch dem richtigen zu.
Alle .luau-Dateien, die Sie in diesen Ordnern erstellen, erscheinen jetzt automatisch als Skripte in Studio.
Schritt 7: Überprüfen Sie Script Sync
Fordern Sie Ihren Agenten im Chatfenster Ihres Editors auf:
Erstellen Sie ein Testskript unter ServerScriptService/Test.server.luau, das 'Hello from Script Sync!' in die Ausgabe druckt.
Überprüfen Sie in Studio den Explorer. Sie sollten sehen, dass Test unter ServerScriptService erscheint. Sie werden eine tiefere, agentengesteuerte Überprüfung durchführen, nachdem MCP verbunden ist.
Schritt 8: Aktivieren Sie die MCP-Verbindung
Der Studio MCP-Server ermöglicht es Ihrem KI-Agenten, direkt mit Studio zu interagieren, den Spielbaum zu lesen, Objekte zu erstellen, Skripte auszuführen und Ausgaben zu überprüfen. Er deckt alles ab, was Script Sync nicht erreichen kann, wie StarterGui und StarterPack.
- Öffnen Sie in Studio das Assistentenfenster über die Schaltfläche Assistent in der oberen rechten Ecke.
- Klicken Sie auf ⋯ → MCP-Server verwalten.
- Bestätigen Sie, dass MCP aktiviert ist.
- Aktivieren Sie unter Schnellverbindung Cursor oder Visual Studio Code.
Wenn Sie Ihren Editor installiert haben, während Studio geöffnet war, müssen Sie möglicherweise Studio, Ihren Editor oder beides neu starten, um die Verbindung herzustellen. Für weitere Details siehe Verbinden mit dem Roblox Studio MCP-Server.
Schritt 9: Überprüfen Sie die MCP-Verbindung
Fordern Sie Ihren Agenten auf:
Verwenden Sie den Roblox MCP, um den aktuellen Spielbaum in Roblox Studio zu lesen. Listen Sie auf, was sich im Workspace befindet.
Möglicherweise müssen Sie den Befehl genehmigen oder das MCP-Tool auf eine Zulassungsliste setzen. Für eine frische Basisplattenvorlage beschreibt die Antwort die Standard-Elemente Camera, Terrain, Baseplate und SpawnLocation und bestätigt, dass es noch keinen anderen Inhalt gibt.
Schritt 10: Führen Sie eine End-to-End-Überprüfung durch
Fordern Sie Ihren Agenten auf, die gesamte Einrichtung auf einmal zu überprüfen:
Verwenden Sie die Roblox MCP-Verbindung, um zu überprüfen, ob Script Sync ordnungsgemäß funktioniert. Nehmen Sie einige Änderungen an Test.server.luau vor, fügen Sie neue Skripte in den anderen beiden Ordnern hinzu und überprüfen Sie die Ausgabe jedes einzelnen. Führen Sie game:GetService("InstanceFileSyncService"):GetStatus(instance) in jedem Skript aus, um den Synchronisierungsstatus zu überprüfen. Wenn Sie fertig sind, löschen Sie alle drei Skripte.
Beobachten Sie in Studio, und Sie werden sehen, wie der Agent einen Playtest startet, um die Ausgabe zu bestätigen.
Schritt 11: In Git committen
Sie haben jetzt eine saubere, funktionierende Konfiguration, was diesen Moment zu einem guten Zeitpunkt macht, um zu committen. Geben Sie in Ihrem Terminal ein:
git add .
git commit -m "Script Sync verbunden und MCP überprüft"Nächste Schritte
Ihr Projekt ist jetzt mit Studio synchronisiert, Ihr KI-Agent kann direkt mit ihm kommunizieren, und Sie haben ein Git-Repository, um Änderungen und Fortschritte zu verfolgen.
Von hier aus können Sie die Datei WAVE_SURVIVAL.md aus dem Starterprojekt als Kontext für Ihren Agenten verwenden, um ein Wellenüberlebensspiel zu erstellen. Folgen Sie dem begleitenden Video, um das Spiel schrittweise zu erstellen.