Lyra Starter Game を Unreal Engine の最新エンジンリリースにアップグレードする | Unreal Engine 5.2 ドキュメンテーション

Lyra Starter Game は Unreal Engine のメジャーリリースごとに更新されています。これらの更新はエンジンの最新機能を活用するもので、Lyra に特有の他の問題も解決されます。このページでは、それぞれのエンジンバージョンで Lyra に加えられた主要な変更について説明し、既存のゲームを Unreal Engine 5 の最新リリースにアップグレードする際に役立つ情報を紹介します。

Unreal Engine 5.2

Unreal Engine 5.2 では、Lyra サンプルゲームは引き続きサポートされています。エンジンに追加された新機能とバグ修正の利点を活かしています。

5.2 のアップグレードノート

コンパイル時間を向上させるために、エンジンヘッダが再編成されました。この改善により、Lyra のヘッダが欠如しているケースが明らかになりました。たとえば、CommonUserSubsystem.h は、OnlineError.h を含むように変更しなければなりませんでした。
Lyra 5.1 バージョンは、Iris ネットワークシステムをオプションでサポートしていましたが、これは現在デフォルトでエンジンにコンパイルされています。以前のバージョンの Lyra を 5.2 でコンパイルすると、ネットワークのリンカーエラーが発生しますが、これは LyraGame.build.cs に "SetupIrisSupport(Target);" を加えて修正することができます。

5.2 の改善点

LyraGame ゲームプレイタグは LyraGameplayTags` 名前空間内にあるタグを使用するように変更されました。これにより、オブジェクトを初期化する際に、これらのタグの使用が可能になりました。
試合終了時のマップ転送 (または PlayNextGame コンソールコマンドのチート使用時) がシームレスな移動を使用するようになりました。
Lyra がローカルマルチプレイヤーを実験的にサポートするようになりました。ローカルマルチプレイヤーを有効にするには、2 番目に接続した同じタイプのコントローラのスタートボタンを押すか、メインメニューの [Add Player] ボタンをクリックします
専用サーバーのサポートが改善されました。パッケージ化された LyraServer またはエディタゲームを -server コマンドで実行すると、ALyraGameMode::TryDedicatedServerLogin のコードを使用してデフォルトマップのホストが開始されます。
Replication Graph、Iris、パケット暗号化のネットワークサポートを追加しました。このオプションはデフォルトではオフになっています。
トリガー抵抗やコントローラーの色など、入力デバイスのプロパティが含まれるようにハプティックフィードバックを変更しました (一部のプラットフォーム)。

コントローラーの色は、チームカラー (赤または青) と一致します。 武器のインスタンスは、装備時にデバイスプロパティを追加することができます。たとえば、ショットガンが装備されている間、PlayStation DualSense コントローラのトリガー抵抗が重くなります。
Lyra をパッケージ化すると、複数の .pak ファイルが作成されるようになりました。これは、ゲーム機能プラグイン内のプライマリアセットラベルを使用して設定されます。

5.2 のバグ修正

シームレスな移動とローカルマルチプレイをサポートしながら、ネットワークと UI に関する多くの問題が修正されました。
キャラクター移動におけるアニメーションのスタッタが修正されました。これはもともと 5.1.1 で修正されました。
LyraClient のビルドターゲットに関するいくつかの問題を修正しました。専用サーバーに参加できるようになりました。
ビルドスクリプトのデフォルトのゲームターゲットが LyraGame になるように修正しました。
バージョン管理の状態が不明なアセットに関する警告 EditorValidator_SourceControl の頻度を減らしました。

Unreal Engine 5.1

Unreal Engine 5.1 では、Lyra Sample Game のいくつかの問題を修正して、エンジンに加えられた最新機能を活用できるように Lyra Sample Game が更新されました。

5.1 のアップグレードノート：

コンパイル時間を向上させるために、いくつかのエンジンヘッダが再編成されました。これにより、Lyra ソースファイルに関するいくつかのエラーが新たに生じました。これらの問題は、不足しているヘッダに #pragma once 行を追加し、型の不足に関するエラーがあるソースファイルに #include EditorStyle.h などの行を追加することで修正できます。
ゲームプレイフレームワーククラスのいくつかの生ポインタプロパティが TObjectPtr または TWeakObjectPtr を使用するように変更されました。生ポインタを必要とするコードは、Get() 関数への呼び出しを追加することで修正できます。
ENSURE_ABILITY_IS_INSTANTIATED_OR_RETURN マクロが「GameplayAbility.h」から削除されました。このマクロは、「GameplayAbility.cpp」から別のアビリティソースコードファイルにコピーできます。
ゲーム機能プラグインに関連するいくつかのバーチャル関数が変更されて、新しいパラメータが追加されました。ULyraGameFeaturePolicy など、クラス内のオーバーライドされた関数は更新する必要があります。
ジオメトリメッシュブループリント Tools/BakedGeneratedMeshSystem/BaseClasses/BakedGeneratedMeshActor が 5.1 に更新されました。5.0 アセットも引き続き機能しますが、5.1 バージョンを使用しないと Nanite を適切に設定できなくなります。

5.1 の改善点：

新しい IGameFrameworkInitStateInterface と GameFrameworkComponentManager の初期ステートシステムを使用するように、ULyraHeroComponent と ULyraPawnExtensionComponent 内のポーン初期化フローが書き換えられました。これによってネットワークレプリケーションにおけるいくつかの競合状態が修正されて、新しい機能特有のコンポーネントに合わせて拡張しやすくなります。
さまざまな機能を備えたデバイスに向けて Android デバイスプロファイルを追加し、他のプラットフォーム設定も調整しました。
共通マップのロードに関する UI をエディタのツールバーに追加しました。
Epic Online Services を使ったマルチプレイヤーゲームへの招待のための基礎処理を追加しました。
新しい ShooterExplorer プラグインと ShooterTest プラグインに、プロトタイプとテストコンテンツを追加しました。
割り当て済みのキーをバインディングしようとした際に警告画面が表示されるように、キー割り当ての画面を改善しました。

5.1 のバグ修正

「LyraGame.Target.cs」に含まれる ShouldEnableAllGameFeaturePlugins 関数が false を返すように変更されたため、ゲーム機能プラグインを通常のプラグインと同様に有効にできるようになりました。これによってプラグインが修正されて、エンジンのカスタムコンパイルバージョンとランチャーインストールバージョンの両方で同じように機能するようになります。
Lyra を実行することで他のプロジェクトの既存のプレイインエディタ (PIE) のキー割り当てが変更される問題を修正しました。
ヘルス値に負のモディファイアを適用するのではなく、回復とダメージの属性を適切に使用するよう各機能を変更しました。
非推奨のコントローラー ID の代わりに、新しい PlatformUser 型と InputDeviceId 型を使用するようにコードとブループリントを更新しました。

Unreal Engine 5.0

Lyra Sample Game の 5.0 バージョンは 5.0.2 とともに更新されて、元のリリースに含まれていたいくつかのバグが修正されました。これらの修正は、それ以降のすべてのサンプルのリリースに含まれています。

5.0.2 のバグ修正

さまざまなインストールディレクトリを処理できるよう自動化スクリプトを修正しました。
逆のマウス設定を修正しました。
マネキンリターゲティングアセットとコントロールリグアセットを更新しました。
モバイルデバイスプロファイルのアンチエイリアス設定を更新しました。
不足していたエディタアイコンを追加しました。

最新エンジン リリースにアップグレードする