baharyazici / smash-ultimate-blender

Blender Plugin containing utilities for Smash Ultimate Models and Animations.

smash-ultimate-blender

Blender Plugin that contains utilities for Smash Ultimate models and animations.

Installation

Check the wiki for tutorials and usage instructions.

1. Select a version

• For the latest version, click the green Code button and select Download ZIP.
• For a specific version, check the "Releases" page.

2. Install the .ZIP in Blender under Edit > Preferences > Addons > Install.
3. Make sure the addon is enabled by searching for "Smash Ultimate".
4. After installing the plugin in blender, in the 3D Viewport pull up the Sidebar (Hotkey is 'N'), and look for the new 'Ultimate' tab in the Sidebar. If the addon panel doesn't show up, make sure you are in object mode!
   

System Requirements

The plugin supports 64-bit versions of Blender 4.0 or later for Windows, Linux, and MacOS. Apple machines with M1 processors are also supported. If your computer can run a supported version of Blender but fails to install the plugin, please make an issue in issues.

Legacy Blender Version Support

• Check the releases page for older versions of the plugin that work for the legacy blender version.
• This started with 3.6 LTS, older versions of blender require digging through the commit history and finding a really old version that worked with that old blender version.

Uninstalling / Updating (Please Read!)

TO REMOVE: First "Disable" the plugin, then restart blender, then you can hit "Remove" to uninstall. Then you can install the newest version.

In case of problems?

1. Export Issues? Please go read the export issues wiki page and see if your issue gets fixed, if not...
2. Please read the wiki to see if that issue is mentioned in the List of Known Issues wiki page, if not...
3. Please go add a new issue in the Issues page so the issue can be tracked.

Current Features

1. Creates the .NUSKTB and .NUHLPB needed for real-time animation retargeting on custom models.
2. .NUMDLB, .NUMSHB, .NUSKTB, .NUMATB, .NUMSHEXB, .NUANMB Import And Export

Planned Features

1. Swing bone visualization

Useful Tools

• SSBH Editor (view models and animations and edit materials) https://github.com/ScanMountGoat/ssbh_editor
• Ultimate Tex (batch convert .NUTEXB to .PNG on Windows, MacOS, or Linux) https://github.com/ScanMountGoat/ultimate_tex
• Switch Toolbox (to convert .NUTEXB to .PNG on Windows) https://github.com/KillzXGaming/Switch-Toolbox

Special Thanks

• SMG for creating SSBH_DATA_PY, which without it none of this would be possible https://github.com/ScanMountGoat/ssbh_data_py (and also for providing alot of the reference code for how to use the library, most of which was shamelessly stolen and implemented here) (and also for making CrossMod which was a great reference for how smash ultimate shaders work, from the CrossMod render code certain details such as which step of the shading process do vertex colors get factored in was used)
• The Rokoko plugin https://github.com/Rokoko/rokoko-studio-live-blender for being the reference used for the UI code used in this project.