Physis

Physis is a library for reading and writing FFXIV data.

Features

Here is a list of supported formats and their status:

File Format	Read	Write	Note
Configuration files	✅	✅
Saved character data	✅	✅
Chara make params	✅	❌
Dictionaries	✅	❌
Excel data	✅	❌
File infos	✅	✅
Map layers	✅	❌	Layer support isn't well tested yet.
Chat logs	✅	❌	Not all chat categories are discovered yet.
Models	✅	✅	Adding custom shape keys aren't fully supported yet.
Materials	✅	❌
Patch files	✅	~	ZiPatch writing support is currently being worked on, but many operations are not yet implemented.
Pre bone deformers	✅	❌
Shader packages	✅	❌
Skeletons	✅	❌
Terrain	✅	❌
Textures	✅	❌	Only some formats are supported.

Physis also supports doing some other useful things other than reading and writing file formats:

• Extract game data from SqPack files, and list file hashes from index/index2.
• Apply game patches. Indexed ZiPatch is not yet supported, though.
• Blockfish ciphers for encrypting and decrypting SqexArg.
• Construct paths to equipment, items, faces, and other useful models.
• Extract strings from executables.

Supported Game Versions

Version	Works	Note
A Realm Reborn (2.x)	???	Have yet to test.
Heavensward (3.x)	???	Have yet to test.
Stormblood (4.x)	???	Have yet to test.
Shadowbringers (5.x)	✅
Endwalker (6.x)	✅
Dawntrail (7.x)	✅	Visual formats (models, materials, etc) by Physis crashes the 7.x retail client.

Only Windows versions of the game is supported at the moment. Only the latest version in a patch series is supported, but benchmarks for the expansion should be supported.

Usage

If you want to use Physis in your Rust project, you can simply add it as a dependency in Cargo.toml:

[dependencies]
physis = "0.4"

Documentation is available online at docs.xiv.zone. It's automatically updated as new commits are pushed to the main branch.

C# projects can use PhysisSharp which exposes Physis in C#.

C/C++ projects (or anything that can interface with C libraries) can use libphysis.

Building

You need to set up Rust and then run cargo build. Although Physis is a library, we have a few examples you can run.

Contributing & Support

Feel free to submit patches to help fix bugs or add functionality. Filing issues is appreciated, but I do this in my free time so please don't expect professional support.

See CONTRIBUTING for more information about the project.

Credits & Thank You

• goatcorp (XIVQuickLauncher, docs.xiv.dev, and even more)
• Ioncannon (FFXIV Data Explorer) for the first documenting the file formats
• binrw team for an awesome Rust library!
• sha1-smol for a dependency-free SHA1 implementation
• FFXIVTools for it's Havok parsing implementation
• texture2ddecoder for it's BCn texture decoding functions.

And everyone else who writes FFXIV tools!

License

This project is licensed under the GNU General Public License 3. Some parts of the code or assets may be licensed differently, refer to the REUSE metadata.