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.

0.7.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.

0.6.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.

0.5.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. Move xc1.json, xc2.json, and xc3.json into the appropriate extracted folder containing the executables for convenience. 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. The provided JSON files do not include any DLC data, so users wanting to work with DLC files should generate their own database using xc3_shader following the instructions on the development page.

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 tools 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.

0.4.1

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. Move xc1.json, xc2.json, and xc3.json into the appropriate extracted folder containing the executables for convenience. 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. The provided JSON files do not include any DLC data, so users wanting to work with DLC files should generate their own database using xc3_shader following the instructions on the development page.

This versions adds support for replacing wimdo and wismt images. This feature and wilay image replacement are experimental, so please report any bugs in issues.

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 tools 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.

0.3.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. Move xc1.json, xc2.json, and xc3.json into the appropriate extracted folder containing the executables for convenience. 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. The provided JSON files do not include any DLC data, so users wanting to work with DLC files should generate their own database using xc3_shader following the instructions on the development page.

This versions adds support for editing wilay images. This feature is experimental, so please report any bugs in issues.

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.

Note that a small amount of debug code accidentally made it into the release build. Please ignore the "mxmd.txt" file that is generated by running some commands.

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 tools 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.

0.2.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. Move xc1.json, xc2.json, and xc3.json into the appropriate extracted folder containing the executables for convenience. 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. The provided JSON files do not include any DLC data, so users wanting to work with DLC files should generate their own database using xc3_shader following the instructions on the development page.

Run any of the executables with the --help flag to display usage information. Some example commands are listed below.

xc3_gltf "Xeno 2 Dump\map\ma02a.wismhd" export\map.gltf xc2.json
xc3_gltf "Xeno 3 Dump\chr\ch\ch01027000.wimdo" export\model.gltf xc3.json

xc3_tex "Xeno 3 Dump\chr\tex\nx\m\00a57332.wismt" out.dds
xc3_tex in.dds out.wismt

xc3_viewer "Xeno 2 Dump\map\ma02a.wismhd" xc2.json
xc3_viewer "Xeno 3 Dump\chr\ch\ch01027000.wimdo" xc3.json
xc3_viewer "Xeno 3 Dump\chr\ch\ch01027000.wimdo" xc3.json "Xeno 3 Dump\chr\ch\ch01027000_event.mot" 1

xc3_shader --help

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 tools 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.

0.1.0-alpha

xc3_lib

The initial release for the command line tools for xc3_lib. This is an experimental alpha release, so there will be bugs! Please report any issues by submitting an issue.

See the development documentation for how to build and run the latest version from source with new fixes. These programs are primarily intended as development tools, so some features may not be documented outside of the source code. This should hopefully be improved in future releases.

Usage

Those programs are command line applications, so they must be run from a terminal like command prompt (cmd) or powershell. Some applications support drag and dropping the file like xc3_tex. It's strongly recommended to specify the additional arguments using a terminal. Run any of the executables with the --help flag to display usage information. Some example commands are listed below. Make sure to use the right JSON file for the game version. Not specifying the JSON file argument will result in less accurate texture channel handling and rendering.

xc3_gltf "Xeno 2 Dump\map\ma02a.wismhd" export\map.gltf xc2.json
xc3_gltf "Xeno 3 Dump\chr\ch\ch01027000.wimdo" export\model.gltf xc3.json

xc3_tex "Xeno 3 Dump\chr\tex\nx\m\00a57332.wismt" out.dds
xc3_tex in.dds out.wismt

xc3_viewer "Xeno 2 Dump\map\ma02a.wismhd" xc2.json
xc3_viewer "Xeno 3 Dump\chr\ch\ch01027000.wimdo" xc3.json
xc3_viewer "Xeno 3 Dump\chr\ch\ch01027000.wimdo" xc3.json "Xeno 3 Dump\chr\ch\ch01027000_event.mot" 1

xc3_shader --help

Installation

Check the steps below for your operating system if the application still fails to launch properly. Users for MacOS and Linux can compile from source following the building instructions.

Windows Installation Instructions

xc3_lib tools 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.