Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/uyjulian/ed8pkg2glb

Conversion tool from ED8 / 閃の軌跡 / Sen no Kiseki / Trails of Cold Steel pkg file to glb file
https://github.com/uyjulian/ed8pkg2glb

Last synced: 7 days ago
JSON representation

Conversion tool from ED8 / 閃の軌跡 / Sen no Kiseki / Trails of Cold Steel pkg file to glb file

Awesome Lists containing this project

README 

        
# 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](https://github.com/Trails-Research-Group) for more resources to assist in modding the game.  



## Usage



First, download and extract the [Win32 version](https://github.com/uyjulian/ed8pkg2glb/releases/latest/download/ed8pkg2glb-win32.zip).  

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](https://www.blender.org/).  

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](https://www.blender.org/) without any conversion needed.  



## Compatibility



### Game support



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

* 英雄伝説: 閃の軌跡 / Eiyuu Densetsu: Sen no Kiseki / The Legend of Heroes: Trails of Cold Steel / ED81

* 英雄伝説: 閃の軌跡 II / Eiyuu Densetsu: Sen no Kiseki II / The Legend of Heroes: Trails of Cold Steel II / ED82

* 英雄伝説: 閃の軌跡 III / Eiyuu Densetsu: Sen no Kiseki III / The Legend of Heroes: Trails of Cold Steel III / ED83

* 英雄伝説: 閃の軌跡 IV / Eiyuu Densetsu: Sen no Kiseki IV / The Legend of Heroes: Trails of Cold Steel IV / ED84

* 英雄伝説: 創の軌跡 / Eiyuu Densetsu: Hajimari no Kiseki / The Legend of Heroes: Trails into Reverie / ED85

* 東亰ザナドゥ / Tokyo Xanadu / TX



### 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](https://vrchat.com/home/user/usr_f261268d-87ad-4281-94c0-33cb5085195b) using a tool based on ed8pkg2glb.  



## License



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