Mit einem Code-Harness bauen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Dieser Leitfaden und das begleitende Video führen Sie durch die Verbindung eines KI-gestützten Codierungsharneses mit Roblox Studio über MCP, damit 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 ist, 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:

  1. Einen KI-gestü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 Sie bevorzugen.
  2. Roblox Studio - Laden Sie es von create.roblox.com herunter.
  3. Git - Installieren Sie es von git-scm.com.
    • Unter Windows können Sie WinGet verwenden: winget install --id Git.Git -e --source winget.
    • Unter macOS können Sie Homebrew verwenden: brew install git.

Schritt 2: Melden Sie sich überall an

  1. 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 sich das Chat-Fenster öffnet. Andere Anbieter sind ähnlich.
    • Cursor — Öffnen Sie Cursor, melden Sie sich mit Ihrem Cursor-Konto an und bestätigen Sie, dass sich das Chat-Fenster öffnet. Sie können jedes Modell verwenden, das Sie bevorzugen.
  2. 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 bietet Ihnen das Ordnerlayout und eine .gitignore-Datei, damit Git nur die Teile Ihres Projekts verfolgt, die wichtig sind. Der Großteil der manuellen Einrichtung ist bereits für Sie erledigt.

  1. Laden Sie das Starter-Repository herunter und entpacken Sie es. Es enthält bereits einen Ordner namens WaveSurvival.
  2. Wählen Sie in Ihrem Editor Datei → Ordner öffnen und wählen Sie WaveSurvival. Sie sollten drei Ordner darin sehen:
    • ServerScriptService/ enthält Server-Skripts, wie Spiel-Logik, Gegner-KI und Wellenverwaltung.
    • ReplicatedStorage/ enthält gemeinsam genutzte Module, die sowohl der Server als auch der Client verwenden können.
    • StarterPlayerScripts/ enthält Client-Skripts, 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

  1. Öffnen Sie Roblox Studio und klicken Sie auf Neue Erfahrung.
  2. Wählen Sie Datei → Speichern unter, navigieren Sie zu Ihrem WaveSurvival-Ordner und speichern Sie den Ort als WaveSurvival.rbxlx. Die .gitignore des Starter-Repositories schließt bereits .rbxlx-Dateien von Git aus.
  3. Lassen Sie Studio offen. Sie benötigen es für Script Sync und MCP.

Schritt 5: Aktivieren Sie die Script Sync Beta

Script Sync ist ein Beta-Feature, das Sie aktivieren müssen, bevor Sie es verwenden können.

  1. Wählen Sie in Studio Datei → Beta-Funktionen.
  2. Suchen Sie Script Sync, aktivieren Sie es und klicken Sie auf Speichern.
  3. 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.

  1. Klicken Sie im Explorer mit der rechten Maustaste auf ServerScriptService.
  2. Wählen Sie Script Sync → Synchronisieren zu, und navigieren Sie zu Ihrem WaveSurvival-Ordner.
  3. Wiederholen Sie dies für ReplicatedStorage und StarterPlayerScripts.

Alle .luau-Dateien, die Sie in diesen Ordnern erstellen, werden jetzt automatisch als Skripts in Studio angezeigt.

Schritt 7: Überprüfen Sie Script Sync

Fordern Sie in der Chat-Panel Ihres Editors Ihren Agenten auf:

Erstellen Sie ein Testskript in ServerScriptService/Test.server.luau, das 'Hello from Script Sync!' in die Ausgabe druckt.

Überprüfen Sie im Studio den Explorer. Sie sollten sehen, dass Test unter ServerScriptService erscheint. Sie werden eine tiefere, agentengestützte Ü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, Skripts auszuführen und Ausgaben zu überprüfen. Er deckt alles ab, was Script Sync nicht erreichen kann, wie StarterGui und StarterPack.

  1. Öffnen Sie in Studio das Assistant-Fenster über die Assistant-Schaltfläche oben rechts.
  2. Klicken Sie auf ⋯ → MCP-Server verwalten.
  3. Bestätigen Sie, dass MCP aktiviert ist.
  4. 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 beide 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 Erlaubenliste setzen. Für eine frische Basisplattenvorlage beschreibt die Antwort die Standard-Elemente Camera, Terrain, Baseplate und SpawnLocation und bestätigt, dass noch kein anderer Inhalt vorhanden ist.

Schritt 10: Führen Sie einen End-to-End-Check 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 Skripts 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 Skripts.

Beobachten Sie in Studio, und Sie werden sehen, wie der Agent einen Playtest startet, um die Ausgabe zu bestätigen.

Schritt 11: Committieren Sie zu Git

Sie haben jetzt eine saubere, funktionierende Konfiguration, was einen guten Moment zum Committieren darstellt. Führen Sie von Ihrem Terminal aus:


git add .
git commit -m "Script Sync verbunden und MCP überprüft"

Nächste Schritte

Ihr Projekt ist nun mit Studio synchronisiert, Ihr KI-Agent kann direkt damit 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 Starter-Projekt als Kontext für Ihren Agenten verwenden, um ein Wellenüberlebensspiel zu erstellen. Verfolgen Sie das begleitende Video, um das Spiel schrittweise zu erstellen.

©2026 Roblox Corporation. Roblox, das Roblox-Logo und "Powering Imagination" gehören zu unseren eingetragenen und nicht eingetragenen Markenzeichen in den USA und anderen Ländern.