Skip to content

Xenoblade Chronicles file format and rendering libraries

License

Notifications You must be signed in to change notification settings

ScanMountGoat/xc3_lib

Repository files navigation

xc3_lib GitHub release (latest by date including pre-releases)

Rust libraries and tools for working with rendering related file formats for Xenoblade Chronicles X, Xenoblade Chronicles 1 DE, Xenoblade Chronicles 2, and Xenoblade Chronicles 3.

Report any bugs or request new features in issues. Download precompiled binaries for the tools in releases. Python bindings for xc3_model are available with xc3_model_py. See the xenoblade rendering research website for information on topics related to in game rendering.

Formats

xc3_lib supports a number of in game formats. All formats support reading. Write support is still a WIP for some formats. Click on the links to open the corresponding Rust module in xc3_lib. Extensions starting with wi are for the Switch like wimdo or wismt. Extensions starting with pc are for PC builds like pcmdo or pcsmt. Extensions starting with ca are for the Wii U like camdo or casmt.

Format Magic Extensions Write
Apmd DMPA wimdo ✔️
Bc BC anm, motstm_data ✔️*
Beb beb ✔️
Beh hdev beh
Bmn BMN bmn
Dhal LAHD wilay ✔️*
Eva eva eva ✔️*
Fnt fnt ✔️
Laft LAFT wifnt ✔️
Lagp LAGP wilay ✔️*
Laps LAPS wilay ✔️*
Last LAST wisty ✔️
Ltpc LTPC ✔️
Mibl LBIM witex, witx ✔️
Msmd DMSM wismhd
Msrd DRSM wismt ✔️*
Mtxt MTXT catex, calut, caavp ✔️
Mxmd DMXM wimdo ✔️*
MxmdLegacy MXMD camdo
Sar1 1RAS arc, chr, mot ✔️
Spch HCPS wishp ✔️
Xbc1 xbc1 wismt ✔️

* Some files are not binary identical with the originals after saving.

Projects

See Architecture for a design overview of the various projects. Click on the docs.rs links below to see the generated rustdoc documentation.

Libraries

  • Crates.io docs.rs - file format library
  • Crates.io docs.rs - higher level API for xc3_lib
  • Crates.io docs.rs - model and map renderer
  • Crates.io docs.rs - binary writing and layout

Binaries

  • xc3_gltf - convert models and maps to glTF
  • xc3_test - test against files in an extracted dump
  • xc3_tex - convert textures to and from common formats and replace textures in wilay and wimdo files
  • xc3_viewer - simple model viewer for testing xc3_wgpu
  • xc3_wgpu_batch - batch render models and maps to PNG

Building

After installing the Rust toolchain, run cargo build --release in the repository directory to build the tools to target/release. Running cargo build without the --release will result in faster compile times during development but dramatically worse runtime performance. The tools can also be run using cargo run --release -p <project> <args>. xc3_tex uses image_dds, which supports Windows x86, Linux x86, MacOS x86, and MacOS Apple Silicon due to using precompiled kernels for DDS encoding. Other projects should build on other platforms without issues.

Credits

This project is based on previous reverse engineering work, including work done for Xenoblade X and Xenoblade 2. Special thanks go to members of the World Tree Research discord (formerly the World of Alrest discord) for their assistance.