XB2AssetTool

A rewrite of XBC2ModelDecomp in C++ using the Qt UI library for UI, aiming for performance, cross platform compatibility, and code reuse (by way of moving all of the logic to a library anyone can import).

Features

• Dump models (including bones and flexes) to glTF
• Dump maps (including props) to glTF
• Save specified LOD values for both props and maps
• Dump all textures from files (including mesh textures/main chunk textures)
• Dumps uncompressed raw files and animations for research

Thanks to

PredatorCZ/Lukas Cone - 3DSMax Xenoblade Import Tools

Thealexbarney - XbTool (Texture swizzling implmentation)

Turk645 - Map format & ideas

Running

Simply run the executable, and pick an input file. An output folder will be created in the path you choose your file(s) in, but you can override this by picking a output folder manually. Each file will have its own folder in the output folder. Then, configure your output settings at the bottom and hit Extract. The file should export to the output path in the format you chose.

Compiling

Refer to BUILDING.md for how to build XB2AssetTool.

Using the xb2core library in your own projects

XB2AssetTool's source code layout is designed to allow other developers to use the core code driving it in your own projects. Here's how!

First and foremost, if you're using Git for your source control, you can include the XB2AssetTool code in a safe way by doing:

cd path/to/3rdparty/
git submodule add https://github.com/BlockBuilder57/XB2AssetTool.git

This will (unlike every other solution, even dumb unneeded hacks like git-repo) not clutter your project's history with useless changes, and can be updated easily by simply doing git pull.

You can include the XB2AssetTool source code in your project like so, so that you only get xb2core (and configure xb2core to your liking).

set(XB2AT_XB2CORE_ONLY ON)
# Optional if you want to use the Easymode API:
#set(XB2AT_XB2CORE_EASYMODE ON)
add_subdirectory(path/to/3rdparty/XB2AssetTool)

Thanks to CMake, this one line is all you need in order for everything like include path and dependencies to be set up in your project:

target_link_libraries(MyCoolProject xb2core)

Doxygen generated documentation packages will be available soon.