【TopDown Engine】敵キャラを走らせる方法（CharacterRunの使い方）

前書き
Character Runとは
敵キャラクターにCharacterRunを追加する
AIで走りを制御する方法
上記の方法では動かなかったのでちょっと修正
検証：どのくらいWalkingすればRunできる？
応用例
トラブルシューティング
1. 走らない
2. 常に走りっぱなし
まとめ

前書き

TopDownEngineに含まれるデモ用の敵キャラクターを見てみると、「CharacterRun」という移動系アクションアビリティが設定されています。

プレイヤーの場合は スペースキーを押しながら移動するとRun状態 に切り替わりますが、敵キャラクターには当然スペースキーを押す入力が存在しません。そのため、デフォルトのままでは敵AIに走らせることができない という問題が発生します。

本記事では、AIキャラクターにRunを実装する方法と注意点を解説していきます。サンプルとして、デモに含まれている KoalaNinja を対象に設定していきます。

Character Runとは

CharacterRunは、TopDownEngineにおける キャラクター移動系アビリティ の一つです。
その役割はシンプルで、歩き速度（WalkSpeed）と走り速度（RunSpeed）を切り替える 仕組みを提供します。

通常は歩き速度（WalkSpeed）
走り状態ではRunSpeedに切り替え
切り替えはCharacterRunコンポーネントのRunStart() / RunStop()で行う

プレイヤーキャラクターでは入力に応じて自動的に切り替わりますが、AIの場合は コードやAI Brainから手動で呼び出す必要 があります。

敵キャラクターにCharacterRunを追加する

まずは敵キャラクターのPrefabにCharacterRunを追加します。

敵キャラPrefabを選択
CharacterRunコンポーネントを追加
設定を確認
- Run Speed：走るときの速度（歩く速度に依存しない）

この時点で準備完了です。次に、AI側からRunを制御できるようにします。

今回はDemoにあるKoalaNinjaを使って説明していこうと思います。

AIで走りを制御する方法

AIキャラクターの場合、AIBrainのステートに応じてRunStart / RunStopを呼び出す必要があります。

基本的な流れ

ターゲットに接近中：RunStart（走る）
ターゲット探索中や待機中：RunStop（歩く）

これを実現するために、以下のアクションを利用します。

AIActionRunStart：Run開始を指示するアクション
AIActionRunStop：Run終了を指示するアクション

AIBrainで上記のアクションを設定してみましょう。設定方法は以下になります。

キャラクターアビリティ「AIActionRunStart」と「AIActionRunStop」を追加する
AIBrainのMovingで「Actions」ステートにRunStartを呼ぶアクションを追加する
AIBrainのDetectingで「Actions」ステートにRunStopを呼ぶアクションを追加する

上記の設定をすることで敵に近づくときはRunを行う、敵を捜索中の時はRunをやめるっといった動きになります。

この状態でさっそく動かしてみましょう。・・・ここまでの設定で一見正しく動作しそうですが、実際に試すと 移動速度がRunSpeedに切り替わらない という現象が発生します。

上記の方法では動かなかったのでちょっと修正

上記の設定でやってみるとなぜかAIBrainはRun状態になりますが、敵キャラの移動速度は速くなってないと思います。CharacterRunスクリプトを見てみるとRunをする条件に

現在のキャラクタのステータスがWalkを実行していること

という条件分岐がありました。
そのため、いきなりIdle（待機）状態からRun状態に移行することはできなく、必ず

Idle → Walking → Run という段階を踏む実装になっていました。

よって、まずは一定時間Walkingを行ってからRunに移行するようにAIBrainも設定する必要があります。

AI Brainをちょっと変えてみました。新しくAIDecisionTimeInStateとRunningというステートを追加しました。AIDecisionTimeInStateは一定時間が経ったらTrueを返すscriptになります。今回は一定時間Walkを実行した後にRunを実行するという条件を作りたいため追加しました。

設定例：