初めに

この記事では、UE4でLinux用のパッケージ化できる状態から、Linux DedicatedServerをWSLを用いてLocalで起動して、Windows Clientアプリで接続するまでについて説明します。

クラウドや実際にホスティングをする前に、手元でデバックや挙動を確かめておきたいことがよくあると思います。ここでは、Windows上で、簡単にLinuxのサブシステムを動かすことができるWSLを用いて、サーバーでの挙動の確認を行っていきます。

前提

ソースからUE4のビルドができている。

Linux用のパッケージ化がEditorからできるようになっている。

開発環境

Windows 10
Visual Studio IDE / 2019
Unreal Engine / 4.27.2 Built From Source Code
Toolchain -v19 clang-11.0.1-based
プロジェクトファイルは、C++を使用したプロジェクトを想定しています。
WSL2の有効化 (以下の記事などを参考に利用できるようにしておきます)
- https://bsblog.casareal.co.jp/archives/5361
- https://qiita.com/matarillo/items/98d7452967987fe5d633

Setup

まず初めに、パッケージ化したいプロジェクトファイルのDefaultEngine.iniファイルに、Linuxのターゲット設定を追記します。

[/Script/LinuxTargetPlatform.LinuxTargetSettings]
TargetArchitecture=X86_64UnknownLinuxGnu

(この追加作業は、現場のUE4.27では必要ないかもしれません。)

DefaultEngine.iniファイルは、[ProjectRoot]/Config/DefaultEngine.iniにあります。

さらに、[ProjectRoot]/SourceにServerとClientのターゲットファイルを追加します。

例えば、Server用のターゲットファイルには、

using UnrealBuildTool;
using System.Collections.Generic;

public class LinuxSampleServerTarget : TargetRules
{
	public LinuxSampleServerTarget(TargetInfo Target) : base(Target)
	{
		Type = TargetType.Server;
		DefaultBuildSettings = BuildSettingsVersion.V2;
		ExtraModuleNames.Add("LinuxSample");
	}
}

のように、プロジェクトファイル生成時に生成されるLinuxSmapleEditorファイルをコピーした内容から、Editor部分をServerやClientという文字列に置き換えたファイルを追加します。この設定を行い、再度プロジェクトファイルを右クリックから、Generate Visual Studio project filesをすると、

パッケージする設定から、どのビルドターゲットにするかを選択できるようになります。

Build

ここまでの設定が完了したら、プロジェクトファイルを開き、Package ProjectからBuild ConfigurationをDevelopmentに、先ほどのBuild TargetをServerにした状態で、Linuxのビルドを行います。

今回は、パッケージ化したファイルをプロジェクトフォルダー内のPackagesフォルダーに保存します。例えば、以下のようにプロジェクトファイル名 + Serverというファイルが、以下のパスにあることが確認できるともいます。

この作業は、VSからも以下のようにターゲットをServer、プラットフォームをLinuxに設定してビルドすることでも必要なファイルを手に入れることができます。

同じ手順で、windowsのclientアプリに関してもビルドしておきます。

Usage

これまでで必要なパーツが揃ったので、実際にWSLを用いてLinux 上で先ほどのビルドを立ち上げていきます。

今回は、Microsoft StoreにあるUbuntu 18.04 LTSを利用します。WSL2からlocal hostへのアクセスがそのままではできないので、WSL上のIPを

ip -4 addr show eth0

で取得します。

can't access 127.0.0.1:80 outside of WSL2 / Ubuntu 20.04

このIPにWindowsのClientアプリからアクセスすることで、サーバーにアクセスできるように、先ほどのビルドを起動します。

Linuxのビルドは、私の場合は、 /mnt/c/UE/MySample/LinuxSample/Packages/LinuxServer/LinuxSample/Binaries/Linux/

にあるので、

cd /mnt/c/UE/MySample/LinuxSample/Packages/LinuxServer/LinuxSample/Binaries/Linux/
./LinuxSampleServer xxx.xx.xxx.xxx -log

で起動します。-logをつけることで、Serverのlogを見ながら接続が可能になります。また、xxx.xx.xxx.xxxには、先ほどip addr showで取得したIPを入力してください。

この状態で、今度は、Windowsのcmdなどで、Clientアプリを起動します。起動は、

{Clientアプリ実行ファイルまでのpath}/LinuxSampleClient -log xxx.xx.xxx.xxx -windowed resx=720 resy=480

とすることで、適当なサイズのwindowでサーバーへ接続するwindowsのアプリケーションを立ち上げることができます。

#Reference