0.8.0

Please report any issues by submitting an issue. See the changelog for a full list of changes in each release. See the development documentation for how to build and run the latest version from source with new fixes.

Usage

Those programs are command line applications, so they must be run from a terminal like command prompt (cmd) or powershell on Windows or terminal on Linux and MacOS. Some applications support drag and dropping the file on Windows like xc3_tex. It's strongly recommended to still specify the additional arguments using a terminal.

Download and extract the shader_database_json.zip file. It's recommended to move xc1.json, xc2.json, and xc3.json into the extracted folder containing the xc3_lib tools to simplify the terminal commands. Make sure to use the right JSON file for the game version when running a command. Not specifying the JSON file argument will result in less accurate texture channel handling and rendering.

Run any of the executables with the --help flag to display help text for supported commands and formats.
See xc3_gltf, xc3_shader, xc3_tex, xc3_viewer, and xc3_wgpu_batch for command line usage information.

Installation

Check the steps below for your operating system if the application still fails to launch properly. Linux users shouldn't need to perform any additional installation steps. Please report any installation issues by making a new issue on github with information on your operating system and CPU architecture.

Windows Installation Instructions

xc3_lib requires the Visual C++ runtime, which can be downloaded from https://aka.ms/vs/17/release/vc_redist.x64.exe. This only needs to be installed once.

Mac OS Installation Instructions

MacOS users with Apple silicon macs should select the build ending in apple_silicon. xc3_lib isn't released through the Apple App Store or signed with an Apple Developer ID. You may see a warning that the application "can't be checked for malicious software". Follow the steps on the apple support page to open and run the application. These steps only need to be done once every time the application is downloaded.