【UEFN】Verseの始め方と基本操作｜VScodeの使い方

画面左上の「Verse」→「Verse Explorer」にチェックを入れるとタブが表示される。

「Verse Explorer」タブから自身のプロジェクト名の書かれた親ファイルを選択し右クリック →「Add new Verse file to project」をクリック

「Verse Device」テンプレートを選択。Device Nameを設定して「作成」ボタンを押す。

例：「Test_device」

「Verse Explorer」タブに新しく作成した「Test_device.verse」のようなファイルが追加されているはずです。ダブルクリックして展開しましょう。

#（ハッシュタグ）を先頭に付けるとメモが書ける

#（ハッシュタグ）を先頭に付けるとコードに影響しないメモを書くことができます。初期テンプレートの状態でも、公式が説明書きをメモしてくれていますよね。メモなので不要であれば消して構いません。

コードの冒頭で、使いたい機能の種類をあらかじめ宣言してあげる必要があります。デフォルトでは下記の３種類が書かれています。

using { /Fortnite.com/Device }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

例えば、一番上のDeviceの部分で「Deviceの機能を使うよ」と前もって宣言することで、はじめてDevice（仕掛け）の要素をVerse内でいじることができるわけですね。

要するに、ここから先のコードは新しい仕掛け(Device)を作るためのものです。フォートナイトに標準で用意されている仕掛けとは別に、自分でオリジナルの仕掛けを作ることができるわけですね。

Test_device := class(creative_device):
    OnBegin<override>()<suspends>:void=
        Print("Hello, world!")
        Print("2 + 2 = {2 + 2}")

デフォルトではこのようなコードが書かれていると思います。私の場合は「Test_device」という名前の新しい仕掛け(Device)を作ろうとしているわけです。

また、その中身としては「OnBegin（開始時）」というコードの下を見ていくことで分かります。現状 Print関数が動作して、テキスト情報が出力されるだけのシンプルな機能になっています。

今回はデフォルトの状態のまま、次のステップへ進みゲーム内で動作を確認していきます。

VScodeでコードを書き終わったらUEFNに戻ってきて「Verse」→「Verseコードをビルド」をクリックします。そうすると変更が反映され、エラーがなければVerseのマークに緑色のチェックマークが付きます。

※問題がある場合は、赤色の警告マークが出るのでコードを修正する必要があります。

Verseで自作した仕掛け(Device)もフォートナイト標準のデバイスと同じように、レベル内に配置して使うことができます。

コンテンツドロワーから、自身のプロジェクト名が書かれたフォルダの中を確認してみましょう。すると新しく「Test_device (Verseクラス)」というようなデータが追加されていると思います。

早速、ドラッグ＆ドロップしてレベル内に配置してみましょう。コンピューターのような見た目をしています。これが自作の仕掛けです。

「詳細タブ」→「ユーザーオプション」→「Visible in Game」のチェックを外します。チェックを入れたままの状態だとゲーム中に見えてしまうので、外して見た目を非表示にした方がよいでしょう。

※「Enable At Game Start」はゲーム開始時に有効化する項目です。オンのまま使っていきます。

「セッションを開始」ボタンを押してテストプレイしてみましょう。

ゲームを起動すると画面左上に一瞬メッセージが表示されます。

早すぎて見逃した方は「M」キーを押して「ログ」の項目を確認してみましょう。すると過去の動作履歴を確認することができます。

Hello, world!
2 + 2 = 4

というような内容が書かれていると思います。これがPrint関数の機能です。しっかりと動作していますね。

例：Print

検索内容がヒットしたら「Enter」キーを押すことで順番に見ていくことができます。

そうするとコンテンツブラウザのどこにアセットが格納されているのかを辿ることができます。

今度は、コンテンツブラウザ内で対象のデバイスを選択し右クリック →「Visual Studio Codeで定義を開く」を選択しましょう。

例えば「Creature Spawner」のデバイスを右クリックし「Visual Studio Codeで定義を開く」をクリックしてみます。

そうするとVScode側で「Fortnite.digest.verse」ファイルが自動で開き「creature_spawner_device」の項目に飛ぶことができます。

@editable
Test_creature_spawner : creature_spawner_device = creature_spawner_device{}

上記のコードを追加しました。

Verse上でDeviseを使用するには、まず何のDeviceを使うのか宣言する必要があります。それが「@editable」の役割です。

Test_creature_spawner の部分は、自分が好きに付けていい名前の部分です。

また、Verse上で各種デバイスを使用する際には、以下のような書き方でデバイスのクローンを作るような工程が必要です。

creature_spawner_device = creature_spawner_device{}

「Verse」タブ →「Verseコードをビルド」を押します。

コードを反映させたら、自作した「Test_device」を選択して詳細タブを確認しましょう。

すると「Test_creature_spawner」という項目が新しく表示されていることが確認できます。ここでVerseとの連携作業ができます。

スポイトマークを押して、レベル上にある「Creature Spawner」を１つ選択しましょう。

これでVerseとの連携作業が完了しました。連携が完了したCreature SpawnerはVerseで自由に動かすことができます。

２種類目のDeviceを使用したい場合は、どうすればいいでしょうか？

まずは定義を調べるところから行っていきます。次はコンテンツブラウザで「Creature Placer」のデバイスを右クリックし「Visual Studio Codeで定義を開く」をクリックしてみます。

そうするとVScode側で「Fortnite.digest.verse」ファイルが自動で開き「creature_placer_device」の項目に飛ぶことができます。

@editable
Test_creature_placer : creature_placer_device = creature_placer_device{}

上記のコードを追加しました。

２つ目のデバイスを追加するときも、このように同じ手順を繰り返せばよいのですね。

「Verse」タブ →「Verseコードをビルド」を押します。

コードを反映させたら、自作した「Test_device」を選択して詳細タブを確認しましょう。

すると「Test_creature_placer」という項目が新しく表示されていることが確認できます。

スポイトマークを押して、レベル上にある「Creature Placer」を１つ選択しましょう。

これで2種類目のデバイスも、Verseとの連携作業が完了しました。