uyjulian / ed8pkg2glb

Conversion tool from ED8 / 閃の軌跡 / Sen no Kiseki / Trails of Cold Steel pkg file to glb file
MIT License
10 stars 1 forks source link

ed8pkg2glb

Converts model data and texture data contained in ED8 .pkg files to GLTF binary format and/or PNG binary format.

Modding help and resources

See Trails Research Group for more resources to assist in modding the game.

Usage

First, download and extract the Win32 version.
Afterwards, drag and drop a single .pkg file onto the executable ed8pkg2glb.exe.
.glb or (not and) .png files will be output in the same directory as .pkg.

Output file information

The .glb file can be imported in Blender.
Compatibility with other applications is not guaranteed due to the output file not completely adhering to the GLTF specification.
Due to the fact that the game uses shaders for manipulating the pixel output, the output result may not look exactly as in the game, and not all textures will be mapped to glTF materials.

The .png file is always output in compressed RGBA format. It is loadable in Blender without any conversion needed.

Compatibility

Game support

The following games are known to be compatible with this program:

Platform support

Vita PS3 PS4 PS5 PC Switch
ED81 4 2 2 1 3
ED82 4 2 2 1 3
ED83 2 1 3
ED84 2 1 3
ED85 2 1 3
TX 4 2 1 3

Tier 1

The files from this platform are tested before each release and are known working and produce the correct output.

Tier 2

The files from this platform are known working and produce the correct output.

Tier 3

The files from this platform are known working, but may not produce the correct output.

Tier 4

Some or all files from this platform are known to not work.

Locating .pkg files from the game

Steam

Open Steam, select the "Library" tab, select the targeted game from the left hand side bar, click on the gear icon (Manage) on the right, then go to "Manage->Browse local files".
A file browser window will open showing the files related to the game. If you do not see any .pkg files, see the section "Extracting a .pkg file from an outer archive" for details on extracting .pkg files.

Extracting a .pkg file from an outer archive

PSARC (PS3/PSVita/PS4)

For PS3 and PSVita, please visit the following page: https://www.psdevwiki.com/ps3/PlayStation_archive_(PSARC)
For PS4, you will need to use the orbis-psarc tool. This utility can be found easily using a search engine.

BRA (PC)

The following program can be used for this purpose: https://heroesoflegend.org/forums/viewtopic.php?t=356

PKA (PC/Switch)

The following program can be used for this purpose: https://github.com/uyjulian/unpackpka

NSP/XCI/ROMFS (Switch)

The following program can be used for this purpose: https://github.com/SciresM/hactool

PKG (PS3)

Use RPCS3 to install the game, then look in dev_hdd0/game/ for the decrypted contents.

PKG (PSVita)

The following programs can be used:
Unpacking the .pkg file: https://github.com/mmozeiko/pkg2zip
Decrypting the unpacked contents: https://github.com/motoharu-gosuto/psvpfstools

PKG (PS4)

You will need to use the orbis-pub-cmd tool. This utility can be found easily using a search engine.

Credits

The PS4, PS3, and Vita image untiling are adapted from here: https://github.com/xdanieldzd/Scarlet/blob/8c56632eb2968e64b6d6fad14af3758e606a127d/Scarlet/Drawing/ImageBinary.cs#L1256
The PS4 texture information are adapted from here: https://zenhax.com/viewtopic.php?f=7&t=7573
The LZ4 decompression is adapted from here: https://gist.github.com/weigon/43e217e69418875a55b31b1a5c89662d
The nislzss/LZ77 decompression is adapted from here: https://github.com/Sewer56/Sen-no-Kiseki-PKG-Sharp/blob/3a458e201aa946add705c6ed6aa1dd49dce00223/D/source/decompress.d#L50
The DXT1/DXT3/DXT5/BC5/BC7 decompression is adapted from here: https://github.com/python-pillow/Pillow/blob/78d258f24d1b6a605754af9f8ac57b665543e8b9/src/libImaging/BcnDecode.c
This project uses the python-zstandard library: https://github.com/indygreg/python-zstandard
Huge thanks to PMONickpop123 for assisting with debugging and feature completeness. He has created many VRChat worlds using a tool based on ed8pkg2glb.

License

The program is licensed under the MIT license. Please check LICENSE for more information.