This Blender addon allows you to import and export meshes and animations to and from the PSK and PSA file formats used in many versions of the Unreal Engine.
This software is licensed under the GPLv3 license.
For Blender 4.2 and higher, download the latest version from the Blender Extensions platform.
For Blender 4.1 and lower, see Legacy Compatibility.
- Full PSK/PSA import and export capabilities.
- Non-standard file section data (.pskx) is supported for import only (vertex normals, extra UV channels, vertex colors, shape keys).
- Fine-grained PSA sequence importing for efficient workflow when working with large PSA files.
- PSA sequence metadata (e.g., frame rate) is preserved on import, allowing this data to be reused on export.
- Bone collections can be excluded from PSK/PSA export (useful for excluding non-contributing bones such as IK controllers).
- PSA sequences can be exported directly from actions or delineated using a scene's timeline markers, pose markers, or NLA track strips, allowing direct use of the NLA when creating sequences.
- Manual re-ordering of material slots.
- Multiple armature objects can be exported to a single PSK or PSA file, allowing seamless use of action slots.
- Support for exporting instance collections.
- Select the mesh objects you wish to export.
- Navigate to
File>Export>Unreal PSK (.psk). - Enter the file name and click
Export.
- Navigate to
File>Import>Unreal PSK (.psk/.pskx). - Select the PSK file you want to import and click
Import.
- Select the armature objects you wish to export.
- Navigate to
File>Export>Unreal PSA (.psa). - Enter the file name and click
Export.
- Select an armature that you want import animations for.
- Navigate to
File>Import>Unreal PSA (.psa). - Select the PSA file you want to import.
- Select the sequences that you want to import and click
Import.
Note that in order to see the imported actions applied to your armature, you must use the Dope Sheet or Nonlinear Animation editors.
Simply importing an animation into the scene will not automatically apply the action to the armature. This is in part because a PSA can have multiple sequences imported from it, and also that it's generally bad form for importers to modify the scene in ways that the user may not expect.
The PSA importer creates Actions for each of the selected sequences in the PSA. These actions can be applied to your armature via the Action Editor or NLA Editor.
The PSK format, unlike other more modern formats, has no explicit or implicit unit system. Each game has its own convention as to what the base distance unit will represent. As such, this addon makes no assumptions as to the unit scale of the imported PSKs. If you think that your models are being imported into Blender either too big or too small, there are a couple ways to remedy this.
The method I prefer is to simply change the Blender scene properties to match the unit system and scale for the game you're using. This is non-destructive and ensures that the unit scaling of any PSK or PSA exports from Blender will match the source file from which it was derived.
The second option is to simply change the Scale value on the PSK import dialog. This will scale the armature by the factor provided. Note that this is more destructive, but may be preferable if you don't intend on exporting PSKs or PSAs to a game engine.
The PSK format does not support vertex normals and instead uses smoothing groups to control shading. Note that a mesh's Custom Split Normals Data will be ignored when exporting to PSK. Therefore, the best way to control shading is to use sharp edges and the Edge Split modifier.
Why are the mesh normals not accurate when importing a PSK extracted from UE Viewer?
If preserving the mesh normals of models is important for your workflow, it is not recommended to export PSK files from UE Viewer. This is because UE Viewer makes no attempt to reconstruct the original smoothing groups. As a result, the normals of imported PSK files will be incorrect when imported into Blender and will need to be manually fixed.
There is a pull request to add support for exporting explicit normals from UE Viewer, although UEViewer's maintainer has seemingly abandoned the project.
Below is a table of the latest addon versions that are compatible with older versions of Blender. These versions are no longer maintained and may contain bugs that have been fixed in newer versions. It is recommended to use the latest version of the addon for the best experience.
| Blender Version | Addon Version |
|---|---|
| 4.1 | 7.0.0 |
| 4.0 | 6.2.1 |
| 3.4 - 3.6 | 5.0.6 |
| 2.93 - 3.3 | 4.3.0 |
To execute the automated tests, run:
./test.sh
This will create a Docker container with and run the tests inside it. The tests are executed using pytest and the results will be displayed in the terminal.
For now, the tests are not exhaustive and primarily focus on sanity checking the most common use cases (PSK & PSA import). New tests will likely be made to cover new features and prevent further regressions of reported issues.
