⚡ Universal Roblox AI Studio — Autonomous Multi-Mode Capability MCP Platform

Universal Roblox AI Studio ist eine neuartige Model-Context-Protocol-Laufzeitumgebung (MCP), die Roblox Studio in eine AI-native, autonome und bidirektionale Entwicklungsplattform für externe KI-Codierungsassistenten (Claude Desktop, Cursor, Antigravity, VS Code usw.) verwandelt.

📖 Inhaltsverzeichnis

• 🌟 Kernfunktionen

• 🏛️ Architektur und 11 spezialisierte Provider

• 🧱 Hierarchie & komponentenorientierte Konstruktion („+“-Paradigma)

• 🛡️ Eingeschränkter und offizieller MCP-Routing-Baum (Restricted Taxonomy)

• 🧠 Selbstheilende Diagnose-Engine (Self-Healing Diagnostics)

• 🛠️ Umfassende MCP-Tool-Liste (63+ Tools)

• 🚀 Schnelle Installation & Erste Schritte

• 🤖 KI-Client-Konfigurationen (Claude Desktop / Cursor)

• 📊 Live-Telemetrie und Studio-Oberfläche

• 🧪 Tests und Validierung

🌟 Kernfunktionen

1. 63+ erstklassige universelle MCP-Tools: DataModel-Hierarchie, Instance-Lebenszyklus, Luau-Script-Verwaltung, PBR-Material, Voxel-Terrain, Playtest-Simulation, 3D Generative AI und virtuelle Hardware-Eingabe.

2. Native Integration des offiziellen Roblox Studio MCP (StudioMCP.exe): Roblox' eigener offizieller MCP-Client (%LOCALAPPDATA%\Roblox\Versions\...\StudioMCP.exe und mcp.bat) wird automatisch erkannt, und eingeschränkte 3D-/Asset-/Playtest-Befehle werden direkt an die offizielle Engine weitergeleitet.

3. Komponenten- & hierarchieorientierte Konstruktion (VisualConstructionEngine): Statt alles mit riesigen Scripts zu erzeugen, werden physische Objekte, Constraints, Lichter, Partikel und Sounds Schicht für Schicht nach der +-Logik (Insert Object) des Studio-Explorers erstellt.

4. Erweiterte Animation & Hardware-Kalibrierung (AnimationAuthoringEngine): R15/R6-Rig-Posen (Motor6D), Gelenksicherheit, KeyframeSequence-Erstellung und Tool.Grip-Kalibrierung, damit Werkzeuge korrekt in der Hand des Charakters sitzen.

5. Selbstheilende Fehlerdiagnose (DiagnosticsEngine): Analysiert Luau-Engine-Fehler (C0 is read only, attempt to index nil, HttpDisabled usw.) sofort und liefert dem KI-Assistenten fertigen Korrekturcode (suggestedFix) und Empfehlungen.

6. 4-stufige dynamische Fähigkeitsauflösung (UniversalCapabilityEngine): Ein Befehl wird direkt über ein Tool, eine Workflow-Vorlage, kompilierte Primitive oder einen autonomen Planer aufgelöst.

7. Bidirektionale sichere HTTP/HTTPS-Brücke: Echtzeit-Ereignisüberwachung zwischen dem Studio-Plugin und dem Node.js-Server (LogService, Fehler, Auswahländerungen) sowie ChangeHistoryService-Undo/Redo-Sicherheit (Ctrl+Z).

🏛️ Architektur und 11 spezialisierte Provider

Universal Roblox MCP arbeitet nicht mit einer statischen Tool-Liste, sondern über 11 spezialisierte Provider (IProvider) und einen zentralen Fähigkeits-Router (CapabilityRouter):

                      ┌────────────────────────────────────────────────────────┐
                      │             AI Client (Claude / Cursor)                │
                      └──────────────────────────┬─────────────────────────────┘
                                                 │ MCP (JSON-RPC)
                                                 ▼
                      ┌────────────────────────────────────────────────────────┐
                      │         Universal Roblox Studio MCP Router             │
                      │           (UniversalCapabilityEngine)                  │
                      └───────┬──────────────────┬───────────────────┬─────────┘
                              │                  │                   │
         ┌────────────────────┴───┐     ┌────────┴────────┐   ┌──────┴────────────────┐
         │ 1. Embedded Plugin     │     │ 2. Official MCP │   │ 3-11. Specialized     │
         │    (HTTP/HTTPS Bridge) │     │ (StudioMCP.exe) │   │       Domain Engines  │
         └────────────┬───────────┘     └────────┬────────┘   └──────┬────────────────┘
                      │                          │                   │
                      │ Polling RPC              │ Stdio / WS        │ Logic & Templates
                      ▼                          ▼                   ▼
    ┌──────────────────────────────────────────────────────────────────────────────────┐
    │                               Roblox Studio Session                              │
    │  • DataModel Tree    • Luau ScriptEditor    • Viewport Framebuffer  • Simulation │
    └──────────────────────────────────────────────────────────────────────────────────┘

Die 11 Provider-Ebenen:

1. EmbeddedPluginProvider: Verwaltet 36 grundlegende Primitive über die Kommunikation mit dem lokalen Plugin in Roblox Studio.

2. OfficialRobloxMCPProvider: Verbindet sich mit der offiziellen StudioMCP.exe-Binärdatei von Roblox und führt eingeschränkte 3D-, Asset- und Playtest-Befehle aus.

3. ModelingProvider: Koordiniert 3D-Meshes, PBR-Materialien und prozedurale Part-Montagen.

4. AnimationProvider: Verwaltet Animationsbausteine, Player-Controller und Rig-Posen.

5. LuauProvider: Sorgt für Luau-Statikanalyse, Syntaxvalidierung und sicheres Code-Ausführen.

6. WorkflowProvider: Implementiert zusammengesetzte Spielsysteme (Tag/Nacht, Leaderstats, Inselgenerator usw.) als Vorlagen.

7. AssetProvider: Ruft Modelle, Sounds und visuelle Assets aus dem Creator Store und der Cloud-Inventar ab bzw. fügt sie ein.

8. TestingProvider: Verwaltet automatisierte Szenariotests, virtuelle Tastatur-/Mauseingaben und Validierungsprozesse.

9. DiagnosticsProvider: Überwacht Studio-Ausgaben, führt Root-Cause-Analysen durch und empfiehlt sichere Reparaturen.

10. ObservationProvider: Verwaltet Viewport-Bildschirmaufnahmen und visuelle Inspektion.

11. DesignProvider: Prüft räumliche Ästhetik, Farbharmonie und Designregeln.

🧱 Hierarchie & komponentenorientierte Konstruktion („+“-Paradigma)

Ein erfahrener Entwickler in Roblox Studio erzeugt nicht alles prozedural mit einem einzigen riesigen Luau-Script. Stattdessen arbeitet er komponenten- und hierarchiebasiert (Component-Driven). Unser System erstellt Objekte in 5 Phasen nach Industriestandard:

[Katman 1: Mekansal İskelet]  ───▶ Model / Folder / Frame / Parts / Meshes / PrimaryPart
            ↓
[Katman 2: Görsel & Duyusal]  ───▶ PBR Materials / PointLight / Particles / Sounds / SurfaceGui
            ↓
[Katman 3: Etkileşim & Fizik] ───▶ ProximityPrompt / HingeConstraint / WeldConstraint / Attachments
            ↓
[Katman 4: Animasyon & Donanım]──▶ KeyframeSequence / Motor6D Poses / Tool Grip Calibration
            ↓
[Katman 5: Ayrık Mantık]      ───▶ Sadece sinyalleri dinleyen hafif ve modüler Luau Controller

Vorgefertigte Komponentenvorlagen (component_compose):

• interactive_door: Holzrahmen (Frame), Scharnier (HingePart), Türblatt (DoorPanel), ProximityPrompt, Öffnungsgeräusch (Sound), TweenService-Controller und benutzerdefinierte Attributes (IsOpen, OpenAngle).

• collectible_coin: Rotierender Zylinder-Coins, Metallmaterial, goldenes PointLight, Sparkles, Sammelgeräusch und CollectionService-Tag.

• equippable_weapon: Kalibrierter Tool.Grip, RightGripAttachment, Handle, Schwinggeräusch, Bewegungsspur (Trail) und Aktivierungsscript.

• interactive_chest: Fester Truhenkörper, aufklappbarer Deckel (ChestLid), HingeConstraint, ProximityPrompt, goldener Glanz und LootTable-Attribute.

• streetlamp_fixture: Metallmast, Glaslampenkopf, PointLight, SpotLight, Neon-Material und automatischer Tag/Nacht-Lichtsensor.

• teleporter_pad: Teleportationsplattform, Partikelstrahl (ParticleEmitter & Beam), Teleportgeräusch und Zielkoordinaten.

• dialogue_npc: Posierter R15/R6-Charakter, BillboardGui-Namensschild, Dialog-ProximityPrompt und Gesprächsbaum.

🛡️ Eingeschränkter und offizieller MCP-Routing-Baum (Restricted Taxonomy)

Die Roblox-Engine schränkt aus Sicherheitsgründen einige APIs für Drittanbieter-Plugins ein (RobloxSecurity, RobloxScriptSecurity, SensitiveInput, Capture). Unser System erkennt diese Einschränkungen automatisch über die RestrictedCapabilityRegistry und leitet sie direkt an den offiziellen StudioMCP.exe-Proxy weiter:

RESTRICTED / OFFICIAL-ONLY (12 Kategori)
├── 1. RobloxSecurity                   ──▶ official-roblox-mcp (execute_luau / search_game_tree)
├── 2. RobloxScriptSecurity             ──▶ official-roblox-mcp (script_grep / execute_luau)
├── 3. Internal Studio APIs             ──▶ official-roblox-mcp (get_studio_state, list_roblox_studios)
├── 4. Internal Engine APIs             ──▶ official-roblox-mcp (generate_mesh / get_console_output)
├── 5. Internal Plugin APIs             ──▶ official-roblox-mcp (internal plugin manager)
├── 6. Protected Debug APIs             ──▶ official-roblox-mcp (get_console_output)
├── 7. Protected Studio Control APIs    ──▶ official-roblox-mcp (start_stop_play [Play/Run/Stop])
├── 8. Missing Sandbox Capabilities     ──▶ official-roblox-mcp (screen_capture, keyboard/mouse input)
├── 9. Restricted Asset APIs            ──▶ official-roblox-mcp (generate_mesh, generate_material, search_asset)
├── 10. Restricted HTTP APIs            ──▶ official-roblox-mcp (Cloud Auth HTTP)
├── 11. Internal Network APIs           ──▶ official-roblox-mcp (Replication diagnostics)
└── 12. Provider-Specific Capabilities  ──▶ official-roblox-mcp (subagent, execute_luau)

🧠 Selbstheilende Diagnose-Engine (Self-Healing Diagnostics)

KI-Modelle können bei der Codeausführung auf häufige Roblox-API-Fehler stoßen. Die DiagnosticsEngine fängt diese Fehler ab und erzeugt direkt funktionierende Lösungen für die KI:

🛠️ Umfassende MCP-Tool-Liste (63+ Tools)

1. Visuelle Konstruktions- & Animationswerkzeuge

• component_compose: Baut vollständige Komponenten (Tür, Truhe, Coin, NPC usw.) mit vorgefertigten Vorlagen.

• component_template_list: Listet alle verfügbaren Komponentenvorlagen und Hierarchiebäume auf.

• hierarchy_scaffold: Unterteilt das Studio-Projekt nach professionellen Industriestandards in Ordner.

• tool_grip_calibrate: Kalibriert automatisch die Griffwinkel von Waffen und Gegenständen in der Hand des Charakters (Tool.Grip).

• rig_pose_and_animate: Posed R15/R6-Charaktergelenke (Motor6D) sicher.

2. Offizielle Roblox-MCP-Tools (StudioMCP.exe-integriert)

• generate_mesh: Erzeugt 3D-Meshes aus natürlichen Sprachbefehlen über Roblox Cloud AI.

• generate_material: Erzeugt PBR-Materialien und Texturen aus natürlichen Sprachbefehlen.

• generate_procedural_model: Erstellt prozedurale Part-Montagen.

• search_asset & insert_asset: Sucht und platziert Assets aus dem Creator Store und der Cloud-Bibliothek.

• screen_capture: Nimmt hochauflösende Screenshots aus dem 3D-Viewport von Studio auf.

• start_stop_play: Startet das Spiel physisch (Play/Run) oder kehrt in den Bearbeitungsmodus zurück (Stop).

• get_studio_state: Fragt die Studio-Sitzung, das geöffnete Dokument und den aktiven Simulationsmodus ab.

• list_roblox_studios & set_active_studio: Listet laufende Studio-Fenster auf und wählt das aktive aus.

• character_navigation: Bewegt den Charakter während der Simulation zu 3D-Weltkoordinaten.

• user_keyboard_input & user_mouse_input: Injiziert Tastatur- und Mausklicks auf Hardware-Ebene in die Simulation.

• script_read, multi_edit, script_search, script_grep: Lokale Mehrfachdatei-Bearbeitung und Suche über den Studio-Script-Editor.

• subagent & execute_luau: Führt Roblox' lokalen Sub-Agenten und die Luau-Codeausführungs-Engine aus.

3. Grundlegende DataModel- & Primitive-Tools

• studio_info, studio_get_tree, studio_search, studio_inspect: DataModel-Hierarchie-Scan und tiefgehende Eigenschaftsprüfung.

• instance_create, instance_delete, instance_clone, instance_reparent, instance_rename, instance_move: Objektlebenszyklus und 3D-Positionierung.

• property_get, property_set, property_get_all: Eigenschaftslesen/-schreiben mit automatischer Luau-Typkonvertierung.

• attribute_get, attribute_set, attribute_delete, attribute_get_all: Attributverwaltung.

• script_get_source, script_set_source, script_patch_source, script_search_code: Script-Quellcode lesen, zeilenbasiertes Patchen und Codesuche.

• selection_get, selection_set, selection_add, selection_clear: Auswahlsteuerung im Studio-Explorer.

• output_get, output_get_errors, output_clear: Ausgabeprotokoll und Fehlererfassung.

• terrain_fill_block, terrain_fill_ball, terrain_clear: Voxel-Terrain erstellen und löschen.

• batch_execute: Atomische Mehrfachbefehlsausführung in einem einzigen Vorgang (mit Undo/Redo-Waypoint-Unterstützung).

🚀 Schnelle Installation & Erste Schritte

1. Voraussetzungen

• Node.js: v18.0.0 oder höher (v20+ / v24 empfohlen).

• Roblox Studio: Installiert auf Windows oder macOS.

2. Repository klonen und kompilieren

git clone <repo-url>
cd "Roblox Studio MCP"
npm install
npm run build

3. Roblox-Studio-Plugin installieren

Sie können das Plugin auf eine von zwei Arten installieren:

Methode A: Fertige Plugin-Datei kopieren (Empfohlen)

Führen Sie npm run bundle:plugin und node scripts/build-rbxmx.js aus (oder kopieren Sie die kompilierten Dateien):

• Windows: Kopieren Sie die Datei plugin-build\RobloxUniversalMCP.rbxmx in das Verzeichnis %LOCALAPPDATA%\Roblox\Plugins\.

• macOS: Kopieren Sie die Datei plugin-build/RobloxUniversalMCP.rbxmx in das Verzeichnis ~/Library/Application Support/Roblox/Plugins/.

Methode B: Manuelle Installation in Studio

1. Öffnen Sie in Roblox Studio ein beliebiges Place.

2. Fügen Sie den Inhalt der Datei plugin-build/RobloxUniversalMCP.luau in ein Script ein.

3. Klicken Sie mit der rechten Maustaste auf das Script und wählen Sie "Save as Local Plugin...".

4. Aktivieren Sie unter Home > Game Settings > Security die Option "Allow HTTP Requests".

🤖 KI-Client-Konfigurationen (Universelle Einrichtung für alle Computer)

Für den stabilen und portablen Betrieb auf jedem Computer werden 3 verschiedene universelle Methoden angeboten:

🌟 Methode 1: Globale CLI-Registrierung (Empfohlen — Eine Zeile auf allen Computern!)

Führen Sie einmalig npm link im Projektordner aus, um das System als globalen Befehl zu registrieren:

npm run build
npm link

Danach müssen Sie in Claude Desktop, Cursor oder einem beliebigen MCP-Client keinen Dateipfad mehr angeben:

Claude Desktop (claude_desktop_config.json)

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "roblox-universal-studio": {
      "command": "roblox-studio-mcp"
    }
  }
}

🚀 Methode 2: Cursor / VS Code Universeller Arbeitsbereich (${workspaceFolder})

Wenn Sie das Projekt in Cursor oder VS Code öffnen, fügen Sie es zur Datei .cursor/mcp.json oder .vscode/mcp.json hinzu. Egal auf welchem Computer es geöffnet wird, ${workspaceFolder} wird automatisch erkannt:

{
  "mcpServers": {
    "roblox-universal-studio": {
      "command": "node",
      "args": [
        "${workspaceFolder}/dist/index.js"
      ]
    }
  }
}

📁 Methode 3: Direkte Ausführung mit Angabe des Dateipfads

Falls Sie anstelle der globalen CLI direkt die kompilierte Datei dist/index.js aufrufen möchten:

{
  "mcpServers": {
    "roblox-universal-studio": {
      "command": "node",
      "args": [
        "<PROJE_KLASORUNUZ_TAM_YOLU>/dist/index.js"
      ]
    }
  }
}

(Beispiel Windows: C:\\Projects\\Roblox-Studio-MCP\\dist\\index.js | macOS: /Users/username/Projects/Roblox-Studio-MCP/dist/index.js)

📊 Live-Telemetrie und Studio-Oberfläche

Wenn das Plugin geladen ist, wird in Roblox Studio ein spezielles DockWidget (DiagnosticsView) geöffnet:

• Plugin Runtime: ONLINE / STANDALONE

• MCP Bridge: CONNECTED (Grün) / DISCONNECTED (Rot)

• Capabilities Discovered: 80+ Live Capabilities (Alle Anbieter und Subsysteme)

• Low-Level Tools: 57 Primitive Tools

• High-Level Workflows: 19 Composite Workflows

• Total Universal Tools: 76 Universal Tools

• Active Mode: CHAT | OBSERVE | BUILD | PLAYTEST | AUTONOMOUS

🧪 Test und Validierung

Um die gesamte Testsuite auszuführen:

npm test

Testausgabe:

✔ Tool Registry contains all universal tools
✔ HTTP Bridge Status returns disconnected when no session is active
✔ HTTP Bridge Handshake registers studio session
✔ Executing a command dispatches over polling RPC and resolves with response
✔ 11 Providers are registered and operational in ProviderRegistry
✔ Universal Capability Engine resolves across 4-tier hierarchy
✔ MultiModeEngine handles operating mode transitions and permissions
✔ Live Dashboard endpoint returns comprehensive real-time telemetry
✔ Visual Construction Engine lists rich archetypes and templates
✔ Animation Authoring Engine calibrates tool grips and keyframe sequences

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Viel Spaß mit der KI-nativen Spieleentwicklungserfahrung mit Roblox Studio! 🎮⚡