Skip to main content
Version: 1.0.0

Migration Guide

Demo Project Migration

After you have checked out the TBIA_Demo project you might want to use its example setup as a base for your own project.

This migration guide will help you with the process of correctly transferring all necessary files as well as making important changes to your own project.

Content Folder Migration

Open the TBIA_Demo project and select the folder TwistedBytes 1 in the Content Browser. Right-click this folder and select Migrate.... Then, select all assets in the Asset Report window and confirm by clicking on the OK button 2.

Migrate Content: Asset Report

A new window will pop up where you need to specify the Content 1 folder of the project you want to migrate the TwistedBytes demo files to.

Migrate Content: Choose Content folder

Add Gameplay Tags

Our plugin uses a Gameplay Tag Data Table asset that holds all mandatory tags needed for its core functionalities to work correctly in any project. Unfortunately, the previous migration action you executed within Unreal Editor does not migrate Gameplay Tags.

The following steps will explain in detail how to add all required Gameplay Tags to your own project.

In the Content Browser, select the plugin folder named TwistedBytes_InteractionSystem Content and navigate further into the GAS sub-folder. In this folder you will find the mentioned Gameplay Tag Data Table asset called TBIA_GamePlayTags 3.

This asset file needs to be added to the GameplayTags section of your project settings as shown in 4.

GameplayTags Data Table asset

note

In order to find the Gameplay Tag Data Table asset, you might first need to make the plugin folder visible by clicking on View Options 1 in the bottom right corner of the Content Browser.

Make sure to check both Show Plugin Content and Show Engine Content 2.

You are now all set regarding Gameplay Tags!

However, in the demo project we also set up some Gameplay Tags, so that we can demonstrate to you how to implement certain gameplay mechanics using our plugin. So, it is totally up to you if you want to follow the rest of the instructions in this subsection.

Add these tags in project settings by writing them as shown in 1 and 2.

Additional GameplayTags in project settings

Alternatively, you can save yourself some typing work and just copy these tags from the demo project. Use your file manager of choice (e.g. Explorer) and navigate to <TBIA_Demo Project Root Folder>/Config/.

Open the file DefaultGameplayTag.ini 1 in a text editor and copy all lines starting with +GameplayTagList= as shown in 2 to your project's DefaultGameplayTag.ini.

Copy GameplayTags from demo project

note

You will need to restart the Unreal Editor after modifying DefaultGameplayTag.ini before your newly added Gameplay Tags will become available in your project.

After adding these tags, open the Blueprint BP_PlayerCharacter that is located in InteractionsDemo/Blueprints/Core/. Since Gameplay Tags are not migrated by Unreal Editor, any tags that are not found in the target project will be removed in all Blueprint nodes.

Reassign the tag as shown below in 1. Next, open the macro Check Controller at 2 and reassign the Gameplay Tag as shown in 3.

Reassign tags in Player Character

Collision Settings

The demo project uses a custom Object Collision Channel that needs to be set up in the project settings.

Go to Edit | Project Settings ... and select Collision under the Engine section.

Add a new Object Collision Channel, name it Interactable and set the Default Response to Block.

Collision Settings

After adding the new Object Collision Channel, navigate to BP_GAInteractPassive and BP_GAInteractActive. The value of the Trace Channel property will be ECC Game Trace Channel 2 as shown in 1.

Change the value to the new Interactable channel as shown in 2 in both Blueprints.

Ability Collision Channel

Input Settings

Go to Edit | Project Settings ... and select Input under the Engine section.

Add three Action Mappings with the exact same names as shown in 1, 2, and 3.

Input Settings

Setting GameMode

Navigate to the folder shown in the image below and select BP_FirstPersonGameMode 1. In the World Settings tab, assign the GameMode Override property with the selected Game Mode asset as shown in 2.

Game Mode

note

In case you cannot find the World Settings tab in Unreal Editor, go to Window | World Settings to open it.

PostProcess Material

The demo project uses a custom PostProcess Material so that objects focused by a player can be highlighted. In order to make the highlighting feature work, change Custom Depth-Stencil Pass to Enabled with Stencil in your project settings. The easiest way to find it is by searching for Custom Depth in the Project Settings search field 1.

Then, select your PostProcessVolume in the World Outliner tab 3 and add our custom PostProcess Material M_Highlight at 4 to the Post Process Materials array as shown in 5. Also make sure that Infinite Extent (Unbound) 6 is enabled in your PostProcessVolume.

Post Process Material