移動する目標マーカー

目標マーカーは、多くのゲームでプレイヤーを次の目標や注視点にガイドするために使用されます。 このチュートリアルでは、マップ インジケーターの仕掛けと Verse を使用して、再利用可能な目標マーカーを作成する方法について説明します。

使用する Verse 言語機能

• 構造体：構造体内のさまざまな型の変数をグループ化できます。

• 拡張メソッド：特別なタイプの関数で、既存のクラスまたは型のメンバーのように機能しますが、新しい型またはサブクラスを必要としません。 このガイドでは、構造体の拡張メソッドを作成します。

• 名前付き引数：パラメータ名を指定して関数呼び出しにパスされる引数です。

使用する Verse API

• creative_prop API：creative_prop API は、小道具を動かすための手段を提供します。

• 編集可能なプロパティ：迅速にテストするため、仕掛けの参照と変数値の更新の両方に複数のプロパティを使用します。

手順

次の手順に従って、複数の目標や注視点に移動できる、単一の目標マーカーの仕掛けの設定方法を確認します。 完全なスクリプトは、参照用としてこのガイドの末尾に記載されています。

レベルを設定する

この例では、次の小道具と仕掛けを使用しています。

• 建築小道具 × 1：マップ インジケーターの仕掛けを移動するために使用される小道具です。

• マップ インジケーターの仕掛け × 1：ミニマップおよび概要マップにカスタム仕様のマーカーを表示する仕掛けです。

• プレイヤー スポーン パッドの仕掛け × 1：これを小道具の近くに追加することで、近くでプレイヤーがスポーンします。

Prop API を使用する

Verse を使用して仕掛けを移動するための最初のステップは、Prop API を使用して小道具を移動することです。 以下の手順に従って、レベルで小道具を移動します。

1. objective_coordinator_device という新しい Verse の仕掛けを作成します。

2. Verse ファイルの一番上のデフォルトの using 式の下に、SpatialMath モジュールの using 式を追加します。 このモジュールには小道具を動かすために参照するコードが含まれます。

   Verse

        using { /UnrealEngine.com/Temporary/SpatialMath }
   

   Copy full snippet(1 line long)

3. 2 つの編集可能なプロパティを追加します。

   • 動く小道具への参照を格納する RootProp という名前の creative_prop の定数。

   • 小道具の移動先の場所を格納する Destination という名前の transform の定数。

     Verse

       objective_coordinator_device<public> := class<concrete>(creative_device):
     
           @editable
           RootProp<public> : creative_prop = creative_prop{}
     
           @editable
           Destination<public> : transform = transform{}

     Copy full snippet(7 lines long)

4. このコードを実行し、objective_coordinator_device をレベル内にドラッグすると、2 つのプロパティが [Details (詳細)] パネルに表示されます。

5. 小道具を実際に移動させるのは TeleportTo[] メソッドです。 TeleportTo[] は失敗する可能性がある式であるため、それを if 式 内で呼び出して、丸括弧ではなく角括弧を使用します。 if は、失敗コンテキストを作成します。

   Verse

        if(RootProp.TeleportTo[Destination.Translation, Destination.Rotation]):
            Print("Prop move successful")
        else:
            Print("Prop move failed")
   

   Copy full snippet(4 lines long)

6. TeleportTo[] の引数は、Translation および Rotation です。 これらはどちらも Destination プロパティに由来するものです。

7. エディタに戻り、コンテンツ ブラウザで [Fortnite (フォートナイト)] > [Galleries (ギャラリー)] > [Props (小道具)] から小道具をドラッグします。 このガイドで使用しているのは Coastal Buoy 02B という名前のものですが、「Props」フォルダのものであればどれでも構いません。

8. [Outliner (アウトライナー)] で目標コーディネーターの仕掛けを選択します。 [Details (詳細)] パネルで、小道具に RootProp を設定します。 この例では、RootProp は Coastal Buoy 02B に設定されています。

   

9. [Details] パネルで、[Destination (目的地)] を展開します。 [Destination] は、transform 型であるため、[Scale (スケール)]、[Rotation (向き)]、および [Translation (トランスレーション)] で構成されます。 [Translation] を変更するだけでこの小道具を移動できるため、これを展開します。 X が 5000.0 で終了するようにフィールドを設定します。

   

   コードのテスト時は、効果をわかりやすくするため、値を大きく変更すると良いでしょう。 小さい変更では、コードが期待する処理を行っているか判断するのが難しくなります。

   Verse

    using { /Verse.org/Simulation }
    using { /Fortnite.com/Devices }
    using { /UnrealEngine.com/Temporary/SpatialMath }
   
    objective_coordinator_device<public> := class<concrete>(creative_device):
   
        @editable
        RootProp<public> : creative_prop = creative_prop{}
   
        # Where the marker will be moved to
   
   Expand code Copy full snippet(19 lines long)

10. [Verse] をクリックして [Build Verse Code (Verse コードをビルド)] を選択し、[Launch Session (セッションを起動)] をクリックします。 最後に、[Start Game (ゲームを開始)] をクリックします。 小道具が移動するのを確認できるはずです。

親と構造体

これで、小道具はレベル内で移動するようになりましたが、本当の目標はマップ インジケーターの仕掛けを移動してプレイヤーがウェイポイントとして使用できるようにすることです。 以下の手順に従って、建築小道具およびマップ インジケーターの仕掛けをレベルに追加し、その仕掛けを建築小道具にアタッチします。

1. コンテンツ ブラウザ内を右クリックしてコンテキスト メニューを開きます。

2. コンテキスト メニューから [Blueprint Class (ブループリント クラス)] を選択します。

   

3. [Pick Parent Class (親クラスを選択)] ウィンドウで、[Building Prop (建築小道具)] をクリックします。

   

4. コンテンツ ブラウザに新しいブループリント クラスが表示されます。 その名前を「BuildingProp」に変更します。

   

5. 建築小道具をレベル内にドラッグします。 この小道具にはメッシュがないため、トランスフォーム ギズモのみが表示されます。

   

6. アウトライナー内で Map Indicator Device (マップ インジケーターの仕掛け) を BuildingProp にドラッグします。 これにより、BuildingProp が Map Indicator Device の親になります。 これで、BuildingProp が移動すると、Map Indicator Device も一緒に移動するようになりました。

   

Verse を使用して仕掛けを作成する方法については説明しましたが、独自の仕掛けを持たない Verse ファイルを作成することもできます。

1. 新しい Verse ファイルを作成し、名前を「objective_marker」とします。 このファイルは仕掛けを作成しません。 代わりに、前に作成した Verse の仕掛けに公開される struct の定義を含んでいます。

2. まず、objective_marker という struct を宣言します。 これには、RootProp と MapIndicator という 2 つのメンバーがあります。 これらの両方に @editable 指定子が必要です。

   Verse

        objective_marker<public> := struct<concrete>:
   
        @editable
        RootProp<public> : creative_prop = creative_prop{}
   
        @editable
        MapIndicator<public> : map_indicator_device = map_indicator_device{}

   Copy full snippet(7 lines long)

拡張メソッドと名前付き引数

単一のメソッドである MoveMarker を宣言します。これは、RootProp メンバーとそれにアタッチされたマップ インジケーターの仕掛けを移動します。 このメソッドは、拡張メソッドと名前付き引数という 2 つの言語の機能を導入します。

(Marker : objective_marker).MoveMarker<public>(Transform : transform, ?OverTime : float)<suspends> : void =

• 拡張メソッド：MoveMarker() メソッドを objective_marker 構造体に追加します。 拡張メソッドでは識別子と型をコロンで区切り、それらを括弧で囲んで宣言します。 この場合であれば、(Marker : objective_marker) となります。

• 名前付き引数：2 番目の引数 ?OverTime は、? を使用することで MoveMarker 関数呼び出しで名前を指定する必要があることを示します。 これにより、MoveMarker への呼び出しを参照したり記述したりするデベロッパーにとって、float 引数が行う処理が理解しやすくなります。

MoveMarker() は、先ほど使用した TeleportTo[] または MoveTo() のいずれかのメソッドを Prop API から呼び出します。 if..else ブロックを作成し、パラメータ OverTime が 0.0 より大きいかをテストします。 大きい場合は、MoveTo() を呼び出します。 これにより、すぐにテレポートするのではなく、指定した期間の経過後に目標が次の場所に移動します。

(Marker : objective_marker).MoveMarker<public>(Transform : transform, ?OverTime : float)<suspends> : void =

 if (OverTime > 0.0):
        Marker.RootProp.MoveTo(Transform.Translation, Transform.Rotation, OverTime)
    else:
        if:
            Marker.RootProp.TeleportTo[Transform.Translation, Transform.Rotation]

このコードを現時点でコンパイルすると成功はしますが、コンテンツ ブラウザ内の「CreativeDevices」フォルダには新しい仕掛けが表示されません。 これは、objective_marker が struct であり、creative_device から継承されたクラスではないためです。

目標コーディネーターの仕掛けを更新する

新しいタイプの参照ができたため、今度は objective_coordinator_device を参照するように更新する必要があります。

1. RootProp プロパティを削除し、型が objective_marker の PickupMarker というプロパティで置き換えます。 これは、自分で作成した型です。

2. MoveMarker() には float 型の引数が必要であるため、これを MoveTime という名前の編集可能なプロパティとして作成します。

3. TeleportTo[] への呼び出しを削除します。 代わりに、objective_marker のために作成した MoveMarker() メソッドを呼び出します。 これには、名前付き引数である ?OverTime が必要です。

   Verse

        objective_coordinator_device<public> := class<concrete>(creative_device):
   
            @editable
            PickupMarker<public> : objective_marker = objective_marker{}
   
            # Where the marker will be moved to
            @editable
            Destination<public> : transform = transform{}
   
            # How much time the marker should take to reach its new location
   
   Expand code Copy full snippet(16 lines long)

このコードをコンパイルし、目標コーディネーターの仕掛けの詳細を確認します。 PickupMarker プロパティおよび MoveTime プロパティが表示されます。また、PickupMarker には RootProp および MapIndicator が含まれています。

1. [RootProp] フィールドを BuildingProp に、[MapIndicator] フィールドを Map Indicator Device に設定します。

   

2. コードをコンパイルし、[Launch Session] をクリックします。 ゲームが開始すると、少ししてからミニマップにマーカーが表示されます。 MoveTime にさまざまな値 (0.0 も含む) を設定してこのマーカーを試してみましょう。 さまざまなシナリオで、どのような動きが最適かを検討してください。

GetPlayers() と ActivateObjectivePulse()

プレイヤーが次の目標にたどり着けるように、手助けできる手段が用意されています。 これは目標パルスと呼ばれ、これが有効なときはプレイヤーからマップ インジケーターの仕掛けに向かって破線が表示されます。 以下の手順に従って、目標パルスを目標コーディネーターの仕掛けに追加します。

目標パルスを有効にするために必要なメソッドは ActivateObjectivePulse() で、これには agent 型の引数が 1 つ必要です。 まず、プレイヤーのキャラクターを表す agent のインスタンスを取得するメソッドの作成から始めましょう。

1. FindPlayer() という関数を <private> に設定して宣言し、戻り値は void にします。

2. Self.GetPlayspace().GetPlayers() を使用し、レベル内のすべてのプレイヤーの配列を取得します。 AllPlayers という変数にこの配列を格納します。

   Verse

        FindPlayer<private>() : void =
   
            AllPlayers := Self.GetPlayspace().GetPlayers()

   Copy full snippet(3 lines long)

3. レベル内のプレイヤーが 1 人のみの場合にその参照を取得するには、最初の配列要素を独自の変数に割り当てます。 配列へのアクセスは失敗する可能性がある式であるため、if 式の中に配置します。

   Verse

        if (FirstPlayer := AllPlayers[0]):
   

   Copy full snippet(1 line long)

4. 変数への player の割り当ては失敗する可能性があるため、コード内でプレイヤーを参照する際には、オプション型の変数を使用することもできます。 任意のプレイヤー変数 ?player を宣言します。 他のメンバー変数とともに使用する必要があります。

   Verse

        objective_coordinator_device<public> := class<concrete>(creative_device):
   
        var PlayerOpt<private> : ?player = false
   
        @editable
        PickupMarker<public> : objective_marker = objective_marker{}
   
        # Where the marker will be moved to
        @editable
        Destination<public> : transform = transform{}
   
   Expand code Copy full snippet(14 lines long)

5. 新しい変数を設定し、Print() 式を使用して else ブロックを作成し、プレイヤーが見つからない場合には通知を表示するようにします。 これで、FindPlayer() 関数が完成しました。

   Verse

        FindPlayer<private>() : void =
   
            # Since this is a single player experience, the first player [0]
            # should be the only one available.
   
            AllPlayers := Self.GetPlayspace().GetPlayers()
   
            if (FirstPlayer := AllPlayers[0]):
                set PlayerOpt = option{FirstPlayer}
                Print("Player found")
   
   Expand code Copy full snippet(13 lines long)

OnBegin() 関数に戻り、次の 2 つの変更を加える必要があります。

1. FindPlayer() 関数を呼び出します。

   Verse

        OnBegin<override>()<suspends> : void =
   
            FindPlayer()

   Copy full snippet(3 lines long)

2. MoveMarker() の呼び出し後、別の if 式を使用してオプションのプレイヤーの変数を新しい変数に設定し、それを PickupMarker.MapIndicator.ActivateObjectivePulse() の引数として渡します。

   Verse

        if (FoundPlayer := PlayerOpt?):
            PickupMarker.MapIndicator.ActivateObjectivePulse(FoundPlayer)
   

   Copy full snippet(2 lines long)

これでコードを実行すると、キャラクターからレベル内の目標マーカーの位置を指す目標パルスが表示されます。

完全なスクリプト

Objective_marker.verse

using { /Verse.org/Simulation }
using { /Fortnite.com/Devices }
using { /UnrealEngine.com/Temporary/SpatialMath }
using { /Fortnite.com/Devices/CreativeAnimation }

objective_marker<public> := struct<concrete>:

    # The prop that will be moved
    @editable
    RootProp<public> : creative_prop = creative_prop{}

Objective_coordinator_device.verse

using { /Verse.org/Simulation }
using { /Fortnite.com/Devices }
using { /Fortnite.com/Playspaces }
using { /UnrealEngine.com/Temporary/SpatialMath }

objective_coordinator_device<public> := class<concrete>(creative_device):

    var PlayerOpt<private> : ?player = false

    @editable

応用編

ここで記述した移動のコードはどの小道具に対しても有効です。 移動可能な小道具を仕掛けの親として作成すれば、その仕掛けは小道具とともに移動します。 他の小道具や仕掛けも移動させてみましょう。また、これらを利用したゲームが考えられないか検討しましょう。

次のステップ

このガイドに沿って集荷/配達ゲームを開発している場合は、次のステップとしてカウントダウン タイマー機能の作成方法を学習しましょう。