EditorSettings

Inherits: Resource < Reference < Object

Object that holds the project-independent editor settings.

Description

Object that holds the project-independent editor settings. These settings are generally visible in the Editor > Editor Settings menu.

Property names use slash delimiters to distinguish sections. Setting values can be of any Variant type. It's recommended to use snake_case for editor settings to be consistent with the Godot editor itself.

Accessing the settings can be done using the following methods, such as:

# `settings.set("some/property", value)` also works as this class overrides `_set()` internally.
settings.set_setting("some/property",value)

# `settings.get("some/property", value)` also works as this class overrides `_get()` internally.
settings.get_setting("some/property")

var list_of_settings = settings.get_property_list()

Note: This class shouldn't be instantiated directly. Instead, access the singleton using EditorInterface.get_editor_settings.

Methods

void	add_property_info ( Dictionary info )
void	erase ( String property )
PoolStringArray	get_favorites ( ) const
Variant	get_project_metadata ( String section, String key, Variant default=null ) const
String	get_project_settings_dir ( ) const
PoolStringArray	get_recent_dirs ( ) const
Variant	get_setting ( String name ) const
String	get_settings_dir ( ) const
bool	has_setting ( String name ) const
bool	property_can_revert ( String name )
Variant	property_get_revert ( String name )
void	set_favorites ( PoolStringArray dirs )
void	set_initial_value ( String name, Variant value, bool update_current )
void	set_project_metadata ( String section, String key, Variant data )
void	set_recent_dirs ( PoolStringArray dirs )
void	set_setting ( String name, Variant value )

Signals

settings_changed ( )

Emitted after any editor setting has changed.

Constants

NOTIFICATION_EDITOR_SETTINGS_CHANGED = 10000 --- Emitted after any editor setting has changed. It's used by various editor plugins to update their visuals on theme changes or logic on configuration changes.

Method Descriptions

void add_property_info ( Dictionary info )

Adds a custom property info to a property. The dictionary must contain:

• name: String (the name of the property)
• type: int (see Variant.Type)
• optionally hint: int (see PropertyHint) and hint_string: String

Example:

editor_settings.set("category/property_name", 0)

var property_info = {
    "name": "category/property_name",
    "type": TYPE_INT,
    "hint": PROPERTY_HINT_ENUM,
    "hint_string": "one,two,three"
}

editor_settings.add_property_info(property_info)

void erase ( String property )

Erases the setting whose name is specified by property.

PoolStringArray get_favorites ( ) const

Returns the list of favorite files and directories for this project.

Variant get_project_metadata ( String section, String key, Variant default=null ) const

Returns project-specific metadata for the section and key specified. If the metadata doesn't exist, default will be returned instead. See also set_project_metadata.

String get_project_settings_dir ( ) const

Returns the project-specific settings path. Projects all have a unique subdirectory inside the settings path where project-specific settings are saved.

PoolStringArray get_recent_dirs ( ) const

Returns the list of recently visited folders in the file dialog for this project.

Variant get_setting ( String name ) const

Returns the value of the setting specified by name. This is equivalent to using Object.get on the EditorSettings instance.

String get_settings_dir ( ) const

Gets the global settings path for the engine. Inside this path, you can find some standard paths such as:

settings/tmp - Used for temporary storage of files

settings/templates - Where export templates are located

bool has_setting ( String name ) const

Returns true if the setting specified by name exists, false otherwise.

bool property_can_revert ( String name )

Returns true if the setting specified by name can have its value reverted to the default value, false otherwise. When this method returns true, a Revert button will display next to the setting in the Editor Settings.

Variant property_get_revert ( String name )

Returns the default value of the setting specified by name. This is the value that would be applied when clicking the Revert button in the Editor Settings.

void set_favorites ( PoolStringArray dirs )

Sets the list of favorite files and directories for this project.

void set_initial_value ( String name, Variant value, bool update_current )

Sets the initial value of the setting specified by name to value. This is used to provide a value for the Revert button in the Editor Settings. If update_current is true, the current value of the setting will be set to value as well.

void set_project_metadata ( String section, String key, Variant data )

Sets project-specific metadata with the section, key and data specified. This metadata is stored outside the project folder and therefore won't be checked into version control. See also get_project_metadata.

void set_recent_dirs ( PoolStringArray dirs )

Sets the list of recently visited folders in the file dialog for this project.

void set_setting ( String name, Variant value )

Sets the value of the setting specified by name. This is equivalent to using Object.set on the EditorSettings instance.