トラブルシューティング
よく起きるトラブルと、その本当の原因です。その多くはプラットフォーム側のバグに見えますが、実際はそうではなく、 ゲームコード側の特定の挙動が原因です。
ゲーム
画面が空白または真っ白になる
ほぼ必ず、次の三つのいずれかです。可能性が高い順に挙げます。
src/内のファイルが書き込まれていない。 シェルが存在しない script ファイルを 参照しているため、何も起動しません。未書き込みのファイルが残っているシェルでは実行時チェックがスキップ されるため、AI が早まって成功を宣言すると見過ごされることがあります。ゲームのファイル一覧を出させ、 足りないファイルを書かせてください。- 読み込み順序。 マーカーブロックやハーネスが script タグの下に来てしまっている
ため、コード実行時に
GAME_CONFIGがundefinedになっています。すべて script タグより上に置く必要があります。 - script パスの先頭にスラッシュが付いている——
src="/src/core/engine.js"はサイトのルートとして解決され、404 になります。
AI に検証を実行させるか、テストプレイのスクリーンショットを撮らせてください:どちらも推測ではなく、 実際のコンソールエラーを返します。
生成したアートがいつまでも表示されない
アートを生成しても読み込まれるだけです。実際に表示されるのは、コードがそれを描画した場合だけです。 ゲームがその場所にまだプレースホルダーの四角形を描いている場合、あなたは読み込まれているのに見えない 画像にお金を払ったことになります——しかもスクリーンショットは普通のゲームに見えてしまうため、この問題は なかなか気づかれません。
AI にゲームの素材を一覧表示させ、報告されたヒントをすべて解消させてください。プラットフォームは納品時に この一覧を自動的に返すため、きちんとした実行であれば、未描画の素材が渡されることはないはずです。
2 つ目の原因:マーカー行に防御的なフォールバックが書かれているケースです。game.html に
window.GAME_ASSETS = window.GAME_ASSETS || {}; // __GI_ASSETS__ と書かれていると、サーバーは
そのブロックを一切書き換えられなくなり、以降のすべての生成が静かに反映されなくなります。その行は、
そのまま window.GAME_ASSETS = {}; // __GI_ASSETS__ という単純な形でなければなりません。
アートは表示されるが、サイズがそれぞれ違う
生成のたびに、余白の量が変わります——同じ 512×512 のキャンバスでも、キツネが 63% を占めることもあれば、 クマが 41% しか占めないこともあります。そのまま描画すると、片方がもう片方の 1.5 倍のサイズに見えて しまいます。ゲームはプラットフォームの sprite ヘルパーを通して描画するべきです。これは実際のコンテンツの 範囲を測り、デザイン用のボックスに合わせてくれます。AI にこのヘルパーへ切り替えさせてください。
音楽があるのに、ゲームから音が出ない
原因は 3 つあり、音声を再生成してもどれも解決しません:
- コードが一度も再生していない。 生成はトラックをオーディオテーブルに入れるだけです。
- ユーザーが何も操作する前に再生を開始している。 ブラウザはこれをブロックします。最初の クリックかキー入力で再生を始める必要があります。
- 毎フレーム新しいオーディオオブジェクトが作られているため、音が途切れ、メモリも大量に 消費します。
音を再生成させないでください。再生の状態が良くなることはなく、すでに承認した音声を上書きしてしまいます ——しかも全額かかります。
ロードバーが終わったあとに、アートが急に表示される
ゲームはページの load イベントが発火した時点でロード画面を隠していますが、このイベントは画像のデコードが 終わるよりずっと早く発火します。代わりに、プラットフォームの素材準備完了シグナルを待つべきです。実際の 進捗カウントも用意されているので、ロードバーは単なるアニメーションではなく、実際の進捗を表示できます。
背景がつぶれて見える
画像が X と Y を別々に伸縮させてキャンバスいっぱいに引き伸ばされています。縦横比を保ったまま拡大縮小し、 中央でクロップする必要があります。丸い顔が楕円になっていたら、それが見分けるサインです。
エディター
Inspector が空、またはコントロールが 1、2 個しかない
AI がその数値を外に出していない——ゲームロジックの中にまだハードコードされたままです。設定に移し、 スキーマを拡張させてください。これはコードだけで完結する無料の変更で、特に難易度に関わる数値はすべて そこに置くべきです。
スライダーは動くが、何も起きない
ゲームが起動時に設定をローカル変数へコピーしてしまい、毎フレーム読み直していません。値によっては、変更時に 派生状態も再構築する必要があります——敵の数を変えても、敵プールを再構築しない限り何も起きません。どちらも、 AI にとっては 1 行で直せる修正です。
保存しようとすると、他の人がすでに保存済みと表示される
同じゲームを 2 人が編集しました。自動では消えないバナーが表示され、相手のバージョンを読み込む、自分の バージョンで強制的に上書きする(どちらが破棄されるかが明示されます)、あとで決める、のいずれかを選べます。 調整済みの設定は互いに釣り合いの取れた値の集まりなので、自動的にマージされることはありません。長時間の 調整作業に入る前に、在席状況の表示を確認してください。
入れ替えた素材が消えてしまった
入れ替えた素材は一時的に保持されてローカルでプレビューされるだけで、保存を押したときにだけ ゲームに書き込まれます。保存せずに離れると、スライダーの変更と同じようにそれらは破棄されます。
公開ボタンを押しても、何も起きていないように見える
実際には動いています。公開処理では、まず実際のブラウザを開いてゲームの操作テストを行います。これに約 15 秒かかり、そのあとゲームは審査キューに入り、審査中と表示されます。モデレーターが承認するまで、 公開にはなりません。
エディターのリンクを開くと、プレイページに飛ばされる
プレイのみの権限しかありません——「プレイのみ」レベルの共有招待によるものか、チームに「プレイヤー」 ロールで参加しているかのどちらかです。編集権限については、オーナーかチーム管理者に依頼してください。
Credits とプラン
生成が途中で止まった
有効なウォレットの残高がなくなりました。生成は別のウォレットに自動的に切り替わるのではなく、メッセージを 出して停止します——この分離は意図的な設計です。ウォレットを切り替える、チャージする、あるいはチーム 管理者に割り当てを増やしてもらってください。生成以外のすべての機能は、引き続き通常どおり動作します。
ツールが「Pro が必要」と表示する
プラン制限があるのは Live2D だけで、Pro プランが必要です。それ以外の 機能——2D アート、sprite、アニメーション、効果音、音楽、ボイス ——はどのプランでも使え、制限は credits だけです。
使用量ページに、どのゲームにも紐づいていない支出が 表示される
それはデザイン段階の作業で、特にコンセプトアートです。紐づけ先のゲームが存在する前に課金されるため、発生 した時点ではどのゲームにも割り当てられません。実在するゲームにかかった、正真正銘の支出です。
予算モードの実行は目標内と 報告しているのに、残高は違うことを示している
原因は同じです。ゲームが作られる前に生成されたコンセプトアートは予算ツールから見えないため、実際の金額が もっと多くても、実行側は正直に「5,000 のうち 5,000」と報告できてしまいます。アシスタントに、デザイン段階の アートも計画に数えさせ、ゲームができた時点でゲーム id を渡すよう伝えてください。
MCP 接続
| 症状 | 原因と対処法 |
|---|---|
401、または認証を求められる |
ヘッダーが欠けているか、形式が誤っています。Authorization: Bearer gi_… という
形式にし——間にスペースを入れ、gi_ プレフィックスも残す必要があります。OAuth による
フォールバックはないため、ヘッダーを設定できないクライアントは接続できません。 |
| 「MCP key が必要です」 | サーバーに有効な key が届いていません。ヘッダー名を確認し、貼り付け時に key が途中で切れていないかも 確認してください。 |
| Gamentic のツールが 1 つも出てこない | クライアントが設定を再読み込みしていません。クライアントを再起動し、MCP パネルでサーバーが接続済み と表示されているか確認してください。 |
| 作業の途中でツールが消え、その後また現れる | 正常な動作です。サーバーの再起動でセッションが無効になり、クライアントは裏側で自動的に再初期化 します。解消しない場合はクライアントを再起動してください。 |
| 長い時間がかかるツール呼び出しがタイムアウトする | Agent Lab で不安定な接続モードをオンにし、1 回の長い呼び出しではなく、再開可能な チャンク単位でゲームをアップロードするようにしてください。 |
| 見えているはずの id で「ゲームが見つかりません」と出る | たいていは入力ミスではなく権限の問題です——その key が属するアカウントに、そのゲームへのアクセス権が ありません。id 自体の許容度は高く、引用符やバッククォート付き、エディターの URL をそのまま貼り付けた 場合でも受け付けます。 |
| 素材が失われるという理由で編集が拒否された | その書き込みは、ゲーム内に既にある画像・音声・モデルを削除してしまうところでした。防止機構が 働いている状態です。本当に削除したい場合、AI は明示的に許可する必要があります——または、先に スナップショットを取ってくれる削除ツールを使ってください。 |
| AI が、自分が書き込んだばかりの素材が元に戻されたと言っている | 古いコピーをもとにファイル全体の書き直しを送信し、サーバー上の現在の素材が優先された結果です。 レスポンスには、何が保持されたかが記載されています。それを「修正」しようとするのではなく、まず ファイルを読み直すべきです。 |
コンテンツと公開設定
誰かに送ってもらったリンクのゲームが見られない
そのゲームが非公開で、あなたが招待されていないか、あるいは成人向けに分類されているかのどちらかです。 成人向けゲームを見るには成人アカウントが必要で、アカウント設定で成人向けコンテンツを許可 をオンにする必要があります——これは既定でオフになっており、ログアウトした状態の訪問者には成人向け コンテンツは一切表示されません。
新規登録で招待コードを求められる
パブリックベータの間、新規登録には制限がかかっています。それは制限そのものであり、入力内容の誤りでは ありません。
それでも解決しない場合
サイトのすべてのページの隅にバグを報告/アイデアを共有ボタンがあり、関連する情報が 自動的に添付されます。エディター内では、実行中のゲームをスクリーンショットして書き込むのが、見た目の 問題を伝えるいちばん早い方法です。