1. Epic GamesDeveloper
  3. StateTree クイック スタート ガイド

StateTree クイック スタート ガイド

Unreal Engine で StateTree システムを使用するためのクイックスタート ガイド。

StateTree クイック スタート ガイド

概要

StateTree は汎用の階層型ステート マシンで、behavior tree の セレクター とステート マシンの ステート および 遷移 を組み合わせたものです。ユーザーは柔軟性のある高性能なロジックを作成したり、それを整理された状態に維持したりできます。

State Tree の詳細については、「State Treeの概要」に関するドキュメントを参照してください。

目的

このガイドでは、State Tree を使用して、プレイヤーが撃って破壊できる移動するターゲットを作成します。

目標

  • プレイヤーが撃って破壊できるターゲット アクタの ブループリント を作成します。

  • ターゲット アクタを移動および破棄するロジックを含む State Tree を作成します。

  • State Tree Task を作成し、それらを State Tree で使用します。

  • State Tree Evaluator を作成し、それらを State Tree で使用します。

1 - 必要な設定

  1. 新規プロジェクトを作成して [Games (ゲーム)] カテゴリを選択し、「First Person」テンプレートを選択します。プロジェクトの場所と名前を入力します。[Create (作成)] をクリックします。

    クリックしてフルサイズで表示。

  2. [Settings (設定)] > [Plugins (プラグイン)] をクリックして、[Plugins (プラグイン)] ウィンドウを開きます。

    Open the Plugins window

  3. GameplayStateTree および StateTree プラグインを検索して 有効 にします。Unreal Engine エディタを再起動します。

    Open the Plugins window

このセクションの結果

このセクションでは、新しいプロジェクトを作成し、State Tree プラグインを有効にしました。これで、ターゲット アクタで使用する State Tree を作成する準備が整いました。

2 - State Tree を作成する

このセクションでは、ターゲット アクタが使用する State Tree を作成します。この State Tree は、ターゲット アクタのコンポーネントとして使用することを目的としているため、この例では State Tree Component Schema を使用します。

  1. コンテンツ ブラウザ で、右クリックして [Artificial Intelligence] > [StateTree] を選択します。

    In the Content Browser, right click and select Artificial Intelligence > StateTree

  2. StateTreeComponentSchema クラスを選択し、[Select (選択)] をクリックします。

    Select the StateTreeComponentSchema class and click Select

  3. ステートに「Tree ST_ShootingTarget」という名前を付けます。

    Name the State Tree ST ShootingTarget

このセクションの結果

このセクションでは、ターゲット アクタによって使用されるコンポーネント スキーマを用いて State Tree を作成しました。

3 - シューティング ターゲットのブループリントを作成する

このセクションでは、プレイヤーから攻撃を受ける移動可能なターゲット アクタのブループリントを作成します。

  1. コンテンツ ブラウザ 内で右クリックし、[Create Basic Asset (基本アセットの作成)] セクションの [Blueprint Class (ブループリント クラス)] を選択します。

    1.[Pick Parent Class (親クラスを選択)] ウィンドウで、[Actor (アクタ)] ボタンをクリックして、新しいアクタのブループリントを作成します。

    1.ブループリントに「BP_ShootingTarget」という名前を付けます。

    Select Blueprint Class from the Create Basic Asset section Click the Actor button to create a new Actor Blueprint Name the Blueprint BP_ShootingTarget

  2. 「BP_ShootingTarget」を開き、[Components (コンポーネント)] ウィンドウに移動します。[+Add (+ 追加)] をクリックし、スタティックメッシュ を選択します。

    1.[Details (詳細)] パネルに移動して、[Static Mesh (スタティックメッシュ)] セクションまで下にスクロールします。

    1.[Static Mesh (スタティックメッシュ)] ドロップダウンをクリックし、「1M_Cube」を選択します。

    Click +Add and select Static Mesh Click the Static Mesh dropdown and select 1M_Cube

  3. スタティックメッシュ の [Scale (スケール)] を X = 0.2、Y = 2.0、Z = 2.0 に設定します。

    Set the Scale of the Static Mesh to X = 0.2, Y = 2.0, Z = 2.0

  4. [Components (コンポーネント)] ウィンドウで、[+Add] をクリックし、StateTree を選択します。

    1.[Details] パネルに移動し、[AI] セクションまで下にスクロールします。

    1.[State Tree] ドロップダウンをクリックし、「ST_ShootingTarget」を選択します。

    Click +Add and select StateTree Click the State Tree dropdown and select ST Shooting Target

    ドロップダウンに [State Tree] が表示されない場合は、誤ったスキーマが選択されていることを意味しています。State Tree コンポーネントで使用する StateTreeComponentSchema が選択されていることを確認してください。

  5. スタティックメッシュ コンポーネントを右クリックし、[Add Event (イベントの追加)] > [Add OnComponentHit (OnComponentHit の追加)] を選択します。

    Right click the Static Mesh component and select Add Event then Add OnComponentHit

  6. 新しい変数を作成し、「HitCount」という名前を付けます。

    1.[Details] パネルに移動し、[Variable Type (変数の型)] を [Integer (整数)] に設定します。

    Create a new variable and name it HitCount Set the Variable Type to Integer

  7. HitCount 変数を [Event Graph (イベント グラフ)] にドラッグし、Get HitCount を選択します。

    1.HitCount ノードからドラッグし、Increment Int を検索して選択します。

    1.On Component Hit ノードを Increment Int ノードに接続します。

    Connect the On Component Hit node to the Increment Int node

  8. [Event Graph] で右クリックし、[Add Custom Event (カスタム イベントを追加)] を検索して選択します。イベントに「DelayedDestroy」という名前を付けます。

    Add a Custom Event and name it DelayedDestroy

  9. DelayedDestroy ノードからドラッグし、Delay を検索して選択します。

    Add a Delay node

  10. Delay ノードからドラッグし、Destroy Actor を検索して選択します。

    Add a Destroy Actor node

このセクションの結果

このセクションでは、プレイヤーがゲームプレイ中に撃つ、シューティング アクタのブループリントを作成しました。これで、State Tree の Idle ステートと Dead ステートを作成する準備が整いました。

4 - Idle ステートと Dead ステートを作成する

  1. 「ST_ShootingTarget」に戻り、[Schema (スキーマ)] セクションで [Context Actor Class (コンテキスト アクタ クラス)] ドロップダウンをクリックします。「BP_ShootingTarget」を選択します。

    Click the Context Actor Class dropdown and select BP_ShootingTarget

  2. [+ Add State (+ ステートを追加)] をクリックして新しいステートを作成し、「Idle」という名前を付けます。

    Click + Add State to create a new State and name it Idle

  3. [Details] パネルに移動し、[Transitions (遷移)] セクションまで下にスクロールします。

    1.[Go to State (ステートに移動)] セクションを展開し、[Transition To (次に遷移)] ドロップダウンをクリックします。[Root (ルート)] を選択します。これにより、このステートが完了すると、State Tree が Root ステートに戻るように設定されます。

    1. [Trigger (トリガー)] ドロップダウンをクリックし、[On State Completed (オンステート完了)] を選択します。
    Click the Transition To dropdown and select Root The Idle State now shows the Transition to Root

  4. 別のステートを作成し、「Dead」という名前を付けます。

    Create another State and name it Dead

  5. Idle ステートを選択し、別の Transition を追加します。

    1.[Trigger (トリガー)] ドロップダウンをクリックし、[On Tick (ティック時)] を選択します。

    1.[Transition To (次に遷移)] ドロップダウンをクリックし、[Dead] を選択します。

    Click the Trigger dropdown and select On Tick. Click the Transition To dropdown and select Dead

  6. プラス記号 をクリックして、新しい Condition を追加します。ドロップダウンをクリックして [Integer Compare (整数と比較)] を選択します。

    1.構造を展開し、[Left Bind (左バインド)] ドロップダウンをクリックして、[Actor (アクタ)] > [Hit Count (ヒットカウント)] を選択します。これにより、「BP_ShootingTarget」内の [Hit Count] の値が StateTree Condition にバインドされます。

    1.Right 整数の値として「5」を入力します。

    Expand the structure and click on the Left Bind dropdown and select Actor > Hit Count Expand the structure and click on the Left Bind dropdown and select Actor > Hit Count Enter 5 as the value of the Right integer

このセクションの結果

このセクションでは、State Tree に Idle ステートと Dead ステートを追加しました。これで、Dead ステートを処理する State Tree Task を作成する準備が整いました。

5 - 新しい State Tree タスクを作成する

このセクションでは、Dead ステートが実行されたときにアクタを破棄する新しい State Tree Task を作成します。

  1. コンテンツ ブラウザ で、右クリックして [Blueprint Class] を選択します。

    1.[Pick Parent Class (親クラスを選択)] ウィンドウで [All Classes (すべてのクラス)] ドロップダウンを展開し、「StateTreeTaskBlueprintBase」を検索して選択します。

    1.[Select (選択)] をクリックしてアセットを作成します。

    1.ブループリント クラスに「STT_Destroy」という名前を付けます。

    Select Blueprint Class from the Create Basic Asset section Expand the All Classes dropdown and search for and select StateTreeTaskBlueprintBase Name the Blueprint class STT Destroy

  2. コンテンツ ブラウザ で「STT_Destroy」をダブルクリックして開きます。[Functions (関数)] セクションに移動し、[Override (オーバーライド)] ドロップダウンをクリックします。[ExitState] を選択します。

    Go to the Functions section and click the Override dropdown. Select ExitState

  3. 新しい変数を作成し、「Actor」という名前を付けます。タイプを [Actor Object Reference (アクタ オブジェクト参照)] に設定します。

    1.[Details] パネルに移動し、[Category (カテゴリ)] フィールドをクリックします。「Context」と入力します。

    1.Actor 変数を [Event Graph] にドラッグし、[Get Actor (アクタをゲット)] を選択します。

    1.Actor ノードからドラッグし、Cast to BP_ShootingTarget を検索して選択します。

    1. Cast to BP_ShootingTarget ノードの As BP Shooting Target ピンからドラッグし、Delayed Destroy を検索して選択します。

    1.Event ExitState ノードを Cast to BP_ShootingTarget ノードに接続します。

    Create a new variable and name it Actor. Set its type to Actor Object Reference Go to the Details panel, and set its Category to Context Connect the Event ExitState node to the Cast to BP_ShootingTarget node

このセクションの結果

このセクションでは、Dead ステートが実行されると起動する新しい State Tree Task を作成しました。このタスクによって、アクタが破棄されます。

6 - Dead ステートを終わらせる

  1. 「ST_ShootingTarget」に戻り、Dead ステートを選択します。新しい Task を追加し、ドロップダウンから [Debug Text Task] を選択します。

    1.[Text (テキスト)] フィールドに「Actor Destroyed」と入力します。

    1.[Text Color (テキストの色)] と [Font Scale (フォント スケール)] を入力します。

    Add a new Task and select Debug Text Task from the dropdown

  2. 別の Task を追加し、ドロップダウンから [Delay Task (遅延タスク)] を選択します。

    1.[Duration (持続時間)] に「2.0」を入力します。

    Add another Task and select Delay Task from the dropdown

  3. 3 つ目の Task を追加し、ドロップダウンから「STT_Destroy」を選択します。これにより、アクタが破棄されます。

    Add a third Task and select STT_Destroy from the dropdown

  4. 新しい Transition を作成し、[Trigger] を [On State Completed (オン ステート完了)] に設定します。

    1.[Transition To] ドロップダウンを [Tree Succeeded (ツリー成功)] に設定します。

    Create a new Transition and set the Trigger to On State Completed. Set the Transition To dropdown to Tree Succeeded

  5. 「BP_ShootingTarget」をレベルにドラッグし、[Play (プレイ)] を押します。ブループリントを動作させ、State Tree が機能していることを確認します。

    Drag BP_ShootingTarget to your Level and press Play The player shoots and destroys the Shooting Target

このセクションの結果

このセクションでは、Dead ステートを完了し、シューティング アクタ ブループリントがダメージを受けて破壊できることをテストしました。

7 - スプライン パスを追加する

このセクションでは、スプライン コンポーネントを使用してアクタを作成します。このスプラインで、シューティング ターゲット ブループリントがレベル内を移動できるようにします。

  1. コンテンツ ブラウザ 内で右クリックし、[Create Basic Asset (基本アセットの作成)] セクションの [Blueprint Class (ブループリント クラス)] を選択します。

    1.[Pick Parent Class (親クラスを選択)] ウィンドウで、[Actor (アクタ)] ボタンをクリックして、新しいアクタのブループリントを作成します。

    1.ブループリントに「BP_SplineActor」という名前を付けます。

    Select Blueprint Class from the Create Basic Asset section Click the Actor button to create a new Actor Blueprint Name the Blueprint BP_ShootingTarget

  2. 「BP_SplineActor」を開き、[Components (コンポーネント)] ウィンドウに移動します。[+Add (+ 追加)] をクリックし、[Spline] を選択します。

    1.ブループリントを コンパイル して 保存 します。

    Click the +Add button and select Spline

このセクションの結果

このセクションでは、スプライン コンポーネントを持つ一般的なブループリント アクタを作成しました。このスプラインは、レベルでシューティング アクタが移動するパスを作成するために使用されます。

8 - State Tree Evaluator を追加する

ここで、レベル内のすべてのスプライン アクタを検索し、State Tree に最も近いものを返す State Tree Evaluator を作成します。

  1. コンテンツ ブラウザ 内で右クリックし、[Create Basic Asset (基本アセットの作成)] セクションの [Blueprint Class (ブループリント クラス)] を選択します。

    1.[Pick Parent Class (親クラスを選択)] ウィンドウで [All Classes (すべてのクラス)] ドロップダウンを展開し、「StateTreeEvaluatorBlueprintBase」を検索して選択します。

    1.[Select (選択)] をクリックしてアセットを作成します。

    1.ブループリント クラスに「STE_GetSpline」という名前を付けます。

    Select Blueprint Class from the Create Basic Asset section In the Pick Parent Class window, expand the All Classes dropdown and search for and select StateTreeEvaluatorBlueprintBase Name the Blueprint class STE_GetSpline

  2. 「STE_GetSpline」を開き、[My Blueprint (マイ ブループリント)] パネルの [Functions (関数)] セクションに移動します。

    1.[Override] ドロップダウンをクリックし、[TreeStart] を選択します。

    Click the Override dropdown and select TreeStart

  3. Event TreeStart ノードからドラッグし、「Get All Actors of Class」を検索して選択します。

    1.[Actor Class (アクタのクラス)] ドロップダウンをクリックし、「BP_SplineActor」を選択します。

    Drag from the Event TreeStart node and search for and select Get All Actors of Class

  4. 新しい変数を作成し、「Actor」という名前を付けます。

    1.[Details] パネルに移動し、[Variable Type (変数の型)] を [Actor Object Reference (アクタ オブジェクト参照)] に設定します。

    1.[Category (カテゴリ)] ドロップダウンをクリックし、「Context」と入力します。

    Create a new variable and name it Actor Set the Variable Type to Actor Object Reference and click the Category dropdown and enter 'Context'

  5. Get All Actors from Class ノードの Out Actors ピンからドラッグし、Find Nearest Actor を検索して選択します。

    1.Actor 変数を [Event Graph] にドラッグし、[Get Actor (アクタをゲット)] を選択します。

    1.Actor ノードからドラッグし、Get Actor Location を検索して選択します。

    1.Get Actor Location ノードの Return Value (戻り値) を Find Nearest Actor ノードの Origin (原点) ピンに接続します。

    Drag from the Out Actors pin of the Get All Actors from Class node and search for and select Find Nearest Actor

  6. Find Nearest Actor ノードの Return Value ピンからドラッグし、「Cast to BP_SplineActor」を検索して選択します。

    1.Cast to BP_SplineActor ノードの As BP Spline Actor ピンを右クリックし、[Promote to Variable (変数へ昇格)] を選択します。

    1.この変数に SplineActor という名前を付け、その [Category] に「Output」と入力します。

    1.ブループリントを コンパイル して 保存 します。

    Drag from the Return Value pin of the Find Nearest Actor node and search for and select Cast to BP_SplineActor Name this variable to SplineActor and enter 'Output' for its Category

  7. 「ST_ShootingTarget」に戻り、[StateTree] ウィンドウの下で、Evaluators の横にある [プラス記号] をクリックします。

    1.ドロップダウンをクリックして [STE_GetSpline] を選択します。

    Click the dropdown and select STE_GetSpline

このセクションの結果

このセクションでは、State Tree の始動時に実行される State Tree Evaluator を作成しました。この Evaluator はレベル内のすべてのスプライン アクタをチェックし、シューティング アクタに最も近いものを返します。

9 - スプラインに沿って移動する State Tree タスクを追加する

このセクションでは、アクタを「BP_SplineActor」のスプラインに沿って移動させる新しい State Tree Task を作成します。

  1. コンテンツ ブラウザ で、右クリックして [Blueprint Class] を選択します。

    1.[Pick Parent Class (親クラスを選択)] ウィンドウで [All Classes (すべてのクラス)] ドロップダウンを展開し、「StateTreeTaskBlueprintBase」を検索して選択します。

    1.[Select (選択)] をクリックしてアセットを作成します。

    1.ブループリント クラスに「STT_MoveAlongSpline」という名前を付けます。

    Select Blueprint Class from the Create Basic Asset section In the Pick Parent Class window, expand the All Classes dropdown and search for and select StateTreeTaskBlueprintBase Name the Blueprint class STT_MoveAlongSpline

  2. 「STT_MoveAlongSpline」を開き、[My Blueprint (マイ ブループリント)] パネルの [Functions (関数)] セクションに移動します。[Override] ドロップダウンをクリックし、[Tick] を選択します。

    Click the Override dropdown and select Tick

  3. 新しい変数を作成し、「Actor」という名前を付けます。

    1.[Details] パネルに移動し、[Variable Type (変数の型)] を [Actor Object Reference (アクタ オブジェクト参照)] に設定します。

    1.[Category (カテゴリ)] ドロップダウンをクリックし、「Context」と入力します。

    Create a new variable and name it Actor Set the Variable Type to Actor Object Reference and click the Category dropdown and enter 'Context'

  4. 新しい変数を作成し、「SplineActor」という名前を付けます。

    1.[Details] パネルに移動し、[Variable Type (変数の型)] を [BP_SplineActor] に設定します。

    1.[Category (カテゴリ)] として「Input」と入力します。

    Create a new variable and name it SplineActor Set the Variable Type to B SplineActor and enter 'Input' as the Category

  5. Actor 変数を [Event Graph] にドラッグし、[Get Actor (アクタをゲット)] を選択します。

    1.Actor ノードからドラッグし、「Set Actor Location」を検索して選択します。

    1.Tick ノードを Set Actor Location ノードに接続します。

    Drag from the Actor node and search for and select Set Actor Location

  6. SplineActor を [Event Graph] にドラッグし、Get Spline Actor を選択します。

    1.SplineActor ノードからドラッグし、「Spline」を検索して選択します。

    1.Spline ノードからドラッグし、Get Location at Distance Along Spline を検索して選択します。

    1.Get Location の Return Value を Distance Along Spline ノードに接続し、さらにそれを Set Actor Location ノードの New Location ピンに接続します。

    1.Get Location at Distance Along Spline ノードの Distance (距離) ピンを右クリックし、[Promote to Variable] を選択します。

    Connect the Return Value of the Get Location at Distance Along Spline node and connect it to the New Location pin of the Set Actor Location node

  7. Set Actor Location ノードからドラッグし、「Branch」を検索して選択します。

    1.Distance 変数を [Event Graph] にドラッグし、[Get Distance] を選択します。

    1.Distance ノードからドラッグし、「Less」を検索して選択します。

    1.Less ノードを Branch ノードの Condition (条件) ピンに接続します。

    Connect the Less node to the Condition pin of the Branch node

  8. SplineActor を [Event Graph] にドラッグし、Get Spline Actor を選択します。

    1.SplineActor ノードからドラッグし、「Spline」を検索して選択します。

    1.Spline ノードからドラッグし、「Get Spline Length」を検索して選択します。

    1.Get Spline Length ノードからの Return Value を接続し、それを Less ノードの下のピンに接続します。

    Connect the Return Value from the Get Spline Length node and connect it to the lower pin of the Less node

  9. Distance 変数を [Event Graph] にドラッグし、[Get Distance] を選択します。

    1.Distance ノードからドラッグし、「Add」を検索して選択します。

    1.Float タイプの新しい変数を作成し、「MovementSpeed」という名前を付けます。

    1.MovementSpeed を Add ノードの下のピンに接続します。

    1.Distance 変数を [Event Graph] にドラッグし、[Set Distance] を選択します。

    1.Add ノードを Set Distance ノードに接続します。

    1.以下に示すように、Branch ノードの True ピンを Set Distance ノードに接続します。

    Connect the True pin of the Branch node to the Set Distance node, as seen below

  10. MovementSpeed 変数を選択し、[Default (デフォルト)] の値を「5.0」に設定します。

    Select the MovementSpeed variable and set its Default value to 5.0

  11. Distance 変数を [Event Graph] にドラッグし、[Set Distance] を選択します。

    1.Branch ノードの False ピンを Set Distance ノードに接続します。

    1.Set Distance ノードからドラッグし、Finish Task 関数を検索して選択します。

    Connect the False pin of the Branch node to the Set Distance node Connect both Set Distance nodes to the Return Node with a Return Value of Running

このセクションの結果

このセクションでは、スプライン アクタ ブループリントで作成されたスプライン パスに沿って、シューティング アクタ ブループリントを移動させる State Tree Task を作成します。

10 - State Tree を完成させる

  1. 「ST_ShootingTarget」に戻り、[+Add State (+ ステートを追加)] をクリックします。新しいステートに「MoveAlongSpline」という名前を付けます。

    1.MoveAlongSpline ステートをクリックして Idle ステートにドラッグし、親にします。

    Click and drag the MoveAlongSpline State into the Idle State to parent it

  2. [Details] パネルに移動し、[+] ボタンをクリックして新しい Task を追加します。

    1.ドロップダウン をクリックして「STT_MoveAlongSpline」を選択します。

    1.Spline Actor の横にある [Bind (バインド)] ドロップダウンをクリックし、[STE Get Spline] > [Spline Actor] を選択します。

    Click the dropdown and select STT_MoveAlongSpline Click the Bind dropdown next to Spline Actor and select STE Get Spline > Spline Actor The Spline Actor is now bound to the Spline Actor variable in STE Get Spline

  3. 「BP_SplineActor」をレベルにドラッグします。

    Drag B SplineActor to the Level

  4. 「BP_SplineActor」の Spline コンポーネントを選択します。Alt キーを押しながらドラッグ して、新しいスプライン ポイントを作成し、閉じた形状を作成します。

    1.Spline Actor ブループリントの Spline コンポーネントを選択し、[Spline (スプライン)] セクションまでスクロールします。[Closed Loop (クローズドループ)] チェックボックスを 有効 にして、スプラインを閉じた形状にします。

    Select the Spline component of BP_SplineActor. Alt-drag to create new spline points and create a closed shape Enable the Closed Loop checkbox to make the spline a closed shape

  5. [Play (プレイ)] を押して、ターゲットを撃ちます。

    Press Play and shoot at the target

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page