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.

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.