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.

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/use_filter

true

String

application/config/custom_user_dir_name

""

String

application/config/description

""

String

application/config/icon

""

String

application/config/macos_native_icon

""

String

application/config/name

""

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

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

bool

debug/gdscript/completion/autocomplete_setters_and_getters

false

bool

debug/gdscript/warnings/assert_always_false

true

bool

debug/gdscript/warnings/assert_always_true

true

bool

debug/gdscript/warnings/constant_used_as_function

true

bool

debug/gdscript/warnings/deprecated_keyword

true

bool

debug/gdscript/warnings/empty_file

true

bool

debug/gdscript/warnings/enable

true

bool

debug/gdscript/warnings/exclude_addons

true

bool

debug/gdscript/warnings/function_used_as_property

true

bool

debug/gdscript/warnings/incompatible_ternary

true

bool

debug/gdscript/warnings/integer_division

true

bool

debug/gdscript/warnings/narrowing_conversion

true

bool

debug/gdscript/warnings/property_used_as_function

true

bool

debug/gdscript/warnings/redundant_await

true

bool

debug/gdscript/warnings/return_value_discarded

true

bool

debug/gdscript/warnings/shadowed_variable

true

bool

debug/gdscript/warnings/shadowed_variable_base_class

true

bool

debug/gdscript/warnings/standalone_expression

true

bool

debug/gdscript/warnings/standalone_ternary

true

bool

debug/gdscript/warnings/treat_warnings_as_errors

false

bool

debug/gdscript/warnings/unassigned_variable

true

bool

debug/gdscript/warnings/unassigned_variable_op_assign

true

bool

debug/gdscript/warnings/unreachable_code

true

bool

debug/gdscript/warnings/unreachable_pattern

true

bool

debug/gdscript/warnings/unsafe_call_argument

false

bool

debug/gdscript/warnings/unsafe_cast

false

bool

debug/gdscript/warnings/unsafe_method_access

false

bool

debug/gdscript/warnings/unsafe_property_access

false

bool

debug/gdscript/warnings/unused_local_constant

true

bool

debug/gdscript/warnings/unused_parameter

true

bool

debug/gdscript/warnings/unused_private_class_variable

true

bool

debug/gdscript/warnings/unused_signal

true

bool

debug/gdscript/warnings/unused_variable

true

bool

debug/gdscript/warnings/void_assignment

true

String

debug/settings/crash_handler/message

"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

false

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

int

display/window/size/height

600

bool

display/window/size/resizable

true

int

display/window/size/test_height

0

int

display/window/size/test_width

0

int

display/window/size/width

1024

int

display/window/vsync/vsync_mode

1

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"

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/use_hidpi

false

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

""

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

""

String

layer_names/3d_physics/layer_10

""

String

layer_names/3d_physics/layer_11

""

String

layer_names/3d_physics/layer_12

""

String

layer_names/3d_physics/layer_13

""

String

layer_names/3d_physics/layer_14

""

String

layer_names/3d_physics/layer_15

""

String

layer_names/3d_physics/layer_16

""

String

layer_names/3d_physics/layer_17

""

String

layer_names/3d_physics/layer_18

""

String

layer_names/3d_physics/layer_19

""

String

layer_names/3d_physics/layer_2

""

String

layer_names/3d_physics/layer_20

""

String

layer_names/3d_physics/layer_21

""

String

layer_names/3d_physics/layer_22

""

String

layer_names/3d_physics/layer_23

""

String

layer_names/3d_physics/layer_24

""

String

layer_names/3d_physics/layer_25

""

String

layer_names/3d_physics/layer_26

""

String

layer_names/3d_physics/layer_27

""

String

layer_names/3d_physics/layer_28

""

String

layer_names/3d_physics/layer_29

""

String

layer_names/3d_physics/layer_3

""

String

layer_names/3d_physics/layer_30

""

String

layer_names/3d_physics/layer_31

""

String

layer_names/3d_physics/layer_32

""

String

layer_names/3d_physics/layer_4

""

String

layer_names/3d_physics/layer_5

""

String

layer_names/3d_physics/layer_6

""

String

layer_names/3d_physics/layer_7

""

String

layer_names/3d_physics/layer_8

""

String

layer_names/3d_physics/layer_9

""

String

layer_names/3d_render/layer_1

""

String

layer_names/3d_render/layer_10

""

String

layer_names/3d_render/layer_11

""

String

layer_names/3d_render/layer_12

""

String

layer_names/3d_render/layer_13

""

String

layer_names/3d_render/layer_14

""

String

layer_names/3d_render/layer_15

""

String

layer_names/3d_render/layer_16

""

String

layer_names/3d_render/layer_17

""

String

layer_names/3d_render/layer_18

""

String

layer_names/3d_render/layer_19

""

String

layer_names/3d_render/layer_2

""

String

layer_names/3d_render/layer_20

""

String

layer_names/3d_render/layer_3

""

String

layer_names/3d_render/layer_4

""

String

layer_names/3d_render/layer_5

""

String

layer_names/3d_render/layer_6

""

String

layer_names/3d_render/layer_7

""

String

layer_names/3d_render/layer_8

""

String

layer_names/3d_render/layer_9

""

int

memory/limits/message_queue/max_size_kb

4096

int

memory/limits/multithreaded_server/rid_pool_prealloc

60

int

mono/debugger_agent/port

23685

bool

mono/debugger_agent/wait_for_debugger

false

int

mono/debugger_agent/wait_timeout

3000

String

mono/profiler/args

"log:calls,alloc,sample,output=output.mlpd"

bool

mono/profiler/enabled

false

int

mono/runtime/unhandled_exception_policy

0

int

navigation/2d/default_cell_size

10

int

navigation/2d/default_edge_connection_margin

5

float

navigation/3d/default_cell_size

0.3

float

navigation/3d/default_edge_connection_margin

0.3

int

network/limits/debugger/max_chars_per_second

32768

int

network/limits/debugger/max_errors_per_second

400

int

network/limits/debugger/max_queued_messages

2048

int

network/limits/debugger/max_warnings_per_second

400

int

network/limits/packet_peer_stream/max_buffer_po2

16

int

network/limits/tcp/connect_timeout_seconds

30

int

network/limits/webrtc/max_channel_in_buffer_kb

64

int

network/remote_fs/page_read_ahead

4

int

network/remote_fs/page_size

65536

String

network/ssl/certificate_bundle_override

""

float

physics/2d/default_angular_damp

1.0

float

physics/2d/default_gravity

980.0

Vector2

physics/2d/default_gravity_vector

Vector2(0, 1)

float

physics/2d/default_linear_damp

0.1

String

physics/2d/physics_engine

"DEFAULT"

bool

physics/2d/run_on_thread

false

float

physics/2d/sleep_threshold_angular

0.139626

float

physics/2d/sleep_threshold_linear

2.0

float

physics/2d/time_before_sleep

0.5

float

physics/3d/default_angular_damp

0.1

float

physics/3d/default_gravity

9.8

Vector3

physics/3d/default_gravity_vector

Vector3(0, -1, 0)

float

physics/3d/default_linear_damp

0.1

String

physics/3d/physics_engine

"DEFAULT"

bool

physics/3d/run_on_thread

false

float

physics/3d/sleep_threshold_angular

0.139626

float

physics/3d/sleep_threshold_linear

0.1

float

physics/3d/time_before_sleep

0.5

bool

physics/common/enable_object_picking

true

float

physics/common/physics_jitter_fix

0.5

int

physics/common/physics_ticks_per_second

60

int

rendering/2d/opengl/batching_send_null

0

int

rendering/2d/opengl/batching_stream