ssbucarlos / smash-ultimate-blender

Blender Plugin containing utilities for Smash Ultimate Models and Animations.
45 stars 9 forks source link

smash-ultimate-blender

wiki

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

Key Features

  1. Import/Export of Model, Material, Texture, Animation, and Swing files
    • Model Files: .numdlb, .numshb, .nusktb, .nuhlpb, update.prc, .numeshexb, .adjb
    • Material & Texture Files: .numatb, .nutexb
    • Animation Files: .nuanmb
    • Swing Files: swing.prc
  2. Tools for creating a "Magic Exo Skel" for real-time animation retargeting in-game.
    • UI panel for step-by-step creation
    • Modifier setup for previewing real-time retargeting pre-export
  3. Extra QOL Features for Animators
    • Import/Export Camera .nuanmb
    • Drivers for previewing Visibilty and Material data in animation files.
    • UI Panels for easily editing Visiblity and Material data in animation files.
    • Modal Operator for intuitively editing Characters eyes in 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!

    image

  5. Click on the 'Ultimate' tab.

    image

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

Uninstalling / Updating

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.

Useful Tools

Special Thanks