pokevs_rgby.exe の使い方詳細 #

このドキュメントでは、AIによるポケモンバトルを実現する pokevs_rgby.exe の利用方法について解説します。

1. pokevs_rgby.exe の使い方 #

pokevs_rgby.exe は、PokeVSのポケモンバトルをWebインターフェース上で視覚的に楽しむためのパッケージです。 バックエンドでエミュレータとAIが動作し、その状況がリアルタイムでWebインターフェースに表示されます。

実行コマンド #

このスクリプトは、コマンドラインから引数を指定して実行します。

pokevs_rgby.exe [envファイル] [ROM1] [ROM2] [セーブ1] [セーブ2] [-p1_client コントローラー1] [-p1_model LLMモデル] [-p2_client コントローラー2] [-p2_model LLMモデル]

コマンド例:

pokevs_rgby.exe \
    config.env \
    pokemon_red.gb \
    pokemon_blue.gb \
    save1.sav \
    save2.sav \
    -p1_client manual \
    -p2_client openrouter \
    -p2_model google/gemini-1.5-pro-latest

2. 環境設定とコマンド引数の詳細 #

PokeVSの動作は、config.envファイルによる環境変数の設定と、実行時のコマンドライン引数によって決まります。両者の関係を理解することが重要です。

2.1. 環境変数 (.env ファイル) #

.envファイルは、ご自身の環境に合わせてPokeVSの基本的な設定を行うためのものです。

2.2. コマンドライン引数 #

コマンドライン引数は、対戦ごとに変わる設定を指定します。

2.3. 環境変数と引数の連携 #

これらがどのように連携して動作するのか、具体例を挙げて説明します。

• ROMファイルの特定: プログラムは、.envのROM_ROOTPATHと引数のrom1（例: pokemon_red.gb）を結合して、D:/roms/pokemon/pokemon_red.gb のような絶対パスを組み立て、対象のROMファイルを読み込みます。

• AIコントローラーの利用: 引数で -p2_model "google/gemini-1.5-pro-latest" のようにLLMを指定した場合、プログラムは.envファイルからOPENROUTER_API_KEYを読み込み、そのキーを使ってOpenRouterのAPIにアクセスし、AIの思考を促します。もしこのキーが設定されていなければ、AIは動作できずエラーとなります。

2.4. コントローラーの種類 #

-p1_client と -p2_client で指定できるコントローラーの種類は以下の通りです。

2.5. LLMモデルの種類 #

-p1_model と -p2_model で指定可能なLLMモデルは以下の通りです。