Unity-Plugin einrichten, Schritt für Schritt

Alles, um von einem leeren Unity-Projekt zu einem AI-Agenten zu kommen, der im Editor arbeitet: Plugin installieren, anmelden, AI-Client verbinden und die Erweiterungen hinzufügen, die du brauchst. Die Unity-Installationsseite hat die Kurzfassung.

Bevor du loslegst

Unity 2022.3 oder neuer, ein ai-game.dev-Konto und ein AI-Client.

Unity 2022.3 oder neuer — Unity 6 wird unterstützt.
Ein ai-game.dev-Konto für die standardmäßige Cloud-Verbindung — lege eins an, wenn du noch keins hast.
Ein AI-Client — die AI Game Dev App, Claude Code, Cursor, Copilot, Gemini, Codex oder einer der 14 unterstützten MCP-Clients.
Internetzugang beim ersten Öffnen — das Plugin lädt seine .NET-Pakete von NuGet.

Plugin installieren

Mit der App, der CLI, OpenUPM oder dem Installer-Paket — such dir einen Weg aus.

Vier Wege, das Plugin hinzuzufügen, vom einfachsten angefangen:

Öffne dein Unity-Projekt in der AI Game Dev App und klicke auf Install Package. Die App installiert das neueste Plugin von OpenUPM, meldet es an und richtet deinen Agenten ein.

Installiere die CLI aus npm und füge dann das Plugin zu deinem Projekt hinzu (sie bearbeitet Packages/manifest.json für dich):

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

Mit der OpenUPM CLI führst du im Projektordner Folgendes aus:

openupm add com.ivanmurzak.unity.mcp

Keine OpenUPM CLI? Füge die Scoped Registry zu Packages/manifest.json hinzu und dann das Paket in Window → Package Manager:

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}

Fenster öffnen und anmelden

Öffne das AI Game Developer-Fenster und melde dich einmal mit deinem Konto an.

Wähle in Unity Window → AI Game Developer — MCP (Ctrl+Alt+A, oder Cmd+Option+A unter macOS).
Lass den Schalter Connection auf Cloud und klicke auf Authorize.
Dein Browser öffnet die Anmeldeseite von ai-game.dev mit einem kurzen Code. Prüfe, ob der Code übereinstimmt, und bestätige ihn.
Der Unity-Status wechselt auf Connected.

Die Anmeldung gilt für den ganzen Computer: Wenn du dich bereits mit der App oder mit unity-mcp-cli login angemeldet hast, nutzt der Editor diese und du kannst diesen Schritt überspringen.

AI-Client verbinden

Ein Befehl oder ein Klick im Fenster schreibt die Konfiguration deines Clients.

Klicke im Fenster neben deinem AI-Agenten auf Configure — oder führe setup-mcp in einem Terminal aus. Beides schreibt die projektgebundene URL und einen Projektschlüssel in die Konfiguration des Clients, sodass er sich sofort verbindet:

# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

Starte den AI-Client neu, nachdem sich seine Konfiguration geändert hat. Für andere Clients und die manuelle Konfiguration siehe AI-Clients verbinden und die MCP-Endpunkt-Seite.

Erweiterungen hinzufügen (optional)

Animation, Cinemachine, Terrain, Timeline und mehr — installiere nur, was du brauchst.

Jede Erweiterung ist ein eigenes Unity-Paket. Sie bringt dem Agenten direkt nach der Installation einen Bereich von Unity über RQL bei. Ein paar beliebte:

AI Animation3 Funktionen

openupm add com.ivanmurzak.unity.mcp.animation

AI Cinemachine4 Funktionen

openupm add com.ivanmurzak.unity.mcp.cinemachine

AI Terrain4 Funktionen

openupm add com.ivanmurzak.unity.mcp.terrain

AI Timeline5 Funktionen

openupm add com.ivanmurzak.unity.mcp.timeline

Alle 10 Unity-Erweiterungen →

Fehlerbehebung

Lösungen für die häufigsten Probleme. Mehr im Leitfaden zur Unity-Fehlerbehebung.

Nächster Halt

Unity-Wiki →Konfiguration, Tools und RQL, eigene Tools, die CLI-Referenz und mehr.Unity-Tools →Alles, was der Agent in Unity kann – mit Beispielen.Best Practices →Wie du den Agenten um Aufgaben bittest, die er gut löst.