Utu Plugin - Unity to Unreal Project Converter

8 ratings

This plugin gives you the possibility to import a big chunk of the art work you did in Unity into Unreal.

Compatible Unity Versions (Win64 & Mac): 2018 to 2023
Compatible Unreal Versions (Win64): 4.25, 4.26, 4.27, 5.1, 5.2, 5.3
Compatible Unreal Versions (Mac): 4.25, 4.26, 4.27, 5.1 (5.2 & 5.3 should also work, but you'll have to compile them yourself)

Utu Plugin Demo & Tutorial:
https://youtu.be/34qx5Ac8cZo?si=ne29q3cGtNJ6WWsu

Other Unreal Engine Tutorials:
https://www.youtube.com/AlexQuevillonEn?sub_confirmation=1

Features:

- Export / imports the main asset types used in a game engine (Scenes, Meshes, Materials, Textures, Prefabs, Lights & Camera)
- Re-creates the hierarchies (Content Browser, Scenes, Prefabs)
- Has two multi-tabs user interfaces which provides a lot of information about the process and the assets
- The export and import processes can be cancelled at any time
- Every export and import comes with a log file that is automatically saved so it's easier to debug if you have any problems
- A list of settings that let you adjust the import a little bit

Important/Additional Notes:

- This plugin is not perfect and will probably never be due to the differences between both engines.
- You will probably still have some adjustments to do manually for the scenes to be perfect, but the amount of work will be considerably reduced.
- This plugin has some limitations. Please look at the pictures and read below for the complete list.

How does it work? Is it complicated?

- You select the scenes that you want to export and the plugin will convert it and include all their dependencies
- Only a small amount of inputs is required by the user
- The user interfaces are simple and user friendly

Why? Reasons to use this plugin:

- You changed your mind and want to use Unreal instead of Unity without starting over
- You want to sell your asset pack on both engines
- You want to convert some old projects or assets (Make sure to read the policy if you bought the assets)

Which assets are supported?

- Scenes
- Static / Skeletal Meshes
- Materials
- Textures
- Prefabs
- Point, Spot and Directional Lights
- Cameras

Which assets are not supported?

- Animations
- Terrains
- Foliage
- Particle Systems
- 2D Objects
- User Interfaces
- Audio
- Scripts
- etc. (Everything else that is not in the Supported Assets list)

Anything else?

- This plugin also re-creates the hierarchies (Content Browser, Scenes, Prefabs) the same way you built them in Unity.

How to install - Unity

- Copy "..\UtuPluginPackage\Unity_Plugin\UtuPlugin" in the "Assets" folder of your Unity project.

- Open the provided Unity project. Which also contains the sample scenes. "..\UtuPluginPackage\Unity_SampleProject\UnityProject"

How to install - Unreal

- Copy "..\UtuPluginPackage\Unreal_Plugin\4.25\UtuPlugin" in the "Plugins" folder of your Unreal project
* If the "Plugins" folder doesn’t exist, create it.
* Use the version that match your project.

- Open the provided Unreal project. Project version is 4.25 "..\UtuPluginPackage\Unreal_SampleProject\UnrealProject"

Process Steps

In Unity
1 - Install the tool in your Unity project.
2 - Open your Unity project.
3 - Open the tool using the 'Plugins/Utu Plugin' drop down menu at the top.
4 - Select the scenes you want to Export. (The tool will export evertything that is referenced par the selected scenes.)
5 - Name your export (optional)
6 - Press Export

In Unreal
7 - Install the tool in your Unreal project in which you want to Import your scenes.
8 - Open the destination Unreal project.
9 - Open the tool using the 'Utu Plugin' button at the top.
10 - Select the Export that you want to Import.
11 - Press Import.
12 - Go get some coffee
13 - Once completed, you can look at the 'Log' tab to get more information about the process. (Including the warnings and errors.)

IMPORTANT:

Please backup your project before using this tool.
I've never lost any data using this tool, but I don't want to be responsible for any data loss during the process.
(It is also a good habit to backup your project from time to time or to simply use a source control.)

Supported Assets:

Scene:

What it does:
- Creates a World asset
- Adds a SkyLight to simulate Unity's default lighting
- Adds all the actors (Including display name, transform, visibility and tag)
- Recreates the scene's hierarchy
- Supports instance edited materials on static mesh actors
Limitations:
- If your scenes contain non-uniform scaling on any parent of a rotated mesh, the result will not be as expected in Unreal because of the way the meshes are transformed.

- Bad hierarchy examples:
Scene root -> Non-uniformly scaled object -> Rotated mesh
Scene root -> Non-uniformly scaled object -> Uniformly scaled object -> Rotated mesh
Scene root -> Non-uniformly scaled object -> Rotated object -> Not rotated mesh

- Good hierarchy examples:
Scene root -> Uniformly scaled object -> Rotated mesh
Scene root -> Non-uniformly scaled object -> Not rotated mesh
Scene root -> Uniformly scaled object -> Not rotated mesh

Prefab:

What it does:
- Creates a Blueprint Actor asset
- Adds all the components (Including display name, transform, visibility and tag)
- Recreates the prefab's hierarchy
- Supports instance edited materials on static mesh components
- Supports nested prefabs (child actor components)
Limitations:
- If your prefabs contain non-uniform scaling on any parent of a rotated mesh, the result will not be as expected in Unreal because of the way the meshes are transformed.

- Bad hierarchy examples:
Prefab root -> Non-uniformly scaled object -> Rotated mesh
Prefab root -> Non-uniformly scaled object -> Uniformly scaled object -> Rotated mesh
Prefab root -> Non-uniformly scaled object -> Rotated object -> Not rotated mesh

- Good hierarchy examples:
Prefab root -> Uniformly scaled object -> Rotated mesh
Prefab root -> Non-uniformly scaled object -> Not rotated mesh
Prefab root -> Uniformly scaled object -> Not rotated mesh

Static Mesh:

What it does:
- Creates a Static Mesh asset using the .fbx file
- Assigns the materials to the mesh
New feature:
- Now supports .fbx files with more than one mesh
Known Bugs:
- The materials ID are sometime swapped during import

Skeletal Mesh:

What it does:
- Creates a Skeletal Mesh asset using the .fbx file
- Assigns the materials to the mesh
Limitations:
- Rig may not be supported by Unreal
- Animations are not imported
Known Bugs:
- The materials ID are sometime swapped during import

Texture:

What it does:
- Creates a Texture2D asset using the texture file
Limitations:
- .tif files are not supported

Material:

What it does:
- Creates a Material asset
- Adds all the referenced textures into the material
- Connects textures to the equivalent parameter
- Sets the equivalent parameters for Metallic, Specular, Emission, Tiling and Offset
Supported shader types:
- Standard
- Standard (Specular setup)
- Unlit/Color
- Unlit/Texture
- Unlit/Transparent
- Unlit/Transparent Cutout
- Mobile/Diffuse
- Mobile/Unlit (Supports Lightmap)
- Legacy Shaders/Diffuse

Spotlight:

Supported parameters:
- Intensity
- Color
- Range
- Cast Shadows
- Spot Angle
Limitations:
- Equivalence is not 100% perfect

Pointlight:

Supported parameters:
- Intensity
- Color
- Range
- Cast Shadows
Limitations:
- Equivalence is not 100% perfect

Directionnal Light:

Supported parameters:
- Intensity
- Color
- Cast Shadows
Limitations:
- Equivalence is not 100% perfect

Camera:

Supported parameters:
- Clipping planes
- Aspect ratio
- Projection
- Field of view
- Focal length
- Sensor size

Plugin Content:

- 2 Blueprints
- 10 C++ Classes
- 5 C++ Enums
- 18 C++ Structs
- 8 Textures
- 7 Static Meshes
- 23 C# Classes
- 2 C# Enums
- 1 C# Structs

Release Note:

1.4 (September 2023)
- Compiled for Unreal 5.3
- Compiled for Mac
- Some bug fixes
1.3 (August 2023)
- Added import of gameobjects mobility (Movable vs Static)
- Added settings to adjust meshes import scale
- Added import of .obj files (but not 100% supported as .fbx is the recommended format)
- Added error message when asset filename contains invalid characters
1.2 (July 2023)
- Fix crash on Unreal 5
- Support meshes that aren't using ConvertUnits
1.1 (July 2023)
- Added support for multiple static meshes coming from the same fbx file
- Added a list of settings to adjust the import process a little bit
- Compiled for Unreal 5.2
1.0 (March 2023)
- Initial Release