FF16Tools

Tools for Final Fantasy XVI / 16.

Features

• .pac Unpacker/Repacker
• .tex to .png conversion
• Nex .nxd conversion
• Planned: Automatic Mod Manager

This has been tested on Final Fantasy 16 Demo (Steam/PC) files.

Usage

Get the latest version in Releases.

Pac File

• Unpacking all files: FF16Tools.CLI unpack-all -i <path_to_pac> [-o <output_directory>]
• Unpacking a specific file: FF16Tools.CLI unpack -i <path_to_pac> -f <game_file> [-o <output_directory>]
• Pack a directory into a .pac: FF16Tools.CLI pack -i <path_to_directory> [-o <output_directory>]
• Listing files: FF16Tools.CLI list-files -i <path_to_pac>

Textures

• Converting .tex to .png: Drag-drop files/folders or FF16Tools.CLI tex-conv -i <path>

Warning

• 3D textures are not yet supported.
• Textures using R32G32_UINT and R10G10B10A2_UNORM formats are not yet supported.
• Textures using BC6 (HDR) are not yet supported.
• Currently converts only to .png.

Nex (NXD)

• To SQLite: nxd-to-sqlite -i <path to directory> [-o output sqlite file]
• From SQLite: sqlite-to-nxd -i <path to sqlite file> [-t <table_list> -o <output_directory>]

Note

• When converting from SQLite to Nex, you can provide a table list to avoid converting all the tables if not needed.
• Use a SQLite database editor/viewer such as SQLiteStudio.
• Refer to the table layouts here for the column value types. Note: this has been mapped mostly manually. Please contribute if something is amiss or you have figured out the column names.
• Nex can contain nested data, therefore arrays and other structs are converted to json strings.
• Nex can contain row sets that don't actually contain any rows. This information is lost between SQLite conversion, but should hopefully not matter.
• You may need to edit root.nxl from 0001 to reflect the number of rows (if you've added/removed any).

Modding

Note

You may choose to rebuild a .pac entirely, or preferably you can use .diff.pac files.

When packing an extracted folder, the output pack file should have .diff in its name. The game will load this file.

So if your files came from 0000.pac, the new pac file should be 0000.diff.pac.

Important

You only have to include files you want to edit, not ALL the files from the original .pac.

If the extracted archive had a .path file, it should be present when packing.

If you are editing any of the language files (like 0001.en.pac), you should have 0001.diff.pac AND 0001.diff.en.pac. if you don't have the first one, the second one won't load. If you don't need to edit the first one, just copy it and rename it.

Extra Notes

Each pack file can contain a general embedded folder name. This is the case for 0001.pac, or nested packs inside 0000.pac.

For instance, 0001.pac has nxd has its embedded folder name. Which means that every file in that pack is inside a folder named nxd. Example: ability.nxd becomes nxd/ability.nxd

This can be tricky to handle, so the unpacker creates a .path file with the name of the folder.

The packer picks the path from this file accordingly. It can also be set manually with the --name argument, if needed.

Building

Requires .NET 8.0 (VS2022), Windows, DirectStorage support.

Format Documentation

• 010 Editor Templates
• C# Classes

Roadmap

• Support .nxd files - export/import from SQLite (let's not use excel like they did.)
• Return building/unpack progress
• Expose lib as a NuGet Package (for package consumption from i.e mod managers)
• Find a GDeflate library that actually works cross-platform

Acknowledgements

Vortice.Windows for having a usable DirectStorage wrapper/API.

• GisDeflate would break on a certain file (also doesn't have span interfaces),
• Silk.NET has 0 documentation, and would return obtuse windows errors such as 0x8004001 (not implemented). Very useful!

---

• Nenkai - Reverse-Engineering, Unpack/Packing
• frostbone25 GUI Version of the Unpack tool (thanks!)
• yretenai - Information on the file structure

License

MIT License. Make sure to credit if you reuse this!