WEPPY

Loslegen

Die wesentlichen ersten Schritte nach der Installation — verbinden Sie den MCP-Server und das Studio-Plugin.

Die Verwendung von Roblox MCP erfordert zwei Komponenten.

KI-App (Claude, Codex, Gemini, etc.)

   MCP-Server  ← Übersetzt KI-Befehle in eine für Roblox verständliche Form

Roblox Studio Plugin  ← Führt Befehle innerhalb von Studio aus

Wenn Ihre KI-App “erstelle einen blauen Part” sagt, übersetzt der MCP-Server die Anfrage und das Roblox Studio Plugin erstellt den Part tatsächlich.

Ein-Zeilen-Installation (Empfohlen)

Führen Sie den einzelnen Befehl unten aus, um sowohl den MCP-Server als auch das Plugin auf einmal zu installieren.

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

Öffnen Sie nach der Installation Ihre KI-App erneut und starten Sie Roblox Studio neu.

Wenn während der Installation ein Fehler auftritt, wird der Pfad zu einer temporären Log-Datei ausgegeben. Im interaktiven Modus bleibt die Konsole vor dem Beenden offen, damit Sie die Ursache sehen können.

Automatische MCP-Registrierung wird unterstützt für Claude Code, Claude Desktop, Cursor, Codex CLI / App, Gemini CLI und Antigravity.

Wenn die PowerShell-Ausführung unter Windows blockiert ist, fahren Sie mit der manuellen Installation unten fort. Bei Verwendung des ZIP-Pakets können Sie setup-plugin.bat und setup-mcp.bat ausführen.

Manuelle Installation

Ein alternatives Verfahren, wenn die Ein-Zeilen-Installation nicht funktioniert oder die automatische Installation in Ihrer Umgebung nicht verfügbar ist.

Schritt 1 — Roblox Studio Plugin installieren

Laden Sie die Plugin-Datei von GitHub herunter und platzieren Sie sie im Roblox Studio Plugins-Ordner.

Schritt 2 — MCP-Server in Ihrer KI-App registrieren

Wählen Sie Ihre KI-App und folgen Sie der entsprechenden Setup-Anleitung. WEPPY funktioniert mit jeder KI-App, die MCP unterstützt.

Auch wenn Ihre KI-App oben nicht aufgeführt ist, können Sie sie verwenden, solange sie MCP unterstützt. Der MCP-Server-Befehl lautet npx -y @weppy/roblox-mcp.

Optional — WEPPY Roblox Explorer (VSCode-Erweiterung)

Durchsuchen Sie den synchronisierten Instanzbaum mit Roblox-Klassen-Icons direkt in VSCode. Diese Erweiterung erfordert, dass die Roblox MCP-Installation oben zuerst abgeschlossen ist, da der Explorer die weppy-project-sync Sync-Daten unter Ihrem Projektstamm liest.

Nach der Installation

  1. Öffnen Sie Roblox Studio und klicken Sie auf WEPPY → Connect im Plugins-Tab.

  2. Testen Sie es aus Ihrer KI-App:

    Erstelle einen blauen Part in Roblox Studio
  3. Wenn der Part erfolgreich erstellt wurde, ist die Installation abgeschlossen.