diff --git a/README.md b/README.md index 63f87dd..e3cacb6 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,9 @@ -This Blender 2.80+ add-on allows you to import and export meshes and animations to and from the [PSK and PSA file formats](https://wiki.beyondunreal.com/PSK_%26_PSA_file_formats) used in many version of the Unreal Engine. +[![Blender](https://img.shields.io/badge/Blender->=3.4-blue?logo=blender&logoColor=white)](https://www.blender.org/download/ "Download Blender") +[![GitHub release](https://img.shields.io/github/release/DarklightGames/io_scene_psk_psa?include_prereleases=&sort=semver&color=blue)](https://github.com/DarklightGames/io_scene_psk_psa/releases/) + +This Blender add-on allows you to import and export meshes and animations to and from the [PSK and PSA file formats](https://wiki.beyondunreal.com/PSK_%26_PSA_file_formats) used in many version of the Unreal Engine. + +> **NOTE**: This addon requires Blender 3.4+. If this is not available to you, install version [4.2.0](https://github.com/DarklightGames/io_scene_psk_psa/releases/tag/4.2.0), as it has a minimum Blender version of 2.8. # Features * Full PSK/PSA import and export capabilities @@ -11,36 +16,33 @@ This Blender 2.80+ add-on allows you to import and export meshes and animations # Installation 1. Download the zip file for the latest version from the [releases](https://github.com/DarklightGames/io_export_psk_psa/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. +2. Open Blender. +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. -3. Navigate to File > Export > Unreal PSK (.psk) -4. Enter the file name and click "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" +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". +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". +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](https://www.gildor.org/en/projects/umodel)?