トラブルシューティング
AI Game Dev アプリと gamedev CLI でよくある問題を解決: サインイン、モデル、エンジンプラグインとエディタ接続、パッケージ、ローカル・クラウド生成。
このページでは、AI Game Dev アプリと gamedev CLI のユーザーが最もよく遭遇する問題を、考えられる原因と解決策とともにまとめています。症状は、サインイン、モデル、エンジン接続、パッケージ、ローカルモデル、クラウド生成、CLI の各分野から探してください。
サインイン
サインイン用のブラウザウィンドウが開きません。 既定のブラウザが設定されていないか、ファイアウォールがサインインをブロックしています。既定のブラウザを設定して、もう一度 Sign in を選択してください。社内プロキシの背後にいる場合は、ai-game.dev への HTTPS 送信を許可してください。CLI では /login がコードとアドレスを表示し、それを別のデバイスで開くこともできます。
アプリがサインイン画面に戻ってしまった、または CLI が /login を要求する。 セッションが期限切れになったか、たとえばアカウントの Connected devices ページから失効されました。もう一度サインインしてください。チャットと設定は保持されます。
ヘッドレス実行がコード 2 で終了する。 コンピューターがサインインしていない、プロンプトが空だった、またはフォルダやフラグが使用できない状態です。gamedev を一度対話モードで実行し、/login と入力してください。終了コードを参照してください。
間違ったアカウントでサインインしている。 アプリ、CLI、gamedev acp はコンピューターごとに 1 つのサインインを共有します。CLI では /login --switch を使うか、デスクトップアプリでサインアウトしてから再度サインインしてください。
フローの詳細: 認証ガイド。
モデル
モデル一覧が読み込み中、または到達不能と表示される。 一覧は ai-game.dev から取得されます。接続がなく、最後の一覧の保存コピーもない場合、表示できるものはありません。接続を確認して、ピッカーを開き直してください。
モデルがグレー表示されている。 理由はモデル名の下に表示されます。上位のプランが必要（料金ページを参照）か、請求先住所の国では提供されていない（モデルの提供状況を参照）か、アカウントで年齢確認が必要な可能性があります。モデル一覧の下部に、提供状況の基準となる地域が表示されます。
CLI で --model が拒否される。 そのモデルはあなたのアカウントでは利用できません。/model で選択するか、別の id を指定してください。
使用量がすぐに尽きる。 使用量は月間許容量のパーセンテージで表示されます。大きなモデルは同じ作業でもより多く消費します。日常的な編集には高速なモデルを使い、セッションに必要なツールだけをオンにしておいてください。
エンジンプラグインとエディタ接続
CLI がフォルダに Unity、Godot、Unreal のプロジェクトがないと表示する。 プロジェクトのルートフォルダを開いてください。Unity なら ProjectSettings/ があるフォルダ、Godot なら project.godot があるフォルダ、Unreal なら .uproject ファイルがあるフォルダです。
プラグインがインストールされなかった。 エンジンまたはプロジェクトが見つかりませんでした。エンジン（Unity Hub、Unreal Engine、Godot）がインストールされていること、実際のプロジェクトフォルダを開いていることを確認してから、サイドバーの Install Package をクリックするか /install-plugin を実行してください。手動でインストールする場合は、Unity、Unreal、Godot のガイドに従ってください。
サイドバーに Update Package と表示される。 新しいプラグインバージョンが利用可能です。クリックするとプロジェクト内のプラグインが更新されます。
エディタに「Disconnected」と表示される。 エディタが認可を完了していないか、Cloud 接続が失われています。エディタで AI Game Developer ウィンドウを開き、Cloud を選択して Authorize をクリックし、Ready になるまで待ってください。
エージェントがエディタを長時間待っている。 大規模なプロジェクトは開くのに時間がかかります。アプリはエディタの起動を最大 15 分、そのツールをさらに最大 2 分待ちます。Stop を押すと待機をキャンセルできますが、すでに起動したエディタは開いたままになります。長時間のセッションの前に自分でエディタを開いておけば、待ち時間を避けられます。
プロジェクト作成時にエンジンエディタがインストールされていないと表示される。 先にエンジンをインストールするか、作成ダイアログでインストール済みのエディタを手動で選択してください。
パッケージ
「requires AI Game Dev >=X, you have Y」。 このパッケージにはより新しいアプリが必要です。アプリを更新してください（インストールを参照）。
パッケージに警告件数が表示される。 Packages ウィンドウを開いてパッケージを選択し、Errors タブを確認してください。詳細はアプリログの pkg:<id> にあります。
プロジェクト内でパッケージが動作しなくなった。 パッケージホストが 5 分以内に 3 回クラッシュすると、自動では再起動されません。Packages ウィンドウで Reload をクリックするか、CLI で /packages reload を実行してください。
パッケージが更新されない。 自動更新はパッケージごと、コンピューターごとに設定されます。その Auto-update スイッチを確認してください。ローカルフォルダからのパッケージと、タグに固定された GitHub ソースは自動更新されません。Check for updates を使うか、gamedev pkg update <id> を実行してください。
バージョンに「not in registry anymore」と表示される。 そのバージョンは取り下げられました。動作は継続しますが、更新先として提示されることはありません。
依存関係が除外されているためパッケージがブロックされる。 その依存関係はこのプロジェクトのいずれかのレベルでオフになっています。Packages ウィンドウで Include it again を選択するか、gamedev pkg include <id> を実行してください。
「Tools of package X are unavailable in this session」。 同じ名前の MCP サーバーがすでにセッション用に設定されています（あなた、プロジェクト、またはエンジンによって）。Settings の MCP servers で、もう一方のサーバーの名前を変更するか削除してください。
リンクしたパッケージフォルダが機能しない。 id-mismatch はフォルダのマニフェストが別のパッケージを指していることを、not-found はフォルダが移動したことを意味します。gamedev pkg unlink <id> を実行すると、公開バージョンに戻ります。
チャットにツールが表示されない。 インストール済みのパッケージがすべてのチャットにツールを追加するわけではありません。セッションの Tools 行でツールをオンにしてください（CLI: /config の Tools）。変更は次のメッセージから適用されます。
ローカル画像・動画モデル
自分のコンピューター向けにモデルが提示されない。 各モデルには適合するハードウェアが記載されており、アプリはあなたの GPU、ビデオメモリ、ドライバーで実行できるものだけを提示します。ハードウェアやドライバーを変更した場合は、/images redetect を実行してください。ハードウェア表を参照してください。
生成が「out of memory」で失敗する、または非常に遅い。 ビデオメモリが不足した実行は、より小さなメモリ予算で 1 回だけ再試行されます。CPU への暗黙のフォールバックは隠さずに失敗として報告されます。より軽量なモデル（たとえば Lightning バリアントや Z-Image Turbo）を試すか、GPU を大量に使う他のプログラムを閉じてください。/images stop はキュー内の画像をキャンセルし、GPU を解放します。
ディスクがいっぱい。 Settings の Model storage で、または /images storage <new folder> で、モデルストレージをより大きなドライブに移動してください。/images free-space はどのモデルも使っていないファイルを削除します。
画像ランタイムがブロックされた、または壊れている。 /images reinstall を実行して再セットアップしてください。
クラウド生成
エージェントがクラウド生成が有効になっていないと表示する。 セッションの Tools 行で Cloud generation をオンにするか、CLI で /cloud ask を使ってください。
クラウドモデルが使えない。 クラウド生成は有料プラン向けで、一部のモデルは Studio 以上が必要で、地域によっては提供されないものもあります。Models タブに理由が表示されます。失敗したジョブは許容量を消費しません。
SuperCollider と Blender
Linux で音楽が始まらない。 SuperCollider ランタイムは現在 Windows と macOS で利用可能です。
Blender が見つからない。 /blender list でアプリが見つけたすべての Blender を確認でき、/blender setup で再セットアップ（オプションで Blender のパスを指定）でき、/blender でポータブル Blender をダウンロードさせることもできます。Blender 4.2 以降が必要です。
CLI とバックグラウンドサービス
CLI が古い。 gamedev update を実行してください。
「The running host does not offer … yet. Quit every AI Game Dev window and CLI, then start again」。 バックグラウンドサービスが、起動した CLI やアプリより古いです。すべての AI Game Dev ウィンドウと CLI を閉じてから再度起動するか、CLI で /update now を使ってください。
バグ報告用のログが必要。 gamedev daemon status でバックグラウンドサービスの状態を確認でき、gamedev daemon logs --lines 200 で最近のログを出力できます。関連する部分だけを Discord や GitHub で共有し、認証情報は決して共有しないでください。