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

Lyra Starter Game は Unreal Engine (UE) のメジャーリリースごとに更新されています。これらの更新はエンジンの最新機能を活用するもので、Lyra に特有の問題が解決されます。このページでは、各エンジンバージョンでの Lyra に対する主要な変更について説明し、既存のゲームで Unreal Engine の最新リリースの機能を活用できるようにアップグレードするための情報を紹介します。

Unreal Engine 5.3

Unreal Engine 5.3 では、Lyra サンプルゲームのサポートに引き続き、対応しています。エンジンに追加された最新機能や修正を活用するようになりました。

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

一部のオブジェクトポインタ変数は、TObjectPtr を使用するように変更されました。
安全でない使用方法についての警告を修正するように、複数の C++ ラムダが更新されました。
不要なパスを削除するように一部のヘッダインクルードが更新されました。

5.3 の改善点：

Lyra に実験的機能であるクライアントリプレイサポートが含まれるようになりました。それらがサポートされるプラットフォームでは、リプレイの保存を設定メニューで有効にしてから、メインメニューで再生できます。保存されたリプレイは、現時点では一部のビジュアルエフェクトおよびサウンドエフェクトでは利用できません。一部のプラットフォームでは、クライアントリプレイサポートがサポートされていない場合があります。
共有ゲームプレイ設定は、新しいエンジンの LocalPlayerSaveGame クラスから継承されるようになり、プラットフォームのログインが正常に完了するまでロードされないようになりました。
ゲーム機能 ShooterExplorer プラグインに、オープンワールドおよび AI システムをテストする一部の現在進行中の実験的コンテンツが含まれるようになりました。
Lyra 固有の入力設定が、拡張入力の改善を処理するように更新されました。

5.3 のバグ修正：

ゲームプレイアビリティ、およびマップ内に直接配置される NPC キャラクターのカスタマイズ済みキャラクターパーツの問題を修正しました。
SyncMarker、FootFX、および FootstepEffectTag アニメーションモディファイアが更新されました。
タッチベースのジョイスティックが非表示中に入力に影響するバグを修正しました。
リプレイテスト中に発見された複数のネットワーキングのバグを修正しました。
LyraHealthComponent でのヘルス変更コールバックに発信者が含まれるようになりました (利用可能な場合)。

Unreal Engine 5.2

Unreal Engine 5.2 では、Lyra サンプルゲームのサポートに引き続き、対応しています。エンジンに追加された最新機能や修正を活用するようになりました。

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

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

5.2 の改善点

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

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

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 の初期ステートシステムを使用するように、LyraHeroComponent と LyraPawnExtensionComponent 内のポーン初期化フローが書き換えられました。これによってネットワークレプリケーションにおけるいくつかの競合状態が修正されて、新しい機能特有のコンポーネントに合わせて拡張しやすくなります。
さまざまな機能を備えたデバイスに向けて 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 のバグ修正

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

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