Eine Schritt-für-Schritt-Anleitung zur Eingrenzung von Verbindungs-, Berechtigungs-, Sync- und Validierungsproblemen.
Plugin verbindet sich nicht
Symptom: “Verbindung fehlgeschlagen” oder das Plugin wird in Roblox Studio als getrennt angezeigt.
- Bestätigen Sie, dass der MCP-Server läuft:
npx -y @weppy/roblox-mcp - Roblox Studio: Plugins-Tab → WEPPY → klicken Sie auf Connect
- Stellen Sie sicher, dass keine Firewall, kein Antivirus oder VPN
localhost:3002blockiert - Starten Sie sowohl Roblox Studio als auch den MCP-Server neu
KI-Client erkennt MCP-Server nicht
- Prüfen Sie, ob der korrekte Befehl in den KI-Client-Einstellungen verwendet wird:
npx -y @weppy/roblox-mcp - Bestätigen Sie, dass Node.js 18 oder höher installiert ist:
node --version - Wenn Sie unter Windows einen Berechtigungsfehler erhalten, versuchen Sie, das Terminal als Administrator auszuführen
- Prüfen Sie die Installationsanleitung für Ihre KI-App
Hinweis “Pro-Funktion erforderlich”
Wenn auf Basic eine Pro-exklusive Action angefordert wird, versucht WEPPY nach Möglichkeit, eine Umgehung zu finden. Der Umgehungsfluss verbraucht jedoch zusätzliche Token und liefert nicht immer identische Ergebnisse.
Einige Pro-exklusive Tools haben außerdem keine machbare Umgehung und können auf Basic überhaupt nicht ausgeführt werden. Wenn dieser Hinweis wiederholt erscheint, erwägen Sie ein Upgrade auf Pro.
Sync funktioniert nicht
- Sync-Status prüfen: bitten Sie die KI,
manage_sync statusauszuführen - Bestätigen Sie, dass das Plugin verbunden ist, bevor Sie Sync starten
- Wenn Reverse-Sync (Datei → Studio) nicht funktioniert, überprüfen Sie, ob der Pro-Tier aktiv ist
- Bestätigen Sie, dass der lokale Sync-Ordner existiert und Schreibrechte hat
Siehe Bidirektionaler Sync für detaillierte Sync-Konfiguration.
Kompatible KI-Clients
| Client | Basic | Pro |
|---|---|---|
| Claude Code | ✅ | ✅ |
| Claude Desktop | ✅ | ✅ |
| Cursor | ✅ | ✅ |
| Codex CLI | ✅ | ✅ |
| Codex Desktop | ✅ | ✅ |
| Gemini CLI | ✅ | ✅ |
| Jede MCP-kompatible App | ✅ | ✅ |
Server-Befehl: npx -y @weppy/roblox-mcp
Systemanforderungen
| Element | Minimum |
|---|---|
| Node.js | 18.0.0 oder höher |
| Roblox Studio | Neueste Version (Auto-Update aktiviert lassen) |
| Betriebssystem | Windows 10+ oder macOS 12+ |
| Netzwerk | localhost:3002 muss zugänglich sein |
Basic vs Pro Funktionsvergleich
Basic (kostenlos) deckt den zentralen KI-Coding-Workflow ab. Es enthält alle wesentlichen Tools für Instanzen, Eigenschaften, Skripte, Auswahl, Kamera und Logs sowie Studio → Lokal Einweg-Sync und Tool-Ausführungsverlauf. Pro ergänzt bidirektionalen Sync, Massenoperationen und eine erweiterte Tool-Suite, die Terrain, Beleuchtung, Physik, Audio und Animationen abdeckt.
| Funktion | Basic | Pro |
|---|---|---|
| Instanzen suchen, erstellen, löschen, klonen und verschieben | ✅ | ✅ |
| Instanzbaum- und Hierarchie-Navigation | ✅ | ✅ |
| Eigenschaften und Tags lesen/schreiben | ✅ | ✅ |
| Skripte lesen, schreiben und bearbeiten | ✅ | ✅ |
| Auswahlverwaltung | ✅ | ✅ |
| Kamerabewegung und Fokus | ✅ | ✅ |
| Log-Anzeige | ✅ | ✅ |
| System-Info und Verbindungsprüfung | ✅ | ✅ |
| Tool-Ausführungsverlauf und Statistiken | ✅ | ✅ |
| Studio → Lokal Einweg-Sync | ✅ | ✅ |
| Bidirektionaler Sync (Lokal → Studio) | — | ✅ |
| Per-Typ Direction / Apply Mode | — | ✅ |
| Sync-Änderungsverlauf | — | ✅ |
| Multi-Place-Sync (bis zu 3) | — | ✅ |
| Massenoperationen (Batch erstellen/bearbeiten) | — | ✅ |
| Beleuchtungs- und Atmosphärensteuerung | — | ✅ |
| Terrain-Generierung und -Bearbeitung | — | ✅ |
| Tween- und Animationssteuerung | — | ✅ |
| Audiosteuerung | — | ✅ |
| Partikel und Effekte | — | ✅ |
| Physik-Gruppen und Kollision | — | ✅ |
| Räumliche Abfragen und Raycasting | — | ✅ |
| Asset-Suche, -Einfügung und -Export | — | ✅ |
| Screenshot-Aufnahme | — | ✅ |
| Automatisierter Playtest und Testinjektion | — | ✅ |
| Batch-Ausführung und beliebiger Luau-Code | — | ✅ |
Wenn ein Basic-Benutzer eine Pro-exklusive Funktion anfordert, findet WEPPY nach Möglichkeit eine Umgehung, was jedoch mehr Token verbraucht und einige Funktionen überhaupt nicht umgangen werden können. Siehe den Abschnitt Hinweis “Pro-Funktion erforderlich” oben für Details.
Häufige Fehlermeldungen
| Fehler | Ursache | Behebung |
|---|---|---|
ECONNREFUSED localhost:3002 | MCP-Server läuft nicht | Führen Sie npx -y @weppy/roblox-mcp aus |
Timeout waiting for plugin | Studio-Plugin nicht verbunden | Klicken Sie im Plugin-Panel auf Connect |
Forbidden path | Versuchter Zugriff auf CoreGui/CorePackages | Verwenden Sie nur gültige Instanzpfade |
Place ID mismatch | Falscher Place verbunden | Erneut aus der korrekten Studio-Session verbinden |
Hilfe benötigt?
Wenn das Problem immer noch nicht gelöst ist, posten Sie in GitHub Discussions mit den folgenden Informationen:
- Betriebssystem und Node.js-Version
- KI-Client und Version
- Fehlermeldung oder Logs
- Schritte, die Sie bereits versucht haben