Project Settings

Project settings are options that are configured once and affect the entire application. Most project settings can be configured from the editor, though some (currently) can only be configured by writing certain configuration files manually.

In the editor you will find the project settings under Editor > Project Settings > ….

Data Directories

Editor > Project Settings > Data Directories… opens a dialog to set up the data directories.

Engine Plugins

Editor > Project Settings > Engine Plugins… opens a dialog to configure the active engine plugins:

Engine Plugins

This dialog shows all available engine plugins. These are DLLs that are located in the same directory as Editor.exe. Note that EZ uses a specific name schema to differentiate which DLLs are considered engine plugins:

In the list above a number of plugins have a checkmark. Also, most plugins are tagged with (active), even if they are not checked:

If you want to fully remove a certain integration, even in the editor, you need to edit the list of editor plugins (TODO). Then plugin specific asset types will not show up in the asset browser and its dedicated components won’t show up in the component list. However, this is a machine wide setting, that applies to all projects and should only be done when a plugin interacts badly with some other functionality.

Loading Plugins from Code

A custom application (TODO) or game state can load plugins directly from code if necessary. For example the ezInspectorPlugin is automatically loaded for you by stock EZ applications, when building the code for development.

Input Configuration

Editor > Project Settings > Input Configuration… opens a dialog to configure input actions.


Editor > Project Settings > Tags… opens a dialog to configure which tags are available in the project.

Window Configuration

Editor > Project Settings > Window Configuration… opens a dialog to configure the default window configuration when running a scene.

Window Configuration

These settings allow you to configure basic window settings for Play-the-Game mode and when running an exported scene in ezPlayer. A proper game would typically implement this logic in a custom application (TODO) and should allow the user to choose settings such as the resolution. The window configuration dialog is mainly for use during development.

There are two separately stored configurations:

Project Default: This configuration will be stored in the project folder and thus should be checked into source control to be shared with others.

User Specific: This configuration is only stored locally for the active user and not in the project directory. Therefore it cannot be checked into source control. It is meant for users who want to use settings different from the project default. For instance, when you have multiple monitors, you may want the exported scene to always appear on a specific one. This configuration must be enabled to override the default one.

Apart from the window position and size, the window configuration also controls the behavior of the mouse. If Clip Mouse Cursor is enabled, the mouse won’t be able to leave the window area. This should be preferred for games that hide the mouse and only use relative mouse movement.

Asset Profiles

Editor > Project Settings > Asset Profiles… opens a dialog to edit asset profiles (TODO).


If the FMOD Integration is enabled, Editor > Project Settings > Fmod Project Settings… will be available to configure the speaker mode and which master sound bank to use.


If the PhysX Integration is enabled, Editor > Project Settings > PhysX Project Settings… will be available to configure the collision layers.



See Also