# Unreal Editor for Fortnite (UEFN): OptiTrack Plugin for Live Link Hub ## Overview The OptiTrack Live Link Hub plugin allows game designers to use OptiTrack Motion Capture data to animate characters in Fortnite through Unreal Editor for Fortnite (UEFN).Comment ### Requirements Download the latest Unreal Engine 5 Plugin from the [OptiTrack Downloads page](https://optitrack.com/support/downloads/plugins.html#unreal-plugin). Open the Epic Games Launcher. The following Epic Games applications must be installed: * Unreal Engine 5.5Comment * Live Link Hub * UEFN * Fortnite ## Getting Started ### Install the Plugin * Launch Unreal Editor for Fortnite (UEFN). * Select *Live Link Hub* from the Tools menu, if it's not already open. * Click the *Settings* button in the upper right corner and select *Plugins...*

Live Link Hub with Settings button options displayed.

* In the *User Plugin Directories* section, click the *Add Element* button.

* Click the ellipses button to browse to and select the downloaded plugin.

* Restart UEFN when prompted after the plugin is installed. ### Motive Streaming Settings To enable streaming in Motive, click the

button to open the [*Applications Settings*](https://docs.optitrack.com/v3.2/motive-ui-panes/settings) panel, then select the [*Streaming* ](https://docs.optitrack.com/v3.2/motive-ui-panes/settings/settings-streaming)tab, or use the

button in the right corner of the [Control Deck](https://docs.optitrack.com/v3.2/motive-ui-panes/control-deck) to open the *Streaming* tab directly. * In the *NatNet* section, select ***Enable*** to begin streaming. * Select the **Local Interface**. Use Loopback if streaming to the same computer, otherwise select the IP address for the network where the client application resides. * Set the **Bone Naming Convention** to *UnrealEngine*. * Set the **Up Axis** to Y-Axis. The plugin will bring the data in with a Y-Forward orientation. Please see the [Data Streaming](https://docs.optitrack.com/v3.2/motive/data-streaming) page for more details on all settings available for streaming.

Application Settings Panel: Streaming Tab, Streaming enabled.

### Configure Live Link Hub #### Add Source * In Unreal Engine, open Live Link Hub from the *Tools* menu *o*n the toolbar, if it's not open already. Under *Virtual Production,* select *Live Link Hub.* * Click the

button in Live Link Hub to add a new Live Link source. * Select *OptiTrack Source*, check *Connect Automatically,* or enter the IP address for the Motive PC in the *Server Address* field, the IP address for the Unreal PC in the *Client Address* field. Enter 127.0.0.1 in both fields if running both on the same PC. Click create.

Properties are shown in the Source Details tab when the OptiTrack source is selected. The properties that are applicable to Fortnite characters are listed below.

Live Link Hub Sources and Source Details tab.

#### Streaming Data Offset Adjust the location, orientation, or scale of the streaming data. #### Timecode Timecode is fully supported in the plugin. Click the button in the top right to use preset system time codes or add a new Timecode Provider in the *Source Details* tab.

Timecode data may appear to stutter in Unreal Editor even when it is transmitting correctly. To confirm that the data is in sync, compare the timecode in Live Link Hub to the timecode in Motive.

Timecode displayed in Motive, Live Link Hub, and UEFN.

{% hint style="info" %} Unreal Editor for Fortnite does not support the display of markers. {% endhint %} ### Copy Assets to Project Folder We recommend using Windows Explorer to copy assets into the project folder. Right-click the project folder in the Unreal Editor Content Browser and select *Show in Explorer*.

In the Content Browser, copy the following files and folders from *All > Engine > Plugins > OptiTrack - Live Link Content > Animations* to the project folder: * Female Avatar (folder) * Male Avatar (folder) * Textures (folder) * IK\_MotiveAvatar\_Opti.uasset (file) * SK\_MotiveAvatar\_Opti.uasset (file) {% hint style="info" %} The T-Pose asset and animation blueprints typically used in Unreal Engine are not supported in Unreal Editor. {% endhint %} Once the required assets are copied to the project folder, click the

button. Unreal Editor will prompt to *Save Selected*, with all unsaved content selected by default. Unreal Editor will validate the project files before launching the live session. ## Create Retargeter in Unreal Editor All skeletons in Unreal Editor are based on the standard Fortnite mannequin. Animation is applied to the mannequin rather than using an animation blueprint. In this example, we will use the Fortnite Mannequin to build an IK Rig to receive data from the OptiTrack skeletons. ### Create IK Rig Before creating our IK Rig, drag the Motive Avatar of your choosing into the scene to prep the retarget phase. To create the IK Rig: * Right-click in the Content area. Select *Animation > Retargeting > IKRig.* * Name the IKRig. We recommend *IK\_FNMannequin*.

Double-click the newly created IKRig to edit it. This will open in a new window.

In the Details tab, change the Preview Mesh to the FN Mannequin.

The mannequin is pre-configured to work with Fortnite. This allows you to use the *Auto Create* features in the upper left corner to finish setting up the IK Rig.

1. Click the *Auto Create Retarget Chains* button. 2. Click *Auto Create IK*. 3. Click *Reset*. 4. Click *Save*. The IK Rig is now configured and the tab can be closed. ### Create IK Retargeter * Right-click in the Content area. Select *Animation > Retargeting > IK Retargeter.* * Name the IK Retargeter. We recommend *RTG\_Motive\_FN*.

* Open the newly created Retargeter. * On the Details tab, go to *Source > Source IKRig Asset.* * Use the dropdown list to select the standard Motive avatar, *IK\_MotiveAvatar\_Opti.*

* In the Target section, set the *Target IKRig Asset* to the [IKRig created earlier](https://app.gitbook.com/o/6K2GcxpSS9y4e9SRLTrx/s/uHClgoIWDmmoXSr2eD9q/plugins/optitrack-unreal-engine-plugin/unreal-engine-optitrack-live-link-plugin/unreal-editor-for-fortnite-uefn-optitrack-plugin-for-live-link-hub#create-ik-rig), *IK\_FNMannequin.*

### Align Skeletons The Viewport will show that the two skeletons are not properly aligned. This occurs because the skeletons are in different poses. * Click the Running Retargeter button in the upper left corner to stop the retargeter and switch to edit mode. The button will update to *Editing Retarget Pose.*

* Click the Auto Align button

and select *Align all Bones t*o complete the alignment. * Set the Retargeter back to *Run* mode for the remaining steps. #### Blend to Source To complete the next step, it's easiest if only the mapped bone chains are visible. * In the Chain Mapping pane, click the Settings button and select *Hide Chains Without IK.*

* Select all of the mapped Chains. * In the Details tab, go to *IK > Blend to Source*. * Set the value to 1.0.

* Click the *Root Settings* button

in the top right corner. * Go to *Blend to Source > Blend to Source* and set the value to 1.0.

The retarget will now display correctly in the Viewport. This window can now be closed. ## Add Animation * From the Content Browser, drag the skeletal mesh for the Fortnite mannequin into the scene. The mannequin is located in *All > Fortnite > Characters > PlayerBasics.* * Both the Motive Avatar and the Fortnite Mannequin will be in the scene. * Select the Motive Avatar. * Click the ![](https://2559979491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ne9bLcvxMzpZqIc5yuj%2Fuploads%2FUCN8kMmVfOgNJ89doPen%2FLive%20Link%20Add%20Component%20button.png?alt=media\&token=e8a6e744-e5af-4408-9894-8368e57ad811) Add button to add the Performer component. * In the Details tab, go to *Performer > Performance Capture > Subject Name.* * Select a performer from the list of actors in Motive. * The Motive Avatar will now animate with the selected actor.

* Select the Fortnite Mannequin to display its properties in the Details pane. * Click the Add button ![](https://2559979491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ne9bLcvxMzpZqIc5yuj%2Fuploads%2FRqNtx6JipNY5DbBWy1oA%2FLive%20Link%20Add%20Component%20button.png?alt=media\&token=89261137-a876-477b-ab66-44431feb2414) and use the search bar to find and add the *Retarget Component*.

Once the Retarget Component is attached to the Mannequin, update the following properties in the *Retarget* section: * **Source Skeletal Mesh Component:** Select the Motive Avatar. * **Controlled Skeletal Mesh Component:** This should already be set to the Fortnite Mannequin. * **Retarget Asset:** Select the [IK Retargeter](#create-ik-retargeter) created in an earlier step (*RTG\_Motive\_FN* in our example).

* Click the Push Changes button ![](https://2559979491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ne9bLcvxMzpZqIc5yuj%2Fuploads%2FZ5KtcF4xj7B0d9tql9TG%2FUEFN%20Push%20Changes%20Button.png?alt=media\&token=b5614eb0-b3a7-4186-b36c-7fa4d3a8fd63) to save the change into the Fortnite game. {% hint style="info" %} The Avatar and Mannequin will animate in realtime only in the Editor, not in the game. {% endhint %} #### Align the Avatar and Mannequin * In the Outliner pane, drag the Mannequin to nest under the Motive Avatar. * In the Details pane for the Mannequin, go to *Transform > Location* and reset the values to 0. * The Avatar and the Mannequin will be aligned.

## Record Animation Once all of the characters are configured, the next step is to record the animation using the Take Recorder and Sequencer in Unreal Editor. * To open either pane, go to the *Windows menu > Cinematics.* * Type the project name in the Slate field. * With the Mannequin selected, click the add source ![](https://2559979491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ne9bLcvxMzpZqIc5yuj%2Fuploads%2FVM9genBRymvJMXnl3aDi%2FUE%20Add%20Source%20Button.png?alt=media\&token=5a3b5007-dfa7-418b-b396-cbde626c3dc4) button. * Select *From Actor > Add 'Device Mannequin'.*

With the Mannequin selected, update the following properties: * Disable *Transform > Transform Track.* * Disable *Animation Recorder > Remove Root Animation* (shown below)*.*

#### Countdown Go to *User Settings > Countdown* to include a countdown timer to start recording.

#### Recording To begin recording, click the large red Play button on the right edge of the Slate in the Take Recorder:

Recorded tracks will show in the Sequencer tab. Click the Stop Recording button

when done recording.

#### Review Recording When the recording is completed, click the *Review* button in the Take Recorder pane.

Take Recorder pane - Review Last recording button.

The character will now animate as expected.

You can find the Take and the associated animations in the Cinematics folder in the Content Browser. Takes are organized with a folder for each subscene. The animations recorded in that subscene are stored in an Animation folder, one for the Device Mannequin and one for the Motive Avatar.

Animation for a subscene in the Content Browser.

## Animate Fortnite Characters Now that the animation has been created and aligned to the Device Mannequin, it's time to apply it to a Fortnite character. Since all characters in Fortnite use this same skeleton, no additional alignment is required. ### Select a Character in UEFN Fortnite has a large selection of characters available, all based on the Device Mannequin skeleton. To add a character to the scene from the Content Browser: * Go to *Fortnite > Devices > AI*. * Drag the **Character Device** to the scene.

* Select the Character Device in the Viewport. * Go to *Fortnite > Characters* and select the desired character from the gallery.

In the Details pane for the newly added Character Device, drag the Fortnite character you wish to use to *User Options > Character*.

### Apply Animation * Select the Fortnite character in the Viewport. * Under *User Options*, check the box for *Custom Idle*. * Drag the Device Mannequin animation from the Content Browser to the *Custom Idle* field.

* Click the Push Changes ![](https://2559979491-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4ne9bLcvxMzpZqIc5yuj%2Fuploads%2F6sFTIqo3D7HgZcYdknXp%2FUEFN%20Push%20Changes%20Button.png?alt=media\&token=bccbfecf-d968-4c57-b8d9-7f8fe85d2c20) button to save and update the game. * Fortnite will update the game in Edit Mode, with the status displayed in the upper right corner. The game will move through the following phases: Preparing; Loading Project; Downloading; and Connecting (displayed on the Edit Session screen). When the game loads, the status will be Up to Date.

The animation will play on the Fortnite character when the game starts. It will not play in the editor. To see this, you can start the game from UEFN or inside Fortnite itself.