Skip to content

Blender addon for importing Xenoblade models, maps, and animations

License

Notifications You must be signed in to change notification settings

ScanMountGoat/xenoblade_blender

Repository files navigation

xenoblade_blender GitHub release (latest by date including pre-releases) wiki

A Blender addon for importing models, maps, and animations for Xenoblade Chronicles X, Xenoblade Chronicles 1 DE, Xenoblade Chronicles 2, and Xenoblade Chronicles 3.

Report bugs or request new features in issues. Download the latest version from releases. Check the wiki for more usage information.

Features

  • Faster and more accurate than intermediate formats like FBX or glTF
  • Import characters, objects, enemies, and weapon models from .wimdo and .camdo files
  • Import maps from .wismhd files
  • Import character animations from .mot files
  • Decoded and embedded RGBA textures for easier use in Blender
  • Material parameters, textures, and texture channel assignments based on decompiled in game shader code
  • Export .wimdo models using an existing model as a base (WIP)

Getting Started

  • Download the latest version of the addon supported by your Blender version from releases.
  • Install the .zip file in Blender using Edit > Preferences > Addons > Install...
  • Enable the addon if it is not already enabled.
  • Extract the files from the arh and ard from your romfs dump of the game using XbTool.
  • Import any of the supported file types using the new menu options under File > Import.
    Select the game version before importing for correct material texture assignments.

Updating

Update the addon by reinstalling the latest version from releases. Windows users will need to disable the previous version of the addon, restart Blender, remove the addon, and then install the new version's zip file to properly upgrade. MacOS and Linux users can reinstall the addon without any additional steps.

Building

Clone the repository with git clone https://github.com/ScanMountGoat/xenoblade_blender --recursive.

xenoblade_blender uses xc3_model_py for simplifying the addon code and achieving better performance than pure Python addons.

xc3_model_py must be compiled from source after installing Rust. See development for details.