Skip to content

Waffle1434/Blender-UE4-Importer

Repository files navigation

Blender UE4 Importer

Blender addon to import Unreal Engine 4 asset files. Download the latest release.

image import_umesh

Features

  • Directly reads Unreal Engine project files, no exporting in Unreal Editor required
  • Import full .umap scenes
  • Import individual mesh & material .uasset files
  • Pixel-perfect material recreation for supported nodes
  • Blender equivalent material graph with labels and comments
  • Cubemaps & irridance volume placement for Eevee
  • umodel.exe for texture extraction
  • Normal map format correction
Saved with Engine UMap Static Mesh Skeletal Mesh Material Material Instance Skeleton Animation
4.16 ✔️ ✔️ ⚠️ ✔️ ✔️
4.27 ✔️ ✔️ ⚠️ ✔️ ✔️
5

Known Issues

  • Unreal's binary files are a painful history of microchanges that lead to tons of branching paths that need to be supported. I might be fighting a losing battle. It is particularly hard for me to follow Unreal's source code, I can't promise anything in the future.
  • Most testing has been performed on Unreal Engine 4.27 using free assets from the asset store. Assets saved with UE5 might work, but its unlikely. UE4 assets should still import into Blender from UE5 projects. If something isn't importing, I might be able to support it if you send a copy.
  • Due to their complexity, materials are the most likely to fail to import. The importer will attempt to power through, but nodes may be missing or materials left unassigned.
  • Skeletal meshes import as rigid meshes. The vertex groups are correct, getting the correct orientation of the bones is tripping me up so I'm excluding the armature for now.
  • BSP and terrain is MIA, I may support this if requested enough.

UMap Support

Element Support Notes
Static & Skeletal Meshes ✔️
Blueprint Instances ⚠️ Only Static Meshes for now
Point, Spot, Directional Lights ✔️ Eevee 128 light limit
Box & Sphere ReflectionCapture ✔️
Cameras ✔️
Material Overrides ✔️
Hierarchy Folders ✔️
BSP, Terrain

Material Support

Node Support Notes
Add, Subtract, Multiply, Divide ✔️
Sin, Cos, Tan, Arcsin, Arccos, Arctan ✔️
Power, Log2, Log10 ✔️
Frac, Fmod, Round, Ceil, Floor, Truncate ✔️
Abs, Sign, 1-x, Min, Max ✔️
Step, Smoothstep, Clamp, Lerp ✔️
Distance, Dot, Cross, Normalize ✔️
Constants, Parameters ✔️
Switch, If ✔️
Texture2D (& Parameters), TextureCoordinate ✔️
TwoSidedSign, VertexColor, VertexNormal, WorldPosition, ObjectPosition ✔️
CameraPosition, CameraVector, CameraDepthFade ✔️
ScreenPosition, PixelDepth ✔️
Desaturation, Contrast, BlackBody ✔️
Append, ComponentMask ⚠️ vec1+vec1, TODO
MakeMaterialAttributes ⚠️ TODO: multiple nodes
Transform TODO
LightmassReplace N/A
Texture3D, BumpOffset, CustomExpression Blender unsupported
Material Functions ✔️
Comment, Reroute ✔️

Tested Assets

Asset Support Notes
Modular SciFi Season 1 Starter Bundle ✔️⚠️ Parallax mapped snow, Blender unsupported
Modular Scifi Season 2 Starter Bundle ✔️ Personal favorite
FPS Weapons Bundle ✔️
Vehicle Variety Pack ✔️
Vehicle Variety Pack Volume 2 ✔️
Military Supplies - VOL.1 - Tents ✔️ $
Military Supplies - VOL.2 - Clothing ✔️ $
Military Supplies - VOL.3 - Checkpoint ✔️ $
Military Supplies - VOL.4 - Furniture ✔️ $
Military Supplies - VOL.5 - Devices ✔️⚠️ $, Trailer materials swapped (why)
Military Supplies - VOL.6 - Crates ✔️ $
Military Supplies - VOL.7 - Containers ✔️ $
Military Supplies - VOL.8 - Supplies ✔️ $
Twinmotion Construction Vehicles 1 Compressed (fml)
Toolset Collection - Vol 1 Compressed (fml)