# Fehlerbehebung — AI Game Dev App & CLI · AI Game Developer Wiki Behebe typische Probleme von AI Game Dev App und gamedev CLI: Anmeldung, Modelle, Plugins, Editor-Verbindung, Pakete, lokale und Cloud-Generierung. Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/app/troubleshooting). Diese Seite sammelt die Probleme, auf die Nutzer der AI Game Dev App und der `gamedev` CLI am häufigsten stoßen, mit der wahrscheinlichen Ursache und der Lösung. Finde dein Symptom in seinem Bereich: Anmeldung, Modelle, Engine-Verbindung, Pakete, lokale Modelle, Cloud-Generierung oder die CLI. ## Anmeldung **Das Browserfenster für die Anmeldung öffnet sich nicht.** Es ist kein Standardbrowser festgelegt, oder eine Firewall hat die Anmeldung blockiert. Lege einen Standardbrowser fest und wähle erneut **Sign in**. Hinter einem Unternehmens-Proxy erlaube ausgehendes HTTPS zu ai-game.dev. In der CLI zeigt `/login` einen Code und eine Adresse an, die du stattdessen auf einem anderen Gerät öffnen kannst. **Die App ist zum Anmeldebildschirm zurückgekehrt, oder die CLI fragt nach `/login`.** Deine Sitzung ist abgelaufen oder wurde widerrufen, zum Beispiel auf der Seite „Connected devices“ deines Kontos. Melde dich erneut an; deine Chats und Einstellungen bleiben erhalten. **Ein Headless-Lauf endet mit Code 2.** Der Computer ist nicht angemeldet, der Prompt war leer, oder der Ordner bzw. ein Flag ist nicht verwendbar. Führe `gamedev` einmal interaktiv aus und tippe `/login`. Siehe die [Exit-Codes](https://ai-game.dev/de/docs/wiki/app/cli#headless). **Das falsche Konto ist angemeldet.** Die App, die CLI und `gamedev acp` teilen sich eine Anmeldung pro Computer. Verwende `/login --switch` in der CLI, oder melde dich in der Desktop-App ab und wieder an. Mehr zu den Abläufen: [Authentifizierungsanleitung](https://ai-game.dev/docs/auth). ## Modelle **Die Modellliste zeigt an, dass sie lädt oder nicht erreichbar ist.** Die Liste kommt von ai-game.dev. Ohne Verbindung und ohne gespeicherte Kopie der letzten Liste gibt es nichts anzuzeigen. Prüfe deine Verbindung und öffne die Auswahl erneut. **Ein Modell ist ausgegraut.** Der Grund steht unter seinem Namen: Es erfordert vielleicht einen höheren Tarif (siehe [die Preisseite](https://ai-game.dev/pricing)), wird vielleicht im Land deiner Rechnungsadresse nicht angeboten (siehe [Modellverfügbarkeit](https://ai-game.dev/model-availability)) oder erfordert eine Altersbestätigung in deinem Konto. Am Ende der Modellliste wird die Region angezeigt, auf der deine Verfügbarkeit basiert. **`--model` wird in der CLI abgelehnt.** Das Modell ist für dein Konto nicht verfügbar. Wähle eines mit `/model` oder gib eine andere ID an. **Das Nutzungskontingent ist schnell aufgebraucht.** Die Nutzung wird als Prozentsatz deines monatlichen Kontingents angezeigt. Größere Modelle verbrauchen für dieselbe Arbeit mehr davon; verwende für Routine-Bearbeitungen ein schnelleres Modell und aktiviere nur die Tools, die eine Sitzung braucht. ## Engine-Plugin und Editor-Verbindung **Die CLI meldet, dass im Ordner kein Unity-, Godot- oder Unreal-Projekt liegt.** Öffne den Stammordner des Projekts: bei Unity den Ordner mit `ProjectSettings/`, bei Godot den Ordner mit `project.godot`, bei Unreal den Ordner mit der `.uproject`-Datei. **Das Plugin wurde nicht installiert.** Die Engine oder das Projekt wurde nicht gefunden. Stelle sicher, dass die Engine installiert ist (Unity Hub, Unreal Engine oder Godot) und dass du einen echten Projektordner geöffnet hast, und klicke dann in der Seitenleiste auf **Install Package** oder führe `/install-plugin` aus. Zur manuellen Installation folge der Anleitung für [Unity](https://ai-game.dev/de/docs/wiki/unity/installation), [Unreal](https://ai-game.dev/de/docs/wiki/unreal/installation) oder [Godot](https://ai-game.dev/de/docs/wiki/godot/installation). **Die Seitenleiste bietet Update Package an.** Eine neuere Plugin-Version ist verfügbar. Klicke darauf, um das Plugin im Projekt zu aktualisieren. **Der Editor zeigt „Disconnected“ an.** Der Editor hat die Autorisierung nicht abgeschlossen oder seine Cloud-Verbindung verloren. Öffne im Editor das Fenster **AI Game Developer**, wähle **Cloud**, klicke auf **Authorize** und warte auf **Ready**. **Der Agent wartet lange auf den Editor.** Große Projekte brauchen eine Weile zum Öffnen. Die App wartet bis zu 15 Minuten darauf, dass der Editor startet, und bis zu 2 weitere Minuten auf seine Tools. Drücke **Stop**, um das Warten abzubrechen; ein Editor, der bereits gestartet ist, bleibt geöffnet. Wenn du den Editor vor einer langen Sitzung selbst öffnest, vermeidest du das Warten. **Beim Erstellen eines Projekts heißt es, der Engine-Editor sei nicht installiert.** Installiere zuerst die Engine oder wähle im Erstellen-Dialog manuell einen installierten Editor aus. ## Pakete \*\*„requires AI Game Dev >=X, you have Y“. \*\* Das Paket benötigt eine neuere App. Aktualisiere die App (siehe [Installation](https://ai-game.dev/de/docs/wiki/app/installation#updates)). **Ein Paket zeigt eine Warnungsanzahl.** Öffne das Fenster Packages, wähle das Paket aus und lies den Tab **Errors**. Im App-Log stehen die Details unter `pkg:`. **Pakete funktionieren in einem Projekt nicht mehr.** Wenn der Paket-Host innerhalb von fünf Minuten dreimal abstürzt, wird er nicht automatisch neu gestartet. Klicke im Fenster Packages auf **Reload** oder führe in der CLI `/packages reload` aus. **Ein Paket wird nicht aktualisiert.** Automatische Updates gelten pro Paket und pro Computer: Prüfe den Schalter **Auto-update**. Pakete aus einem lokalen Ordner und auf einen Tag festgelegte GitHub-Quellen werden nie automatisch aktualisiert. Verwende **Check for updates** oder `gamedev pkg update `. **Eine Version ist als „not in registry anymore“ markiert.** Diese Version wurde zurückgezogen. Sie funktioniert weiterhin und wird nie als Update-Ziel angeboten. **Ein Paket ist blockiert, weil eine Abhängigkeit ausgeschlossen ist.** Die Abhängigkeit ist auf irgendeiner Ebene dieses Projekts deaktiviert. Wähle im Fenster Packages **Include it again** oder `gamedev pkg include `. **„Tools of package X are unavailable in this session“.** Ein MCP-Server mit demselben Namen ist bereits für die Sitzung konfiguriert (von dir, dem Projekt oder einer Engine). Benenne den anderen Server in **Settings**, **MCP servers** um oder entferne ihn. **Ein verknüpfter Paketordner bewirkt nichts.** `id-mismatch` bedeutet, dass das Manifest des Ordners ein anderes Paket benennt; `not-found` bedeutet, dass der Ordner verschoben wurde. Führe `gamedev pkg unlink ` aus, um zur veröffentlichten Version zurückzukehren. **Ein Tool fehlt im Chat.** Installierte Pakete fügen nicht jedem Chat Tools hinzu. Schalte das Tool in der Tools-Leiste der Sitzung ein (CLI: `/config`, **Tools**). Die Änderung gilt ab der nächsten Nachricht. ## Lokale Bild- und Videomodelle **Ein Modell wird für meinen Computer nicht angeboten.** Jedes Modell listet die Hardware auf, zu der es passt; die App bietet nur an, was deine GPU, dein Videospeicher und dein Treiber ausführen können. Wenn du Hardware oder Treiber geändert hast, führe `/images redetect` aus. Siehe die [Hardware-Tabelle](https://ai-game.dev/de/docs/wiki/app/packages-catalog#local-image-models). **Die Generierung schlägt mit „out of memory“ fehl oder ist sehr langsam.** Ein Lauf, dem der Videospeicher ausgeht, wird einmal mit einem kleineren Speicherbudget wiederholt. Ein stiller Fallback auf die CPU wird als Fehler gemeldet statt verborgen. Versuche ein leichteres Modell (zum Beispiel eine Lightning-Variante oder Z-Image Turbo) oder schließe andere GPU-intensive Programme. `/images stop` bricht wartende Bilder ab und gibt die GPU frei. **Die Festplatte ist voll.** Verschiebe den Modellspeicher in **Settings**, **Model storage** oder mit `/images storage ` auf ein größeres Laufwerk; `/images free-space` löscht Dateien, die kein Modell verwendet. **Die Bild-Runtime wurde blockiert oder ist defekt.** Führe `/images reinstall` aus, um sie erneut einzurichten. ## Cloud-Generierung **Der Agent sagt, dass die Cloud-Generierung nicht aktiviert ist.** Aktiviere **Cloud generation** in der Tools-Leiste der Sitzung oder verwende `/cloud ask` in der CLI. **Ein Cloud-Modell kann nicht verwendet werden.** Die Cloud-Generierung ist für kostenpflichtige Pläne gedacht, einige Modelle erfordern Studio oder höher, und einige werden nicht in jeder Region angeboten. Der Tab **Models** nennt den Grund. Ein fehlgeschlagener Auftrag verbraucht dein Kontingent nicht. ## SuperCollider und Blender **Musik startet unter Linux nicht.** Die SuperCollider-Runtime ist derzeit für Windows und macOS verfügbar. **Blender wird nicht gefunden.** Führe `/blender list` aus, um jedes Blender zu sehen, das die App findet, `/blender setup`, um es erneut einzurichten (optional mit dem Pfad zu deinem Blender), oder lass `/blender` ein portables Blender herunterladen. Blender 4.2 oder neuer ist erforderlich. ## CLI und Hintergrunddienst **Die CLI ist veraltet.** Führe `gamedev update` aus. **„The running host does not offer … yet. Quit every AI Game Dev window and CLI, then start again“.** Der Hintergrunddienst ist älter als die CLI oder die App, die du gestartet hast. Schließe jedes AI Game Dev-Fenster und jede CLI und starte erneut, oder verwende `/update now` in der CLI. **Ich brauche Logs für einen Bugreport.** `gamedev daemon status` zeigt den Zustand des Hintergrunddienstes und `gamedev daemon logs --lines 200` gibt dessen aktuelle Logs aus. Teile den relevanten Teil, niemals deine Zugangsdaten, auf Discord oder GitHub. ## Immer noch festgefahren Sieh dir die [FAQ](https://ai-game.dev/de/docs/wiki/app/faq), die [FAQ der Website](https://ai-game.dev/docs/faq) und die [Release Notes](https://ai-game.dev/de/releases) für aktuelle Fehlerbehebungen an. --- Source (HTML): https://ai-game.dev/de/docs/wiki/app/troubleshooting Machine-translated (de) from the English page: https://ai-game.dev/docs/wiki/app/troubleshooting