Preferences - ScanMountGoat/ssbh_editor GitHub Wiki

The Preferences window edits various application settings. Preferences are saved to disk everytime the application closes.

File > Open Preferences Directory...

Opens the application data folder. All versions of SSBH Editor after 0.5.0 store preferences, material presets, and other configuration files in a dedicated folder in the user folder. These files are shared by all versions of SSBH Editor.

Preferences are saved when the application closes. Changes to material presets must be saved manually from the preset editor. All configuration settings are editable from within the application itself, so manually editing these files usually isn't necessary.

Dark Mode

Toggles the color theme of the user interface. This does not impact the viewport background color.

Viewport Background

The background color for the 3D viewport. Click the color button to select a new RGB color.

Automatically Hide Expressions

Hide expression meshes for new model folders when checked. This is equivalent to clicking the Meshes > Hide Expressions menu option after opening the new folder.

Graphics Backend

Configures the preferred GPU backend for ssbh_editor. This can resolve system compatibility or GPU driver issues in some cases. Note that this is only the preferred backend, so ssbh_editor will still try all available backends if one fails to launch properly. This should usually be left at the Auto setting. Some Windows systems may benefit from explicitly setting DX12 as the backend. DX12 makes the application start up slower but generally has better stability and compatibility for Windows. Users on MacOS or Linux should never need to change this setting and can just use the default value of Auto.

The backend can also be set from the commandline. For setting the backend on Windows, run the application from command prompt in the ssbh_editor folder as ssbh_editor.exe --backend dx12 or ssbh_editor.exe --backend vulkan. This updates the preferences before the main window opens and can be used to set the backend even if the application fails to open.