Utu Plugin - Unity to Unreal Project Converter
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.
Or
- 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.
0r
- 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
More Info
More Examples
You'll get the Unreal Plugin, the Unity Plugin and Two Unity Sample Scenes to test the plugin.