最初のバトルをセットアップ

このガイドでは、エンカウントゾーンの設定、野生バトルのトリガー、バトルフローの理解方法を説明します。完了すると、エディタでテスト可能な動作するバトルが出来上がります。

前提条件

MCE がインストールされ、セットアップウィザードが完了していること。
データベースに少なくとも1体のモンスターがあること（同梱の151体またはあなたが作成したもの）。
プレイヤーキャラクターとグリッドベースのタイルマップを持つシーンがあること。

ステップ 1：エンカウントゾーンの作成

野生バトルはタイルマップ上のエンカウントタイルによってトリガーされます。設定方法は以下の通りです：

シーンヒエラルキーで、エンカウントを配置したいタイルマップレイヤー（通常は「Grass」または「TallGrass」レイヤー）を選択します。
グリッドの子として新しい空の GameObject を作成します：Right-click > Create Empty、名前を GrassEncounters にします。
この GameObject に EncounterTile コンポーネントを追加します。
タイルベースの座標を使用して、エンカウントが発生するタイル上に配置します。

または、MCE のエンカウントタイルタイプを使用して、専用のタイルマップレイヤーにエンカウントゾーンを直接ペイントすることもできます。

ステップ 2：エンカウントテーブルの設定

EncounterTile コンポーネントは WildEncountersSet ScriptableObject を参照します。以下のように作成します：

Assets > Create > OpenMon > Wild Encounters Set
わかりやすい名前を付けます（例：Route1_GrassEncounters）。
ScriptableObject を開いてエンカウントを設定します：

フィールド	説明
Monster	出現する種族の MonsterEntry ScriptableObject
Min Level	野生モンスターの最低レベル
Max Level	野生モンスターの最高レベル
Probability	エンカウント重み（高いほど出現しやすい）
Encounter Type	エンカウントのトリガー条件（Walking、Surfing、Fishing など）

バリエーションを作るために複数のエントリを追加します。例：

モンスター	レベル範囲	確率
Flameleon	3-5	40
Leaflet	3-5	40
Sparkit	4-6	20

この WildEncountersSet を EncounterTile コンポーネントの Encounters フィールドに割り当てます。

ステップ 3：バトルシーンのセットアップ

MCE はバトル開始時にアディティブにロードされる専用のバトルシーンを使用します。必要なもの：

フィールドマップシーンにある BattleLauncher コンポーネント。通常は永続的なマネージャー GameObject 上に配置されています。セットアップウィザードを使用した場合は、すでに存在しているはずです。
ビルド設定に登録されたバトルシーン。デフォルトのバトルシーンは MCE に含まれています。

BattleLauncher は遷移を処理します：

画面をフェードします。
バトルシーンをアディティブにロードします。
正しいパラメータで BattleManager をインスタンス化します。
バトル終了後にフィールドマップに戻ります。

BattleManager コンポーネント

BattleManager はバトルシステムの中核です。バトルシーンには BattleManager コンポーネントを持つ GameObject があり、以下の主要モジュールによるモジュラーアーキテクチャを使用しています：

モジュール	目的
BattlersModule	両サイドのバトラーインスタンスを管理
HealthModule	HP追跡、ひんし判定、回復
MovesModule	技の実行、PP管理、タイプ相性
ItemsModule	バトル中のアイテム使用
CaptureModule	野生モンスターの捕獲メカニクス
AIModule	敵の意思決定
AnimationModule	バトルアニメーションとビジュアルエフェクト
AudioModule	バトル音楽と効果音
StatusesModule	状態異常（やけど、どく、ねむりなど）
BattlerStatsModule	ステータス段階と変化
BattlerSwitchModule	パーティメンバーの交代
RostersModule	バトル中のパーティ管理
ScenariosModule	バトルタイプの設定（野生、トレーナーなど）
MegaModule	メガシンカの発動
CharactersModule	トレーナースプライトの表示

これらを個別に設定する必要はありません。BattleManager が Zenject 依存性注入により自動的にすべてを接続します。

ステップ 4：BattleStateMachine の設定

BattleStateMachine がバトルフローを制御します：

Start → Introduction → Turn Selection → Action Execution →
  → Check Fainted → Replace Fainted → Turn End →
  → [loop back to Turn Selection or] → Battle End → Results

ステートマシンはバトルシーンプレハブに事前設定されています。各ステートはバトル条件に基づいて自動的に遷移を処理します。

ステップ 5：バトルのテスト

フィールドマップシーンに以下があることを確認します：
- 少なくとも1体のモンスターを含む手持ちを持つ PlayerCharacter。
- 設定済みの WildEncountersSet を持つ EncounterTile。
- マネージャー GameObject 上の BattleLauncher。
エディタで Play を押します。
キャラクターをエンカウントゾーンに歩かせます。
数歩後（エンカウント率により決定）、バトルがトリガーされます。

クイックテスト

歩き回らずにバトルをすぐテストするには：

EncounterTile のエンカウント率を100%に設定します。
または、BattleLauncher コンポーネントを直接使用して、テストスクリプトからそのランチメソッドを呼び出します。

バトルフローの理解

バトルが開始すると、内部では以下の処理が行われます：

BattleLauncher が EncounterTile からエンカウントトリガーを受信します。
野生モンスターのデータを含む BattleParameters オブジェクトが作成されます。
バトルシーンがアディティブにロードされます。
BattleManager がすべてのモジュールを初期化します。
BattleStateMachine が Introduction ステートに入ります（野生モンスターの表示、鳴き声の再生）。
プレイヤーにアクション選択が提示されます：たたかう、バッグ、モンスター、にげる。
アクションがすばやさ順に実行されます。
一方のサイドがひんしになるか、プレイヤーが逃走/捕獲するまでループが継続します。
BattleResultParameters がフィールドマップに返されます（獲得経験値、使用アイテム、捕獲モンスターなど）。
バトルシーンがアンロードされ、フィールドマップが再開します。

バトルタイプ

MCE は標準で複数のバトルタイプに対応しています：

タイプ	説明
Wild	単体の野生モンスターエンカウント、捕獲可能
Trainer	NPCトレーナーバトル、捕獲不可、勝利時に賞金獲得
Double	2対2のバトル形式
Scripted	特殊条件付きのストーリーバトル

バトルタイプは BattleParameters で渡される BattleType 列挙型によって決定されます。

バトルイベントのリスニング（DLLユーザー向け）

Lite、Basic、Pro ティア（ソースコードなし）を使用している場合でも、SDK を通じてバトルイベントに応答できます：

using OpenMon.MCE.SDK;

public class MyBattleTracker : MonoBehaviour
{
    [Inject] private IBattleSystem battleSystem;

    private void OnEnable()
    {
        battleSystem.OnBattleStarted += HandleBattleStarted;
        battleSystem.OnBattleEnded += HandleBattleEnded;
    }

    private void OnDisable()
    {
        battleSystem.OnBattleStarted -= HandleBattleStarted;
        battleSystem.OnBattleEnded -= HandleBattleEnded;
    }

    private void HandleBattleStarted()
    {
        Debug.Log("A battle has started!");
    }

    private void HandleBattleEnded(bool playerWon)
    {
        Debug.Log($"Battle ended. Player won: {playerWon}");
    }
}

MCE をソースコードなしで拡張する方法については、パブリックAPIガイドをご覧ください。

トラブルシューティング

問題	解決方法
バトルがトリガーされない	`EncounterTile` に有効な `WildEncountersSet` が割り当てられているか確認してください
エンカウント後に画面が真っ黒	バトルシーンが Build Settings のシーンリストに含まれているか確認してください
モンスターがレベル0で出現	エンカウントテーブルで Min Level と Max Level が設定されているか確認してください
バトル音楽が鳴らない	`BattleManagerAudioModule` にオーディオクリップが割り当てられているか確認してください
バトル開始時にクラッシュ	`MCE > Tools > Asset Validation` を実行して、不足しているデータベース参照を確認してください

次のステップ

バトルシステム詳細解説 -- バトルアーキテクチャの全体像を学びます。
技システム -- 668以上の技システムを理解します。
バトルAI -- 敵AIの設定とカスタマイズ方法を学びます。

前提条件​

ステップ 1：エンカウントゾーンの作成​

ステップ 2：エンカウントテーブルの設定​

ステップ 3：バトルシーンのセットアップ​

BattleManager コンポーネント​

ステップ 4：BattleStateMachine の設定​

ステップ 5：バトルのテスト​

バトルフローの理解​

バトルタイプ​

バトルイベントのリスニング（DLLユーザー向け）​

トラブルシューティング​

次のステップ​