Skip to content

Preferences

SMG edited this page Nov 27, 2022 · 3 revisions

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

File > Open Preferences Directory...

SSBH Editor stores its configuration files and material presets in a dedicated directory in the user folder. All versions of SSBH Editor after 0.5.0 use the same shared location for application files. Downloading a new version of SSBH Editor will not change preferences or material presets. 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.

The exact location depends on the operating system. For Windows, this is typically C:\Users\<username>\AppData\Local\ssbh_editor\data where <username> is your user name. A quick way to find the directory on Windows is to type %localappdata% into the path in File Explorer, hit enter, and search for the ssbh_editor folder.

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.