Skip to content

Instantly share code, notes, and snippets.

@mrmowgli
Forked from zhiguangwang/README.md
Last active April 10, 2021 07:30
Show Gist options
  • Save mrmowgli/d7905bc72f58d3dc338a1c61b2f27079 to your computer and use it in GitHub Desktop.
Save mrmowgli/d7905bc72f58d3dc338a1c61b2f27079 to your computer and use it in GitHub Desktop.
Building Unreal Engine Game Client and Dedicated Server on Linux.

Building Unreal Engine Game Client and Dedicated Server on Linux

Because the build tools of UE4 works across platforms (Windows, Mac OS, Linux), steps in this article can be applied to Mac OS and Windows as well.

On Windows, You need to replace RunUAT.sh with RunUAT.bat though.

Prerequisites

First, get Unreal Engine 4 sourcecode and export the following environment variables:

  • $UE4_ROOT Engine sourcecode directory, which contains Setup.sh
  • $GAME_UPROJECT Path of the .uproject file of your game project
  • $ARCHIVED_DIR Your build output directory.

Build Steps

Prepare for Engine Build

cd $UE4_ROOT
./Setup.sh
./GenerateProjectFiles.sh

Build the Engine

make UE4Editor UE4Game UnrealPak CrashReportClient ShaderCompileWorker UnrealLightmass

Generate Game Project Files

This will generate Makefiles on Linux (Visual Studio files on Windows, XCode files on Mac OS).

$UE4_ROOT/GenerateProjectFiles.sh -project="$GAME_UPROJECT" -game

Create a Server Target CS Script

You will need to make a copy of your game client build targets for the Server target. In your project_dir/sources folder you will find editor and game target .cs files. Create a copy of [ProjectName].Target.cs and rename it [ProjectName]Server.Target.cs.

Edit your new file and change the occurrences to add Server as a target. Also set TargetType to Server. See the following example:

// Copyright Epic Games, Inc. All Rights Reserved.                                                                                                                                                                 
                                                                                                                                                                                                                   
using UnrealBuildTool;                                                                                                                                                                                             
using System.Collections.Generic;                                                                                                                                                                                  
                                                                                                                                                                                                                   
public class [YourProject]ServerTarget : TargetRules   // Please notice the added Server                                                                                                                                                                     
{                                                                                                                                                                                                                  
    public [YourProject]ServerTarget(TargetInfo Target) : base(Target)                                                                                                                                                      
    {                                                                                                                                                                                                              
        Type = TargetType.Server; // Changed from Game to Server!                                                                                                                                                                                    
        DefaultBuildSettings = BuildSettingsVersion.V2;                                                                                                                                                            
        ExtraModuleNames.Add("NodejsTest");                                                                                                                                                                        
    }                                                                                                                                                                                                              
}                 

Build and Cook the Dedicated Server

$UE4_ROOT/Engine/Build/BatchFiles/RunUAT.sh \
    BuildCookRun -project="$GAME_UPROJECT" \
    -nop4 -build -cook -compressed -stage \
    -noclient -server -serverplatform=Linux -serverconfig=Development \
    -pak -archive -archivedirectory="$ARCHIVED_DIR" \
    -utf8output

Build and Cook the Client

$UE4_ROOT/Engine/Build/BatchFiles/RunUAT.sh \
    BuildCookRun -project="$GAME_UPROJECT" \
    -nop4 -build -cook -compressed -stage \
    -platform=Linux -clientconfig=Development \
    -pak -archive -archivedirectory="$ARCHIVED_DIR" \
    -utf8output

References

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment