Compare commits
6 Commits
psa-config
...
6.0.0
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b1a6fb9dea | ||
|
|
89767569ec | ||
|
|
b23677f291 | ||
|
|
9fe5aa0388 | ||
|
|
c8e5b8eb47 | ||
|
|
403e9a5cca |
24
README.md
24
README.md
@@ -1,10 +1,20 @@
|
|||||||
[](https://www.blender.org/download/ "Download Blender")
|
[](https://www.blender.org/download/ "Download Blender")
|
||||||
[](https://github.com/DarklightGames/io_scene_psk_psa/releases/)
|
[](https://github.com/DarklightGames/io_scene_psk_psa/releases/)
|
||||||
|
|
||||||
[](https://ko-fi.com/L4L3853VR)
|
[](https://ko-fi.com/L4L3853VR)
|
||||||
|
|
||||||
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 versions of the Unreal Engine.
|
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 versions of the Unreal Engine.
|
||||||
|
|
||||||
|
## Compatibility
|
||||||
|
|
||||||
|
| Blender Version | Addon Version | Long Term Support |
|
||||||
|
|--------------------------------------------------------------|--------------------------------------------------------------------------------|-------------------|
|
||||||
|
| 4.0+ | [latest](https://github.com/DarklightGames/io_scene_psk_psa/releases/latest) | TBD |
|
||||||
|
| [3.4 - 3.6](https://www.blender.org/download/lts/3-6/) | [5.0.5](https://github.com/DarklightGames/io_scene_psk_psa/releases/tag/5.0.5) | ✅️ June 2025 |
|
||||||
|
| [2.93 - 3.3](https://www.blender.org/download/releases/3-3/) | [4.3.0](https://github.com/DarklightGames/io_scene_psk_psa/releases/tag/4.3.0) | ✅️ September 2024 |
|
||||||
|
|
||||||
|
Bug fixes will be issued for legacy addon versions that are under [Blender's LTS maintenance period](https://www.blender.org/download/lts/). Once the LTS period has ended, legacy addon-on versions will no longer be supported by the maintainers of this repository, although we will accept pull requests for bug fixes.
|
||||||
|
|
||||||
# Features
|
# Features
|
||||||
* Full PSK/PSA import and export capabilities.
|
* 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).
|
* Non-standard file section data is supported for import only (vertex normals, extra UV channels, vertex colors, shape keys).
|
||||||
@@ -14,16 +24,6 @@ This Blender add-on allows you to import and export meshes and animations to and
|
|||||||
* PSA sequences can be exported directly from actions or delineated using a scene's [timeline markers](https://docs.blender.org/manual/en/latest/animation/markers.html) or NLA track strips, allowing direct use of the [NLA](https://docs.blender.org/manual/en/latest/editors/nla/index.html) when creating sequences.
|
* PSA sequences can be exported directly from actions or delineated using a scene's [timeline markers](https://docs.blender.org/manual/en/latest/animation/markers.html) or NLA track strips, allowing direct use of the [NLA](https://docs.blender.org/manual/en/latest/editors/nla/index.html) when creating sequences.
|
||||||
* Manual re-ordering of material slots when exporting multiple mesh objects.
|
* Manual re-ordering of material slots when exporting multiple mesh objects.
|
||||||
|
|
||||||
## Compatibility
|
|
||||||
|
|
||||||
| Blender Version | Addon Version | LTS Support |
|
|
||||||
|--------------------------------------------------------------|--------------------------------------------------------------------------------|-------------------|
|
|
||||||
| 4.0+ | [latest](https://github.com/DarklightGames/io_scene_psk_psa/releases/latest) | TBD |
|
|
||||||
| [3.4 - 3.6](https://www.blender.org/download/lts/3-6/) | [5.0.5](https://github.com/DarklightGames/io_scene_psk_psa/releases/tag/5.0.5) | ✅️ June 2025 |
|
|
||||||
| [2.93 - 3.3](https://www.blender.org/download/releases/3-3/) | [4.3.0](https://github.com/DarklightGames/io_scene_psk_psa/releases/tag/4.3.0) | ✅️ September 2024 |
|
|
||||||
|
|
||||||
Bug fixes will be issued for legacy addon versions that are under [Blender's LTS maintenance period](https://www.blender.org/download/lts/). Once the LTS period has ended, legacy addon-on versions will no longer be supported by the maintainers of this repository, although we will accept pull requests for bug fixes.
|
|
||||||
|
|
||||||
# Installation
|
# Installation
|
||||||
1. Download the zip file for the latest version from the [releases](https://github.com/DarklightGames/io_export_psk_psa/releases) page.
|
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 4.0.0 or later.
|
2. Open Blender 4.0.0 or later.
|
||||||
@@ -54,6 +54,8 @@ Bug fixes will be issued for legacy addon versions that are under [Blender's LTS
|
|||||||
3. Select the PSA file you want to import.
|
3. Select the PSA file you want to import.
|
||||||
4. Select the sequences that you want to import and click `Import`.
|
4. 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](https://docs.blender.org/manual/en/latest/editors/dope_sheet/introduction.html) or [Nonlinear Animation](https://docs.blender.org/manual/en/latest/editors/nla/introduction.html) editors.
|
||||||
|
|
||||||
# FAQ
|
# FAQ
|
||||||
## Why are the mesh normals not accurate when importing a PSK extracted from [UE Viewer](https://www.gildor.org/en/projects/umodel)?
|
## Why are the mesh normals not accurate when importing a PSK extracted from [UE Viewer](https://www.gildor.org/en/projects/umodel)?
|
||||||
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](https://en.wikipedia.org/wiki/Smoothing_group). As a result, the normals of imported PSK files will be incorrect when imported into Blender and will need to be manually fixed.
|
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](https://en.wikipedia.org/wiki/Smoothing_group). As a result, the normals of imported PSK files will be incorrect when imported into Blender and will need to be manually fixed.
|
||||||
|
|||||||
@@ -222,12 +222,13 @@ def import_psk(psk: Psk, context, options: PskImportOptions) -> PskImportResult:
|
|||||||
|
|
||||||
# VERTEX NORMALS
|
# VERTEX NORMALS
|
||||||
if psk.has_vertex_normals and options.should_import_vertex_normals:
|
if psk.has_vertex_normals and options.should_import_vertex_normals:
|
||||||
mesh_data.polygons.foreach_set("use_smooth", [True] * len(mesh_data.polygons))
|
mesh_data.polygons.foreach_set('use_smooth', [True] * len(mesh_data.polygons))
|
||||||
normals = []
|
normals = []
|
||||||
for vertex_normal in psk.vertex_normals:
|
for vertex_normal in psk.vertex_normals:
|
||||||
normals.append(tuple(vertex_normal))
|
normals.append(tuple(vertex_normal))
|
||||||
mesh_data.normals_split_custom_set_from_vertices(normals)
|
mesh_data.normals_split_custom_set_from_vertices(normals)
|
||||||
mesh_data.use_auto_smooth = True
|
else:
|
||||||
|
mesh_data.shade_smooth()
|
||||||
|
|
||||||
bm.normal_update()
|
bm.normal_update()
|
||||||
bm.free()
|
bm.free()
|
||||||
|
|||||||
Reference in New Issue
Block a user