フォートナイトクリエイティブで Patchwork 値セッター仕掛けを使用する | Fortnite ドキュメンテーション

値セッター (V-SET) 仕掛けは、特定のゲームプレイの段階に到達したときに音楽の新しいセクションを有効にするなど、ゲームプレイのイベントが Patchwork システムを制御できるようにする接着剤のようなものです。

他の仕掛けから信号を受信したバリューセッターは、任意のPatchworkのパラメータに任意の値を設定します。

仕掛けのオプション

オプション	値	説明
1. 有効なスイッチ	オン、オフ	無効時には、音符のデータが生成されません。
2. ボタンを展開	施錠、開く	仕掛けを展開し、より多くのカスタマイズオプションを表示します。
3. 操作出力ケーブル	利用不可	操作出力ケーブルは、他の Patchwork 仕掛けのノブやカルーセル、トグルスイッチに接続する必要があります。
4. セットボタン	セット	1 つの動作だけを行うボタンであり、ノブで指定した値を即座に設定することができます。
5. ブレンド時間	0.0～16、デフォルト値は0	対象のコントロールの現在の値から新しい値にブレンドする時間を、ビート単位で決定します。このブレンドは、任意のディレイ時間が経過した後に開始します。
6. ディレイカルーセル	即時、次の拍、次の小節、次のフレーズ	対象に値を適用するまでに待機する時間を設定できます。
7. 値ノブ	0.0～1、デフォルト値は0	このノブ値が、この仕掛けの接続先のノブ、カルーセル、あるいはトグルに割り当てられます。

その他の仕掛けオプション

クリエイトモードで、仕掛けまで進み、E を押してカスタマイズパネルを開きます。一部の仕掛けオプションは、Patchworkツールで操作できるコントロールを反映しています。これらは、イベントバインディングのシステムを使用して、コントロールの動作を変更するトリガーとして使用できるようにするために存在しますが、ノブを使用する代わりに、ここで変更することもできます。 [Allow Cable Access (ケーブルアクセスを許可)] オプションは、[Customize (カスタマイズ)] パネルでのみ変更できます。

オプション	値	説明
Triggered by Player (プレイヤーがトリガー)	オフ、オン	プレイヤーの接近度に基づいてこの仕掛けを起動するかどうかを決定する。
ダメージで起動	オフ、オン	この仕掛けがダメージを受けた時に起動するかどうかを決定する。
パルストリガーによって起動	オフ、オン	パルストリガー、あるいはランダムナンバージェネレーターの仕掛けのパルスに触れられた時に、トリガーを起動するかどうかを決定します。
ケーブルでのアクセスを許可する	オフ、オン	Patchworkツールを使って、この仕掛けへのケーブル接続を変更できるかどうかを判断します。
フェーズ時に有効	なし、常時、ゲーム前のみ、ゲームプレイのみ	仕掛けが有効となるゲームフェーズを決定する。「ゲーム前のみ」にはゲーム開始前のすべてのフェーズが含まれます。

設定

バリューセッターを何に接続するのかによって、値のノブがカルーセルになったり、トグルになったりします。

VFX プレビュー

バリューセッターのビジュアルエフェクトによるプレビューは、新しい値が設定される瞬間を表示します。ディレイが設定されている場合、バリューセッターが起動された時にリングが表示され、値が設定されるまでの間、ディレイの長さに合わせてリングが縮小していきます。

ディレクトイベントバインディング

この仕掛けのディレクトイベントバインディングのオプションは以下の通りです。

機能

機能は仕掛けのイベントを聞き取り、アクションを実行します。

どの機能も、「オプション」をクリックして仕掛けを選択し、仕掛けのドロップダウンメニューから選択することでアクセス可能です。
仕掛けを選択したら「イベントを選択する」をクリックして、この機能を起動するイベントを選択します。
2つ以上の仕掛けやイベントを使って機能を起動したい場合、追加ボタンを押して行を追加し、上記の手順を繰り返してください。

オプション	説明
受信時に有効にする	イベントが発生すると仕掛けが有効になります。
受信時に無効にする	イベント発生時は仕掛けが無効になります。
受信時に値を設定	イベントの発生時、対象のコントロールに値を設定します。

イベント

ディレクトイベントバインディングは、「イベント」を送信機として使用します。イベントは、別の仕掛けに機能を実行するように伝えます。

どのイベントオプションにおいても、「オプション」をクリックして仕掛けを選択し、仕掛けのドロップダウンメニューから選択することでアクセス可能です。
仕掛けを選択したら、「機能を選択する」をクリックして仕掛けの機能にイベントを紐づけましょう。
イベントによって複数の機能がトリガーされる場合は、「追加」ボタンを押して手順を繰り返します。

オプション	説明
有効時にイベントを送信する	この仕掛けを有効にすると、選択した仕掛けにイベントが送信されます。
無効時にイベントを送信する	この仕掛けを無効にすると、選択された仕掛けにイベントが送信されます。
値設定時のイベント送信先	この仕掛けがターゲットコントロールの値を設定するたびに、選択された仕掛けにイベントを送信します。

Verse でバリューセッターを使用する

下記のコードを使えば、Verseでバリューセッターの仕掛けを制御することができます。このコードはバリューセッターの仕掛けのAPIにある全機能を使用しています。自分の作品に合わせて変更しましょう。

Verse

using { /Fortnite.com/Devices }

using { /Verse.org/Simulation }

using { /UnrealEngine.com/Temporary/Diagnostics }

# A Verse-authored creative device that can be placed in a level

value_setter_example := class(creative_device):

このコードを自分のUEFNの作品で使うには、以下の手順に従いましょう。

バリューセッターの仕掛けを自分の島までドラッグします。
value_setter_example という名前の新しい Verse 仕掛けを作成します。 Verseで新しい仕掛けを作る方法については、「Verseを使用して独自の仕掛けを作成する」を参照してください。
Verse Explorer を開き、value_setter_example.verse をダブルクリックして Visual Studio Code でスクリプトを開きます。
上記のコードをペーストしてコンパイルし、Verseで作成した仕掛けを自分の島までドラッグします。
アウトライナーで自分が作ったVerseの仕掛けを選択します。
仕掛けの[Details (詳細)] パネルで値セッターのオブジェクト参照を、島にある値セッター仕掛けに割り当てます。ピッカーを使用してビューポート内の仕掛けを選択するか、ドロップダウンを使用して仕掛けを検索することが可能です。
プロジェクトを保存し、「セッションを開始」をクリックします。