Cool_Tools/io_scene_psk_psa
1
0
Fork 0
mirror of https://github.com/DarklightGames/io_scene_psk_psa.git synced 2024-09-23 18:48:26 +02:00
Code
A Blender plugin for importing and exporting Unreal PSK and PSA files
102 Commits 17 Branches 30 Tags 988 KiB
Python 100%
feature-original-sequence-names
Go to file
Colin Basnett 1eafb71dce * Fixed a bug where the action name prefix could be applied even if the checkbox was deselected 
* Fixed a typo in the PSA reader
* Added the ability to define the bone length of imported PSK armatures
* The PSK import options (extra UVs, vertex colors etc.) are now actually respected if turned off
* Ran automated formatting on all the code to quell the PEP8 gods
* Incremented version to 3.0.0
2022-04-24 22:08:36 -07:00
.github Create FUNDING.yml 2022-01-23 00:20:36 -08:00
io_scene_psk_psa * Fixed a bug where the action name prefix could be applied even if the checkbox was deselected 2022-04-24 22:08:36 -07:00
.gitignore PSA exports now work! 2019-12-11 10:25:31 -08:00
LICENSE Initial commit 2019-11-28 23:57:05 -08:00
README.md Merge remote-tracking branch 'origin/master' 2022-01-27 18:26:24 -08:00

README.md

This Blender add-on allows you to import and export meshes and animations to and from the PSK and PSA file formats. In addition, the non-standard PSKX format is also supported for import only.

Installation

  1. Download the zip file for the latest version from the releases page.
  2. Open Blender 2.80 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 the armature object that you wish you import actions to.
  2. Navigate to the Object Data Properties tab of the Properties editor.
  3. Navigate to the PSA Import panel.
  4. Click "Select PSA File".
  5. Select the PSA file that you want to import animations from and click "Select".
  6. In the Actions box, select which animations you want to import.
  7. 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.