How to package and upload the project#

  1. The ACE pipeline requires a Linux build of the Unreal project. If you are on a Windows machine, you must have installed Unreal with Linux as a target platform. Alternatively, you can save the project, reopen it on a Linux machine, and package it from there.

  2. Close the Unreal Editor, if it is running (if you build the project inside the Unreal Editor, you get Error: HttpListener unable to bind to 127.0.0.1:8021).

  3. Build the project from the command line:

    "C:\Program Files\Epic Games\UE_5.3\Engine\Build\BatchFiles\RunUAT.bat" BuildCookRun -clientconfig=Development -serverconfig=Development -project=C:\UnrealProjects\ACE_Template_Scene\ACE_Template_Scene.uproject -utf8output -nodebuginfo -allmaps -noP4 -cook -build -stage -prereqs -pak -archive -archivedirectory=C:\UnrealProjects\ACE_Template_Scene\dist\Linux -platform=Linux

    Warning

    The current ACE plugins require a Development build. Do not use -clientconfig=Shipping -serverconfig=Shipping in the build command.

  4. Packaging can take a long time. The result will be a folder named “Linux” in your chosen location (e.g. C:\UnrealProjects\ACE_Template_Scene\dist\Linux). Once complete, upload the contents of that folder to NGC by following the Uploading a Version to the NGC Resource section.

  5. Usually, you now also want to update the links to your new resource in an UCS application that uses the Unreal Renderer microservice. The parameters under remoteResourcePath need to be updated to point to the new resource. You can also find more information about individual parameters in the Parameters section.