AIによるBevyゲーム開発 — チャットからRustゲームを作成、ビルド、検査
AI Game DeveloperがBevyに対応。Rustゲームを作成し、cargoの実際のビルド進行状況を確認、AIエージェントがBRP経由で実行中のゲームに問い合わせられます。

BevyはRustで書かれたオープンソースのゲームエンジンで、Entity Component Systemを中心に設計されています。エディタはありません。Bevyのゲームはcargoクレートであり、コードとして書かれ、cargoで実行されます。AIエージェントを内蔵したデスクトップアプリ、AI Game DeveloperがBevyプロジェクトに対応しました。アプリは新しいBevyゲームを作成し、cargoの実際の進行状況を示す進行カードとともにビルドと実行を行い、エージェントを実行中のゲームに接続して、ECSワールドの中を覗いて変更できるようにします。
この記事では、アプリがBevyプロジェクトに対して何を行うのか、自分でインストールする必要があるもの、そしてエージェントが実行中のゲームとどう連携するのかを説明します。
AIによるBevyゲーム開発
RustとBevyはAIエージェントとの相性が良いと言えます。コンパイラは厳格でエラーメッセージは正確なので、エージェントは何が問題だったのかをすぐに理解できます。ECSはゲームの状態を、列挙して読み取れる素朴なコンポーネントとして保持します。これまで欠けていたのは、コードを囲むループです。ビルドを開始し、ゲームが実際に動作していることを把握し、ログから推測するのではなく中身を見ることです。
AI Game Developerがそのループを追加します。Cargo.tomlがbevyに依存していてsrcフォルダがあれば、そのフォルダをBevyプロジェクトとして扱い、以降そのプロジェクトにはPlayボタン、ビルド進行カード、エージェント用のライブツール一式が用意されます。
必要なもの: Rustとcargo
アプリはRustをインストールしません。Bevyのゲームはcargoでビルドするので、 https://rustup.rs からrustupでRustツールチェーンを一度インストールしてください。アプリはcargoを通常の場所で探します。CARGO_HOME、ホームディレクトリのデフォルトの .cargo/bin フォルダ、あるいはPATHです。macOSでDockからアプリを起動した場合、シェルのPATHが見えないためPATHが重要になります。cargoが見つからない場合は、曖昧なエラーで失敗するのではなく、その旨を伝えてrustupへのリンクを表示します。
またBevyには、プラットフォームによって独自のシステム要件があります。たとえばLinuxではグラフィックスとオーディオのライブラリです。お使いのオペレーティングシステム向けのBevyのセットアップガイドに従ってください。ゲームが起動直後に停止した場合は、アプリがログのpanic行とともに知らせます。
新しいBevyプロジェクトを作成する
Bevyプロジェクトは、デスクトップのプロジェクト作成ダイアログから、下記のcreateコマンドを使ってCLIから、あるいはチャットでエージェントに頼んで作成できます。できあがるのは、すぐに実行できる小さなクレートです。
- Bevy 0.20と、そのbevy_remote機能を有効にしたCargo.toml。さらにBevy推奨の開発プロファイルも含みます。自分のコードは素早くコンパイルされ、依存関係は最適化されます。
- Bevyのデフォルトプラグイン、アプリが渡すポートで動作するRemote Protocolプラグイン、そして2Dカメラを追加するmain.rs。
- assetsフォルダと、targetフォルダ用の.gitignore。
/create-project bevy my-game既存のBevyゲームがありますか?そのフォルダを開いてください。アプリのBevy向けプラグインインストールは、Cargo.tomlにbevy_remote機能を追加します。Rustのソースは決して編集しません。アプリがまだリモートプラグインを追加していない場合、アプリは追加すべき1行を表示し、頼めばエージェントがそれを追加してくれます。
cargoの実際のビルド進行状況を見る
Bevyゲームの初回ビルドは数百のクレートをコンパイルするため、数分かかることがあります。何が起きているかわからないまま待つのは最悪なので、アプリがそれを表示します。Playを押すと、アプリはバックグラウンドでcargo runを実行し、cargo自身の進行状況バーをログから読み取ります。進行カードは各ステップを実際の数値で示します。クレートインデックスの更新、ゲームのクレートのダウンロード、そして完了したビルドユニット数と総ビルドユニット数、cargo自身が報告するパーセンテージ付きのコンパイルです。推定値は一切ありません。

ビルドが完了すると、カードはゲームを起動中と表示し、実際に動作するまで待ちます。コンパイルエラーでcargoが停止した場合、カードはエラー行と完全なログのパスを表示します。起動直後にゲームがpanicした場合、たとえばシステムライブラリが不足している場合などは、黙って消えてしまったゲームではなく、panicメッセージが表示されます。2回目以降のビルドはインクリメンタルで、ずっと高速です。
各プロジェクトは一度だけ実行されます。ゲームの実行中に再度Playを押すと、2つ目のコピーを起動するのではなく、そのゲームを表示します。チャットを閉じてもゲームは停止しません。まだプレイしている可能性があるからです。
エージェントはBRP経由でゲームと会話する
BevyにはBevy Remote Protocol、略してBRPが同梱されています。HTTP上のJSON-RPCで、別のプログラムが実行中のアプリのECSワールドを問い合わせたり変更したりできます。AI Game Developerはこれをライブ接続として使用し、あなたのマシン上(127.0.0.1)でのみ動作します。エージェントがBevyプロジェクトに接続すると、次のツールが利用可能になります。
- discoverは、実行中のゲームが提供するリモートメソッドを一覧表示します。
- queryは、持っている、または持っていないコンポーネントでエンティティを検索し、コンポーネントの値を返します。
- get_componentsは、1つのエンティティの指定したコンポーネントを読み取ります。
- list_componentsは、1つのエンティティのコンポーネント、またはゲームが登録したすべてのコンポーネント型を一覧表示します。
- callは、他の任意のBRPメソッドを実行します。たとえばエンティティのスポーンやデスポーン、コンポーネントの挿入や変更、リソースの読み書きなどです。
これにより、エージェントは推測ではなく事実を得られます。「なぜ敵が動かないのか?」と尋ねれば、エージェントはゲームの実行中に敵のTransformと速度のコンポーネントを問い合わせ、アイデアを試すために値を変更し、それからコードを修正できます。ツールは現在のBevyのバージョンのメソッド名で動作し、Bevy 0.15と0.16が使う古い名前にもフォールバックします。
複数のBevyプロジェクトを同時に実行できます。アプリは自身が起動した各ゲームに専用のBRPポートを割り当て、そのプロジェクトのために起動したゲームとだけ通信します。Bevyのデフォルトポートは、自分で起動したゲームのために残されます。
知っておくとよいこと
- Bevyのゲームは通常どおり、独自のネイティブウィンドウで開きます。アプリはアイドル状態でもゲームを停止しません。停止するのは再起動やエージェントとの切断のときです。
- エージェントのツールは、BRPが公開するもの、つまりリフレクションに対応したコンポーネントとリソースを見ることができます。自分のコンポーネントとリソースにReflectをderiveすると、それらが見えるようになります。
- Bevy自体のMITまたはApache-2.0ライセンスは、アプリを使わない場合と同様にあなたのゲームに適用されます。
はじめましょう
rustupでRustをインストールし、 ai-game.dev/download からAI Game Developerをダウンロードし、Bevyプロジェクトを作成してPlayを押してください。最初のビルドが走っている間に、作りたいゲームをエージェントに説明しましょう。アプリの詳細は ai-game.dev/docs/app にあります。ブラウザ向けにビルドしたい場合は、Three.js対応について ai-game.dev/blog/threejs-game-development-with-ai で、BRUTAL C#フレームワークについては ai-game.dev/blog/brutal-dotnet-game-development-with-ai で読めます。
画像クレジット: Bevyの鳥のロゴはBevyリポジトリ(MIT OR Apache-2.0)のもので、エンジンを識別するためのものであり、Bevyのものです。イラストはAI Game Developerが作成しました。

