Das erste spielbare Unreal-Level mit Claude Opus 5.5

Die praktische Empfehlung lautet: Verbinde Claude Code, Unreal, Meshy und Blender nicht alle am ersten Tag. Beweise zuerst, dass Claude Code die tatsächlich laufende Unreal-Editor-Instanz lesen kann. Baue danach eine Greybox, durch die du laufen, in der du drei Objekte sammeln, gewinnen und neu starten kannst. Prüfe jede Stufe selbst in Play. Erst wenn diese Schleife stabil ist, solltest du entscheiden, ob ein generiertes 3D-Asset oder eine Bereinigung in Blender die zusätzliche Komplexität rechtfertigt.

Dieser Leitfaden basiert auf aktueller Dokumentation. Er behauptet nicht, dass der Autor dein Projekt ausgeführt hat. Epic kennzeichnet Unreal MCP weiterhin als Experimental und weist darauf hin, dass Funktionen, APIs und Datenformate sich ändern können. Deshalb sind eine MCP-Verbindung, ein erfolgreicher Tool-Status und ein wirklich spielbares Ergebnis hier drei verschiedene Beweise.

Passt dieser Ansatz zu dir?

Der Ablauf eignet sich am besten für Solo-Entwickler, die grundlegende Unreal-Konzepte verstehen, ihr Projekt unter Versionskontrolle halten und nach jeder kleinen Änderung selbst in Play testen. Claude kann klar beschriebene und überprüfbare Arbeit beschleunigen. Es kann nicht allein beurteilen, ob Bewegung, Kamera, Kollision oder Spielgefühl gut sind.

Situation	Empfehlung
Du verstehst die Projektstruktur, prüfst Änderungen und testest in Play	Beginne mit der minimalen Greybox unten
Du willst nur die Spielschleife validieren	Nutze Unreal-Primitives; verschiebe Meshy und Blender
Es gibt keine Sicherung oder Rollback-Möglichkeit	Stoppe und erstelle eine Kopie mit Versions-Checkpoints
Du erwartest ein fertiges Spiel aus einem Prompt	Zerlege das Ziel zuerst in beobachtbare Systeme
Es geht nur um einen Actor-Transform oder einen Zahlenwert	Manuelles Ändern ist meist schneller

Anthropic positioniert Opus 5.5 für komplexe Programmierung und lang laufende agentische Aufgaben. Das macht ein visuelles Ergebnis nicht selbstprüfend. Lass das Modell lesen, planen und ausführen; Genehmigung, Beobachtung und Play-Validierung bleiben beim Menschen.

Definiere zuerst das kleinste spielbare Ergebnis

Das Ziel dieses Leitfadens hat nur vier Anforderungen:

1. Der Spieler startet bei Player Start und kann einer klaren Route bis zum Ziel folgen.
2. Drei sichtbare Sammelobjekte erhöhen einen Zähler jeweils genau einmal von 0 auf 3.
3. Das Ziel löst nur nach allen drei Objekten einen Sieg aus.
4. R setzt Spielerposition, Zähler, Sammelobjekte und Siegzustand zurück.

Schreibe diese Punkte in das Projekt-Briefing. Notiere für jedes Änderungspaket: Änderung, erwartetes Ergebnis, tatsächliches Ergebnis und bestanden/nicht bestanden. Connected ist nicht spielbar. Kompiliert ist nicht spielbar. Eine vom Tool angenommene Anfrage ist nicht spielbar. Nur ein manueller Play-Test beweist die jeweilige Stufe.

Stufe 1: Claude Code mit dem offiziellen Unreal MCP verbinden

Zuerst einen Wiederherstellungspunkt anlegen

Speichere das Projekt und erstelle einen Commit oder Shelve des aktuellen Zustands. Epics offizielles Plugin gibt Claude breiten Live-Zugriff auf den Editor, einschließlich eines Tools, das Python im Editorprozess ausführen kann. Das README empfiehlt, diesen Zugriff wie die Ausführung beliebigen, vom Assistenten erzeugten Codes zu behandeln, vor langen Sitzungen zu speichern und den Diff zu prüfen.

Nutze --dangerously-skip-permissions nicht in einem wichtigen Projekt. Lerne den Ablauf in einer Kopie, Sandbox oder Wegwerf-Branch.

Beide Unreal-Plugins aktivieren

Diese Anleitung folgt der aktuellen offiziellen Unreal-MCP-Seite unter Unreal Engine 5.8 Documentation. Sie setzt voraus, dass dein Engine-Build Unreal MCP (ModelContextProtocol) und All Toolsets (AllToolsets) tatsächlich enthält. Daraus folgt nicht, dass jede UE5-Version dieselben Plugins besitzt. Fehlt eines davon, stoppe und nutze einen von Epic dokumentierten Build, statt einen Community-MCP als Ersatz einzusetzen.

Folge der offiziellen Einrichtung:

• Aktiviere unter Edit → Plugins Unreal MCP.
• Aktiviere auch All Toolsets. Ohne dieses Plugin kann der Server vorhanden sein, aber keine nutzbaren Tools liefern.
• Starte den Editor neu.
• Aktiviere Auto Start Server in Editor Preferences oder führe in der Konsole aus:

ModelContextProtocol.StartServer

Der lokale Standard-Endpunkt ist http://127.0.0.1:8000/mcp. Er hat standardmäßig keine Authentifizierung und ist nicht für Fernzugriff gedacht. Leite den Port nicht ins Internet weiter und nutze ihn nicht auf einem gemeinsam verwendeten Rechner.

Claude-Code-Konfiguration erzeugen

Führe in der Unreal-Konsole aus:

ModelContextProtocol.GenerateClientConfig ClaudeCode

Eine Launcher-Installation schreibt .mcp.json normalerweise neben die .uproject; ein Source-Build kann sie im Workspace-Root neben Engine/ ablegen. Erzeuge die Datei nach einem Portwechsel neu. Starte Claude Code aus dem Root, das die erzeugte Konfiguration enthält.

Installiere Epics offizielles Claude-Code-Plugin:

/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official

Falls der offizielle Marketplace fehlt, füge ihn zuerst hinzu:

/plugin marketplace add anthropics/claude-plugins-official

Modellzugriff, Editor und Asset-Dienst getrennt halten

Claude Code kann ein Anthropic-Konto oder eine kompatible Modell-API verwenden. Bei BetterToken verlangt die aktuelle Claude-Code-Anleitung, ANTHROPIC_BASE_URL auf https://bettertoken.ai ohne /v1 zu setzen und ANTHROPIC_AUTH_TOKEN lokal bereitzustellen. Füge einen echten Schlüssel nie in einen Chat, ein Repository oder ein Materialpaket ein.

Die offizielle Modell-ID von Anthropic lautet claude-opus-5-5. Beim Routing über BetterToken kopierst du die exakte ID aus dem aktuellen Model Plaza und bestätigst ihre Verfügbarkeit für die gewählte Key-Gruppe; prüfe nach dem Start das tatsächliche Routing mit /model und den Request-Daten des Anbieters, statt einer alten kopierten Konfiguration zu vertrauen.

Einen echten Read-only-Aufruf prüfen

Kontrolliere alle vier Ebenen:

• /plugin zeigt das offizielle Unreal-Plugin als aktiviert;
• /mcp zeigt unreal-mcp;
• das Unreal Output Log enthält keinen Port- oder Abhängigkeitsfehler;
• ein Read-only-Prompt liefert den echten Levelnamen, wichtige Actor und das Vorhandensein von Player Start.

Erst die letzte Prüfung beweist, dass der Editor erreichbar ist. Epic weist ausdrücklich darauf hin, dass ein connected Proxy oder gecachte Tools keine erfolgreichen Live-Aufrufe garantieren.

Stufe 2: nur eine begehbare Greybox bauen

Beginne mit einer bereits spielbaren Third-Person-Basis. Ein Player Start markiert nur den Spawnpunkt; er liefert nicht von selbst steuerbaren Charakter, GameMode, Eingabe oder Kamera. Für ein neues Projekt eignet sich Unreals Template Third Person. In einem bestehenden Projekt prüfst du, ob der aktive GameMode einen steuerbaren Third-Person-Pawn spawnt, Bewegung und Follow Camera funktionieren und der Level einen Player Start enthält.

Bevor MCP Geometrie verändert, klicke auf Play, nicht Simulate. Prüfe, ob tatsächlich ein Charakter erscheint, WASD ihn bewegt und die Maus die Kamera steuert; beende danach PIE. Schlägt etwas fehl, repariere zuerst diese Basis, statt das Problem im Greybox-Prompt zu verstecken.

Nach dem PASS soll Claude Level, GameMode, Spielerfigur und verfügbare Toolsets nur lesen und Plan sowie geänderte Assets nennen. Ein fehlendes Tool beendet die Aufgabe. Eine brauchbare Grenze lautet:

Erstelle auf Basis der bereits in Play geprüften Third-Person-Grundlage eine minimale Greybox im aktuellen Level. Behalte Spielerfigur, GameMode, Input Mappings und Kamera bei; ersetze oder rekonstruiere sie nicht. Verwende Primitives für Boden, Grenzen, einen klaren Weg und eine Zielmarke. Keine Gegner, Art Assets oder komplexe UI. Melde jedes erstellte oder geänderte Asset. Stoppe bei fehlendem Tool, fehlgeschlagener Kompilierung oder einem Ergebnis ohne ausdrücklichen Erfolg.

Bei der Ausführung:

• Abhängige Änderungen am selben Asset oder Editor-Zustand seriell ausführen.
• C++-, Blueprint- oder Shader-Kompilierung abwarten; eine angenommene Anfrage ist keine fertige Kompilierung.
• Jeden Ergebnisstatus lesen und ohne ausdrücklichen Erfolg stoppen.

Play-Test A: Klicke erneut auf Play, starte mit der am Player Start erzeugten Figur und gehe die gesamte Strecke. Sie darf weder Grenzen verlassen noch in Engstellen hängen oder über unsichtbare Hindernisse springen müssen. Behebe nur den beobachteten Fehler, ohne Kamera, Materialien oder Strecke nebenbei neu zu gestalten.

Danach speichern, committen und einen Wiederherstellungspunkt markieren.

Stufe 3: drei Sammelobjekte hinzufügen

Das nächste Paket ergänzt nur die Sammelregeln und schützt die bereits akzeptierte Route:

Füge entlang der Route drei gut sichtbare, getrennte Sammelobjekte hinzu. Berührung darf jedes Objekt nur einmal auslösen; danach wird es ausgeblendet oder entfernt, und ein lesbarer Zähler steigt von 0 auf 3. Verschiebe weder Player Start noch Route, Grenzen oder Ziel. Nenne beteiligte Blueprints, Variablen, Events und UI-Assets und liefere eine Play-Checkliste.

Play-Test B: Sammle in normaler und umgekehrter Reihenfolge; jedes Objekt zählt einmal; die Folge lautet 1, 2, 3; erneutes Betreten eines alten Ortes erhöht nichts; eine neue Play-Sitzung beginnt bei 0.

Wenn Claude „fertig“ meldet, der Zähler sich in Play aber nicht ändert, ist die Stufe nicht bestanden. Notiere Verhalten und Output Log, fordere zuerst eine Diagnose und anschließend genau eine eng begrenzte Korrektur an.

Stufe 4: Sieg und Neustart

Das letzte Gameplay-Paket ergänzt nur Abschluss und Reset:

Das Ziel zeigt nur bei Zählerstand 3 einen Sieg. Mit weniger Objekten darf kein Sieg ausgelöst werden. R startet das Level neu und stellt Spielerposition, alle drei Objekte, Zähler und Sieg-UI wieder her. Route und Input bleiben unverändert. Nenne die Änderungen und liefere eine Play-Checkliste mit fünf Schritten.

Play-Test C:

1. Mit zwei Objekten zum Ziel: kein Sieg.
2. Alle drei sammeln und ankommen: Sieg erscheint.
3. In der Mitte R drücken: alles wird zurückgesetzt.
4. Nach dem Sieg R drücken: alles wird zurückgesetzt.
5. In anderer Reihenfolge sammeln: Verhalten bleibt korrekt.

Erst jetzt gibt es ein erstes spielbares Level. Speichere, committe und behalte eine stabile Version ohne externe Grafik.

Meshy oder Blender erst nach bestandener Greybox ergänzen

Beides sind optionale Zweige, keine Standardvoraussetzungen.

Meshy nur für ein wirklich wertvolles, besonderes Objekt

Dieser Zweig bleibt optional. Der offizielle Meshy MCP Server benötigt einen gültigen MESHY_API_KEY; API-Keys erfordern einen geeigneten bezahlten Tarif, und API-Anfragen verbrauchen vorausbezahlte API-Credits. Tarif oder Guthaben in der Web-App beweisen nicht allein, dass API-Zugang und API-Guthaben nutzbar sind. Prüfe vor der Generierung meshy_check_balance.

Für Claude Code unter Bash nutzt du diese lokale Einrichtung. Gib den Key verborgen ein, füge ihn nicht in den Chat ein und committe die lokale Konfiguration nicht:

read -rs MESHY_API_KEY && export MESHY_API_KEY
claude mcp add-json meshy "{\"command\":\"npx\",\"args\":[\"-y\",\"@meshy-ai/meshy-mcp-server\"],\"env\":{\"MESHY_API_KEY\":\"${MESHY_API_KEY}\"}}"
unset MESHY_API_KEY

Prüfe danach mit /mcp, dass meshy verbunden ist, lasse die verfügbaren Meshy-Tools auflisten und rufe meshy_check_balance auf. Diese Prüfungen erzeugen keine Generierungsaufgabe. Stoppe, wenn Key, Tarif oder API-Guthaben nicht passen.

Nutze zunächst einen einfachen Text-to-3D-Weg für das Sammelobjekt:

1. Rufe meshy_text_to_3d mit einem kurzen, konkreten prompt und target_formats: ["glb"] auf. Das erzeugt eine untexturierte Preview. meshy_text_to_3d_refine folgt nur nach erfolgreicher Preview und nur, wenn Textur eine separate Aufgabe wert ist. Refine liefert eine neue task ID: Bewahre Preview- und Refine-ID auf und verwende die Refine-ID mit task type text-to-3d für Statusprüfung und Download des texturierten Ergebnisses.
2. Notiere die task ID und den task type text-to-3d. Ein natürlicher Chattext allein reicht nicht.
3. Rufe meshy_get_task_status mit derselben ID und demselben type auf. PENDING, IN_PROGRESS oder ein Tool-TIMEOUT sind kein Fehlschlag. Auch Netzwerkabbruch, 429 oder 5xx bei der Statusabfrage bedeuten nicht FAILED; frage später dieselbe task ID ab, statt eine doppelte bezahlte Aufgabe zu erstellen.
4. Lade erst nach SUCCEEDED herunter. Lies bei FAILED den task_error, und stoppe bei CANCELED. Speichere in einen eindeutigen lokalen Quellasset-Pfad, zum Beispiel:

meshy_download_model
task_id: <same task ID>
task_type: "text-to-3d"
format: "glb"
save_to: "<absolute-project-path>/SourceAssets/Props/CollectibleMarker/marker.glb"

Prüfe die Datei vor Blender oder Unreal-Import. Nach Meshys Asset Retention werden API-Assets für Nicht-Enterprise-Kunden höchstens drei Tage gespeichert; behalte daher nicht nur die URL.

Asset-Test D, nur bei gewähltem Meshy-Zweig: Das lokale GLB lässt sich wiederholt öffnen; task ID, task type, prompt, Endstatus und lokaler Pfad sind dokumentiert. Damit ist es noch nicht Unreal-tauglich.

Blender nur für eine klar benannte Bereinigung

Manuelle Bereinigung genügt; ein weiterer MCP ist nicht standardmäßig nötig. Nur wenn du Blender bewusst über Claude steuern willst, installierst du offizielles Add-on, LLM Client und MCP Server von der Blender-MCP-Seite und beginnst mit einem read-only Inventar der Szenenobjekte. Vermische das nicht mit Ports, Toolnamen oder Setup von ahujasid/blender-mcp. Blender warnt, dass der offizielle MCP LLM-generierten Code ohne Datenschutz-Guards ausführt; nutze eine VM oder ein System ohne sensible Daten.

Für ein statisches Sammelobjekt reicht diese Route:

1. Wähle in Blender File → Import → glTF 2.0 (.glb/.gltf) und öffne marker.glb. Behalte nur das gewünschte Objekt, entferne lose Geometrie manuell und prüfe Maßstab, Ausrichtung, Origin, Namen und Materialien.
2. Speichere die bereinigte Quelle als <absolute-project-path>/SourceAssets/Props/CollectibleMarker/marker-clean.blend, damit eine editierbare, wiederherstellbare Fassung erhalten bleibt.
3. Wähle nur das bereinigte statische Objekt, dann File → Export → glTF 2.0, setze das Format auf glTF Binary (.glb), aktiviere Selected Objects und Apply Modifiers und speichere marker-clean.glb neben der .blend-Datei.
4. Erstelle oder öffne im Unreal Content Browser /Game/Assets/Props/Collectibles/ und importiere marker-clean.glb. Bestätige in der Interchange-Importvorschau, dass der gewünschte Eintrag ein Static Mesh ist, importiere nur dieses statische Objekt und speichere das Asset. Prüfe die Größe im Static Mesh Editor; füge einfache Collision nur bei Bedarf hinzu und störe nicht den vorhandenen Overlap Trigger.
5. Öffne den bereits in Play geprüften Collectible-Blueprint oder Actor und ersetze nur die Mesh-Referenz der sichtbaren Static-Mesh-Komponente. Trigger, einmaliges Sammelereignis, Zähler, Sieg, Neustart und platzierte Instanzen bleiben unverändert. Kompilieren, speichern und erneut Play ausführen.

Asset-Test E, nur bei gewähltem Blender/Import-Zweig: .blend, die bereinigte .glb und das Unreal Static Mesh öffnen sich; Maßstab, Ausrichtung, Origin und Collision sind nachvollziehbar; die sichtbare Mesh wurde ohne Logikänderung ersetzt; Play-Tests A–C bestehen weiter.

Fehler nach Beweisebene untersuchen

Symptom	Zuerst prüfen	Nicht verwechseln mit
/mcp ist connected, aber das Level ist nicht lesbar	Laufender Editor, Output Log, echter Read-only-Aufruf	Spielbereite Verbindung
Server läuft, aber keine Tools erscheinen	AllToolsets, bei Bedarf ModelContextProtocol.RefreshTools	Modellschwäche
Aufrufe hängen oder fehlschlagen	Kompilierung, Level-Laden oder aktives PIE	Sicheres Netzwerkproblem
Blueprint-Tool antwortet, Gameplay scheitert	Status, Kompilierung, Output Log, manueller Play-Test	Fertigstellung
Meshy-Status endet mit Timeout, Abbruch, 429 oder 5xx	task ID/type behalten und dieselbe Aufgabe später abfragen	FAILED oder Grund für eine zweite bezahlte Aufgabe
Download-URL ist abgelaufen	Lokale Kopie, task ID, Aufbewahrungszeit	Dauerhafte URL
Maßstab oder Kollision falsch	Einheiten, Ursprung, Export, Unreal-Kollision	Zwingend schlechte Generierung

Nach zwei erfolglosen Reparaturen desselben Symptoms rollst du zum letzten akzeptierten Checkpoint zurück und verkleinerst die Aufgabe. Staple keine dritte spekulative Korrektur auf zwei unbestätigte.

Drei getrennte Nutzungs-Konten führen

Wandle „19 % eines wöchentlichen Max-Plans“ nicht in API-Tokens um. Ein Community-Autor berichtete für seinen ersten vollständigen Build etwa vier Stunden und ungefähr 19 % seines wöchentlichen Max-Plans. Das ist ein individueller Erfahrungswert, keine Zeit-, Preis- oder Kontingentgarantie.

Weg	Separat zu prüfender Pflichtpunkt	Nicht enthalten	Nachweis
Claude Code mit Claude-Abo	Tarif, Sitzungs-/Wochenlimit, aktives Modell	Meshy-Credits oder Modell-API-Rechnung	Modell- und Nutzungsanzeige in Claude Code
Claude Code mit Modell-API	API key, echte model ID, Input/Output/Cache-Tokens, Guthaben	Claude-Max-Wochenlimit oder Meshy	Provider-Requests und Abrechnung; bei BetterToken Modell- und Token-Daten
Optionales Meshy-Asset	MESHY_API_KEY, geeigneter bezahlter Tarif/API-Zugang, vorausbezahltes API-Guthaben und Verbrauch je Aufgabe	Modell-API-Tokens; Web-App-Guthaben beweist kein API-Guthaben	meshy_check_balance, Aufgaben und Abrechnung
Unreal, Blender, Plugins und Inhalte	Aktuelle Lizenzen, Hardware, Marketplace-Assets, Drittanbieter-Plugins	Annahme, dass der gesamte Stack kostenlos ist	Aktuelle Bedingungen und Kaufbelege

Vor der Skalierung einen Level messen: Prompts, Wiederholungen, Modellanfragen, optionale Meshy task IDs, Downloads und menschliche Play-Zeit. Der Kern muss A–C stabil wiederholen; D gilt nur bei Meshy und E nur beim Blender/Import-Zweig. Erst erweitern, wenn die tatsächlich genutzten Zweige stabil sind.

Abschluss-Checkliste

• Vor der Sitzung und nach jeder akzeptierten Stufe existiert ein Rollback-Punkt.
• Zusätzlich zur /mcp-Anzeige war ein echter Read-only-Aufruf an Unreal erfolgreich.
• In Play kannst du die Route gehen, genau drei Objekte sammeln, korrekt gewinnen und aus jedem Zustand neu starten.
• PIE ist vor Asset-Änderungen beendet, und die Kompilierung endet vor dem nächsten Schritt.
• Meshy und Blender bleiben optional, bis die Greybox funktioniert.
• Falls Meshy genutzt wurde, liegt das Ergebnis lokal vor und task ID, task type sowie Endstatus sind dokumentiert.
• Falls ein externes Asset ein Primitive ersetzt hat, wurden Play-Tests A–C wiederholt.
• Tatsächliches Modell, Modell-Tokens, Claude-Abo-Kontingent und Meshy-Credits werden getrennt geprüft.

Das Ergebnis ist nicht nur eine eindrucksvolle KI-Demo, sondern ein wiederherstellbarer, beobachtbarer und erweiterbarer Ablauf, bei dem klar bleibt, was tatsächlich funktioniert.