MCP でゲームを作る
各ツールがどう使われることを想定しているかを説明します。その大部分は、アシスタントがサーバー自体から把握します—— このページはあなたのためのもので、実行が順調かどうかを見極め、うまくいっていないときに軌道修正できるようにします。
まだ接続していませんか?まずはクイックスタート:AI を接続するをご覧ください。正確な ツールの一覧はツールリファレンスをご覧ください。
接続すると何が得られるか
あなたのアシスタントは、自分自身のモデル、コンテキスト、課金を保ったままです。Gamentic 側が提供するのは、ツール、 ストレージ、生成用のハードウェア、検証、そしてエディターです。組み込みのウェブエージェントも外部クライアントと まったく同じエンドポイントに接続するため、計測、プラン制限、所有権チェック、カバー生成、規約検証など、すべてが 同じように適用されます。特権を持つ内部専用の経路は存在せず、ポリシーの適用経路は一本だけです。
制作フロー
サーバーは専用の指示を AI に渡します。正しく進める場合、実行は次の順序になります。
-
ルールを読む——無料
get_conventionはマーカー規約、現在有効なモジュール設定、価格表、ウォレットの状態を返します。get_skillはナレッジパックを返します。mechanics(メカニクス)と balance(バランス)は必読、 screens(画面)はすべてのゲームで必読です。該当するジャンルのブループリントがあれば、メカニクスを自分で 考え出すのではなく、それを読んでください。 -
アンケートを取得——無料
new_game_briefはあなたに渡すフォームの URL を返し、続いてwait_for_briefがロングポーリングで回答を待ちます。何度かポーリングを繰り返すのは正常です。 -
キャストを設計——画像料金
concept_artで生成し、コードが存在する前にあなたが確認・承認します。 -
シェルを作成——無料
create_gameで 60–120 行のgame.htmlを作成します。内容はマーカーブロック、 ハーネス、キャンバス、そして予定している各ファイル用の script タグを依存順に 1 つずつ並べたものです。 レスポンスには、まだ存在しないファイルの一覧が含まれます。 -
各ファイルを書き込む——無料
write_game_fileで 1 つずつ書き込みます。最後の未書き込みファイルが揃うと、サーバーが実際に ヘッドレスブラウザでテストを実行し、runtime: passedまたは具体的なエラーを返します。 -
素材を生成して組み込む——credits を消費
アート、効果音、音楽。その素材がまだどこにも描画されていない場合、結果にヒントが添えられます。
-
セルフチェック——無料
list_assetsで未描画のアートや未再生の音声をすべて解消し、playtest_screenshotで結果を確認したうえで、エディターのリンクを渡します。
シェルファーストが重要な理由
ゲーム全体を 1 つの HTML 文字列として書き、あとから分割するというやり方は、すでに料金を払ったコードを書き直して いるだけです。さらに悪いことに、単一ファイルのゲームには天井があります。あとから変更するたびに、ソース全体を コンテキストウィンドウに通すことになり、AI は自分にはもう見えていない部分を壊し始めます。シェルファーストで 作れば、1 回の変更で読み書きするのは数百 KB ではなく数 KB で済みます。
本当に 1 画面だけの小さなゲーム——1,500 行を大きく下回り、レベルなし、敵は 1 種類のみ——であれば、
create_game 1 回で作って構いません。複数レベル、複数種類の敵、ストーリーモードのいずれかが
あるなら、そうすべきではありません。
ファイルが欠けたシェルは、真っ白な画面になります。 未書き込みのファイルがシェルに残っている間は 実行時チェックがスキップされるため、最後の 1 つが揃うまで何も検証されません。ファイルがまだ残っているのに アシスタントがゲームの完成を宣言した場合、その主張はまだテストされていません。
編集:変更の大きさでツールを選ぶ
既存のゲームに対する反復作業がどれだけ速く、どれだけ安く済むかは、ほぼこれ一つで決まります。
| 変更 | 方法 |
|---|---|
| 数値だけを変更 | bake_config |
src/ 内の 1 ファイルの挙動 | list_game_files → read_game_file → edit_game_file——群を抜いて安い |
| シェル内の何か(マーカー、script の順序、起動処理) | search_game_source → edit_game |
| 新しいシステム、キャラクター、シーン | write_game_file のあと、edit_game で script タグを追加 |
| ストーリーやセリフの内容 | read_data / write_data——検索置換は絶対に使わない |
| 全面書き直し | update_game、または分割アップロード |
get_game が検索ツール代わりに使われていないか注意してください。 素材が入ると、ゲームは
数 MB になります。1 つの関数を探すためにゲーム全体を取得するのは遅いうえ、他のすべてをコンテキストから
押し出してしまいます。list_game_files と search_game_source は、まさにこれを
避けるために存在します。
遭遇する保護機構
サーバー側にはいくつかのルールがあり、いずれも実際に起きた事故がきっかけで導入されました。アシスタントが 試みた操作を時おり拒否しますが、その拒否はたいてい正しい判断です。
| ルール | 内容 |
|---|---|
| 素材消失防止 | 画像・音声・モデルの数を減らす書き込みは、呼び出し側が明示的に許可しない限り拒否されます。あるとき編集で 26 個の素材が 1 個にまで減ってしまった事故のあとに導入されました。 |
| サーバー側の素材を優先 | AI が古いコピーをもとにファイル全体を書き直して送信した場合、素材ブロックはキーごとにマージされ、サーバー上の現在のバージョンが優先されます。レスポンスにはどれが保持されたかが示されるため、モデルがそれを「修正」しようとすることはありません。 |
| 注入前に再読み込み | 生成には数秒から数分かかります。ツールは注入の直前にゲームを再読み込みするため、時間のかかるジョブがその間のあなたの変更を上書きすることはありません。 |
| 全か無かの編集 | 編集は保存される前に、適用、検証、構文チェック、素材チェックを経ます。いずれか 1 つでも失敗すれば、何も変更されません。 |
| 実行時ゲート | 送信された内容は実際のブラウザで実行されます。壊れているゲームは拒否され、保存されずあなたに渡ることもありません。 |
非同期ジョブ
音楽、sprite アニメーション、動く CG、Live2D のリグ付けは、バックグラウンドジョブと
して実行されます。ツールはすぐにタスク ID を返し、check_job(check_model_3d として
も登録されています)がそれをポーリングします。中断された sprite ジョブは、保存済みの状態から再開されるため、
動画分の credits を再度消費することはありません。
アシスタントが複数のジョブをまとめて開始し、一緒にポーリングする様子が見られるはずです。それは正しい 動きです——1 つのジョブで動きを止めるべきではありません。
予算
予算は支出メーターではなく、設計上の入力として伝えてください:「5,000 credits でゲームを作って」。
予算モードを組み込んでおけば、うまくいく実行では制作範囲に見積もりを出し、何が手に入り何が手に入らないかを
伝えたうえで、使う前に確認を求めます。その後 budget_status が、そのゲームについてツールごとに
まとめた帳簿と、まだどのゲームにも紐づいていない直近の支出、そしてペースの判定を報告します。
ゲームが存在する前に生成したコンセプトアートは、そのゲームに紐づけられません。 デザイン先行の工程は
create_game より前に行われるため、その支出は budget_status には見えません。
注意深いアシスタントはそれを計画に数え入れ、ゲームができた時点で concept_art にゲーム ID を
渡します。ある実行が「5,000 のうち 5,000 を使用」と報告しても、実際の金額はそれより多いことがあります。
ウォレット
get_convention は、現在どのウォレットが有効か、各ウォレットにどれだけ残っているかを報告します。
生成は有効なウォレットにのみ課金され、残高がなくなれば停止し、別のウォレットへ自動的に切り替わることは
ありません。ツールが残高切れを報告した場合、アシスタントはそれをあなたに伝え、判断をゆだねるべきです——
set_active_wallet でウォレットを切り替えるのはあなたが決めることであり、アシスタントが勝手に
決めることではありません。
エディターのリクエストループ
このループによって、外部のアシスタントもエディターの中で第一級の存在として扱われます。実行中のゲームの中で 何かを丸で囲んで説明すると、それがアシスタントの受け取れるリクエストになります。
| ツール | 動作 |
|---|---|
read_edit_requests | プル方式。テキスト、アクション、対象エンティティ、現在の設定、そして実画像としてのスクリーンショットを最大 2 枚まで返します。 |
wait_for_edit_request | プッシュ方式。ハートビート付きで約 50 秒間ロングポーリングし、エディター側で「AI が待機中」と表示できるようにします。 |
finish_edit_request | 完了時に必ず呼び出します。あなたのメモはエディターにリアルタイムで表示されます。 |
自己改善
「自己学習」モジュールをオンにすると、アシスタントは制作の最後に submit_feedback を呼び出し、
具体的で使い回せる教訓を 1 つ記録します——落とし穴とその対処法、うまくいった数値、API のクセなどです。
これらのメモは、以降の制作で対応する get_skill のレスポンスに追加され、使うほどエンジンが
賢くなっていきます。list_learned で、これまでに蓄積された内容を確認できます。
不安定な接続
巨大な 1 回の create_game は、あらゆる呼び出しの中で最も壊れやすいものです——途中で切断される
と、ゲーム全体を作り直すことになります。不安定な接続モードをオンにすると、アップロードは
番号付きのチャンクに分かれ、begin_game_upload、append_game_html、
commit_game を通じて行われます。切断後に同じチャンクを再送しても安全で、あるチャンクが
抜けている場合はサーバーがどのチャンクを待っているかを教えてくれます。
分割アップロードは、初回作成と全面書き直しのみに使います。日常の変更には編集系ツールを使ってください。
実行を導く
| こう伝える | 得られるもの |
|---|---|
| 「まず規約と関連する skill を読んで」 | 実証済みのブループリントから取ったメカニクスになり、思いつきで作られません。無料で、最も効果の大きい指示です。 |
| 「使う前に見積もりを出して」 | 承認するか削るか判断できる、範囲と小計。 |
| 「シェルファーストで、エンティティごとに 1 ファイルにして」 | あとから変更しても安く済むゲーム。 |
| 「追加のポーズはすべて、キャラクターの立ち絵を使って」 | 画像ごとに別人になるのではなく、最初から最後まで同じキャラクター。 |
「完成したと言う前に list_assets を確認して」 | お金を払ったアートがゲームの中で見えないまま眠ることがなくなる。 |
| 「数値は触らず、外から調整できるようにして」 | 調整可能な値が config と schema に入り、自分で無料で調整できる。 |