Get Started

PokeVS のはじめかた #

はじめに #

PokeVS(pokevs_rgby.exe) は、ポケットモンスター赤・緑・青・ピカチュウ版で2人のプレイヤーが対戦できるプログラムです。自分で操作したり、AIに操作させたりすることができます。

何ができるの? #

  • 🎮 2つのポケモンを同時に動かす: まるで通信対戦のように!
  • 🤖 AIと対戦: ChatGPTのようなAIがポケモンを操作します
  • 👤 自分で操作: プレイヤー1は手動で操作できます
  • 📊 対戦の様子が見える: AIが何を考えているか画面で確認できます

システム要件 #

  • Windows OS
  • BizHawkエミュレータ(同梱しています)

必要なもの #

始める前に、以下のファイルを用意してください:

  1. ポケモンのゲームファイル (拡張子: .gb)

    • 例:pokemon_red.gbpokemon_blue.gbなど
    • プレイヤー1とプレイヤー2で同じゲームファイルを使用可能
  2. セーブデータ (拡張子: .sav)

    • 対戦用のポケモンが準備されているデータ
    • プレイヤー1とプレイヤー2で同じセーブデータを使用可能
  3. 設定ファイル (拡張子: .env)

    • メモ帳で作成できます(作り方は後で説明)

ステップ1: 設定ファイルを作る #

  1. メモ帳を開く
  2. 以下の内容をコピーして貼り付け:
# 使用するBizHawkエミュレータのファイルパス
EMUHAWK_FILEPATH=C:\PokeVS\BizHawk-2.10-win-x64\EmuHawk.exe

# ゲームファイルを格納しているファイルパス
ROM_ROOTPATH=C:\PokeVS\

# 8080以外のportを使用する場合に設定
SOCKET_PORT=8081

# AIを使う場合は、ここにAPIキーを入力
OPENROUTER_API_KEY=ここにあなたのAPIキーを入力
  1. ファイル名を config.env として保存
    • 保存する時「ファイルの種類」を「すべてのファイル」に変更してください

ステップ2: プログラムの起動方法 #

方法1: バッチファイルを使う(初心者向け) #

  1. メモ帳を開く
  2. 以下をコピーして、自分のファイル名に書き換える:
@echo off
pokevs_rgby.exe config.env pokemon_blue.gb pokemon_blue.gb player1.sav player2.sav
pause
  1. 対戦開始.bat という名前で保存
  2. 保存したファイルをダブルクリックで実行

方法2: コマンドプロンプトを使う #

  1. コマンドプロンプトを開く

    • Windowsキー + R を押す
    • 「cmd」と入力してEnter
  2. プログラムがある場所に移動

    cd C:\あなたのフォルダ\PokeVS
    

    (実際のフォルダ名に置き換えてください)

  3. プログラムを実行

    pokevs_rgby.exe config.env pokemon_red.gb pokemon_blue.gb player1.sav player2.sav
    

対戦モードの選び方 #

🎮 自分 vs 🔰 コンピューター(かんたん) #

何も追加せずに実行すれば、自動的にこのモードになります:

pokevs_rgby.exe config.env pokemon_red.gb pokemon_blue.gb player1.sav player2.sav

🎮 自分 vs 🤖 AI(ChatGPTなど) #

コマンドの最後に以下を追加:

pokevs_rgby.exe config.env pokemon_red.gb pokemon_blue.gb player1.sav player2.sav -p2_client openrouter -p2_model "openai/gpt-4o"

🤖 AI vs 🤖 AI(観戦モード) #

両方のプレイヤーをAIにする:

pokevs_rgby.exe config.env pokemon_red.gb pokemon_blue.gb player1.sav player2.sav -p1_client openrouter -p1_model "anthropic/claude-3.5-sonnet" -p2_client openrouter -p2_model "openai/gpt-4o"

画面の見方 #

プログラムを起動すると、大きな画面が開きます:

┌─────────────┬─────────────┬─────────────┬─────────────┐
│             │             │             │             │
│ プレイヤー1 │  プレイヤー1 │ プレイヤー2 │ プレイヤー2 │
│   の状況    │   の行動    │   の行動    │   の状況    │
│             │             │             │             │
│ ・プロンプト│ ・使用モデル│ ・使用モデル│ ・プロンプト│
│ ・AIの回答  │ ・次の行動  │ ・次の行動  │ ・AIの回答  │
│             │             │             │             │
└─────────────┴─────────────┴─────────────┴─────────────┘
  • プロンプト: 現在の戦闘状況が表示されます
  • AIの回答: AIが考えた内容が表示されます(AI使用時)
  • 次の行動: 選択された技や行動が表示されます

注意事項 #

  1. ゲームファイル: 合法的に取得したゲームファイルのみを使用してください
  2. セーブデータ: 対戦用のポケモンが準備されたセーブデータが必要です
  3. APIキー: OpenRouterを使用する場合は、有効なAPIキーが必要です
  4. ウィンドウサイズ: GUIは1920x1080の解像度に最適化されています

よくある質問 #

Q: ファイルをどこに置けばいいですか? #

A: すべてのファイルを同じフォルダに入れておくと簡単です。例えば:

C:\PokeVS\
  ├── pokevs_rgby.exe
  ├── BizHawk-2.10-win-x64
  ├── config.env
  ├── pokemon_red.gb
  ├── pokemon_blue.gb
  ├── player1.sav
  └── player2.sav

Q: AIを使うにはお金がかかりますか? #

A: OpenRouterのAPIキーを使う場合、使用量に応じて料金がかかります。無料で遊びたい場合は「random」モードを使ってください。

Q: 画面が大きすぎて見えません #

A: 画面解像度が1920x1080以下の場合、ウィンドウの端をドラッグして小さくしてください。

困ったときは #

プログラムが起動しない #

  1. すべてのファイルが同じフォルダにあるか確認
  2. ファイル名が正しいか確認(大文字・小文字も含めて)
  3. アンチウイルスソフトがブロックしていないか確認

AIが動かない #

  1. config.envファイルにAPIキーが正しく入力されているか確認
  2. インターネットに接続されているか確認
  3. APIキーの前後に余計なスペースがないか確認

操作方法がわからない #

  • プレイヤー1を手動操作する場合、BizHawkエミュレータの操作方法に従います
  • 通常のゲームボーイと同じ操作です(十字キー、A、B、Start、Select)

使えるAIモデル #

初心者の方は以下のモデルから始めることをおすすめします:

  • openai/gpt-4o-mini: 速くて安い
  • openai/gpt-4o: 賢いけど少し高い
  • anthropic/claude-3.7-sonnet: とても賢い

その他にも、 https://openrouter.ai/models からモデルを検索できます

最後に #

このプログラムは、懐かしのポケモン対戦を新しい形で楽しむためのものです。AIと対戦したり、AI同士の対戦を観戦したりして、新しい発見を楽しんでください!

何か分からないことがあれば、ファイルが正しく配置されているか、設定が正しいかをもう一度確認してみてください。