Skip to content

Releases: Ploaj/SSBHLib

SSBHLib

12 Jul 14:36
@ScanMountGoat ScanMountGoat
v0.22
9ffb271
Compare
Choose a tag to compare
SSBHLib Pre-release
Pre-release

Cross Mod (outdated)

A Smash Ultimate model viewer with a material editor for numatb files.

SSBHLib and its related libraries are no longer being maintained and have been replaced by ssbh_lib. Cross Mod Gui has been replaced by ssbh_editor.

Installation

Download and install the Microsoft .NET Core 3.1 runtime if you haven't already. If you don't have .NET Core 3.1 installed and try to run the program, it should also prompt you to download it. Make sure to install the version to run desktop apps and select x64.
https://dotnet.microsoft.com/download/dotnet-core/3.1/runtime/?utm_source=getdotnetcore&utm_medium=referral

If the program still fails to launch after correctly installing the x64 desktop runtime for .NET Core, make sure that the Visual C++ 2015 runtime is installed. The installer can be downloaded from here: https://www.microsoft.com/en-us/download/details.aspx?id=52685. Make sure to select the 64-bit option. If the program still fails to launch, feel free to open an issue.

How to edit materials

  1. Open the folder containing the model.numdlb, model.numatb, nutexb, etc.
  2. Click the model.numdlb to display the model in the viewport.
  3. Click Menu > Material Editor.
  4. Select a Matl and then a material from the drop down menus. Any changes you make will appear in the viewport in real time.
  5. In the material editor, click File > Export Matl and pick a location to save the currently selected Matl file to save any changes.

Update Notes

See the changelog for release notes for previous versions.

  • Fixed an issue where mesh object names failed to display in the material editor for missing attributes.
  • Improved rendering accuracy by toggling alpha testing based on the current shader label. This uses a heuristic based on decompiled shader code and may not always be accurate.
  • Added a readonly checkbox for whether a material might use alpha testing to the material editor.

Mat Lab

A command line tool for converting between XML and numatb. Material editing features not supported by Cross Mod can be done with editing the XML files generated by MatLab.
XML files can be edited in any text editor. VSCode, Atom, or Notepad++ are recommended for syntax highlighting and other features.
MatLab.exe updated 8/24/2021 to fix missing dependencies when trying to run the exe file

Windows

  1. Drag the numatb file onto MatLab.exe
  2. Edit the XML file
  3. Drag the edited XML file onto MatLab.exe to generate a new numatb.

Linux

The provided exe is Windows only, so you will need to build MatLab from source with dotnet build
Open a terminal and run the following command. Make sure the dotnet core 3.1 runtime is installed.
dotnet MatLab.dll <Input File> <Output File>

NuanmbToJson.exe has been removed. Please use ssbh_data_json.exe instead which can be downloaded from https://github.com/ultimate-research/ssbh_lib/releases.

If you encounter any bugs or other issues, please report them in Issues.

Assets 4
Loading