# Packaged Unreal Engine project Example

## Overview

The Live FX/Unreal Engine workflow allows you to **build your Unreal Engine Projects to a game,** that can exist as an .exe file.&#x20;

This means that if you plan ahead and [package your project](https://assimilate.gitbook.io/live-fx-documentation/unreal-engine/how-to-package-an-unreal-engine-project-for-live-fx), your Unreal Project can work **without Unreal Engine even installed** on the host machine, complete with camera tracking, projection mapping, and Web Remote Control if you need it!&#x20;

If you want to follow along with this example, you do not need to have Unreal Engine installed, just a Windows computer with Live FX already installed and set up.

Here is a complete video walkthrough:

{% embed url="<https://youtu.be/gBtlxkdA36U>" %}

## 1. Download Example Packaged Project

Here is a demo exe file:\
<https://www.dropbox.com/scl/fi/tfnwx5b8hkuy4cavxd4ku/WaterTower_v2.zip?rlkey=fshkrjb1sw8h2c5a8sjvoj4if&dl=0>

Download the .zip folder above.&#x20;

![](https://lh7-us.googleusercontent.com/GhJiYiWhsh3NkATbQJxjsJ7FOYUsx_Z5yO55Bu9zAy6vXMl06xBIYd0PF2r8LNrn7GDk9p8koO21K0ttdGDa-bTchBJ4e0xyVDptlf3t5l438qaNJfGQ1TbezJB7wIUqVrxmQEcv_2JqtPss004mto4)![](https://lh7-us.googleusercontent.com/kGL5Y0PYLE9o4NThdA28x058K-6n8-RDdvMsrSKKzuz0VAyOJzJlaMfIyLarDqhzKxHxjWCH6a0_kRZo8MbDInq6S7gT99YW_5NrKqO0rRAie00F9SzXBWpdjE0lmTPYSrecMpQqPprCoPbSObX5SR8)

{% hint style="warning" %}
EXTRACT WITH A TOOL LIKE 7 ZIP! The default Windows tool sometimes gives an error when trying to unzip large files.
{% endhint %}

In the folder structure, you will find the project “BH\_Project.exe”.&#x20;

If you open this, it will launch a full-screen game, but for it to work properly we’ll have to create a shortcut and **pass some command line arguments in.**

Even if there is a shortcut provided, you will likely need to make your own shortcut for this to work properly.

<br>

<figure><img src="https://lh7-us.googleusercontent.com/7M1tZWQjKKq66W3-0EWqADdloiVPQ6VoO4-VL-hAiwwSaS49-xYExfvVr-0pec6LfhIzTH3CdxL0mlXOk4_qwAx0c6R2erxFRE3mNagctBNC2J6oNYojxBMHGjfottlvUVL3i-mFIOB81kcQg-tvRY4" alt=""><figcaption></figcaption></figure>

## 2. Create a shortcut

1. Right-click on the BH\_Project.exe, and go to **Create shortcut.**

![](https://lh7-us.googleusercontent.com/7B4ZwGp5A50dc6l2kKjrRHI8DcbG0Rxi6ZjoG4nVnSNrVIiKRVIobHQ1pRueV_7_0d9wBvDBrTzpT6D2ikjUy4001anxzxJr-QlwiS1X7zE_ObNG7stH-3jTttScZCL9EKkjICOCK9-AAEZ8hT8rJSk)

I’ve renamed the shortcut to “**OnScreen1920x1080**”

2. Now right-click and go to properties on the shortcut.

![](https://lh7-us.googleusercontent.com/Q7EVFiQIzghzeuWfx_-2LFPd_wL5nPFTrjUKW8OVFCYwaTtp8UZpGKqXk0CA2jqTJPqyxPNjw0gIKoc6Q_TDM-AiNXXNLmO7xgR45on48x53irZughNvgh8qb8oKD-d7WogGLVgY1dPHniFKbYcc0Bk)

3. Paste these in the **target** field, after “...exe”, with one space after the end (with or without -RenderOffscreen, if you want to be able to see it or not).\
   \
   Text to copy and paste:\
   \&#xNAN;**-RenderOffscreen -ForceRes -ResX=1920 -ResY=1080 -RCWebControlEnable -RCWebInterfaceEnable -t.MaxFPS = 23.976**\
   \
   Should look like this:\
   ![](https://lh7-us.googleusercontent.com/wHpA5cBq7rQlfq8DxcrDcz8zVKW-R6VQQKYiTSN2JhrdwtLXvQjd87HwovQl8wSFlnNn--dcUcK0pC2SMBDVNMfugLMRWW87aP7y4hWG8aOiK37v2mJ9j9XR2ilML2JN59fQc3ndxXdNCousI9RYClw)
4. If you are using **projection mapping**, you should use a resolution that is the same aspect of your camera and what you want to render, for example, if you want to project 1920x1080 you'd use:\
   -ForceRes -ResX=1920 -ResY=1080\
   \
   If you are **NOT using projection mapping**, you should enter the resolution of your LED wall, or your monitor, as you want. So if your wall is 2560x1320, you’d use: \
   -ForceRes -ResX=2560 -ResY=1320\
   \
   And you would likely want to [change your timeline resolution](https://assimilate.gitbook.io/live-fx-documentation/getting-started/the-basics/change-shot-framerate-and-resolution) to match this setting as well. \
   \
   Whatever frame rate you are shooting in, your timeline should match and you should set that in your console variables, for example if you are shooting in 59.94, you would use:\
   -t.MaxFPS = 59.94

{% hint style="danger" %}
IF YOU ARE RENDERING OFFSCREEN, YOU WILL NOT SEE THE EXPERIENCE LAUNCH, PRESS **CONTROL+ALT+DELETE** TO SEE IT AND TO CLOSE IT.
{% endhint %}

## 3. Open the Example Project

Now open the **shortcut**, if rendering offscreen you will not see it, **but Live FX will**.&#x20;

## 4a. Green Screen Setup

There are a few different ways we can set up a shot with Unreal in the background.&#x20;

If using an LED Wall, skip to the next section, [Projection Setup](#id-4b.-projection-setup)

If you are using a Green Screen workflow, go to the construct press the Live Setup button, and **choose Green screen with Unreal background for the Model.**

Under Unreal Capture, select **Unreal Texture Share.**

<figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2FD5I7OPhJRplLobkXoSNU%2Fimage.png?alt=media&#x26;token=1bc9e86b-70b4-4ba9-bebd-cfb613cedd40" alt=""><figcaption></figcaption></figure>

## 4b. Projection Setup

From the construct select **Projection Setup**, under Project Media, select **Unreal Texture Share.**&#x20;

Then follow whatever projection mapping methods you normally use.

<figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2FjA1DvGA5DK24z5YrCY1c%2Fimage.png?alt=media&#x26;token=f295f487-8598-4ad9-8e83-c3b794ed001d" alt=""><figcaption></figcaption></figure>

## 4c. Basic Capture

If you want to play the UE project on the wall, but not use the Projection mapping workflow, you can just click Live Setup, then Basic Capture, and under Foreground / Camera, choose Unreal Texture Share.

For this tutorial, I will use this last option, Basic Capture, but the next steps are the same, regardless of your setup.

<figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2F0NIcASK0iv60cVgFSpHu%2Fimage.png?alt=media&#x26;token=ef3e2445-5d26-48c1-8997-7217769cbf1e" alt=""><figcaption></figcaption></figure>

## 5. Set up Unreal Live Link

1. Click on the **Live FX** menu, then click on the **Live Links** Menu.<br>

   <figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2FrUJR4qDPbdKXC0rFVKDZ%2Fimage.png?alt=media&#x26;token=d342720f-4a9d-4e8c-a6fb-40a879caf036" alt=""><figcaption></figcaption></figure>

2. Click on **Unreal Live Link.**\
   **Press On.**

   (Optional) Click Broadcast.

   **Click Connect.**\
   \
   IP can be 127.0.0.1 if using the local machine\
   \
   The Port should remain 9001.\
   \
   If you see numbers moving at the bottom, this is set up correctly.\
   \
   :bulb:**YOU MUST HAVE AN ACTIVE CAMERA IN YOUR SCENE, MORE ON THIS BELOW**<br>

   <figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2FKMZHq9JEfoiudIXXHU3g%2Fimage.png?alt=media&#x26;token=11e48e82-2170-4393-8e4c-adbc261759eb" alt=""><figcaption></figcaption></figure>

3. If using **camera tracking**, make sure your tracking is set up correctly and that you **press “Apply”** so that it applies to your camera.\ <br>

   <figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2F44OnXR1HjwYXElO4T5es%2Fimage.png?alt=media&#x26;token=7567e372-b536-4868-9372-f451f2952297" alt=""><figcaption></figcaption></figure>

4. If **not** using camera tracking, go to the **Camera tab and press “Active”**

   You can manually move the camera in UE, by changing the Tracker / Animation values.<br>

   <figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2Fzu6i71fhRuWyLXACaPmb%2Fimage.png?alt=media&#x26;token=8aed222f-04d0-450f-8308-054cbaea886f" alt=""><figcaption></figcaption></figure>

We can see from the screenshot below that we’ve set everything up correctly because we see the Watertower demo in the viewport (through the Unreal Texture Share layer), the Live Link has a frame counter, **counting frames** below the Scale in the Unreal Live Link window.&#x20;

<figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2FIdwHBBbBBnYGlsh9FW0X%2Fimage.png?alt=media&#x26;token=71bace1a-4623-4804-aa4c-c996c3681695" alt=""><figcaption></figcaption></figure>

In the **Camera tab**, the camera is active and if I pan, it moves the Unreal Engine camera. If you have camera tracking enabled, when you move the camera, it should move correctly. \
\
:bulb:If you are not using projection mapping, you can click on Manual and use the Position to move the Unreal Engine camera around your scene.&#x20;

<figure><img src="https://4002977754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrQtfp6C58EggcONhzAMx%2Fuploads%2FGkGCr3WSO1UcijfrXa0z%2Fimage.png?alt=media&#x26;token=74d97fcf-40d9-40ea-99b1-8b55127b1477" alt=""><figcaption></figcaption></figure>

:bulb:If you are using projection mapping, you cannot use the Position to move the camera in the Unreal scene without affecting your projection mapping. You could use Web Remote instead to move your camera in your scene.&#x20;

## 6. Web Remote Control&#x20;

With the WaterTower demo working, and if you passed the\
&#x20;**-RCWebControlEnable -RCWebInterfaceEnable** flags in the shortcut link before you launched it, you should now be able to **control** certain aspects of the Unreal Engine scene.

Open a browser and enter **“localhost:30000”**

<figure><img src="https://lh7-us.googleusercontent.com/ViLHLr0w3x4X6ikVOLebrGICrSwSYpsli8y5_utEhBsXY0zN7O6ELOeEmcd1xsCd-CxCZR4gu-KZ1t8xvdqddt0QOZNH0Ugi7WzvMBflPucoOcHKpuboXUfIeedkvDgZe8xWJwi6ziCiTYmwxv0-1g0" alt=""><figcaption></figcaption></figure>

You should see this window above and be able to control the time of day, and cloud coverage as well as many other parts of the Unreal Engine scene, in this example **I changed the time to 1800 (6pm).**&#x20;

<figure><img src="https://lh7-us.googleusercontent.com/6Oi0qliYhsQx0dSEI_4AwS-sfibaSiMi_72wBduGDI-q5A09KtQyYjMoP171acmW5o1L_6KoSnE5kZKqeFyVdRy1YZ4TTctBXcAkY7AwiY4i6tJ_EN-wDLSgWgVtNm7uhfmYW_mDpN5fNtYKoXItF1Q" alt=""><figcaption></figcaption></figure>

## 7. iPad and iPhone wireless monitor

You can use the Unreal Engine Remote app with the packaged project, to use as a wireless monitor of just the Unreal scene. This can work with multiple devices, doesn't affect the performance of the host machine, and is NOT synced to the host machine.&#x20;

1. Download the [Unreal Remote 2 app](https://apps.apple.com/us/app/unreal-remote-2/id1374517532).
2. Make sure the host computer and the iPhone are on the same wireless network.&#x20;
3. On the iPad or iPhone, open the app and enter the ip address of the host computer. \
   \
   You can find the ip address on the host machine by opening command prompt and use the command ipconfig to see the ip address(es).&#x20;
