Using RiiStudio
This page describes how to use RiiStudio for BMD creation. This tutorial assumes that a user has a version of RiiStudio > Alpha 5.10.13. As of version Alpha 5.10.13 (Hotfix 1), this program is not recommended for rigged models, ie, those with more than one bone. Finally, these commands should be run in the same directory as the input .dae/.fbx file.
ARC Functionality
For information on how to use RiiStudio to extract and pack ARC files, see Extracting and Packing ARC Files.
Presets
To prevent having to redo every material upon every build, RiiStudio supports material presets that can be applied at .bmd creation or through the GUI. These presets include all the material data for a material (e.g. Cull Mode, Stages, Pixel Engine, Sampler Data), and the actual textures themselves. These preset files have the extension .bmd_rspreset and cannot (or more accurately, should not), be edited outside of RiiStudio. In command line usage, presets are applied by matching the preset file name with the material name.
Command Line BMD Creation
When executing the following commands, omit the '<' and '>' symbols. They are used to indicate that a user will have to fill in a value in place of what is written.
At its simplest, the command line command is
<path to rszst.exe> import-bmd <input_file>
This will work on .fbx and .dae files. It will create a .bmd file with the same name as the input file.
To specify an output file, use the command
<path to rszst.exe> import-bmd <input_file> <output_file>
For example
C:\Users\tarsa\Documents\RiiStudio_Windows\rszst.exe import-bmd course.fbx mario_course.bmd
More options include
| --mipmaps | Generate mipmaps for textures. Very useful for a first conversion before any presets are made. |
| --scale <scale value> | Scale the .bmd by the specified value. Setting --scale 100 may be necessary for Blender users. |
| --merge-mats | Combines identical materials, which is useful for improving efficiency. |
| --preset path <path to preset folder> | Applies presets to the .bmd. Very useful for custom materials. |
| --cull-degenerates | Removes degenerate triangles - those with a side of length 0 |
| --cull-invalid | Removes triangles with invalid vertices. |
A full list of options can be seen by
<path to rszst.exe> help import-bmd
An example of an initial .bmd creation command is
C:\Users\tarsa\Documents\RiiStudio_Windows\rszst.exe import-bmd course.fbx mario_course.bmd --mipmaps --scale 100 --merge-mats --cull-degenerate --cull-invalid
If your initially created .bmd files do not have any textures, make sure that your textures are in a folder called "textures" or in the same directory as your .fbx/.dae file.
An example of .bmd creation with presets would be
C:\Users\tarsa\Documents\RiiStudio_Windows\rszst.exe import-bmd course.fbx mario_course.bmd --preset-path=".\presets" --scale 100 --merge-mats --cull-degenerate --cull-invalid
To dump all presets from a .bmd file, use the command
<path to rszst.exe> dump-presets <bmd.file> ".\preset-folder"
For example
C:\Users\tarsa\Documents\RiiStudio_Windows\rszst.exe mario_course.bmd ".\preset-folder"
The preset folder can be any folder, but it is most helpful to keep all your presets in a dedicated folder close to your .dae/.fbx.
GUI BMD Creation
- Open RiiStudio and drag an .dae or .fbx onto it. Choose "BMD Model".
- Choose your options. The "Model Scale" field is the same as the --scale option as in command line. All other settings, for common use, can be kept as the default. For custom tracks, keep the "Data to Import" as the default (everything but Bone Weights selected).
- Click on the green "Next" button. Wait for the .bmd to be made, then click "Next" again.
- To import presets, right click on each material individually and selecte the desired preset.
- To export all presets, right click on "Model" and choose "Export all materials as presets". To export a single preset, right click on a material and choose "Create material preset"
- To save, click on File -> Save, and save to your intended location
After drag and drop
Mostly default BMD import settings. The Scale has been changed to be 100.
The popup after the .bmd has been internally created
The initial view of your new model in RiiStudio.
