Unreal Engine 5
Unreal Engine 5 は Epic Games によって作成されたビデオゲームエンジンの最新バージョンでした。
この記事の内容は、元々 Unreal Engine wiki に書かれており、Arch Linux 用に特別に適応されました。
目次
- 1 必須条件
- 2 Clone
- 3 コンパイル
- 4 トラブルシューティング
- 4.1 コンパイルの問題
- 4.2 ランタイムの問題
- 4.3 C++ code project problems
- 4.4 Engine modules are out of date, and cannot be compiled while the engine is running. Please build through your IDE
- 4.5 Disable Tooltips
- 4.6 Random freeze under KDE
- 4.7 Slow rendered tooltips in KDE
- 4.8 Blank window in Blueprint with multi-monitor configuration
- 4.9 Error message about blocklisted drivers while using AMDVLK
- 5 Additional Content
必須条件
推奨ハードウェア を参照してください。
ソースコードへのアクセス権を取得
Unreal Engine のソースコードは、プライベートな GitHub リポジトリにあり、アクセスするために開発者（Epic Games）への 無料登録 が必要です。
アクセス権を取得するために、Epic Games アカウント でログインまたは登録し、Epic Games 'Connected Accounts Dashboard' ページの下部にアクセス可能な GitHub ユーザー名を提供してください。その後、プライベートな GitHub リポジトリへのアクセス権の招待が送られます。
Clone
特定のブランチだけをクローンする方が速いです。
$ git clone git@github.com:EpicGames/UnrealEngine.git --branch release --single-branch
コンパイル
ダウンロードした GitHub のリリースから手動でコンパイルするか、AUR からインストールすることができます。
手動
GitHub 上で ZIP として最新のリリースを取得できます。
セットアップ:
$ ./Setup.sh
プロジェクトファイルを生成:
$ ./GenerateProjectFiles.sh
その後、コンパイル:
$ make -j1
これにより、Unreal Engine と Unreal Editor がコンパイルされます。
AUR から
Unreal Engine 5 は、unreal-engineAUR パッケージとして AUR で利用可能です。最初の起動時にシェーダーを事前コンパイルするため、UE5 のパーミッションを修正する必要があるかもしれません：
# chmod -R a+rwX /opt/unreal-engine/Engine
このパッケージはインストール後（最初の起動時にシェーダーをコンパイルした後）約 70 ギガバイト (GiB) で、コンパイルするために約 120 GiB のスペースが必要で、圧縮時に ABS パッケージの出力が約 9 GiB になります。この AUR パッケージは、ソースファイル約 10 GiB と依存関係約 5 GiB をダウンロードします。
リポジトリはプライベートなため、set up an SSH key することで、ソースのダウンロードに GitHub アカウントが使用されます。
PKGBUILD のソースとして .zip リリースを使用すると、ダウンロードサイズが小さくなります。ただし、このリンクは、最初に 上記 で概説された手順に従ってからでないと機能しません。
コンパイル時間
コンパイルにかかる時間は、マシンの性能によって異なり、20 分から数時間かかる場合があります。 例として、AMD FX-8350（8 スレッド）、16GB DDR3、SSD、Clang 3.8.1 の環境では、約 40 分かかります。 （これには、シェーダーのコンパイル時間は含まれません）
トラブルシューティング
コンパイルの問題
コンパイルが失敗した場合、Debug プロファイルを使用してエディターをビルドしてみてください[1]：
$ make UE5Editor-Linux-Debug
ただし、これにはパフォーマンスに影響を与える可能性があります。
別のアプローチとして、異なる clang バージョン（例えば 3.8 または 4.0）を使用することができます。
ランタイムの問題
エディタがメニューから起動しない場合、または何かが正しく動作しない場合、コンソールで起動し、エラーのための出力を確認してください。
$ /opt/unreal-engine/Engine/Binaries/Linux/UnrealEditor
C++ code project problems
After creating a code project, the new project opens in a text editor instead of in Unreal Editor as it should. After re-launching the editor, the new project shows up and can be opened, but on the first run, it takes a half-hour or so to compile, and since this happens in the background (no GUI) it might not seem to be doing anything. The CPU usage should show that it is still compiling, and you may want to launch the editor from a console to see progress.
If while trying to open the project in UE for the first time, you get a message about editor modules being out of date, you need to build the UE5Editor target in your IDE. Do not abort this build, or you will brick the Unreal Editor and will need to reinstall unreal-engine. Afterward, it will open and ask you to rebuild the project class, after which you can actually start working on your new project.
Note that completing both of these rebuilds can very well take over an hour, depending on your system specs.
Engine modules are out of date, and cannot be compiled while the engine is running. Please build through your IDE
First, in your source folder in your project, check that {nameofproject}.Target.cs and {nameofproject}Editor.Target.cs has "DefaultBuildSettings = BuildSettingsVersion.V2;" in the section base(Target) { ... } If it does not work, check the file Engine/Source/Developer/DesktopPlatform/Private/DesktopPlatformBase.cpp in your Unreal Engine source code, look for the line `Arguments += " -Progress -NoEngineChanges -NoHotReloadFromIDE";` et remove the two last options : `Arguments += " -Progress";`
- Re-compile Unreal Engine - Launch your project and accept the rebuild
Disable Tooltips
UE4's mouse-over tooltips might be rendered very slow. They can be disabled by adding to:
Engine/Config/ConsoleVariables.ini
Slate.AllowToolTips=0
Random freeze under KDE
Disable index file content in the KDE file search options.
Slow rendered tooltips in KDE
Epic suggests allowing compositing for the Unreal Editor, which is stopped by default. Source: https://michaeljcole.github.io/wiki.unrealengine.com/Linux_Known_Issues/#KDE
Blank window in Blueprint with multi-monitor configuration
To fix the big blank window go to Edit Preferences > User interface > Enable Window Animation and activate the checkbox
Error message about blocklisted drivers while using AMDVLK
AMDVLK isn't officially supported by Unreal Engine, but this limitation can be circumvented (not recommended) by editing/removing the section for driver blocklisting:
Engine/Config/BaseHardware.ini
[GPU_AMD Linux]
Additional Content
Starter Content
The StarterContent project is installed to /opt/unreal-engine/Samples/StarterContent/StarterContent.uproject, you can browse to it from the launcher.
Marketplace Apps
The launcher with the Unreal Marketplace is not available for Linux yet[2], so apps like the ContentExamples project cannot be installed from Linux[3].
The marketplace apps can be downloaded using the launcher on Windows (or Mac), they are stored in /Program Files (x86)/Epic Games/Launcher/VaultCache/.
There are several options to download Marketplace content natively:
- use lutris and the Epic Games Store installer, with disabled sandbox you can add content directly into your projects
- use Epic Asset Manager from flathub or eam-gitAUR which lets you download the assets to the vault
- there is an implementation of UE4 Marketplace Downloader written in JS.