thatii/smush-material-research

Smash Ultimate material and rendering information

Smash Ultimate Material Research

A collection of dumps, scripts, and markdown files for research into lighting, shading, rendering, and materials for Smash Ultimate. The markdown files contain information on researched values for materials and can be viewed directly in the browser. Please submit an issue or pull request for any incorrect or missing information.

Website

The repository has a website for tutorials and real time demos. If any pages don't load properly or one of the demos is messed up, report the bug in issues.

Generating Data - WIP

Basic instructions for how to generate the value dumps.

SQLite database

Most of the data is stored in an SQLite database generated by the program in the Smush-Material-DB repo.
The repo contains instructions for how to run the tool. The database can be used with the provided python scripts for data visualization even without any SQL knowledge.

XML Dumps

TODO:

Json Dumps

TODO:

Shader Info Dump

Extract the nuc2effectlibrary.nufxlb.json from Value Dumps or convert the nuc2effectlibrary.nufxlb file to JSON using ssbh_lib_json.
python batch_export_shader_info.py nuc2effectlibrary.nufxlb.json <export folder>

Dump Shader Binaries

1. Build the BatchExportShaderBinaries in SSBHLib
2. BatchExportShaderBinaries.exe "render/shader/bin" <Binary Output Folder>

Additional Tools

SSBHLib - Contains libraries and programs for editing, viewing, and exporting various rendering related file types.
SSBU-TOOLS - Contains the XMBDec.py script that can be used to convert XMB files to and from XML