Behavior Tree アセットを作成する

このセクションでは、Unreal Engine 5 内にさまざまな Behavior Tree アセットを作成する方法について説明します。

ビヘイビアツリーを作成する

*ビヘイビアツリー は基本的に AI のプロセッサであり、その結果に基づいて決定を行い、さまざまなブランチを実行することができます。ビヘイビアツリー は、次の方法で コンテンツドロワー** 内に作成されます。

[+Add (新規追加)] ボタンをクリックし、[Create Advanced Asset (高度なアセットを作成)] で [Artificial Intelligence (AI)]、[Behavior Tree] の順に選択します。

Click the Add button then under Create Advanced Asset select Artificial Intelligence and Behavior Tree

新しい Behavior Tree (ビヘイビアツリー) アセットが コンテンツドロワー に追加されるので、名前を付けます。

The new Behavior Tree asset will be added to the Content Drawer where you can define its name

右クリックのコンテキストメニューを使用して、[+Add]>[Artificial Intelligence]>[Behavior Tree] を選択することもできます。

ブラックボードを作成する

Blackboard アセットは、AI の「頭脳」と考えることができ、Behavior Tree がその決定に必要なキーの値を格納します。Blackboard アセットは以下の方法で作成できます。

[+Add (新規追加)] ボタンをクリックし、[Create Advanced Asset (高度なアセットを作成)] で [Artificial Intelligence (AI)]、[Blackboard] の順に選択します。

Click the Add button, then under Create Advanced Asset select Artificial Intelligence and Blackboard

新しい Blackboard アセットが コンテンツドロワー に追加されます。このブラウザを使用して、任意の名前に変更できます。

The new Blackboard asset will be added to the Content Drawer which you can rename to your desired name

ビヘイビアツリー内にブラックボードを作成するもう 1 つの方法があります。

ビヘイビアツリーエディタ のツールバーから [New Blackboard (新規ブラックボード)] ボタンをクリックします。

Inside the Behavior Tree Editor from the Toolbar by clicking the New Blackboard button

これにより、コンテンツドロワー 内に新しい Blackboard アセットも作成されます。

ビヘイビアツリータスクを作成する

タスク とは、ある場所に移動したり、何かに向かって回転するなど、AI に実行させたい「アクション」のことです。

最適化が問題になる場合は、Blueprint ビヘイビアツリータスクをネイティブのビヘイビアツリータスクに切り替えることをお勧めします。

既存の タスク に加えて、独自のロジックでカスタム タスク を作成することができます。

[Behavior Tree Editor (ビヘイビアツリーエディタ)] 内のツールバーから [New Task] ボタンをクリックします。

Click the New Task button from the Toolbar inside the Behavior Tree Editor

これにより、タスク ロジックの作成が可能な新しい BTTask_BlueprintBase クラスの新しいブループリントが開きます。

This will open a new Blueprint of the BTTask_BlueprintBase class where you can provide your Task logic

Task ブループリント は、コンテンツドロワー 内の Behavior Tree アセットと同じ場所に作成されます。

ビヘイビアツリーエディタ から新しい タスク を作成するときは常に、デフォルトの名前を使用するのではなく、コンテンツドロワー にアクセスしてアセットの名前を変更することをお勧めします。

新しい タスク を作成する際に、ドロップダウンメニューで既存の Behavior Tree タスク を選択すると、そのタスクを 親クラス として使用して、その機能を継承することができます。

You can use an existing Behavior Tree Task as the Parent Class to inherit functionality by selecting it from the drop-down menu

Behavior Tree デコレーターを作成する

デコレーター (条件式とも呼ばれる) は Behavior Tree の内側のノードにアタッチし、ツリー内のブランチ (またはノード 1 つでも) を実行可能にするかどうかの決定に使用できます。Behavior Tree で使用できるデフォルトの デコレーター がいくつかありますが、カスタムのデコレーターも作成できます。

ビヘイビアツリーエディタ 内のツールバーから [New Decorator (新規デコーダー)] ボタンをクリックします。

Click the New Decorator button from the Toolbar inside the Behavior Tree Editor

これにより、新しい デコレーター ロジックの作成が可能な新しい BTDecorator_BlueprintBase クラスが開きます。

This will open a new BTDecorator_BlueprintBase class where you can provide your Decorator logic

Decorator ブループリント は、コンテンツドロワー 内の Behavior Tree アセットと同じ場所に作成されます。

ビヘイビアツリーエディタ から新しい デコレーター を作成するときは常に、デフォルトの名前を使用するのではなく、コンテンツドロワー にアクセスしてアセットの名前を変更することをお勧めします。

新しい デコレーター を作成するときは、既存の Behavior Tree デコレーター を 親クラス として使用し、ドロップダウンメニューから機能を継承することができます。

You can use an existing Behavior Tree Decorator as the Parent Class to inherit functionality from by selecting it from the drop-down menu

Behavior Tree サービスを作成する

サービス は Composite ノードにアタッチされ、ブランチが実行されている限り、定義された頻度で実行されます。これらは ブラックボード のチェックや更新によく使われ、他の Behavior Tree システムの従来の Parallel ノードに取って代わるものです。デフォルトで利用可能な サービス はいくつかありますが、Behavior Tree の実行方法の決定を支援する独自のカスタムサービスを作成することができます。

最適化が問題になる場合は、Blueprint Behavior Tree サービスをネイティブの Behavior Tree サービスに切り替えることをお勧めします。

ビヘイビアツリーエディタ のツールバーから [New Service (新規サービス)] ボタンをクリックします。

Click the New Service button from the Toolbar inside the Behavior Tree Editor

これにより、新しい サービス ロジックの作成が可能な新しい BTService_BlueprintBase クラスが開きます。

This will open a new BTService_BlueprintBase class where you can provide your Service logic

Service ブループリント は、コンテンツドロワー 内の Behavior Tree アセットと同じ場所に作成されます。

ビヘイビアツリーエディタ から新しい サービス を作成するときは常に、デフォルトの名前を使用するのではなく、コンテンツドロワー にアクセスしてアセットの名前を変更することをお勧めします。

新しい サービス を作成する際に、ドロップダウンメニューで既存の Behavior Tree サービス を選択すると、そのサービスを 親クラス として使用して、その機能を継承することができます。

You can use an existing Behavior Tree Service as the Parent Class to inherit functionality from by selecting it from the drop-down menu

ブラックボードを編集する

通常、Behavior Tree が意思決定プロセスにおいて ブラックボード を参照するために、Behavior Tree の前に ブラックボード を作成します (必要に応じていつでもキーを追加できます)。コンテンツドロワー でアセットをダブルクリックして ブラックボードエディタ を開くと、Blackboard アセットを編集できます。

You can edit a Blackboard asset by double-clicking on the asset in the Content Drawer to open it up in the Blackboard Editor

ブラックボード が割り当てられた Behavior Tree を編集しているときは、ウィンドウの右上にあるタブをクリックして ブラックボード に切り替えることができます。

You can switch to the Blackboard by clicking the tab in the upper-right corner of the window

[Blackboard Details] パネルでは、親としてもう 1 つの ブラックボード を割り当てると、そこからキーを継承することができます。

In the Blackboard Details panel you can assign a different Blackboard as the Parent, inheriting Keys from it

ブラックボード ウィンドウにある [New Key] ボタンをクリックすると、キーを追加できます。

You can add Keys by clicking the New Key button in the Blackboard window

キーとして格納できる変数型の詳細については、「ブループリント変数」を参照してください。

キーが作成されたら、[Blackboard Details] パネルでキーに関連するプロパティを定義できます。

You can define properties associated with the Key in the Blackboard Details panel

プロパティ	説明
Entry Name	キーのユーザー定義名です。
Entry Description	ブラックボードキーの機能を説明するオプションの説明です。
Key Type	キーの作成時に定義されていますが、Object キーと Class キーには、特定のクラスを定義できるより多くの追加オプションが用意されています。これにより、Object (アクタのようなもの) から継承された任意のタイプのデータを格納できます。
Instance Synced	これは、ブラックボードのすべてのインスタンスでキーの同期の決定に使用されます。

Rename または Delete を行うには、キーを右クリックしてコンテキストメニューを表示するか、キー上で F2 キーまたは Delete キーを押します。

To Rename or Delete Key right-click a Key to bring up the context menu

Class キーと Object キーの場合、[Key Type] の横にある小さな三角形をクリックすると、使用する Base Actor クラスを定義できます。

For Class and Object Keys you can click the little triangle beside Key Type

Enum キーの場合は、[Key Type] の横にある小さな三角形をクリックして設定できる追加のプロパティがあります。

For Enum Keys there are additional properties that can be set by clicking the little triangle beside Key Type

プロパティ	説明
Enum Type	割り当てられた列挙型を使用します。
Enum Name	C++ コードで定義された列挙型の名前は、Enum Type で割り当てられたアセットよりも優先されます。
Is Enum Name Valid	Enum Name のオーバーライドが有効でアクティブなときに設定します。

ビヘイビアツリーを編集する

ビヘイビアツリー を編集するには、Behavior Tree アセットを開く必要があります。

コンテンツドロワー で Behavior Tree アセットをダブルクリックして、[Behavior Tree Mode] に入ります。

Double-click a Behavior Tree asset in the Content Drawer to enter Behavior Tree Mode

または Behavior Tree モード に切り替えることでも可能です。

[Behavior Tree Editor] の右上隅にある [Behavior Tree] タブをクリックします。

Click the Behavior Tree tab in the upper-right corner of the Behavior Tree Editor

[Behavior Tree Mode] に切り替えるには、現在開いている Behavior Tree アセットを持っており、[Blackboard Mode] から切り替えている必要があります。

ブラックボードを割り当てる

Behavior Tree が ブラックボード にアクセスするためには、Blackboard アセットを割り当てる必要があります。

グラフ内の Root ノードを選択 (またはすべてのノードの選択を解除) してから、[Details (詳細)] パネルで必要な Blackboard アセット を設定します。

In the Details panel set your desired Blackboard Asset

ブラックボード を割り当てた後、[Blackboard] パネルは関連付けられた Blackboard Key で更新されます。

The Blackboard panel will update with its associated Blackboard Keys

ノードを操作する

Behavior Tree のグラフに コンポジット、または タスク を追加するには、グラフを右クリックしてコンテキストメニューを表示し、目的のノードを選択します。

Right-click the graph to bring up the context menu and select your desired node

Behavior Tree の Root ノードに接続できるのは、Composite ノードだけです。

ノードをドラッグして追加したいノードをコンテキストメニューから選択することもできます。

You can also drag off a node and select a node to add from the context menu

グラフからノードを削除するには、1 つのノード (もしくは複数のノード) を選択して Delete キーを押します (または右クリックして Delete キーを押します)。

To remove nodes from the graph select a node or nodes and press Delete or right-click and select Delete

ノードを接続するには、左クリックして出力ピンから別のノードの入力ピンにドラッグします。

To connect nodes together left-click and drag from the output pin, to an input pin on another node

Behavior Tree でノードを接続するには、出力を入力に接続する必要があります (入力から出力に接続することはできません)。

ノードの接続を解除するには、ノードを右クリックして (または選択したノードを定義して) 希望の [Break All Pin Link(s) (すべてのリンクを解除)] メソッドを選択します。

To disconnect nodes right-click a node or define a selection of nodes and select your desired Break Link(s) method
[Break All Pin Link(s)] を使用すると、ピン留めされている 1 つまたは複数のノードを切断できます。[Break link to...(...へのリンクを解除)] をクリックすると、指定したノードへの接続が切断されます。