ProjectSettings

Inherits: Object

Contains global variables accessible from everywhere.

Description

Contains global variables accessible from everywhere. Use get_setting, set_setting or has_setting to access them. Variables stored in project.godot are also loaded into ProjectSettings, making this object very useful for reading custom game configuration options.

When naming a Project Settings property, use the full path to the setting including the category. For example, "application/config/name" for the project name. Category and property names can be viewed in the Project Settings dialog.

Feature tags: Project settings can be overridden for specific platforms and configurations (debug, release, ...) using feature tags.

Overriding: Any project setting can be overridden by creating a file named override.cfg in the project's root directory. This can also be used in exported projects by placing this file in the same directory as the project binary. Overriding will still take the base project settings' feature tags in account. Therefore, make sure to also override the setting with the desired feature tags if you want them to override base project settings on all platforms and configurations.

Tutorials

Properties

Color

application/boot_splash/bg_color

Color(0.14, 0.14, 0.14, 1)

bool

application/boot_splash/fullsize

true

String

application/boot_splash/image

""

bool

application/boot_splash/show_image

true

bool

application/boot_splash/use_filter

true

String

application/config/custom_user_dir_name

""

String

application/config/description

""

PackedStringArray

application/config/features

String

application/config/icon

""

String

application/config/macos_native_icon

""

String

application/config/name

""

Dictionary

application/config/name_localized

{}

String

application/config/project_settings_override

""

bool

application/config/use_custom_user_dir

false

bool

application/config/use_hidden_project_data_directory

true

String

application/config/windows_native_icon

""

bool

application/run/disable_stderr

false

bool

application/run/disable_stdout

false

bool

application/run/flush_stdout_on_print

false

bool

application/run/flush_stdout_on_print.debug

true

int

application/run/frame_delay_msec

0

bool

application/run/low_processor_mode

false

int

application/run/low_processor_mode_sleep_usec

6900

String

application/run/main_scene

""

float

audio/buses/channel_disable_threshold_db

-60.0

float

audio/buses/channel_disable_time

2.0

String

audio/buses/default_bus_layout

"res://default_bus_layout.tres"

String

audio/driver/driver

bool

audio/driver/enable_input

false

int

audio/driver/mix_rate

44100

int

audio/driver/mix_rate.web

0

int

audio/driver/output_latency

15

int

audio/driver/output_latency.web

50

float

audio/general/2d_panning_strength

1.0

float

audio/general/3d_panning_strength

1.0

int

audio/video/video_delay_compensation_ms

0

int

compression/formats/gzip/compression_level

-1

int

compression/formats/zlib/compression_level

-1

int

compression/formats/zstd/compression_level

3

bool

compression/formats/zstd/long_distance_matching

false

int

compression/formats/zstd/window_log_size

27

bool

debug/file_logging/enable_file_logging

false

bool

debug/file_logging/enable_file_logging.pc

true

String

debug/file_logging/log_path

"user://logs/godot.log"

int

debug/file_logging/max_log_files

5

int

debug/gdscript/warnings/assert_always_false

1

int

debug/gdscript/warnings/assert_always_true

1

int

debug/gdscript/warnings/constant_used_as_function

1

int

debug/gdscript/warnings/deprecated_keyword

1

int

debug/gdscript/warnings/empty_file

1

bool

debug/gdscript/warnings/enable

true

bool

debug/gdscript/warnings/exclude_addons

true

int

debug/gdscript/warnings/function_used_as_property

1

int

debug/gdscript/warnings/incompatible_ternary

1

int

debug/gdscript/warnings/int_assigned_to_enum

1

int

debug/gdscript/warnings/integer_division

1

int

debug/gdscript/warnings/narrowing_conversion

1

int

debug/gdscript/warnings/property_used_as_function

1

int

debug/gdscript/warnings/redundant_await

1

int

debug/gdscript/warnings/return_value_discarded

1

int

debug/gdscript/warnings/shadowed_global_identifier

1

int

debug/gdscript/warnings/shadowed_variable

1

int

debug/gdscript/warnings/shadowed_variable_base_class

1

int

debug/gdscript/warnings/standalone_expression

1

int

debug/gdscript/warnings/standalone_ternary

1

bool

debug/gdscript/warnings/treat_warnings_as_errors

false

int

debug/gdscript/warnings/unassigned_variable

1

int

debug/gdscript/warnings/unassigned_variable_op_assign

1

int

debug/gdscript/warnings/unreachable_code

1

int

debug/gdscript/warnings/unreachable_pattern

1

int

debug/gdscript/warnings/unsafe_call_argument

0

int

debug/gdscript/warnings/unsafe_cast

0

int

debug/gdscript/warnings/unsafe_method_access

0

int

debug/gdscript/warnings/unsafe_property_access

0

int

debug/gdscript/warnings/unused_local_constant

1

int

debug/gdscript/warnings/unused_parameter

1

int

debug/gdscript/warnings/unused_private_class_variable

1

int

debug/gdscript/warnings/unused_signal

1

int

debug/gdscript/warnings/unused_variable

1

int

debug/gdscript/warnings/void_assignment

1

String

debug/settings/crash_handler/message

"Please include this when reporting the bug to the project developer."

String

debug/settings/crash_handler/message.editor

"Please include this when reporting the bug on: https://github.com/godotengine/godot/issues"

int

debug/settings/fps/force_fps

0

int

debug/settings/gdscript/max_call_stack

1024

int

debug/settings/profiler/max_functions

16384

bool

debug/settings/stdout/print_fps

false

bool

debug/settings/stdout/print_gpu_profile

false

bool

debug/settings/stdout/verbose_stdout

false

int

debug/settings/visual_script/max_call_stack

1024

Color

debug/shapes/collision/contact_color

Color(1, 0.2, 0.1, 0.8)

bool

debug/shapes/collision/draw_2d_outlines

true

int

debug/shapes/collision/max_contacts_displayed

10000

Color

debug/shapes/collision/shape_color

Color(0, 0.6, 0.7, 0.42)

Color

debug/shapes/navigation/disabled_geometry_color

Color(1, 0.7, 0.1, 0.4)

Color

debug/shapes/navigation/geometry_color

Color(0.1, 1, 0.7, 0.4)

String

display/mouse_cursor/custom_image

""

Vector2

display/mouse_cursor/custom_image_hotspot

Vector2(0, 0)

Vector2

display/mouse_cursor/tooltip_position_offset

Vector2(10, 10)

bool

display/window/dpi/allow_hidpi

true

bool

display/window/energy_saving/keep_screen_on

true

int

display/window/handheld/orientation

0

bool

display/window/ios/hide_home_indicator

true

bool

display/window/size/always_on_top

false

bool

display/window/size/borderless

false

bool

display/window/size/fullscreen

false

bool

display/window/size/resizable

true

int

display/window/size/viewport_height

600

int

display/window/size/viewport_width

1024

int

display/window/size/window_height_override

0

int

display/window/size/window_width_override

0

int

display/window/vsync/vsync_mode

1

bool

editor/movie_writer/disable_vsync

false

int

editor/movie_writer/fps

60

int

editor/movie_writer/mix_rate_hz

48000

float

editor/movie_writer/mjpeg_quality

0.75

String

editor/movie_writer/movie_file

""

int

editor/movie_writer/speaker_mode

0

int

editor/node_naming/name_casing

0

int

editor/node_naming/name_num_separator

0

String

editor/run/main_run_args

""

PackedStringArray

editor/script/search_in_file_extensions

PackedStringArray("gd", "gdshader")

String

editor/script/templates_search_path

"res://script_templates"

bool

filesystem/import/blender/enabled

true

bool

filesystem/import/fbx/enabled

true

int

gui/common/default_scroll_deadzone

0

bool

gui/common/swap_cancel_ok

int

gui/common/text_edit_undo_stack_max_size

1024

String

gui/theme/custom

""

String

gui/theme/custom_font

""

bool

gui/theme/default_font_antialiased

true

bool

gui/theme/default_font_generate_mipmaps

false

int

gui/theme/default_font_hinting

1

bool

gui/theme/default_font_multichannel_signed_distance_field

false

int

gui/theme/default_font_subpixel_positioning

1

float

gui/theme/default_theme_scale

1.0

int

gui/timers/incremental_search_max_interval_msec

2000

float

gui/timers/text_edit_idle_detect_sec

3

float

gui/timers/tooltip_delay_sec

0.5

Dictionary

input/ui_accept

Dictionary

input/ui_cancel

Dictionary

input/ui_copy

Dictionary

input/ui_cut

Dictionary

input/ui_down

Dictionary

input/ui_end

Dictionary

input/ui_filedialog_refresh

Dictionary

input/ui_filedialog_show_hidden

Dictionary

input/ui_filedialog_up_one_level

Dictionary

input/ui_focus_next

Dictionary

input/ui_focus_prev

Dictionary

input/ui_graph_delete

Dictionary

input/ui_graph_duplicate

Dictionary

input/ui_home

Dictionary

input/ui_left

Dictionary

input/ui_menu

Dictionary

input/ui_page_down

Dictionary

input/ui_page_up

Dictionary

input/ui_paste

Dictionary

input/ui_redo

Dictionary

input/ui_right

Dictionary

input/ui_select

Dictionary

input/ui_swap_input_direction

Dictionary

input/ui_text_backspace

Dictionary

input/ui_text_backspace_all_to_left

Dictionary

input/ui_text_backspace_all_to_left.macos

Dictionary

input/ui_text_backspace_word

Dictionary

input/ui_text_backspace_word.macos

Dictionary

input/ui_text_caret_document_end

Dictionary

input/ui_text_caret_document_end.macos

Dictionary

input/ui_text_caret_document_start

Dictionary

input/ui_text_caret_document_start.macos

Dictionary

input/ui_text_caret_down

Dictionary

input/ui_text_caret_left

Dictionary

input/ui_text_caret_line_end

Dictionary

input/ui_text_caret_line_end.macos

Dictionary

input/ui_text_caret_line_start

Dictionary

input/ui_text_caret_line_start.macos

Dictionary

input/ui_text_caret_page_down

Dictionary

input/ui_text_caret_page_up

Dictionary

input/ui_text_caret_right

Dictionary

input/ui_text_caret_up

Dictionary

input/ui_text_caret_word_left

Dictionary

input/ui_text_caret_word_left.macos

Dictionary

input/ui_text_caret_word_right

Dictionary

input/ui_text_caret_word_right.macos

Dictionary

input/ui_text_completion_accept

Dictionary

input/ui_text_completion_query

Dictionary

input/ui_text_completion_replace

Dictionary

input/ui_text_dedent

Dictionary

input/ui_text_delete

Dictionary

input/ui_text_delete_all_to_right

Dictionary

input/ui_text_delete_all_to_right.macos

Dictionary

input/ui_text_delete_word

Dictionary

input/ui_text_delete_word.macos

Dictionary

input/ui_text_indent

Dictionary

input/ui_text_newline

Dictionary

input/ui_text_newline_above

Dictionary

input/ui_text_newline_blank

Dictionary

input/ui_text_scroll_down

Dictionary

input/ui_text_scroll_down.macos

Dictionary

input/ui_text_scroll_up

Dictionary

input/ui_text_scroll_up.macos

Dictionary

input/ui_text_select_all

Dictionary

input/ui_text_select_word_under_caret

Dictionary

input/ui_text_submit

Dictionary

input/ui_text_toggle_insert_mode

Dictionary

input/ui_undo

Dictionary

input/ui_up

bool

input_devices/buffering/agile_event_flushing

false

String

input_devices/pen_tablet/driver

String

input_devices/pen_tablet/driver.windows

bool

input_devices/pointing/emulate_mouse_from_touch

true

bool

input_devices/pointing/emulate_touch_from_mouse

false

float

input_devices/pointing/ios/touch_delay

0.15

String

internationalization/locale/fallback

"en"

bool

internationalization/locale/include_text_server_data

false

String

internationalization/locale/test

""

PackedStringArray

internationalization/locale/translation_remaps

PackedStringArray

internationalization/locale/translations

bool

internationalization/pseudolocalization/double_vowels

false

float

internationalization/pseudolocalization/expansion_ratio

0.0

bool

internationalization/pseudolocalization/fake_bidi

false

bool

internationalization/pseudolocalization/override

false

String

internationalization/pseudolocalization/prefix

"["

bool

internationalization/pseudolocalization/replace_with_accents

true

bool

internationalization/pseudolocalization/skip_placeholders

true

String

internationalization/pseudolocalization/suffix

"]"

bool

internationalization/pseudolocalization/use_pseudolocalization

false

bool

internationalization/rendering/force_right_to_left_layout_direction

false

String

internationalization/rendering/text_driver

""

String

layer_names/2d_navigation/layer_1

""

String

layer_names/2d_navigation/layer_10

""

String

layer_names/2d_navigation/layer_11

""

String

layer_names/2d_navigation/layer_12

""

String

layer_names/2d_navigation/layer_13

""

String

layer_names/2d_navigation/layer_14

""

String

layer_names/2d_navigation/layer_15

""

String

layer_names/2d_navigation/layer_16

""

String

layer_names/2d_navigation/layer_17

""

String

layer_names/2d_navigation/layer_18

""

String

layer_names/2d_navigation/layer_19

""

String

layer_names/2d_navigation/layer_2

""

String

layer_names/2d_navigation/layer_20

""

String

layer_names/2d_navigation/layer_21

""

String

layer_names/2d_navigation/layer_22

""

String

layer_names/2d_navigation/layer_23

""

String

layer_names/2d_navigation/layer_24

""

String

layer_names/2d_navigation/layer_25

""

String

layer_names/2d_navigation/layer_26

""

String

layer_names/2d_navigation/layer_27

""

String

layer_names/2d_navigation/layer_28

""

String

layer_names/2d_navigation/layer_29

""

String

layer_names/2d_navigation/layer_3

""

String

layer_names/2d_navigation/layer_30

""

String

layer_names/2d_navigation/layer_31

""

String

layer_names/2d_navigation/layer_32

""

String

layer_names/2d_navigation/layer_4

""

String

layer_names/2d_navigation/layer_5

""

String

layer_names/2d_navigation/layer_6

""

String

layer_names/2d_navigation/layer_7

""

String

layer_names/2d_navigation/layer_8

""

String

layer_names/2d_navigation/layer_9

""

String

layer_names/2d_physics/layer_1

""

String

layer_names/2d_physics/layer_10

""

String

layer_names/2d_physics/layer_11

""

String

layer_names/2d_physics/layer_12

""

String

layer_names/2d_physics/layer_13

""

String

layer_names/2d_physics/layer_14

""

String

layer_names/2d_physics/layer_15

""

String

layer_names/2d_physics/layer_16

""

String

layer_names/2d_physics/layer_17

""

String

layer_names/2d_physics/layer_18

""

String

layer_names/2d_physics/layer_19

""

String

layer_names/2d_physics/layer_2

""

String

layer_names/2d_physics/layer_20

""

String

layer_names/2d_physics/layer_21

""

String

layer_names/2d_physics/layer_22

""

String

layer_names/2d_physics/layer_23

""

String

layer_names/2d_physics/layer_24

""

String

layer_names/2d_physics/layer_25

""

String

layer_names/2d_physics/layer_26

""

String

layer_names/2d_physics/layer_27

""

String

layer_names/2d_physics/layer_28

""

String

layer_names/2d_physics/layer_29

""

String

layer_names/2d_physics/layer_3

""

String

layer_names/2d_physics/layer_30

""

String

layer_names/2d_physics/layer_31

""

String

layer_names/2d_physics/layer_32

""

String

layer_names/2d_physics/layer_4

""

String

layer_names/2d_physics/layer_5

""

String

layer_names/2d_physics/layer_6

""

String

layer_names/2d_physics/layer_7

""

String

layer_names/2d_physics/layer_8

""

String

layer_names/2d_physics/layer_9

""

String

layer_names/2d_render/layer_1

""

String

layer_names/2d_render/layer_10

""

String

layer_names/2d_render/layer_11

""

String

layer_names/2d_render/layer_12

""

String

layer_names/2d_render/layer_13

""

String

layer_names/2d_render/layer_14

""

String

layer_names/2d_render/layer_15

""

String

layer_names/2d_render/layer_16

""

String

layer_names/2d_render/layer_17

""

String

layer_names/2d_render/layer_18

""

String

layer_names/2d_render/layer_19

""

String

layer_names/2d_render/layer_2

""

String

layer_names/2d_render/layer_20

""

String

layer_names/2d_render/layer_3

""

String

layer_names/2d_render/layer_4

""

String

layer_names/2d_render/layer_5

""

String

layer_names/2d_render/layer_6

""

String

layer_names/2d_render/layer_7

""

String

layer_names/2d_render/layer_8

""

String

layer_names/2d_render/layer_9

""

String

layer_names/3d_navigation/layer_1

""

String

layer_names/3d_navigation/layer_10

""

String

layer_names/3d_navigation/layer_11

""

String

layer_names/3d_navigation/layer_12

""

String

layer_names/3d_navigation/layer_13

""

String

layer_names/3d_navigation/layer_14

""

String

layer_names/3d_navigation/layer_15

""

String

layer_names/3d_navigation/layer_16

""

String

layer_names/3d_navigation/layer_17

""

String

layer_names/3d_navigation/layer_18

""

String

layer_names/3d_navigation/layer_19

""

String

layer_names/3d_navigation/layer_2

""

String

layer_names/3d_navigation/layer_20

""

String

layer_names/3d_navigation/layer_21

""

String

layer_names/3d_navigation/layer_22

""

String

layer_names/3d_navigation/layer_23

""

String

layer_names/3d_navigation/layer_24

""

String

layer_names/3d_navigation/layer_25

""

String

layer_names/3d_navigation/layer_26

""

String

layer_names/3d_navigation/layer_27

""

String

layer_names/3d_navigation/layer_28

""

String

layer_names/3d_navigation/layer_29

""

String

layer_names/3d_navigation/layer_3

""

String

layer_names/3d_navigation/layer_30

""

String

layer_names/3d_navigation/layer_31

""

String

layer_names/3d_navigation/layer_32

""

String

layer_names/3d_navigation/layer_4

""

String

layer_names/3d_navigation/layer_5

""

String

layer_names/3d_navigation/layer_6

""

String

layer_names/3d_navigation/layer_7

""

String

layer_names/3d_navigation/layer_8

""

String

layer_names/3d_navigation/layer_9

""

String

layer_names/3d_physics/layer_1

""