1
0
mirror of https://github.com/DarklightGames/io_scene_psk_psa.git synced 2024-11-23 22:40:59 +01:00
A Blender plugin for importing and exporting Unreal PSK and PSA files
Go to file
Colin Basnett f185ffbe16 Fixed a bug where the importer would crash when importing PSA files from programs using CUE4Parse (#46)
This is not actually a bug in this addon, but a bug with the CUE4Parse library itself. A fix for the library has been submitted (https://github.com/FabianFG/CUE4Parse/issues/103), but there will still be bugged versions hanging around for a while, so it's prudent to have this addon accomodate the broken files, especially since the fix is relatively easy and won't interfere with properly formatted files.

At some point, this fix will be deprecated to reduce cruft.
2023-09-09 18:24:38 -07:00
.github Create FUNDING.yml 2022-01-23 00:20:36 -08:00
io_scene_psk_psa Fixed a bug where the importer would crash when importing PSA files from programs using CUE4Parse (#46) 2023-09-09 18:24:38 -07:00
.gitignore PSA exports now work! 2019-12-11 10:25:31 -08:00
build.py Excluded the build files and script from the package 2023-08-04 17:03:40 -07:00
LICENSE Initial commit 2019-11-28 23:57:05 -08:00
README.md Update README.md 2023-07-10 00:24:11 -07:00

Blender GitHub release

ko-fi

This Blender add-on 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.

Note

: This addon requires Blender 3.4+. If this is not available to you, install version 4.3.0, as it has a minimum Blender version of 2.9, but is no longer receiving new features.

Features

  • Full PSK/PSA import and export capabilities.
  • Non-standard file section data 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, sequence name) is preserved on import, allowing this data to be reused on export.
  • Specific bone groups 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, allowing direct use of the NLA when creating sequences.
  • Manual re-ordering of material slots when exporting multiple mesh objects.

Installation

  1. Download the zip file for the latest version from the releases page.
  2. Open Blender 3.4.0 or later.
  3. Navigate to the Blender Preferences (Edit > Preferences).
  4. Select the Add-ons tab.
  5. Click the Install... button.
  6. Select the .zip file that you downloaded earlier and click Install Add-on.
  7. Enable the newly added Import-Export: PSK/PSA Importer/Exporter addon.

Usage

Exporting a PSK

  1. Select the mesh objects you wish to export.
  2. Navigate to File > Export > Unreal PSK (.psk).
  3. Enter the file name and click Export.

Importing a PSK/PSKX

  1. Navigate to File > Import > Unreal PSK (.psk/.pskx).
  2. Select the PSK file you want to import and click Import.

Exporting a PSA

  1. Select the armature objects you wish to export.
  2. Navigate to File > Export > Unreal PSA (.psa).
  3. Enter the file name and click Export.

Importing a PSA

  1. Select an armature that you want import animations for.
  2. Navigate to File > Import > Unreal PSA (.psa).
  3. Select the PSA file you want to import.
  4. Select the sequences that you want to import and click Import.

FAQ

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.

As a workaround, it is recommended to export glTF meshes out of UE Viewer instead, since the glTF format has support for explicit normals and UE Viewer can correctly preserve the mesh normals on export. Note, however, that the imported glTF armature may have it's bones oriented incorrectly when imported into Blender. To mitigate this, you can combine the armature of PSK and the mesh of the glTF for best results.