Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

EditorSettings

继承: Resource < RefCounted < Object

保存编辑器设置的对象,这些设置与项目无关。

描述

保存编辑器设置的对象,这些设置与项目无关,通常在编辑器 > 编辑器设置菜单中可见。

属性名称中使用斜线分隔符来区分不同的部分。设置的值可以是任何 Variant 类型。编辑器设置的名称建议使用 snake_case 形式,与 Godot 编辑器本身保持一致。

可以使用以下方法访问设置,例如:

var settings = EditorInterface.get_editor_settings()
# 也可以写 `settings.set("some/property", 10)`,因为这个类内部覆盖了 `_set()`。
settings.set_setting("some/property", 10)
# 也可以写 `settings.get("some/property")` ,因为这个类内部覆盖了 `_get()`。
settings.get_setting("some/property")
var list_of_settings = settings.get_property_list()

注意:不能直接实例化这个类。请改用 EditorInterface.get_editor_settings() 访问单例。

属性

bool

asset_library/use_threads

bool

debugger/auto_switch_to_remote_scene_tree

bool

debugger/auto_switch_to_stack_trace

bool

debugger/profile_native_calls

int

debugger/profiler_frame_history_size

int

debugger/profiler_frame_max_functions

int

debugger/profiler_target_fps

float

debugger/remote_inspect_refresh_interval

float

debugger/remote_scene_tree_refresh_interval

bool

docks/filesystem/always_show_folders

String

docks/filesystem/other_file_extensions

String

docks/filesystem/textfile_extensions

int

docks/filesystem/thumbnail_size

float

docks/property_editor/auto_refresh_interval

float

docks/property_editor/subresource_hue_tint

bool

docks/scene_tree/ask_before_deleting_related_animation_tracks

bool

docks/scene_tree/ask_before_revoking_unique_name

bool

docks/scene_tree/auto_expand_to_selected

bool

docks/scene_tree/center_node_on_reparent

bool

docks/scene_tree/hide_filtered_out_parents

bool

docks/scene_tree/start_create_dialog_fully_expanded

Color

editors/2d/bone_color1

Color

editors/2d/bone_color2

Color

editors/2d/bone_ik_color

Color

editors/2d/bone_outline_color

float

editors/2d/bone_outline_size

Color

editors/2d/bone_selected_color

float

editors/2d/bone_width

Color

editors/2d/grid_color

Color

editors/2d/guides_color

Color

editors/2d/smart_snapping_line_color

bool

editors/2d/use_integer_zoom_by_default

Color

editors/2d/viewport_border_color

float

editors/2d/zoom_speed_factor

float

editors/3d/default_fov

float

editors/3d/default_z_far

float

editors/3d/default_z_near

int

editors/3d/freelook/freelook_activation_modifier

float

editors/3d/freelook/freelook_base_speed

float

editors/3d/freelook/freelook_inertia

int

editors/3d/freelook/freelook_navigation_scheme

float

editors/3d/freelook/freelook_sensitivity

bool

editors/3d/freelook/freelook_speed_zoom_link

float

editors/3d/grid_division_level_bias

int

editors/3d/grid_division_level_max

int

editors/3d/grid_division_level_min

int

editors/3d/grid_size

bool

editors/3d/grid_xy_plane

bool

editors/3d/grid_xz_plane

bool

editors/3d/grid_yz_plane

float

editors/3d/manipulator_gizmo_opacity

int

editors/3d/manipulator_gizmo_size

bool

editors/3d/navigation/emulate_3_button_mouse

bool

editors/3d/navigation/emulate_numpad

bool

editors/3d/navigation/invert_x_axis

bool

editors/3d/navigation/invert_y_axis

int

editors/3d/navigation/navigation_scheme

int

editors/3d/navigation/orbit_mouse_button

int

editors/3d/navigation/pan_mouse_button

bool

editors/3d/navigation/show_viewport_navigation_gizmo

bool

editors/3d/navigation/show_viewport_rotation_gizmo

bool

editors/3d/navigation/warped_mouse_panning

int

editors/3d/navigation/zoom_mouse_button

int

editors/3d/navigation/zoom_style

float

editors/3d/navigation_feel/orbit_inertia

float

editors/3d/navigation_feel/orbit_sensitivity

float

editors/3d/navigation_feel/translation_inertia

float

editors/3d/navigation_feel/translation_sensitivity

float

editors/3d/navigation_feel/zoom_inertia

Color

editors/3d/primary_grid_color

int

editors/3d/primary_grid_steps

Color

editors/3d/secondary_grid_color

Color

editors/3d/selection_box_color

Color

editors/3d_gizmos/gizmo_colors/aabb

Color

editors/3d_gizmos/gizmo_colors/camera

Color

editors/3d_gizmos/gizmo_colors/csg

Color

editors/3d_gizmos/gizmo_colors/decal

Color

editors/3d_gizmos/gizmo_colors/fog_volume

Color

editors/3d_gizmos/gizmo_colors/gridmap_grid

Color

editors/3d_gizmos/gizmo_colors/instantiated

Color

editors/3d_gizmos/gizmo_colors/joint

Color

editors/3d_gizmos/gizmo_colors/joint_body_a

Color

editors/3d_gizmos/gizmo_colors/joint_body_b

Color

editors/3d_gizmos/gizmo_colors/lightmap_lines

Color

editors/3d_gizmos/gizmo_colors/lightprobe_lines

Color

editors/3d_gizmos/gizmo_colors/occluder

Color

editors/3d_gizmos/gizmo_colors/particle_attractor

Color

editors/3d_gizmos/gizmo_colors/particle_collision

Color

editors/3d_gizmos/gizmo_colors/particles

Color

editors/3d_gizmos/gizmo_colors/path_tilt

Color

editors/3d_gizmos/gizmo_colors/reflection_probe

Color

editors/3d_gizmos/gizmo_colors/selected_bone

Color

editors/3d_gizmos/gizmo_colors/skeleton

Color

editors/3d_gizmos/gizmo_colors/spring_bone_collision

Color

editors/3d_gizmos/gizmo_colors/spring_bone_inside_collision

Color

editors/3d_gizmos/gizmo_colors/spring_bone_joint

Color

editors/3d_gizmos/gizmo_colors/stream_player_3d

Color

editors/3d_gizmos/gizmo_colors/visibility_notifier

Color

editors/3d_gizmos/gizmo_colors/voxel_gi

float

editors/3d_gizmos/gizmo_settings/bone_axis_length

int

editors/3d_gizmos/gizmo_settings/bone_shape

float

editors/3d_gizmos/gizmo_settings/path3d_tilt_disk_size

bool

editors/animation/autorename_animation_tracks

bool

editors/animation/confirm_insert_track

bool

editors/animation/default_create_bezier_tracks

bool

editors/animation/default_create_reset_tracks

Color

editors/animation/onion_layers_future_color

Color

editors/animation/onion_layers_past_color

Color

editors/bone_mapper/handle_colors/error

Color

editors/bone_mapper/handle_colors/missing

Color

editors/bone_mapper/handle_colors/set

Color

editors/bone_mapper/handle_colors/unset

int

editors/grid_map/palette_min_width

float

editors/grid_map/pick_distance

int

editors/grid_map/preview_size

int

editors/panning/2d_editor_pan_speed

int

editors/panning/2d_editor_panning_scheme

int

editors/panning/animation_editors_panning_scheme

bool

editors/panning/simple_panning

int

editors/panning/sub_editors_panning_scheme

bool

editors/panning/warped_mouse_panning

float

editors/polygon_editor/auto_bake_delay

int

editors/polygon_editor/point_grab_radius

bool

editors/polygon_editor/show_previous_outline

bool

editors/shader_editor/behavior/files/restore_shaders_on_load

bool

editors/tiles_editor/display_grid

Color

editors/tiles_editor/grid_color

bool

editors/tiles_editor/highlight_selected_layer

Color

editors/visual_editors/category_colors/color_color

Color

editors/visual_editors/category_colors/conditional_color

Color

editors/visual_editors/category_colors/input_color

Color

editors/visual_editors/category_colors/output_color

Color

editors/visual_editors/category_colors/particle_color

Color

editors/visual_editors/category_colors/scalar_color

Color

editors/visual_editors/category_colors/special_color

Color

editors/visual_editors/category_colors/textures_color

Color

editors/visual_editors/category_colors/transform_color

Color

editors/visual_editors/category_colors/utility_color

Color

editors/visual_editors/category_colors/vector_color

String

editors/visual_editors/color_theme

Color

editors/visual_editors/connection_colors/boolean_color

Color

editors/visual_editors/connection_colors/sampler_color

Color

editors/visual_editors/connection_colors/scalar_color

Color

editors/visual_editors/connection_colors/transform_color

Color

editors/visual_editors/connection_colors/vector2_color

Color

editors/visual_editors/connection_colors/vector3_color

Color

editors/visual_editors/connection_colors/vector4_color

int

editors/visual_editors/grid_pattern

float

editors/visual_editors/lines_curvature

float

editors/visual_editors/minimap_opacity

int

editors/visual_editors/visual_shader/port_preview_size

String

export/ssh/scp

String

export/ssh/ssh

String

filesystem/directories/autoscan_project_path

String

filesystem/directories/default_project_path

String

filesystem/external_programs/3d_model_editor

String

filesystem/external_programs/audio_editor

String

filesystem/external_programs/raster_image_editor

String

filesystem/external_programs/terminal_emulator

String

filesystem/external_programs/terminal_emulator_flags

String

filesystem/external_programs/vector_image_editor

int

filesystem/file_dialog/display_mode

bool

filesystem/file_dialog/show_hidden_files

int

filesystem/file_dialog/thumbnail_size

String

filesystem/file_server/password

int

filesystem/file_server/port

String

filesystem/import/blender/blender_path

int

filesystem/import/blender/rpc_port

float

filesystem/import/blender/rpc_server_uptime

String

filesystem/import/fbx/fbx2gltf_path

bool

filesystem/on_save/compress_binary_resources

bool

filesystem/on_save/safe_save_on_backup_then_rename

int

filesystem/quick_open_dialog/default_display_mode

bool

filesystem/quick_open_dialog/enable_fuzzy_matching

bool

filesystem/quick_open_dialog/include_addons

int

filesystem/quick_open_dialog/max_fuzzy_misses

int

filesystem/quick_open_dialog/max_results

bool

filesystem/quick_open_dialog/show_search_highlight

String

filesystem/tools/oidn/oidn_denoise_path

bool

input/buffering/agile_event_flushing

bool

input/buffering/use_accumulated_input

int

interface/editor/accept_dialog_cancel_ok_buttons

bool

interface/editor/automatically_open_screenshots

String

interface/editor/code_font

int

interface/editor/code_font_contextual_ligatures

String

interface/editor/code_font_custom_opentype_features

String

interface/editor/code_font_custom_variations

int

interface/editor/code_font_size

float

interface/editor/custom_display_scale

int

interface/editor/display_scale

int

interface/editor/dock_tab_style

String

interface/editor/editor_language

int

interface/editor/editor_screen

bool

interface/editor/expand_to_title

bool

interface/editor/font_allow_msdf

int

interface/editor/font_antialiasing

bool

interface/editor/font_disable_embedded_bitmaps

int

interface/editor/font_hinting

int

interface/editor/font_subpixel_positioning

bool

interface/editor/import_resources_when_unfocused

bool

interface/editor/keep_screen_on

bool

interface/editor/localize_settings

int

interface/editor/low_processor_mode_sleep_usec

String

interface/editor/main_font

String

interface/editor/main_font_bold

int

interface/editor/main_font_size

bool

interface/editor/mouse_extra_buttons_navigate_history

int

interface/editor/project_manager_screen

bool

interface/editor/save_each_scene_on_quit

bool

interface/editor/save_on_focus_loss

bool

interface/editor/separate_distraction_mode

int

interface/editor/show_internal_errors_in_toast_notifications

int

interface/editor/show_update_spinner

bool

interface/editor/single_window_mode

int

interface/editor/ui_layout_direction

int

interface/editor/unfocused_low_processor_mode_sleep_usec

bool

interface/editor/update_continuously

bool

interface/editor/use_embedded_menu

bool

interface/editor/use_native_file_dialogs

int

interface/editor/vsync_mode

bool

interface/editors/derive_script_globals_by_name

bool

interface/editors/show_scene_tree_root_selection

bool

interface/inspector/auto_unfold_foreign_scenes

int

interface/inspector/default_color_picker_mode

int

interface/inspector/default_color_picker_shape

float

interface/inspector/default_float_step

int

interface/inspector/default_property_name_style

bool

interface/inspector/delimitate_all_container_and_resources

bool

interface/inspector/disable_folding

float

interface/inspector/float_drag_speed

bool

interface/inspector/horizontal_vector2_editing

bool

interface/inspector/horizontal_vector_types_editing

int

interface/inspector/max_array_dictionary_items_per_page

int

interface/inspector/nested_color_mode

bool

interface/inspector/open_resources_in_current_inspector

PackedStringArray

interface/inspector/resources_to_open_in_new_inspector

bool

interface/inspector/show_low_level_opentype_features

bool

interface/multi_window/enable

bool

interface/multi_window/maximize_window

bool

interface/multi_window/restore_windows_on_load

int

interface/scene_tabs/display_close_button

int

interface/scene_tabs/maximum_width

bool

interface/scene_tabs/restore_scenes_on_load

bool

interface/scene_tabs/show_script_button

bool

interface/scene_tabs/show_thumbnail_on_hover

Color

interface/theme/accent_color

int

interface/theme/additional_spacing

Color

interface/theme/base_color

int

interface/theme/base_spacing

int

interface/theme/border_size

float

interface/theme/contrast

int

interface/theme/corner_radius

String

interface/theme/custom_theme

bool

interface/theme/draw_extra_borders

bool

interface/theme/follow_system_theme

int

interface/theme/icon_and_font_color

float

interface/theme/icon_saturation

String

interface/theme/preset

float

interface/theme/relationship_line_opacity

String

interface/theme/spacing_preset

bool

interface/theme/use_system_accent_color

bool

interface/touchscreen/enable_long_press_as_right_click

bool

interface/touchscreen/enable_pan_and_scale_gestures

bool

interface/touchscreen/increase_scrollbar_touch_area

float

interface/touchscreen/scale_gizmo_handles

int

network/connection/engine_version_update_mode

int

network/connection/network_mode

String

network/debug/remote_host

int

network/debug/remote_port

String

network/http_proxy/host

int

network/http_proxy/port

String

network/tls/editor_tls_certificates

bool

network/tls/enable_tls_v1.3

String

project_manager/default_renderer

int

project_manager/directory_naming_convention

int

project_manager/sorting_order

bool

run/auto_save/save_before_running

int

run/bottom_panel/action_on_play

int

run/bottom_panel/action_on_stop

bool

run/output/always_clear_output_on_play

int

run/output/font_size

int

run/output/max_lines

bool

run/platforms/linuxbsd/prefer_wayland

int

run/window_placement/android_window

int

run/window_placement/game_embed_mode

int

run/window_placement/rect

Vector2

run/window_placement/rect_custom_position

int

run/window_placement/screen

bool

text_editor/appearance/caret/caret_blink

float

text_editor/appearance/caret/caret_blink_interval

bool

text_editor/appearance/caret/highlight_all_occurrences

bool

text_editor/appearance/caret/highlight_current_line

int

text_editor/appearance/caret/type

int

text_editor/appearance/guidelines/line_length_guideline_hard_column

int

text_editor/appearance/guidelines/line_length_guideline_soft_column

bool

text_editor/appearance/guidelines/show_line_length_guidelines

bool

text_editor/appearance/gutters/highlight_type_safe_lines

bool

text_editor/appearance/gutters/line_numbers_zero_padded

bool

text_editor/appearance/gutters/show_info_gutter

bool

text_editor/appearance/gutters/show_line_numbers

int

text_editor/appearance/lines/autowrap_mode

bool

text_editor/appearance/lines/code_folding

int

text_editor/appearance/lines/word_wrap

int

text_editor/appearance/minimap/minimap_width

bool

text_editor/appearance/minimap/show_minimap

bool

text_editor/appearance/whitespace/draw_spaces

bool

text_editor/appearance/whitespace/draw_tabs

int

text_editor/appearance/whitespace/line_spacing

bool

text_editor/behavior/documentation/enable_tooltips

bool

text_editor/behavior/files/auto_reload_and_parse_scripts_on_save

bool

text_editor/behavior/files/auto_reload_scripts_on_external_change

int

text_editor/behavior/files/autosave_interval_secs

bool

text_editor/behavior/files/convert_indent_on_save

bool

text_editor/behavior/files/open_dominant_script_on_scene_change

bool

text_editor/behavior/files/restore_scripts_on_load

bool

text_editor/behavior/files/trim_final_newlines_on_save

bool

text_editor/behavior/files/trim_trailing_whitespace_on_save

bool

text_editor/behavior/general/empty_selection_clipboard

bool

text_editor/behavior/indent/auto_indent

bool

text_editor/behavior/indent/indent_wrapped_lines

int

text_editor/behavior/indent/size

int

text_editor/behavior/indent/type

String

text_editor/behavior/navigation/custom_word_separators

bool

text_editor/behavior/navigation/drag_and_drop_selection

bool

text_editor/behavior/navigation/move_caret_on_right_click

bool

text_editor/behavior/navigation/open_script_when_connecting_signal_to_existing_method

bool

text_editor/behavior/navigation/scroll_past_end_of_file

bool

text_editor/behavior/navigation/smooth_scrolling

bool

text_editor/behavior/navigation/stay_in_script_editor_on_node_selected

bool

text_editor/behavior/navigation/use_custom_word_separators

bool

text_editor/behavior/navigation/use_default_word_separators

int

text_editor/behavior/navigation/v_scroll_speed

bool

text_editor/completion/add_node_path_literals

bool

text_editor/completion/add_string_name_literals

bool

text_editor/completion/add_type_hints

bool

text_editor/completion/auto_brace_complete

float

text_editor/completion/code_complete_delay

bool

text_editor/completion/code_complete_enabled

bool

text_editor/completion/colorize_suggestions

bool

text_editor/completion/complete_file_paths

float

text_editor/completion/idle_parse_delay

float

text_editor/completion/idle_parse_delay_with_errors_found

bool

text_editor/completion/put_callhint_tooltip_below_current_line

bool

text_editor/completion/use_single_quotes

String

text_editor/external/exec_flags

String

text_editor/external/exec_path

bool

text_editor/external/use_external_editor

int

text_editor/help/class_reference_examples

int

text_editor/help/help_font_size

int

text_editor/help/help_source_font_size

int

text_editor/help/help_title_font_size

bool

text_editor/help/show_help_index

bool

text_editor/help/sort_functions_alphabetically

bool

text_editor/script_list/group_help_pages

bool

text_editor/script_list/highlight_scene_scripts

int

text_editor/script_list/list_script_names_as

bool

text_editor/script_list/script_temperature_enabled

int

text_editor/script_list/script_temperature_history_size

bool

text_editor/script_list/show_members_overview

bool

text_editor/script_list/sort_members_outline_alphabetically

int

text_editor/script_list/sort_scripts_by

String

text_editor/theme/color_theme

Color

text_editor/theme/highlighting/background_color

Color

text_editor/theme/highlighting/base_type_color

Color

text_editor/theme/highlighting/bookmark_color

Color

text_editor/theme/highlighting/brace_mismatch_color

Color

text_editor/theme/highlighting/breakpoint_color

Color

text_editor/theme/highlighting/caret_background_color

Color

text_editor/theme/highlighting/caret_color

Color

text_editor/theme/highlighting/code_folding_color

Color

text_editor/theme/highlighting/comment_color

Color

text_editor/theme/highlighting/completion_background_color

Color

text_editor/theme/highlighting/completion_existing_color

Color

text_editor/theme/highlighting/completion_font_color

Color

text_editor/theme/highlighting/completion_scroll_color

Color

text_editor/theme/highlighting/completion_scroll_hovered_color

Color

text_editor/theme/highlighting/completion_selected_color

Color

text_editor/theme/highlighting/control_flow_keyword_color

Color

text_editor/theme/highlighting/current_line_color

Color

text_editor/theme/highlighting/doc_comment_color

Color

text_editor/theme/highlighting/engine_type_color

Color

text_editor/theme/highlighting/executing_line_color

Color

text_editor/theme/highlighting/folded_code_region_color

Color

text_editor/theme/highlighting/function_color

Color

text_editor/theme/highlighting/keyword_color

Color

text_editor/theme/highlighting/line_length_guideline_color

Color

text_editor/theme/highlighting/line_number_color

Color

text_editor/theme/highlighting/mark_color

Color

text_editor/theme/highlighting/member_variable_color

Color

text_editor/theme/highlighting/number_color

Color

text_editor/theme/highlighting/safe_line_number_color

Color

text_editor/theme/highlighting/search_result_border_color

Color

text_editor/theme/highlighting/search_result_color

Color

text_editor/theme/highlighting/selection_color

Color

text_editor/theme/highlighting/string_color

Color

text_editor/theme/highlighting/symbol_color

Color

text_editor/theme/highlighting/text_color

Color

text_editor/theme/highlighting/text_selected_color

Color

text_editor/theme/highlighting/user_type_color

Color

text_editor/theme/highlighting/word_highlighted_color

int

text_editor/theme/line_spacing

String

version_control/ssh_private_key_path

String

version_control/ssh_public_key_path

String

version_control/username

方法

void

add_property_info(info: Dictionary)

bool

check_changed_settings_in_group(setting_prefix: String) const

void

erase(property: String)

PackedStringArray

get_changed_settings() const

PackedStringArray

get_favorites() const

Variant

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

PackedStringArray

get_recent_dirs() const

Variant

get_setting(name: String) const

bool

has_setting(name: String) const

void

mark_setting_changed(setting: String)

void

set_builtin_action_override(name: String, actions_list: Array[InputEvent])

void

set_favorites(dirs: PackedStringArray)

void

set_initial_value(name: StringName, value: Variant, update_current: bool)

void

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

void

set_recent_dirs(dirs: PackedStringArray)

void

set_setting(name: String, value: Variant)


信号

settings_changed() 🔗

在编辑器设置改变后触发。


常量

NOTIFICATION_EDITOR_SETTINGS_CHANGED = 10000 🔗

在编辑器设置改变后触发。它被各种编辑器插件使用,以在主题更改时更新视觉效果,或在配置更改时更新逻辑。


属性说明

bool asset_library/use_threads 🔗

如果为 true,则资产库会多线程执行 HTTP 请求。这样资产库就不会每加载一个资产阻塞一次主线程了。


bool debugger/auto_switch_to_remote_scene_tree 🔗

如果为 true,当从编辑器中运行项目时会自动切换至远程场景树。如果为 false,当从编辑器中运行项目时会保持显示本地场景树。

警告:启用该设置后,运行包含大量节点的项目(通常是成千上万个节点)可能造成卡顿,即便未聚焦编辑器窗口也是如此。这是由于无论编辑器是否聚焦,远程场景树都会每帧更新。


bool debugger/auto_switch_to_stack_trace 🔗

如果为 true,当调试器触发断点或步进时会自动切换到栈跟踪面板。


bool debugger/profile_native_calls 🔗

如果为 true,则启用从非 GDScript Godot 函数(例如引擎类方法)收集分析数据。启用该功能会减慢执行速度,同时进一步进行分析。


int debugger/profiler_frame_history_size 🔗

分析器的帧历史的大小。如果项目以恒定的 60 FPS 渲染,则默认值(3600)允许查看最多 60 秒的分析。更高的值允许在图表中查看更长时间的分析,尤其是当项目以高帧率运行时。


int debugger/profiler_frame_max_functions 🔗

性能分析器中,每帧能够显示的脚本函数的最大数量。如果给定的分析器帧中存在超过这个数量的脚本函数,则这些函数会被完全全部丢弃。

注意:这个设置仅在首次启动性能分析器时读取,进行分析时修改无效。


int debugger/profiler_target_fps 🔗

可视性能分析器中显示的目标帧率,单位为帧每秒。


float debugger/remote_inspect_refresh_interval 🔗

远程检查器属性的刷新间隔(单位为秒)。值越低反应越快,但如果项目从编辑器运行并且“场景”面板中选中了远程场景树就可能导致卡顿。


float debugger/remote_scene_tree_refresh_interval 🔗

远程场景树的刷新间隔(单位为秒)。值越低反应越快,但如果项目从编辑器运行并且“场景”面板中选中了远程场景树就可能导致卡顿。


bool docks/filesystem/always_show_folders 🔗

如果为 true,则在启用拆分模式时,在文件系统停靠面板的底部窗格中显示文件夹。如果为 false,则只有文件将显示在底部窗格中。可以通过按 res:// 文件夹路径旁边的图标来切换拆分模式。

注意:当拆分模式被禁用(这是默认设置)时,该设置无效。


String docks/filesystem/other_file_extensions 🔗

文件系统面板不支持显示的文件扩展名列表,用英文逗号分隔,例如 "ico,icns"


String docks/filesystem/textfile_extensions 🔗

文件系统面板认为是(双击文件后)可编辑的文本文件的文件扩展名列表,用英文逗号分隔,例如 "txt,md,cfg,ini,log,json,yml,yaml,toml,xml"


int docks/filesystem/thumbnail_size 🔗

“文件系统”面板中使用的缩略图大小(单位为像素)。另见 filesystem/file_dialog/thumbnail_size


float docks/property_editor/auto_refresh_interval 🔗

检查器停靠面板中属性的刷新间隔。当在 2D/3D 编辑器中调整小工具并同时查看检查器时,该设置的效果特别明显。值越低检查器刷新越频繁,也会占用更多 CPU 时间。


float docks/property_editor/subresource_hue_tint 🔗

检查器停靠面板中子资源背景的着色强度。着色用于区分检查器中不同的子资源。值越高,背景颜色差异越明显。


如果为 true,则删除节点时如果存在引用该节点的动画轨道,就会在删除轨道前显示确认对话框。即便使用“删除(无确认)”快捷键也会显示该对话框。


bool docks/scene_tree/ask_before_revoking_unique_name 🔗

如果为 true,则会在左键单击场景树面板中节点名称旁的“百分号”图标后显示确认对话框。点击图标会废除节点的场景唯一名称,由于无法在找到标识符,可能影响对该场景唯一名称存在依赖的脚本的行为。


bool docks/scene_tree/auto_expand_to_selected 🔗

如果为 true,则在选中节点时,场景树停靠面板会自动展开该节点已折叠的父节点。


bool docks/scene_tree/center_node_on_reparent 🔗

如果为 true,则重新设置节点父级时创建的新节点,将位于所选节点的平均位置。


bool docks/scene_tree/hide_filtered_out_parents 🔗

如果为 true,则场景树面板只会显示与筛选器匹配的节点,不会显示不匹配的父节点。该设置也可以在“场景”面板的顶部菜单中更改。


bool docks/scene_tree/start_create_dialog_fully_expanded 🔗

如果为 true,则创建对话框(创建新节点/创建新资源)将以展开其所有部分开始。否则,部分将被折叠,直到用户开始搜索(这将根据需要自动展开部分)。


Color editors/2d/bone_color1 🔗

2D 骨架编辑器中,骨骼颜色渐变的“开始”点。


Color editors/2d/bone_color2 🔗

2D 骨架编辑器中,骨骼颜色渐变的“结束”点。


Color editors/2d/bone_ik_color 🔗

2D 骨架编辑器中,用于启用了反向运动学的骨骼的颜色。


Color editors/2d/bone_outline_color 🔗

2D 骨架编辑器中,用于未选中骨骼的轮廓颜色。另见 editors/2d/bone_selected_color


float editors/2d/bone_outline_size 🔗

2D 骨架编辑器中轮廓的大小(单位为像素)。另见 editors/2d/bone_width

注意:对此值的更改只有在以任何方式修改 Bone2D 节点,或者关闭并重新打开场景后才会生效。


Color editors/2d/bone_selected_color 🔗

2D 骨架编辑器中,用于已选中骨骼的颜色。另见 editors/2d/bone_outline_color


float editors/2d/bone_width 🔗

2D 骨架编辑器中的骨骼宽度(单位为像素)。另见 editors/2d/bone_outline_size

注意:对此值的更改只有在以任何方式修改 Bone2D 节点,或者关闭并重新打开场景后才会生效。


Color editors/2d/grid_color 🔗

2D 编辑器使用的栅格颜色。


Color editors/2d/guides_color 🔗

2D 编辑器使用的参考线颜色。可以通过从标尺上拖动鼠标光标来创建参考线。


Color editors/2d/smart_snapping_line_color 🔗

在 2D 编辑器中,绘制智能吸附线时使用的颜色。如果在 2D 编辑器视口顶部的“吸附选项”菜单中启用智能吸附,则移动 2D 节点时智能吸附线将自动显示。


bool editors/2d/use_integer_zoom_by_default 🔗

如果为 true,2D 编辑器将在不按住 Alt 键的情况下吸附到整数缩放值。如果为 false 则交换这种行为。


Color editors/2d/viewport_border_color 🔗

2D 编辑器中视口边框的颜色。该边框表示在项目设置中定义的基本分辨率下的视口大小。除非使用 Camera2D 节点,或者除非调整窗口大小并将拉伸模式设置为 disabled,否则放置在该边界之外的对象将不可见。


float editors/2d/zoom_speed_factor 🔗

在 2D 编辑器中进行缩放时使用的系数。例如 1.1 会按照每步 10% 缩放。如果设为 2.0,则只会在二的幂之间循环。


float editors/3d/default_fov 🔗

在 3D 编辑器中使用的默认相机垂直视野(以度为单位)。可以使用 3D 编辑器顶部的查看菜单,在每个场景的基础上调整相机视野。如果使用查看菜单调整了场景的相机视野,则该设置将在相关场景中被忽略。在编辑器中预览 Camera3D 节点时,该设置也将被忽略。

注意:编辑器相机始终使用保持高度长宽比模式。


float editors/3d/default_z_far 🔗

在 3D 编辑器中使用的默认相机远剪辑距离(以度为单位)。较高的值可以查看距离相机较远的对象,但会降低深度缓冲区的精度(这可能导致远处可见的 Z 冲突)。可以使用 3D 编辑器顶部的查看菜单在每个场景的基上,调整相机远剪辑距离。如果一个场景使用查看菜单调整了其相机远剪辑距离,则该设置在相关场景中将被忽略。在编辑器中预览 Camera3D 节点时,该设置也将被忽略。


float editors/3d/default_z_near 🔗

要在 3D 编辑器中使用的默认相机近剪辑距离(以度为单位)。较低的值可以查看距离相机更近的对象,但会降低深度缓冲区的精度(这可能会导致远处可见的 Z 冲突)。可以使用 3D 编辑器顶部的查看菜单,在每个场景的基上调整相机近剪辑距离。如果一个场景使用查看菜单,调整了其相机近剪辑距离,则该设置在相关场景中将被忽略。在编辑器中预览 Camera3D 节点时,该设置也将被忽略。


int editors/3d/freelook/freelook_activation_modifier 🔗

用于在 3D 编辑器中启用自由观看的修饰键(在按下鼠标右键的同时)。

注意:无论该设置如何,自由观看切换键盘快捷键(默认为 Shift + F)始终可用。

注意:在 Linux 的某些窗口管理器上,Alt 键在同时单击鼠标按钮时会被窗口管理器拦截。这意味着 Godot 不会看到该修饰键被按下。


float editors/3d/freelook/freelook_base_speed 🔗

基本 3D 自由观看速度(单位:3D 单位(unit)每秒)。这可以通过在自由观看模式下使用鼠标滚轮进行调整,或者按住“快速”或“慢速”修饰键(默认分别为 ShiftAlt )。


float editors/3d/freelook/freelook_inertia 🔗

3D 自由观看相机的惯性。较高的值会使相机启动和停止更慢,这看起来更流畅但会增加延迟。


int editors/3d/freelook/freelook_navigation_scheme 🔗

在 3D 编辑器中启用自由观看时使用的导航方案。在 3D 编辑器中设计特定关卡时,下面的一些导航方案可能会更方便。

  • 默认值:“自由观看向前”、“自由观看向后”、“自由观看向上”和“自由观看向下”键将相对于相机移动,运动时考虑相机的俯仰角。

  • 部分轴锁定:“自由观看向前”和“自由观看向后”键将相对于相机移动,运动时考虑相机的俯仰角。“自由观看向上”和“自由观看向下”键将以“绝对的”方式移动,运动时考虑相机的俯仰角。

  • 完全轴锁定:“自由观看向前”、“自由观看向后”、“自由观看向上”和“自由观看向下”键将以“绝对的”方式移动,运动时考虑相机的俯仰角。

另见 editors/3d/navigation/navigation_scheme


float editors/3d/freelook/freelook_sensitivity 🔗

在 3D 编辑器中启用自由观看模式时使用的鼠标灵敏度。另见 editors/3d/navigation_feel/orbit_sensitivity


如果为 true,则自由观看速度与 3D 编辑器中相机轨道模式中使用的缩放值相关联。


float editors/3d/grid_division_level_bias 🔗

在 3D 编辑器中使用的栅格划分偏差。负值会使小的栅格划分出现得更早,而正值会使小的栅格划分出现得更晚。


int editors/3d/grid_division_level_max 🔗

在 3D 编辑器中使用的最大栅格划分。这个属性与 editors/3d/primary_grid_steps 一同决定栅格划分的大小。栅格不能大于 primary_grid_steps ^ grid_division_level_max 个单位。默认情况下 editors/3d/primary_grid_steps8,这意味着无论相机离栅格有多远,每个栅格划分都不能大于 64 个单位(因此主栅格线之间相距 512 个单位)。


int editors/3d/grid_division_level_min 🔗

在 3D 编辑器中使用的最小栅格划分。这个属性与 editors/3d/primary_grid_steps 一同决定栅格划分的大小。栅格不能小于 primary_grid_steps ^ grid_division_level_min 个单位。默认情况下这意味着无论相机离栅格有多近,每个栅格划分都不能小于 1 个单位。


int editors/3d/grid_size 🔗

栅格大小,单位:3D 单位(unit)。较高的值可防止栅格在某些角度出现“截断”,但会使栅格对渲染的要求更高。根据相机的位置,栅格可能不会完全可见,因为着色器用于逐渐淡化它。


bool editors/3d/grid_xy_plane 🔗

如果为 true,则在 XY 平面上渲染栅格,使用透视图。可用于 3D 横向卷轴游戏。


bool editors/3d/grid_xz_plane 🔗

如果为 true,则在 XZ 平面上渲染栅格,使用透视图。


bool editors/3d/grid_yz_plane 🔗

如果为 true,则在 YZ 平面上渲染栅格,使用透视图。可用于 3D 横向卷轴游戏。


float editors/3d/manipulator_gizmo_opacity 🔗

用于对 3D 节点进行移动、旋转、缩放的默认小工具的不透明度。


int editors/3d/manipulator_gizmo_size 🔗

用于对 3D 节点进行移动、旋转、缩放的默认小工具的大小。


bool editors/3d/navigation/emulate_3_button_mouse 🔗

如果为 true,启用 3 键鼠标模拟模式。这在使用触控板的笔记本电脑上很有用。

启用 3 键鼠标模拟模式后,即使未按住任何鼠标按钮,也始终可以在 3D 编辑器视口中使用平移、缩放和视轨修饰键。


bool editors/3d/navigation/emulate_numpad 🔗

如果为 true,则允许使用顶行 0-9 键作为 3D 编辑器导航的等效数字键盘键。应该在没有可用数字小键盘的键盘上启用。


bool editors/3d/navigation/invert_x_axis 🔗

如果为 true,则在 3D 编辑器中平移或视轨时,反转鼠标水平轴。该设置适用于自由观看模式。


bool editors/3d/navigation/invert_y_axis 🔗

如果为 true,则在 3D 编辑器中平移、视轨或使用自由观看模式时,反转鼠标垂直轴。


int editors/3d/navigation/navigation_scheme 🔗

在 3D 编辑器中使用的导航方案。更改该设置会影响在 3D 编辑器视口中导航所需的鼠标按钮和修饰键。

所有方案下都可以使用鼠标滚轮进行缩放。

  • Godot:鼠标中键进行视轨。Shift + 鼠标中键进行平移。Ctrl + 鼠标中键进行缩放。

  • Maya:Alt + 鼠标左键进行视轨。鼠标中键进行平移,Shift + 鼠标中键提高 10 倍平移速度。Alt + 鼠标右键进行缩放。

  • Modo:Alt + 鼠标左键进行视轨。Alt + Shift + 鼠标左键进行平移。 Ctrl + Alt + 鼠标左键进行缩放。

  • Tablet/Trackpad:Alt进行视轨。Shift进行平移。Ctrl 进行缩放。启用三键鼠标模拟模式。

另见 editors/3d/navigation/orbit_mouse_buttoneditors/3d/navigation/pan_mouse_buttoneditors/3d/navigation/zoom_mouse_buttoneditors/3d/freelook/freelook_navigation_scheme, and editors/3d/navigation/emulate_3_button_mouse

注意:在 Linux 的某些窗口管理器上,点击鼠标按钮的同时 Alt 键会被窗口管理器拦截。这意味着 Godot 不会看到按下了该修饰键。


int editors/3d/navigation/orbit_mouse_button 🔗

在 3D 编辑器视口中视轨时需要按住的鼠标按键。


int editors/3d/navigation/pan_mouse_button 🔗

在 3D 编辑器视口中平移时需要按住的鼠标按键。


bool editors/3d/navigation/show_viewport_navigation_gizmo 🔗

如果为 true,则会在 3D 编辑器视口的下方角落处显示对相机进行移动和旋转操作的小工具。适合触屏设备。


bool editors/3d/navigation/show_viewport_rotation_gizmo 🔗

如果为 true,则会在 3D 编辑器视口的右上角显示朝向小工具。


bool editors/3d/navigation/warped_mouse_panning 🔗

如果为 true,则会在 3D 编辑器中平移时,鼠标超出 3D 视口范围后将其传送到对侧。这样在大型区域中平移就不必先退出平移然后调整鼠标光标。


int editors/3d/navigation/zoom_mouse_button 🔗

在 3D 编辑器视口中进行缩放时需要按住的鼠标按键。


int editors/3d/navigation/zoom_style 🔗

当通过移动鼠标进行缩放时要使用的鼠标光标移动方向。这不会影响使用鼠标滚轮进行缩放。


float editors/3d/navigation_feel/orbit_inertia 🔗

在 3D 编辑器中进行视轨时要使用的惯性。更高的值会使相机启动和停止更慢,这看起来更流畅但会增加延迟。


float editors/3d/navigation_feel/orbit_sensitivity 🔗

在 3D 编辑器中进行视轨时要使用的鼠标灵敏度。另见 editors/3d/freelook/freelook_sensitivity


float editors/3d/navigation_feel/translation_inertia 🔗

在 3D 编辑器中进行平移时要使用的惯性。更高的值会使相机启动和停止更慢,这看起来更流畅但会增加延迟。


float editors/3d/navigation_feel/translation_sensitivity 🔗

在 3D 编辑器中进行平移时的鼠标灵敏度。


float editors/3d/navigation_feel/zoom_inertia 🔗

在 3D 编辑器中进行缩放时要使用的惯性。更高的值会使相机启动和停止更慢,这看起来更流畅但会增加延迟。


Color editors/3d/primary_grid_color 🔗

用于主要 3D 栅格的颜色。颜色的 Alpha 通道会影响栅格的不透明度。


int editors/3d/primary_grid_steps 🔗

如果被设置为大于 0 的值,则主栅格线应在其中被绘制。默认情况下,主栅格线被配置的比次要栅格线更显眼。这有助于在 3D 编辑器中进行测量。另见 editors/3d/primary_grid_coloreditors/3d/secondary_grid_color


Color editors/3d/secondary_grid_color 🔗

用于次要 3D 栅格的颜色。这通常是没有 editors/3d/primary_grid_color 显眼的颜色。颜色的 Alpha 通道影响栅格的不透明度。


Color editors/3d/selection_box_color 🔗

用于在 3D 编辑器视口中围绕选定节点的选择框的颜色。颜色的 Alpha 通道影响选择框的不透明度。


Color editors/3d_gizmos/gizmo_colors/aabb 🔗

显示 GeometryInstance3D 自定义 AABB 的 AABB 小工具所使用的颜色。


Color editors/3d_gizmos/gizmo_colors/camera 🔗

Camera3D 对应的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/csg 🔗

CSG 节点(例如 CSGShape3DCSGBox3D)对应的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/decal 🔗

Decal 节点对应的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/fog_volume 🔗

FogVolume 节点对应的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/gridmap_grid 🔗

GridMap 栅格对应的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/instantiated 🔗

用于 3D 编辑器小工具的颜色覆盖,适用于相关的 Node3D(从当前场景的角度看)属于实例化场景文件的情况。


Color editors/3d_gizmos/gizmo_colors/joint 🔗

用于 Joint3DPhysicalBone3D 的 3D 编辑器小工具颜色。


Color editors/3d_gizmos/gizmo_colors/joint_body_a 🔗

表示部分 Joint3D 类型中 Joint3D.node_a 的颜色。


Color editors/3d_gizmos/gizmo_colors/joint_body_b 🔗

表示部分 Joint3D 类型中 Joint3D.node_b 的颜色。


Color editors/3d_gizmos/gizmo_colors/lightmap_lines 🔗

显示在烘焙 LightmapGI 节点栅格中的直线的颜色。


Color editors/3d_gizmos/gizmo_colors/lightprobe_lines 🔗

用于 LightmapProbe 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/occluder 🔗

用于 OccluderInstance3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/particle_attractor 🔗

用于 GPUParticlesAttractor3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/particle_collision 🔗

用于 GPUParticlesCollision3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/particles 🔗

用于 CPUParticles3DGPUParticles3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/path_tilt 🔗

用于 Path3D 节点倾斜圈的 3D 编辑器小工具的颜色,倾斜圈表示 Curve3D 的倾斜方向。


Color editors/3d_gizmos/gizmo_colors/reflection_probe 🔗

用于 ReflectionProbe 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/selected_bone 🔗

用于 Skeleton3D 中当前选中骨骼的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/skeleton 🔗

用于 Skeleton3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/spring_bone_collision 🔗

用于 SpringBoneCollision3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/spring_bone_inside_collision 🔗

用于启用了内部模式的 SpringBoneCollision3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/spring_bone_joint 🔗

用于 SpringBoneSimulator3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/stream_player_3d 🔗

用于 AudioStreamPlayer3D 节点发射角的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/visibility_notifier 🔗

用于 VisibleOnScreenNotifier3DVisibleOnScreenEnabler3D 节点的 3D 编辑器小工具的颜色。


Color editors/3d_gizmos/gizmo_colors/voxel_gi 🔗

用于 VoxelGI 节点的 3D 编辑器小工具的颜色。


float editors/3d_gizmos/gizmo_settings/bone_axis_length 🔗

3D 编辑器中 Skeleton3D 骨骼小工具的长度。


int editors/3d_gizmos/gizmo_settings/bone_shape 🔗

3D 编辑器中 Skeleton3D 骨骼小工具的形状。Wire 是细线,而 Octahedron 则是一组线条,表示一个指向特定方向的较粗的空心线(与大多数 3D 动画软件类似)。


float editors/3d_gizmos/gizmo_settings/path3d_tilt_disk_size 🔗

编辑 Path3D 的倾斜手柄时显示的圆盘小工具的大小。


bool editors/animation/autorename_animation_tracks 🔗

如果为 true,则在“场景”面板中重命名节点或重设节点的父节点时,会自动更新动画轨道的目标路径。


bool editors/animation/confirm_insert_track 🔗

如果为 true,则在通过按下属性旁边的“钥匙”图标向动画添加新轨道时会显示确认对话框。按住 Shift 将绕过该对话框。

如果为 false,则行为相反,即仅当按住 Shift 时才会显示对话框。


bool editors/animation/default_create_bezier_tracks 🔗

如果为 true,则在按下属性旁的“钥匙”图标向动画中添加新轨道时,创建贝塞尔轨道而不是标准轨道。贝塞尔轨道可以更精细地控制动画曲线,但调整的难度也会大一些。


bool editors/animation/default_create_reset_tracks 🔗

如果为 true,则会在新建动画轨道时创建 RESET 轨道。这个轨道会用于将动画恢复到“默认”状态。


Color editors/animation/onion_layers_future_color 🔗

调制颜色,用于在动画编辑器的洋葱皮功能中显示“未来”帧。


Color editors/animation/onion_layers_past_color 🔗

调制颜色,用于在动画编辑器的洋葱皮功能中显示“过去”帧。


Color editors/bone_mapper/handle_colors/error 🔗

该属性目前没有描述,请帮我们贡献一个吧!


Color editors/bone_mapper/handle_colors/missing 🔗

该属性目前没有描述,请帮我们贡献一个吧!


Color editors/bone_mapper/handle_colors/set 🔗

该属性目前没有描述,请帮我们贡献一个吧!


Color editors/bone_mapper/handle_colors/unset 🔗

该属性目前没有描述,请帮我们贡献一个吧!


int editors/grid_map/palette_min_width 🔗

GridMap 网格调色板侧边面板的最小宽度。


float editors/grid_map/pick_distance 🔗

可以在 GridMap 上放置图块的最大距离,相对于相机位置(使用 3D 单位)。


int editors/grid_map/preview_size 🔗

为 GridMap 的 MeshLibrary 生成的网格预览纹理的大小。


int editors/panning/2d_editor_pan_speed 🔗

在 2D 编辑器中使用鼠标滚轮或触摸屏事件进行平移的速度。该设置不适用于通过按住鼠标中键或鼠标右键进行的平移。


int editors/panning/2d_editor_panning_scheme 🔗

控制在 2D 编辑器中滚动鼠标滚轮是缩放还是平移。另见 editors/panning/sub_editors_panning_schemeeditors/panning/animation_editors_panning_scheme


int editors/panning/animation_editors_panning_scheme 🔗

控制在动画轨道编辑器和贝塞尔编辑器中滚动鼠标滚轮是缩放还是平移。另见 editors/panning/2d_editor_panning_schemeeditors/panning/sub_editors_panning_scheme(控制的是动画混合树编辑器中的平移行为)。


bool editors/panning/simple_panning 🔗

如果为 true,允许通过在 2D 编辑器视口中,按住 Space 进行平移(除了使用鼠标中键或鼠标右键进行平移)。如果为 false,则必须在按住 Space 的同时,按住鼠标左键才能在 2D 编辑器视口中进行平移。


int editors/panning/sub_editors_panning_scheme 🔗

控制鼠标滚轮滚动在子编辑器中是缩放还是平移。受影响的子编辑器列表有:动画混合树编辑器、Polygon2D 编辑器、图块集编辑器、纹理区域编辑器和可视着色器编辑器。另见 editors/panning/2d_editor_panning_schemeeditors/panning/animation_editors_panning_scheme


bool editors/panning/warped_mouse_panning 🔗

如果为 true,则会在 2D 编辑器中平移时,鼠标超出 2D 视口范围后将其传送到对侧。这样在大型区域中平移就不必先退出平移然后调整鼠标光标。


float editors/polygon_editor/auto_bake_delay 🔗

延迟数秒,直到更复杂且性能成本更高的多边形编辑器提交其轮廓,例如 2D 导航多边形编辑器重新烘焙导航网格多边形。负值会停止自动烘焙。


int editors/polygon_editor/point_grab_radius 🔗

Polygon2DCollisionPolygon2D 编辑器中,点可以被选择的半径(以像素为单位)。更高的值可以更轻松地快速地选择点,但是当多个点彼此靠近时,可能会使选择想要的点变得更加困难。


bool editors/polygon_editor/show_previous_outline 🔗

如果为 true,则在 2D 多边形编辑器中,以不透明的灰色轮廓,显示多边形先前的形状。拖动一个点直到释放鼠标左键前,会显示该轮廓。


bool editors/shader_editor/behavior/files/restore_shaders_on_load 🔗

如果为 true,则会重新打开项目上一次关闭时着色器编辑器中打开的着色器文件。


bool editors/tiles_editor/display_grid 🔗

如果为 true,则在 TileMap 编辑器处于活动状态时显示一个栅格。另见 editors/tiles_editor/grid_color


Color editors/tiles_editor/grid_color 🔗

用于 TileMap 编辑器栅格的颜色。

注意:仅当 editors/tiles_editor/display_gridtrue 时有效。


bool editors/tiles_editor/highlight_selected_layer 🔗

通过将场景中的其他 TileMapLayer 变暗来高亮当前选中的 TileMapLayer。


Color editors/visual_editors/category_colors/color_color 🔗

当图形节点属于“颜色”类别时其标题的颜色。


Color editors/visual_editors/category_colors/conditional_color 🔗

当图形节点属于“条件”类别时其标题的颜色。


Color editors/visual_editors/category_colors/input_color 🔗

当图形节点属于“输入”类别时其标题的颜色。


Color editors/visual_editors/category_colors/output_color 🔗

当图形节点属于“输出”类别时其标题的颜色。


Color editors/visual_editors/category_colors/particle_color 🔗

当图形节点属于“粒子”类别时其标题的颜色。


Color editors/visual_editors/category_colors/scalar_color 🔗

当图形节点属于“标量”类别时其标题的颜色。


Color editors/visual_editors/category_colors/special_color 🔗

当图形节点属于“特殊”类别时其标题的颜色。


Color editors/visual_editors/category_colors/textures_color 🔗

当图形节点属于“纹理”类别时其标题的颜色。


Color editors/visual_editors/category_colors/transform_color 🔗

当图形节点属于“变换”类别时其标题的颜色。


Color editors/visual_editors/category_colors/utility_color 🔗

当图形节点属于“实用程序”类别时其标题的颜色。


Color editors/visual_editors/category_colors/vector_color 🔗

当图形节点属于“向量”类别时其标题的颜色。


String editors/visual_editors/color_theme 🔗

在可视化着色器编辑器中使用的颜色主题。


Color editors/visual_editors/connection_colors/boolean_color 🔗

布尔类型的端口/连接的颜色。


Color editors/visual_editors/connection_colors/sampler_color 🔗

采样器类型的端口/连接的颜色。


Color editors/visual_editors/connection_colors/scalar_color 🔗

标量类型(float、int、unsigned int)的端口/连接的颜色。


Color editors/visual_editors/connection_colors/transform_color 🔗

变换类型的端口/连接的颜色。


Color editors/visual_editors/connection_colors/vector2_color 🔗

Vector2 类型的端口/连接的颜色。


Color editors/visual_editors/connection_colors/vector3_color 🔗

Vector3 类型的端口/连接的颜色。


Color editors/visual_editors/connection_colors/vector4_color 🔗

Vector4 类型的端口/连接的颜色。


int editors/visual_editors/grid_pattern 🔗

用于背景栅格的图案。


float editors/visual_editors/lines_curvature 🔗

用于可视着色器编辑器中连接线的曲率。更高的值会使连接线看起来更弯曲,值高于 0.5 会导致连接线中间出现更多“角度”转折。


float editors/visual_editors/minimap_opacity 🔗

在可视着色器编辑器的右下角显示的小地图的不透明度。


int editors/visual_editors/visual_shader/port_preview_size 🔗

在可视着色器 uniform 中用于端口预览的大小(通过点击输出旁边的“眼睛”图标进行切换)。该值以像素为单位且以 100% 缩放时的值定义,并将随缩放自动缩放。


String export/ssh/scp 🔗

SCP(安全复制)可执行文件的路径(用于向桌面平台进行远程部署)。如果留空,则编辑器会尝试根据 PATH 运行 scp

注意:SCP 与 SFTP 不同。在此处指定 SFTP 可执行文件无效。


String export/ssh/ssh 🔗

SSH 可执行文件的路径(用于向桌面平台进行远程部署)。如果留空,则编辑器会尝试根据 PATH 运行 ssh


String filesystem/directories/autoscan_project_path 🔗

项目应该被(递归地)扫描的文件夹,其方式类似于项目经理的扫描按钮。为方便起见,可以将其设置为与 filesystem/directories/default_project_path 相同的值。

注意:将该路径设置为一个包含大量文件/文件夹的文件夹,会显著减慢项目管理器的启动速度。为了让项目管理器快速启动,建议将该值设置为一个尽可能“具体”的文件夹。


String filesystem/directories/default_project_path 🔗

点击项目管理器的新建项目按钮时,默认应在其中创建新项目的文件夹。为方便起见,可以将其设置为与 filesystem/directories/autoscan_project_path 相同的值。


String filesystem/external_programs/3d_model_editor 🔗

点击文件系统面板中的“在外部程序中打开”选项时,用于打开 3D 模型场景文件的程序。如果未指定,则该文件会使用系统默认的程序打开。


String filesystem/external_programs/audio_editor 🔗

点击文件系统面板中的“在外部程序中打开”选项时,用于打开音频文件的程序。如果未指定,则该文件会使用系统默认的程序打开。


String filesystem/external_programs/raster_image_editor 🔗

点击文件系统面板中的“在外部程序中打开”选项时,用于打开位图文件的程序。如果未指定,则该文件会使用系统默认的程序打开。


String filesystem/external_programs/terminal_emulator 🔗

执行文件系统面板的在终端中打开上下文菜单动作时使用的终端模拟器程序。可以输入可执行文件的绝对路径,也可以输入存在于 PATH 环境变量中的程序路径。

留空时 Godot 会使用系统的默认终端模拟器:

  • Windows:PowerShell

  • macOS:Terminal.app

  • Linux:按以下顺序找到的第一个终端:gnome-terminal、konsole、xfce4-terminal、lxterminal、kitty、alacritty、urxvt、xterm。

如果想要在 Windows 上使用“命令提示符”(cmd)代替 PowerShell,请在这个字段中输入 cmd,这样就会自动使用正确的标志。

在 macOS 上,请确保指向的是位于 .app 捆绑包的 Programs/MacOS 文件夹中的实际可执行文件,不要指向 .app 捆绑包目录。

指定自定义终端模拟器时,你可能还会需要覆盖 filesystem/external_programs/terminal_emulator_flags,从而让它在正确的文件夹中打开。


String filesystem/external_programs/terminal_emulator_flags 🔗

执行文件系统面板的在终端中打开上下文菜单动作时传递给终端模拟器的命令行参数。另见 filesystem/external_programs/terminal_emulator

留空时默认的标志是 {directory},会替换为要在终端中打开的目录的绝对路径。

注意:终端模拟器为 PowerShell、cmd、Konsole 时,Godot 会自动在这个列表前加入一些额外的参数,因为这些终端需要非标准的参数才能够在正确的文件夹中打开。


String filesystem/external_programs/vector_image_editor 🔗

点击文件系统面板中的“在外部程序中打开”选项时,用于打开矢量图文件的程序。如果未指定,则该文件会使用系统默认的程序打开。


int filesystem/file_dialog/display_mode 🔗

编辑器的文件对话框所使用的显示模式。

  • Thumbnails(缩略图)占据更多空间,但可以显示动态资源缩略图,无需打开也能够方便地预览资源。

  • List(列表)更紧凑,但不显示动态资源缩略图,而是根据文件扩展名显示静态图标。


bool filesystem/file_dialog/show_hidden_files 🔗

如果为 true,则在编辑器的文件对话框中显示隐藏文件。名称以 . 开头的文件被视为隐藏文件(例如 .hidden_file)。


int filesystem/file_dialog/thumbnail_size 🔗

编辑器的文件对话框中使用的缩略图大小(单位为像素)。另见 docks/filesystem/thumbnail_size


String filesystem/file_server/password 🔗

导出使用远程文件系统的项目时,文件服务器的密码。


int filesystem/file_server/port 🔗

导出使用远程文件系统的项目时,文件服务器的端口。


String filesystem/import/blender/blender_path 🔗

Blender 可执行文件的路径,用于在导入时将 Blender 3D 场景文件 .blend 转换为 glTF 2.0 格式。必须是 Blender 3.0 或后续版本。

针对特定项目启用该功能请使用 ProjectSettings.filesystem/import/blender/enabled

如果将该设置留空,则会检测 Blender 的默认位置,如果存在就会自动使用,检测顺序如下:

Windows:

- C:\Program Files\Blender Foundation\blender.exe
- C:\Program Files (x86)\Blender Foundation\blender.exe

macOS:

- /opt/homebrew/bin/blender
- /opt/local/bin/blender
- /usr/local/bin/blender
- /usr/local/opt/blender
- /Applications/Blender.app/Contents/MacOS/Blender

Linux/*BSD:

- /usr/bin/blender
- /usr/local/bin/blender
- /opt/blender/bin/blender

int filesystem/import/blender/rpc_port 🔗

用于与 Godot 创建的 Blender 可执行文件进程进行远程过程调用(RPC)通信的端口号。

将其设置为 0 会有效禁用与 Godot 的通信和 Blender 进程,从而降低性能。


float filesystem/import/blender/rpc_server_uptime 🔗

Blender 进程的最大空闲运行时间(单位为秒)。

能够在给定的秒数内,防止 Godot 每次导入都创建一个新的进程。


String filesystem/import/fbx/fbx2gltf_path 🔗

包含 FBX2glTF 可执行文件的目录,导入时会使用 FBX2glTF 将 Autodesk FBX 3D 场景文件 .fbx 转换为 glTF 2.0 格式。

要为指定项目启用这个功能,请使用 ProjectSettings.filesystem/import/fbx2gltf/enabled


bool filesystem/on_save/compress_binary_resources 🔗

如果为 true,则对二进制资源使用无损压缩。


bool filesystem/on_save/safe_save_on_backup_then_rename 🔗

如果为 true,当保存文件时,编辑器会将旧文件重命名为不同的名称,保存一个新文件,然后只有在新文件保存后,才删除旧文件。如果编辑器或操作系统在保存时意外退出(例如,由于崩溃或断电),这会降低数据丢失的可能性。

注意:在 Windows 上,该功能可能会与某些防病毒程序产生负面的交互。在这种情况下,可能必须将其设置为 false,以防止出现文件锁定问题。


int filesystem/quick_open_dialog/default_display_mode 🔗

如果设置为 Adaptive,对话框将根据请求的类型以列表视图或网格视图打开。如果设置为 Last Used,则显示模式将始终以上次使用的方式打开。


bool filesystem/quick_open_dialog/enable_fuzzy_matching 🔗

如果为 true,则允许对搜索内容进行模糊匹配。


bool filesystem/quick_open_dialog/include_addons 🔗

如果为 true,则结果中不包含位于 addons 文件夹中的文件。


int filesystem/quick_open_dialog/max_fuzzy_misses 🔗

启用模糊匹配时,匹配中允许缺失的查询字符的数量。例如使用默认值 2 时,foobar 能够匹配 fooburfoob,但无法匹配 foo


int filesystem/quick_open_dialog/max_results 🔗

对话框中显示的最大匹配数。


bool filesystem/quick_open_dialog/show_search_highlight 🔗

如果为 true,则搜索结果中会将匹配内容高亮。


String filesystem/tools/oidn/oidn_denoise_path 🔗

包含开放图像去噪(OIDN)可执行文件的目录路径,可选择用于去噪光照贴图。它可以从 openimagedenoise.org 下载。

要为特定项目启用该功能,请使用 ProjectSettings.rendering/lightmapping/denoising/denoiser


bool input/buffering/agile_event_flushing 🔗

如果为 true,则输入事件将在每个空闲帧和物理帧之前刷新。

如果为 false,则这些事件将仅在引擎迭代之间每个处理帧刷新一次。

启用该设置可以大大提高输入响应能力,尤其是在难以以项目预期的帧速率运行的设备中。


bool input/buffering/use_accumulated_input 🔗

如果为 true,则操作系统发送的相似输入事件将被累积。启用输入累积后,单帧期间生成的所有输入事件将被合并,并在该帧渲染完毕时发出。因此,这会将每秒输入方法调用的次数限制为渲染 FPS。

可以禁用输入累积,以获得稍微更精确/反应灵敏的输入,但代价是增加 CPU 使用率。

注意:输入累积默认是启用的


int interface/editor/accept_dialog_cancel_ok_buttons 🔗

如何在编辑器的 AcceptDialog 中定位取消和确定按钮。不同的平台有不同的标准行为,可以用这个设置来覆盖。如果你在 Windows 和 macOS/Linux 上都使用 Godot,而且你的 Godot 肌肉记忆比你的操作系统记忆更强,那么这一点很有用。

  • Auto 遵守平台约定:在 macOS 和 Linux 上取消在前,在 Windows 上确定在前。

  • Cancel First 强制为取消/确定的顺序。

  • OK First 强制为确定/取消的顺序。


bool interface/editor/automatically_open_screenshots 🔗

如果为 true,则在使用编辑器 > 截图动作截取屏幕截图后,使用与 .png 文件关联的默认程序自动打开该屏幕截图。


String interface/editor/code_font 🔗

脚本编辑器所使用的字体。必须是 Font 类型的资源,例如 .ttf.otf 字体文件。


int interface/editor/code_font_contextual_ligatures 🔗

为当前配置的代码字体启用的字体连字。并非所有字体都包含对连字的支持。

注意:编辑器默认的代码字体(JetBrains Mono)在其字体文件中具有上下文连字。


String interface/editor/code_font_custom_opentype_features 🔗

要使用的自定义 OpenType 特性列表,需要当前配置的代码字体支持。并非所有字体都支持自定义 OpenType 特性。该字符串应遵循 OpenType 规范。

注意:编辑器默认的代码字体(JetBrains Mono)在其字体文件中具有自定义 OpenType 特性,但是目前还没有文档记录的清单。


String interface/editor/code_font_custom_variations 🔗

要使用的备选字符列表,需要当前配置的代码字体支持。并非所有字体都支持自定义变体。该字符串应遵循 OpenType 规范。

注意:编辑器默认的代码字体(JetBrains Mono)在其字体文件中有备选字符,但是有还没有文档记录的清单。


int interface/editor/code_font_size 🔗

脚本编辑器中的字体大小。该设置不会影响“输出”面板的字体大小(请参阅 run/output/font_size)。


float interface/editor/custom_display_scale 🔗

要使用的自定义编辑器缩放系数。这可用于具有非常高 DPI 的显示器,其中 200% 的缩放系数是不够的。

注意:只有当 interface/editor/display_scale 被设置为 自定义(Custom) 时才有效。


int interface/editor/display_scale 🔗

用于编辑器界面的显示缩放系数。更高的值更适合 hiDPI/Retina 显示器。

如果被设置为 Auto,则编辑器缩放将根据屏幕分辨率和报告的显示 DPI 自动确定。这种启发式算法并不总是理想的,这意味着可以通过手动设置编辑器缩放来获得更好的结果。

如果被设置为 Custom,则将使用 interface/editor/custom_display_scale 中的缩放值。


int interface/editor/dock_tab_style 🔗

编辑器停靠面板的选项卡样式。


String interface/editor/editor_language 🔗

用于编辑器界面的语言。

翻译由社区提供。如果发现错误,请在 Weblate 上为编辑器翻译作出贡献!


int interface/editor/editor_screen 🔗

用于显示编辑器的首选显示器。如果为 Auto,则编辑器重启后会记住上一次显示的屏幕。


bool interface/editor/expand_to_title 🔗

将主编辑窗口内容扩展到标题区域,需要 DisplayServer 支持。见 DisplayServer.WINDOW_FLAG_EXTEND_TO_TITLE

专用于 macOS 平台。


bool interface/editor/font_allow_msdf 🔗

如果为 true,则可视化着色器图编辑器会使用 MSDF 字体渲染。使用自定义主字体时可能需要将其设置为 false,因为有些字体的数据中会使用自我交叉的轮廓,导致显示问题。从字体制作商的官方网站下载字体,而不是使用像 Google Fonts 这样的服务,可以帮助解决此问题。


int interface/editor/font_antialiasing 🔗

FreeType 的字体抗锯齿模式,用于渲染编辑器字体。大多数字体在禁用抗锯齿的情况下并不好看,所以建议保持启用,除非你使用的是像素风字体。


bool interface/editor/font_disable_embedded_bitmaps 🔗

如果为 true,则会禁用内嵌字体位图的加载(仅包含位图的字体以及彩色字体会禁用该属性)。


int interface/editor/font_hinting 🔗

用于编辑器字体的字体提示模式。FreeType 支持以下字体提示模式:

  • 无(None):光栅化字体时不使用字体提示。这会产生一个流畅的字体,但看起来可能会模糊。

  • Light:仅在 X 轴上使用提示。这是字体清晰度和平滑度之间的折衷。

  • Normal:在 X 和 Y 轴上使用提示。这会产生清晰的字体,但看起来不是很流畅。

如果被设置为 Auto,字体提示模式将被设置为匹配当前使用的操作系统。这意味着 Light 提示模式将在 Windows 和 Linux 上使用,而 None 提示模式将在 macOS 上使用。


int interface/editor/font_subpixel_positioning 🔗

渲染编辑器字体字形时要使用的子像素定位模式。这对主字体和代码字体都有影响。禁用 ,渲染速度最快,使用的内存最少。自动 ,只对小尺寸的字体使用子像素定位(这里的好处是最明显的)。二分之一像素四分之一像素对所有编辑器字体强制使用相同的子像素定位模式,无论其大小如何(其中四分之一像素是最高质量的选项)。


bool interface/editor/import_resources_when_unfocused 🔗

如果为 true,即使编辑器窗口未聚焦或最小化,也会(重新)导入资源。如果为 false,则仅在编辑器窗口聚焦时(重新)导入资源。可以将其设置为 true,以便在项目文件夹中保存文件时尽早启动导入过程来加快迭代速度。这还允许在无需点击编辑器窗口的情况下获得有关更改的视觉反馈,这在多显示器设置中很有用。将其设置为 true 的缺点是它会增加空闲 CPU 使用率,并且在导入资源时可能会窃取其他应用程序的 CPU 时间。


bool interface/editor/keep_screen_on 🔗

如果为 true,则保持屏幕打开(即使在不活动的情况下),因此屏幕保护程序不会接管。适用于桌面和移动平台。


bool interface/editor/localize_settings 🔗

如果为 true,则编辑器中的设置名称将尽可能本地化。

注意:该设置会影响编辑器 UI 中的大多数 EditorInspector,主要是项目设置和编辑器设置。要控制检查器面板中显示的名称,请改用 interface/inspector/default_property_name_style


int interface/editor/low_processor_mode_sleep_usec 🔗

启用低处理器使用模式时帧之间的睡眠时间(以微秒为单位)。更高的值将导致更低的 CPU/GPU 使用率,这可以延长笔记本电脑的电池寿命。但是,更高的值会导致编辑器的响应速度更慢。默认值设置为允许在高达 144 Hz 的显示器上实现最大流畅度。另见 interface/editor/unfocused_low_processor_mode_sleep_usec

注意:如果 interface/editor/update_continuouslytrue,则忽略该设置,因为启用该设置会禁用低处理器模式。


String interface/editor/main_font 🔗

用于编辑器界面的字体。必须是 Font 类型的资源,例如 .ttf.otf 字体文件。


String interface/editor/main_font_bold 🔗

用于编辑器界面中粗体文本的字体。必须是 Font 类型的资源,例如 .ttf.otf 字体文件。


int interface/editor/main_font_size 🔗

编辑器界面中字体的大小。


bool interface/editor/mouse_extra_buttons_navigate_history 🔗

如果为 true,鼠标的额外侧键将可用于在脚本编辑器的文件历史记录中导航。如果正将侧键用于其他目的(例如 VoIP 程序中的一键通按钮),请将该项设置为 false


int interface/editor/project_manager_screen 🔗

显示项目管理器的首选显示器。


bool interface/editor/save_each_scene_on_quit 🔗

如果为 false,则当正退出编辑器或正退出到项目列表时,确认保存动作后,编辑器将保存所有场景。如果为 true,则编辑器将要求单独保存每个场景。


bool interface/editor/save_on_focus_loss 🔗

如果为 true,则会在编辑器丢失焦点时保存场景和脚本。根据具体工作流程的不同,这种行为可能会比 text_editor/behavior/files/autosave_interval_secs 和自己记得手动保存要方便。


bool interface/editor/separate_distraction_mode 🔗

如果为 true,则编辑器的 Script 选项卡,将具有与 2D/3D/AssetLib 选项卡不同的干扰模式设置。如果为 false,无干扰模式切换在所有选项卡之间共享。


int interface/editor/show_internal_errors_in_toast_notifications 🔗

如果启用,则会使用吐司通知的形式显示引擎的内部错误(可通过点击编辑器底部的“铃铛”图标切换)。无论这个设置项是什么值,非引擎内部错误都会在吐司通知中显示。

默认的 Auto 只会在使用 dev_build=yes SCons 选项(默认为 dev_build=no)编译的编辑器中启用该功能。


int interface/editor/show_update_spinner 🔗

如果启用,则会在编辑器右上角显示一个图标,会在编辑器发生帧重绘时旋转。可以用来诊断引擎不断重绘的问题,防止无意义地增加对 CPU 和 GPU 的占用。要进一步排查这种情况,请在启动编辑器时使用 --debug-canvas-item-redraw 命令行参数

如果你在开发编辑器插件,请考虑启用这个设置,确保只在必要时触发编辑器的重绘。

默认为 Auto 只会在编辑器是使用 dev_build=yes Scons 选项时启用这个图标(默认为 dev_build=no)。

注意:如果 interface/editor/update_continuouslytrue,则旋转图会以红色显示。

注意:如果编辑器启动时使用了命令行参数 --debug-canvas-item-redraw,那么更新旋转图会无视该设置,永远不会显示。这么做是为了避免与现实场景中导致重绘的情况混淆。


bool interface/editor/single_window_mode 🔗

如果为 true,则会在主编辑器窗口中嵌入停靠面板等模态窗口。当启用单窗口模式时,工具提示也会被嵌入到主编辑器窗口中,这意味着它们无法在编辑器窗口之外显示。单窗口模式可能更快,因为无须为每个弹出项和工具提示都创建一个单独的窗口,根据操作系统和所使用的渲染方法的不同,创建窗口可能是很慢的操作。

等价于项目运行时的 ProjectSettings.display/window/subwindows/embed_subwindows,但是取值相反。

注意:要查询编辑器是否可以在编辑器插件中使用多个窗口,请使用 EditorInterface.is_multi_window_enabled() 而不是查询该编辑器设置的值。

注意:如果为 true,则会禁用游戏内嵌。


int interface/editor/ui_layout_direction 🔗

编辑器 UI 默认布局方向。


int interface/editor/unfocused_low_processor_mode_sleep_usec 🔗

当编辑器窗口未聚焦时,启用低处理器使用模式时帧之间的睡眠量(以微秒为单位)。更高的值将导致更低的 CPU/GPU 使用率,这可以延长笔记本电脑的电池寿命(如果编辑器必须连续重绘,还可以提高正在运行的项目的性能)。但是,更高的值会导致编辑器的响应速度变慢。默认值设置会在编辑器窗口未聚焦时,将编辑器限制为 20 FPS。另见 interface/editor/low_processor_mode_sleep_usec

注意:如果 interface/editor/update_continuouslytrue,则忽略该设置,因为启用该设置会禁用低处理器模式。


bool interface/editor/update_continuously 🔗

如果为 true,则即使屏幕上没有任何更改,也会在每一帧中重新绘制编辑器。启用该设置后,更新微调器显示为红色(请参阅 interface/editor/show_update_spinner)。

警告:这会大大增加 CPU 和 GPU 的利用率,从而导致功耗增加。仅应出于故障排除目的启用该功能。


bool interface/editor/use_embedded_menu 🔗

如果为 true,则编辑器的主菜单使用嵌入式 MenuBar,不使用系统全局菜单。

专用于 macOS 平台。


bool interface/editor/use_native_file_dialogs 🔗

如果为 true,编辑器 UI 将使用操作系统原生的文件/目录选择对话框。


int interface/editor/vsync_mode 🔗

设置编辑器的垂直同步模式。从编辑器运行时不会影响项目(这是由 ProjectSettings.display/window/vsync/vsync_mode 控制的)。

根据平台和使用的渲染器,如果不支持所需的模式,引擎将回退到启用

注意:启用之外的垂直同步模式,仅支持 Forward+ 和 Mobile 渲染方式,不支持 Compatibility。


bool interface/editors/derive_script_globals_by_name 🔗

如果为 true,则扩展脚本时如果脚本存在全局类名,就会在脚本创建对话框中插入该类名。如果为 false 则始终插入脚本的文件路径。


bool interface/editors/show_scene_tree_root_selection 🔗

如果为 true,则“场景”面板会显示为新创建的场景快速添加根节点的按钮。


bool interface/inspector/auto_unfold_foreign_scenes 🔗

如果为 true,则会在打开之前没有打开过的场景时,自动展开“检查器”面板中的属性分组。如果为 false,则默认折叠所有分组。


int interface/inspector/default_color_picker_mode 🔗

在编辑器中打开 ColorPicker 时使用的默认取色器模式。模式可以在取色器中临时调整。


int interface/inspector/default_color_picker_shape 🔗

在编辑器中打开 ColorPicker 时使用的默认取色器形状。形状可以在取色器中临时调整。


float interface/inspector/default_float_step 🔗

浮点数精度,适用于没有显式定义精度步长的属性。取值越小,输入值所能达到的精度就越高。


int interface/inspector/default_property_name_style 🔗

在检查器面板中显示的默认属性名称风格。可以在检查器面板的菜单中临时调整该风格。

  • Raw:snake_case 风格显示属性。

  • Capitalized:首字母大写显示属性。

  • Localized:如果给定属性有可用的翻译,则根据当前编辑器语言显示本地化字符串。如果没有可用的翻译,则回退至 Capitalized

注意:要在“项目设置”和“编辑器设置”中显示翻译后的设置名称,请改用 interface/editor/localize_settings


bool interface/inspector/delimitate_all_container_and_resources 🔗

如果为 true,则在未着色的数组、字典、资源编辑器周围添加边距。

注意:如果 interface/inspector/nested_color_modeContainers & Resources,则该参数无效,因为这些编辑器都已着色。


bool interface/inspector/disable_folding 🔗

如果为 true,则会在检查器面板中强制展开所有属性分组,阻止折叠。


float interface/inspector/float_drag_speed 🔗

浮点数数值在检查器中通过拖动来调整时的基础变化速度。


bool interface/inspector/horizontal_vector2_editing 🔗

如果为 true,则检查器会将 Vector2Vector2i 属性显示为一行而不是两行。显示为一行会更加紧凑,但如果不将检查器横向扩大,查看和编辑较大的数值可能会更加困难。


bool interface/inspector/horizontal_vector_types_editing 🔗

如果为 true,则检查器会将 Vector3Vector3iVector4Vector4iRect2Rect2iPlaneQuaternion 属性显示为一行而不是多行。显示为一行更加紧凑,但如果不将检查器横向扩大,对较大数值的显示和编辑就会更加困难。


int interface/inspector/max_array_dictionary_items_per_page 🔗

在检查器中,为 ArrayDictionary 的每一“页”显示多少项目。值越高,每一页可以查看的值就越多,但也会花越多的时间进行加载。在编辑器中选中具有很多数组或字典属性的节点时,这些多出来的加载时间就会很显著。


int interface/inspector/nested_color_mode 🔗

控制哪些属性编辑器需要在打开时着色。

  • Containers & Resources: 对所有数组、字典、资源编辑器着色。

  • Resources: 对所有资源编辑器着色。

  • External Resources: 对编辑外部资源的资源编辑器着色。


bool interface/inspector/open_resources_in_current_inspector 🔗

如果为 true,则可以在当前检查器视图中编辑子资源。如果资源类型包含在 interface/inspector/resources_to_open_in_new_inspector 中,或者这个设置为 false,则尝试编辑子资源时始终会打开新的检查器视图。


PackedStringArray interface/inspector/resources_to_open_in_new_inspector 🔗

即便 interface/inspector/open_resources_in_current_inspectortrue,也应该在新的检查器视图中打开的资源的列表。

Note: The returned array is copied and any changes to it will not update the original property value. See PackedStringArray for more details.


bool interface/inspector/show_low_level_opentype_features 🔗

如果为 true,则在 Font 编辑器中,显示被字体文件标记为 hidden 的 OpenType 特性。


bool interface/multi_window/enable 🔗

如果为 true,将启用编辑器的多窗口支持。以下面板可以成为独立窗口(即浮动):停靠面板、脚本编辑器、着色器编辑器、游戏工作区。

注意:interface/editor/single_window_modetrue 时,多窗口支持始终处于禁用状态。

注意:要查询编辑器是否可以在编辑器插件中使用多个窗口,请使用 EditorInterface.is_multi_window_enabled() 而不是查询该编辑器设置的值。


bool interface/multi_window/maximize_window 🔗

如果为 true,则将面板设为浮动时会将其最大化。

如果为 false,则将面板设为浮动时,位置和大小会和编辑器窗口中的状态一致(不含窗口边框)。


bool interface/multi_window/restore_windows_on_load 🔗

如果为 true,则编辑器在退出时会保存浮动面板的位置、大小、屏幕。下次启动时,会尽可能让浮动面板在保存的位置、大小、屏幕处保持浮动。


int interface/scene_tabs/display_close_button 🔗

控制关闭(X)按钮何时显示在编辑器顶部的场景选项卡上。


int interface/scene_tabs/maximum_width 🔗

顶部编辑器中每个场景选项卡的最大宽度(以像素为单位)。


bool interface/scene_tabs/restore_scenes_on_load 🔗

如果为 true,则在加载项目时会恢复上一次编辑器会话中打开的场景。

注意:如果打开的场景很多,编辑器可能会花费较长的时间才能启动完成。如果必须快速启动编辑器,请考虑将其设置为 false


bool interface/scene_tabs/show_script_button 🔗

如果为 true,则在每个场景选项卡旁边显示一个按钮,点击该按钮会打开场景的“主导”脚本。“主导”脚本是场景层次结构中位于最高级别的脚本。


bool interface/scene_tabs/show_thumbnail_on_hover 🔗

如果为 true,当鼠标悬停在场景选项卡上时,会显示自动生成的缩略图。场景缩略图在保存场景时生成。


Color interface/theme/accent_color 🔗

用于编辑器中“高亮显示”的用户界面元素(按下和悬停的项目)的颜色。


int interface/theme/additional_spacing 🔗

添加到编辑器中各种 GUI 元素的额外间距(以像素为单位)。增加该值有助于提高触摸屏的可用性,但代价是减少可用屏幕空间。

另见 interface/theme/spacing_preset


Color interface/theme/base_color 🔗

用于编辑器中用户界面元素的基色。次要颜色(例如较深/较浅的变体)是从这种颜色派生的。


int interface/theme/base_spacing 🔗

编辑器中各种 GUI 元素使用的基本间距(单位为像素)。另见 interface/theme/spacing_preset


int interface/theme/border_size 🔗

界面元素的边框大小(单位为像素)。


float interface/theme/contrast 🔗

当派生编辑器主题的基色时,使用的对比度系数(参见 interface/theme/base_color)。当使用正值时,派生的颜色将比基色更深。该对比度系数可以设置为负值,这将使派生颜色比基色更浅。对于浅色主题,负对比度通常看起来更好。


int interface/theme/corner_radius 🔗

界面元素的圆角半径(单位为像素)。0 则为正方形。


String interface/theme/custom_theme 🔗

用于编辑器的自定义主题资源。必须是 .tres.res 格式的 Godot 主题资源。


bool interface/theme/draw_extra_borders 🔗

如果 true,则在编辑器中的交互式 UI 元素周围绘制额外的边框。使用Black (OLED)主题预设时该项会自动启用,因为该主题预设使用全黑背景。


bool interface/theme/follow_system_theme 🔗

如果为 true,则编辑器主题预设将尝试自动匹配系统主题。


int interface/theme/icon_and_font_color 🔗

在编辑器中使用的图标和字体的配色方案。

  • Auto 根据 interface/theme/base_color 自动确定要使用的配色方案。

  • Dark 使字体和图标变暗(适合浅色主题)。图标颜色由编辑器按照该文件中定义的一组规则自动转换。

  • Light 使字体和图标变亮(适合深色主题)。


float interface/theme/icon_saturation 🔗

用于编辑器图标的饱和度。值越高,颜色越鲜艳。

注意:在 Godot 4.0 及更高版本中,默认编辑器图标饱和度增加了 30%。要恢复为 Godot 3.x 的图标饱和度,请将 interface/theme/icon_saturation 设置为 0.77


String interface/theme/preset 🔗

要使用的编辑器主题预设。


float interface/theme/relationship_line_opacity 🔗

在编辑器的基于 Tree 的 GUI(例如场景树停靠栏)中,绘制关系线时使用的不透明度。


String interface/theme/spacing_preset 🔗

预设要使用的编辑器主题间距。另见 interface/theme/base_spacinginterface/theme/additional_spacing


bool interface/theme/use_system_accent_color 🔗

如果为 true,则根据系统设置来设置主题色。

注意:该设置仅在 Windows、MacOS 和 Android 上有效。


bool interface/touchscreen/enable_long_press_as_right_click 🔗

如果为 true,长按触摸屏被视为右键点击。

注意:在触摸屏设备上默认为 true


bool interface/touchscreen/enable_pan_and_scale_gestures 🔗

如果为 true,则在触摸屏设备上启用两指平移和缩放手势。

注意:在触摸屏设备上默认为 true


bool interface/touchscreen/increase_scrollbar_touch_area 🔗

如果为 true,则增加滚动条触摸区域以提高触摸屏设备的可用性。

注意:在触摸屏设备上默认为 true


float interface/touchscreen/scale_gizmo_handles 🔗

指定为了在提高触摸屏设备的可用性而对编辑器小工具手柄应用的缩放乘数。

注意:在非触摸屏设备上默认为 1


int network/connection/engine_version_update_mode 🔗

指定引擎检查更新的方式。

  • Disable Update Checks 阻止引擎进行更新检查(另见 network/connection/network_mode)。

  • Check Newest Preview(预览版本默认)检查最新的开发快照。

  • Check Newest Stable(稳定版本默认)检查最新的稳定版本。

  • Check Newest Patch 检查最新的稳定版本,但次版本号必须相同。例如你的版本为 4.3.stable,则会通知 4.3.1.stable,不会通知 4.4.stable

所有更新模式均会忽略主版本号不同的构建(例如 Godot 4 -> Godot 5)。


int network/connection/network_mode 🔗

决定编辑器中是否启用资产库、更新检查等在线功能。禁用这些在线功能可以防止编辑器向 Godot 网站和托管资产库中资产的第三方平台发出 HTTP 请求,有助于减轻对隐私的担忧。


String network/debug/remote_host 🔗

启动远程调试器时要监听的地址。可以将其设置为该设备的本地 IP 地址,从而允许外部客户端连接到远程调试器(而不是限制远程调试器仅接受来自 localhost 的连接)。


int network/debug/remote_port 🔗

启动远程调试器时要监听的端口。如果配置的数字已被另一个应用程序占用,Godot 将尝试使用高于该配置数字的端口号。


String network/http_proxy/host 🔗

用于在编辑器中联系 HTTP 和 HTTPS 代理的主机(用于资产库和导出模板下载)。另见 network/http_proxy/port

注意:Godot 目前不会自动使用系统代理设置,所以如果需要,必须在此处手动输入。


int network/http_proxy/port 🔗

用于在编辑器中联系 HTTP 和 HTTPS 代理的端口号(用于资产库和导出模板下载)。另见 network/http_proxy/host

注意:Godot 目前不会自动使用系统代理设置,所以如果需要,必须在此处手动输入。


String network/tls/editor_tls_certificates 🔗

用于在编辑器中发出的 HTTP 请求(例如来自 AssetLib 选项卡)的 TLS 证书包。如果留空,将使用包含的 Mozilla 证书包


bool network/tls/enable_tls_v1.3 🔗

如果为 true,则启用 TLSv1.3 协商。

注意:仅在使用 Mbed TLS 3.0 或更高版本时支持(Linux 发行版包可能是针对较旧的系统 Mbed TLS 包编译的),否则最大支持的 TLS 版本始终为 TLSv1.2。


String project_manager/default_renderer 🔗

创建新项目时默认勾选的渲染器类型。可接受的字符串是“forward_plus”“mobile”或“gl_compatibility”。


int project_manager/directory_naming_convention 🔗

项目管理器的目录命名规则。选项有“无规则”(使用项目名称作为目录名称)“kebab-case”(默认)“snake_case”“camelCase”“PascalCase”“Title Case”。


int project_manager/sorting_order 🔗

在项目管理器中使用的排序顺序。在项目管理器中更改排序顺序时,该设置将在编辑器设置中被永久设置。


bool run/auto_save/save_before_running 🔗

如果为 true,则在运行游戏项目之前会自动保存所有场景和脚本。将该项设置为 false 可防止编辑器在没有更改的情况下保存,这可以稍微加快该游戏项目的启动速度,但它可以运行带有未保存的更改的游戏项目。(未保存的更改在正在运行的项目中将不可见。)


int run/bottom_panel/action_on_play 🔗

运行项目时要对底部面板执行的动作。

注意:使用底部面板角落的固定按钮锁定底部面板时,该选项不起作用。


int run/bottom_panel/action_on_stop 🔗

停止项目时要对底部面板执行的动作。

注意:使用底部面板角落的固定按钮锁定底部面板时,该选项不起作用。


bool run/output/always_clear_output_on_play 🔗

如果为 true,则编辑器会在运行游戏项目时清空“输出”面板。


int run/output/font_size 🔗

编辑器底部输出面板中的字体大小。该设置不会影响脚本编辑器的字体大小(见 interface/editor/code_font_size)。


int run/output/max_lines 🔗

输出面板中一次显示的最大行数。


bool run/platforms/linuxbsd/prefer_wayland 🔗

如果为 true,在 Linux/BSD 上,编辑器将首先检查 Wayland 而不是 X11(如果可用)。


int run/window_placement/android_window 🔗

指定游玩窗口相对于 Android 编辑器的启动方式。

  • Auto (based on screen size)(默认)根据设备和屏幕尺寸自动选择启动游玩窗口的方式。默认手机上为 Same as Editor、平板上为 Side-by-side with Editor

  • Same as Editor 在编辑器窗口中启动游玩窗口。

  • Side-by-side with Editor 与编辑器窗口并列启动游玩窗口。

注意:仅在 Android 编辑器中可用。


int run/window_placement/game_embed_mode 🔗

为所有新打开的项目覆盖游戏内嵌设置。启用后,不会保存游戏内嵌设置。


int run/window_placement/rect 🔗

从编辑器启动项目时,用于显示项目的窗口模式。

注意:“Force Maximized”和“Force Fullscreen”不支持游戏内嵌。


Vector2 run/window_placement/rect_custom_position 🔗

从编辑器启动游戏项目时,使用的自定义位置(相对于左上角,单位为像素)。仅当 run/window_placement/rect 设置为 Custom Position 时才有效。


int run/window_placement/screen 🔗

从编辑器启动游戏项目时,用于显示该游戏项目的显示屏。


如果为 true ,则文本光标按照 text_editor/appearance/caret/caret_blink_interval 来闪烁。如果长时间使用脚本编辑器,禁用这个设置可以改善笔记本电脑的电池寿命,因为可以减少编辑器需要重绘的频率。


文本光标闪烁的时间间隔(单位为秒)。另见 text_editor/appearance/caret/caret_blink


bool text_editor/appearance/caret/highlight_all_occurrences 🔗

如果为 true,则在脚本编辑器中高亮显示当前所选文本的所有匹配项。另见 text_editor/theme/highlighting/word_highlighted_color


bool text_editor/appearance/caret/highlight_current_line 🔗

如果为 true,则使用 text_editor/theme/highlighting/current_line_color 为文本光标当前所在行的背景着色。


int text_editor/appearance/caret/type 🔗

在脚本编辑器中使用的文本光标的形状。Line 会在当前字符的左侧显示一条垂直线,而 Block 会在当前字符上方显示一个轮廓。


int text_editor/appearance/guidelines/line_length_guideline_hard_column 🔗

在哪列将细线显示为脚本的行长参考线。这通常应该大于 text_editor/appearance/guidelines/line_length_guideline_soft_column


int text_editor/appearance/guidelines/line_length_guideline_soft_column 🔗

在哪行将一条非常细的线显示为脚本的行长参考线。这通常应该低于 text_editor/appearance/guidelines/line_length_guideline_hard_column


bool text_editor/appearance/guidelines/show_line_length_guidelines 🔗

如果为 true,则显示行长度参考线以帮助控制行的长度。另见 text_editor/appearance/guidelines/line_length_guideline_soft_columntext_editor/appearance/guidelines/line_length_guideline_hard_column


bool text_editor/appearance/gutters/highlight_type_safe_lines 🔗

如果为 true,则通过使用 text_editor/theme/highlighting/safe_line_number_color 而不是 text_editor/theme/highlighting/line_number_color,来显示行号颜色以突出显示类型安全行。类型安全行是指所有变量的类型在编译时已知的代码行。由于类型化的指令,这些类型安全的行可能会运行得更快。


bool text_editor/appearance/gutters/line_numbers_zero_padded 🔗

如果为 true,则显示的行号使用零填充(例如 7 会变成 007)。


bool text_editor/appearance/gutters/show_info_gutter 🔗

如果为 true,则会在左侧显示一个装订线,为存在信号连接和覆盖方法的方法显示图标。


bool text_editor/appearance/gutters/show_line_numbers 🔗

如果为 true,则会在左侧的装订线中显示行号。


int text_editor/appearance/lines/autowrap_mode 🔗

如果 text_editor/appearance/lines/word_wrap 设置为 1,则设置文本换行模式。每种模式的行为见 AutowrapMode


bool text_editor/appearance/lines/code_folding 🔗

如果为 true,则显示缩进的代码小节旁边的折叠箭头,并允许代码折叠。如果为 false,则隐藏缩进的代码小节旁边的折叠箭头,并禁止代码折叠。


int text_editor/appearance/lines/word_wrap 🔗

如果为 true,则将长行换成多行以避免水平滚动。这是一个仅显示的功能;它实际上并没有在脚本中插入换行符。


int text_editor/appearance/minimap/minimap_width 🔗

脚本编辑器中小地图的宽度(单位为像素)。


bool text_editor/appearance/minimap/show_minimap 🔗

如果为 true,则在滚动条附近绘制脚本概览。小地图可以被左键点击,以“绝对”的方式直接滚动到某个位置。


bool text_editor/appearance/whitespace/draw_spaces 🔗

如果为 true,则会将空格字符绘制为居中的点。


bool text_editor/appearance/whitespace/draw_tabs 🔗

如果为 true,则会将制表符绘制为人字形。


int text_editor/appearance/whitespace/line_spacing 🔗

行与行之间要增加的空间(像素)。更大的行间距可以帮助提高可读性,但代价是在屏幕上显示更少的行。


bool text_editor/behavior/documentation/enable_tooltips 🔗

如果为 true,则悬停在符号上时会出现文档工具提示。


bool text_editor/behavior/files/auto_reload_and_parse_scripts_on_save 🔗

如果为 true,则工具脚本在保存时会自动进行软重载。


bool text_editor/behavior/files/auto_reload_scripts_on_external_change 🔗

如果为 true,当脚本被外部编辑器修改和保存时,会自动在编辑器中重新加载脚本。


int text_editor/behavior/files/autosave_interval_secs 🔗

如果设置为大于 0 的值,则按照指定的时间间隔(以秒为单位)会自动保存当前脚本。这可用于防止编辑器崩溃时的数据丢失。


bool text_editor/behavior/files/convert_indent_on_save 🔗

如果为 true,则在保存脚本时转换缩进,以匹配脚本编辑器的缩进设置。另见 text_editor/behavior/indent/type


bool text_editor/behavior/files/open_dominant_script_on_scene_change 🔗

如果为 true,则打开场景时会自动打开根节点上附加的脚本,如果根节点没有脚本则为最靠上的节点。


bool text_editor/behavior/files/restore_scripts_on_load 🔗

如果为 true,则在给定项目上重新打开编辑器时,重新打开在上次会话中打开的脚本。


bool text_editor/behavior/files/trim_final_newlines_on_save 🔗

如果为 true,则在保存脚本时修剪最后一个换行符后的所有空换行符。最后一个换行符指的是文件末尾的空换行符。由于这些换行符没有实际用途,因此可以且应该将其移除,以减少对版本控制差异的干扰。


bool text_editor/behavior/files/trim_trailing_whitespace_on_save 🔗

如果为 true,则在保存脚本时修剪尾随空格。尾随空格是指放置在行尾的制表符和空格字符。由于这些没有任何实际用途,因此可以并且应该将其移除,以减少版本控制差异的干扰。


bool text_editor/behavior/general/empty_selection_clipboard 🔗

如果为 true,未选中内容时进行复制或剪切会对光标所在行进行操作。否则需要先选中才能进行复制和剪切。


bool text_editor/behavior/indent/auto_indent 🔗

如果为 true,则在按 Enter 键时,将根据新行上方的代码块,自动缩进代码。


bool text_editor/behavior/indent/indent_wrapped_lines 🔗

如果为 true,则所有换行的行都会缩进,缩进量与展开的行相同。


int text_editor/behavior/indent/size 🔗

使用制表符缩进时,确定每个制表符的长度。使用空格缩进时,确定按下 Tab 和执行自动缩进时,插入了多少空格。


int text_editor/behavior/indent/type 🔗

要使用的缩进风格(制表符或空格)。

注意:GDScript 风格指南建议使用制表符进行缩进。建议仅当需要处理当前使用空格进行缩进的游戏项目时,才更改这项设置。


String text_editor/behavior/navigation/custom_word_separators 🔗

如果 text_editor/behavior/navigation/use_custom_word_separatorstrue,则将字符视为单词分隔符。如果 text_editor/behavior/navigation/use_default_word_separatorstrue,则这是对默认字符的补充。字符应定义为无分隔符,例如 _♥=


bool text_editor/behavior/navigation/drag_and_drop_selection 🔗

如果为 true,则允许在脚本编辑器中拖放文本以移动文本。如果发现不小心在脚本编辑器中拖放了文本,请禁用该项。


bool text_editor/behavior/navigation/move_caret_on_right_click 🔗

如果为 true,则在脚本编辑器中右键点击某处时,文本光标将被移动(像左键点击或中键点击时一样)。如果为 false,文本光标只会在左键点击或中键点击某个位置时移动。


bool text_editor/behavior/navigation/open_script_when_connecting_signal_to_existing_method 🔗

如果为 true,则在从 Node 面板将信号连接到现有脚本方法时打开脚本编辑器。


bool text_editor/behavior/navigation/scroll_past_end_of_file 🔗

如果为 true,则允许滚动越过文件的末尾。


bool text_editor/behavior/navigation/smooth_scrolling 🔗

如果为 true,则允许在子行间隔内滚动,并在使用鼠标滚轮滚动时启用平滑的滚动动画。动画的速度见 text_editor/behavior/navigation/v_scroll_speed

注意:text_editor/behavior/navigation/smooth_scrolling 当前在 ProjectSettings.physics/common/physics_ticks_per_second 从其默认值(60)显著增加的游戏项目中表现不佳。在这种情况下,建议禁用该设置。


bool text_editor/behavior/navigation/stay_in_script_editor_on_node_selected 🔗

如果为 true,则在场景树面板中选择节点时,可防止自动在脚本和 2D/3D 屏幕之间切换。


bool text_editor/behavior/navigation/use_custom_word_separators 🔗

如果为 true,则使用 text_editor/behavior/navigation/custom_word_separators 中的字符作为单词导航和操作的单词分隔符。如果还启用了 text_editor/behavior/navigation/use_default_word_separators,则这是对默认字符的补充。单词导航和操作包括双击单词或按住 Ctrl(macOS 上为 Cmd)同时按 leftrightbackspacedelete


bool text_editor/behavior/navigation/use_default_word_separators 🔗

如果为 true,则使用 `!"#$%&'()*+,-./:;<=>?@[\]^`{|}~、Unicode 通用标点符号表和 Unicode CJK 标点符号表中的字符作为单词导航和操作的单词分隔符。如果为 false,则使用这些字符的子集,不包括字符 <>$~^=+|。如果还启用了 text_editor/behavior/navigation/use_custom_word_separators,则这是自定义字符的补充。这些字符用于确定单词的结束位置。单词导航和操作包括双击单词或按住 Ctrl(在 macOS 上为 Cmd)同时按 leftrightbackspacedelete


int text_editor/behavior/navigation/v_scroll_speed 🔗

滚动的速度,即每秒的行数,在 text_editor/behavior/navigation/smooth_scrollingtrue 时使用。使用鼠标滚轮时,较高的值会使脚本滚动得更快。

注意:可以在按住 Alt 的同时,使用鼠标滚轮将滚动速度暂时提高 5 倍。


bool text_editor/completion/add_node_path_literals 🔗

如果为 true,则在代码自动补全或将对象属性拖放到脚本编辑器时恰当地使用 NodePath 而不是 String


bool text_editor/completion/add_string_name_literals 🔗

如果为 true,则代码自动补全在合适时使用 StringName 而不是 String


bool text_editor/completion/add_type_hints 🔗

如果为 true ,则在使用代码自动补全时,或在按下 Ctrl 键的同时将节点拖放到脚本编辑器中创建 onready 变量时,将添加 GDScript 静态类型 提示,类型提示类似 -> void: int 。如果为 true,则新创建的脚本也会自动将类型提示添加到其方法参数和返回类型中。


bool text_editor/completion/auto_brace_complete 🔗

如果为 true,则通过打字或自动补全插入左括号时会自动插入相应的右括号。对左括号按 Backspace 键也会自动移除右括号。包括括号(()[]{})字符串引号(''"")语言支持注释的话还包含注释(/**/)。


float text_editor/completion/code_complete_delay 🔗

用户停止输入后,应显示自动补全建议的延迟时间(以秒为单位)。


bool text_editor/completion/code_complete_enabled 🔗

如果为 true,代码补全将在 text_editor/completion/code_complete_delay 之后自动触发。即使为 false,仍然可以使用 ui_text_completion_query 动作(默认情况下为 Ctrl + Space 或 macOS 上的 Cmd + Space),手动触发代码补全。


bool text_editor/completion/colorize_suggestions 🔗

如果为 true,则启用自动补全建议中某些项目的着色,例如向量分量。


bool text_editor/completion/complete_file_paths 🔗

如果为 true,则在 load()preload() 等方法中,为文件路径提供自动补全建议。


float text_editor/completion/idle_parse_delay 🔗

用户停止输入后,脚本编辑器应检查错误的延迟时间(以秒为单位)。


float text_editor/completion/idle_parse_delay_with_errors_found 🔗

解析器发现错误时的延迟,代替 text_editor/completion/idle_parse_delay。较低的数值在修复代码时应该感觉更灵敏,但可能会导致明显的卡顿并增加 CPU 使用率。


bool text_editor/completion/put_callhint_tooltip_below_current_line 🔗

如果为 true,除非当前行下方的屏幕上没有空间,否则代码补全工具提示,将出现在当前行下方。如果为 false,则代码补全工具提示,将出现在当前行上方。


bool text_editor/completion/use_single_quotes 🔗

如果为 true,则执行带单引号的字符串自动补全。如果为 false,则执行带双引号的字符串自动补全(则与 GDScript 风格指南一致)。


String text_editor/external/exec_flags 🔗

运行外部文本编辑器时传递的命令行参数,需要 text_editor/external/use_external_editortrue。另见 text_editor/external/exec_path


String text_editor/external/exec_path 🔗

用于编辑文本文件的文本编辑器可执行文件路径,需要 text_editor/external/use_external_editortrue


bool text_editor/external/use_external_editor 🔗

如果为 true,则会使用外部编辑器,不使用内置脚本编辑器。另见 text_editor/external/exec_pathtext_editor/external/exec_flags


int text_editor/help/class_reference_examples 🔗

控制应在编辑器帮助中显示哪些多行代码块。该设置不会影响编辑器帮助中的单行代码文字。


int text_editor/help/help_font_size 🔗

编辑器帮助(内置类参考)的字体大小。


int text_editor/help/help_source_font_size 🔗

编辑器帮助(内置类参考)中示例代码的字体大小。


int text_editor/help/help_title_font_size 🔗

编辑器帮助(内置类参考)中标题的字体大小。


bool text_editor/help/show_help_index 🔗

如果为 true,则在编辑器帮助的左侧显示目录(编辑脚本时出现成员概览的位置)。


bool text_editor/help/sort_functions_alphabetically 🔗

如果为 true,则脚本编辑器中脚本的方法列表按字母表排序。


bool text_editor/script_list/group_help_pages 🔗

如果为 true,则脚本编辑器的脚本列表会将参考页统一放置到底部。


bool text_editor/script_list/highlight_scene_scripts 🔗

如果为 true,则脚本编辑器的脚本列表中会高亮显示当前场景所使用的脚本。


int text_editor/script_list/list_script_names_as 🔗

指定脚本路径在脚本编辑器的脚本列表中应如何显示。如果使用“Name”选项,并且某些脚本的文件名相同,则会展示出路径中更多的部分,从而避免冲突。


bool text_editor/script_list/script_temperature_enabled 🔗

如果 true,则脚本编辑器中最近打开的脚本名称将以强调颜色突出显示,强度取决于距离最近一次打开有多近。


int text_editor/script_list/script_temperature_history_size 🔗

如果 text_editor/script_list/script_temperature_enabledtrue,最多可以突出显示多少个脚本名称。超过此值的脚本将使用默认字体颜色。


bool text_editor/script_list/show_members_overview 🔗

如果为 true,则在脚本编辑器的左侧显示当前脚本的成员变量和函数的概览。另见 text_editor/script_list/sort_members_outline_alphabetically


bool text_editor/script_list/sort_members_outline_alphabetically 🔗

如果为 true,则使用字母顺序,对成员大纲(位于脚本编辑器的左侧)进行排序。如果为 false,则根据在脚本中找到成员的顺序,对成员大纲进行排序。

注意:仅当 text_editor/script_list/show_members_overviewtrue 时有效。


int text_editor/script_list/sort_scripts_by 🔗

指定脚本编辑器打开脚本列表的排序方式。


String text_editor/theme/color_theme 🔗

脚本编辑器中,使用的语法主题。

可以使用脚本编辑器顶部的文件 > 主题 > 另存为...,从当前设置中保存自己的语法主题。然后,语法主题将在本地颜色主题列表中可用。

可以在 godot-syntax-themes 存储库中,找到要安装的其他语法主题。


Color text_editor/theme/highlighting/background_color 🔗

脚本编辑器中,背景的颜色。如果设置为半透明的颜色,会透出后面的编辑器主题的基础色。


Color text_editor/theme/highlighting/base_type_color 🔗

脚本编辑器中,基础类型的颜色(用于 Vector2Vector3Color 等类型)。


Color text_editor/theme/highlighting/bookmark_color 🔗

脚本编辑器中,书签图标的颜色(在装订线中显示)。


Color text_editor/theme/highlighting/brace_mismatch_color 🔗

脚本编辑器中,括号不匹配的颜色。当文本光标位于不匹配的大括号、圆括号或方括号字符上时使用。


Color text_editor/theme/highlighting/breakpoint_color 🔗

脚本编辑器中,断点图标的颜色(在装订线中显示)。


Color text_editor/theme/highlighting/caret_background_color 🔗

脚本编辑器中,文本光标的背景色。

注意:该设置无效,因为当前未使用。


Color text_editor/theme/highlighting/caret_color 🔗

脚本编辑器中,文本光标的颜色。


Color text_editor/theme/highlighting/code_folding_color 🔗

脚本编辑器中,代码折叠图标的颜色(在装订线中显示)。


Color text_editor/theme/highlighting/comment_color 🔗

脚本编辑器中,注释的颜色。

注意:在 GDScript 中,与 Python 不同,多行字符串不被视为注释,而是使用字符串高亮显示颜色。


Color text_editor/theme/highlighting/completion_background_color 🔗

脚本编辑器中,自动补全框的背景色。


Color text_editor/theme/highlighting/completion_existing_color 🔗

脚本编辑器中,自动补全框的背景颜色,用于高亮显示补全结果中的现有字符。这应该是半透明的颜色,以便在后面可以看到 text_editor/theme/highlighting/completion_selected_color


Color text_editor/theme/highlighting/completion_font_color 🔗

脚本编辑器中,自动补全框的文本颜色。


Color text_editor/theme/highlighting/completion_scroll_color 🔗

脚本编辑器中,自动补全框的滚动条颜色。


Color text_editor/theme/highlighting/completion_scroll_hovered_color 🔗

脚本编辑器中,自动补全框的滚动条被鼠标悬停或按下时的颜色。


Color text_editor/theme/highlighting/completion_selected_color 🔗

脚本编辑器中,自动补全框的当前选中行的背景色。


Color text_editor/theme/highlighting/control_flow_keyword_color 🔗

脚本编辑器中,控制流关键字的颜色(用于 ifforreturn 等关键字)。


Color text_editor/theme/highlighting/current_line_color 🔗

脚本编辑器中,文本光标当前所在行的背景色。这应该被设置为半透明颜色,以便它可以显示在其他的行颜色修饰之上,例如 text_editor/theme/highlighting/mark_color


Color text_editor/theme/highlighting/doc_comment_color 🔗

脚本编辑器的文档注释颜色。在 GDScript 中,这被用于以 ## 开头的注释。在 C# 中,这被用于以 ////** 开头的注释。


Color text_editor/theme/highlighting/engine_type_color 🔗

脚本编辑器中引擎类型的颜色(ObjectMeshNode……)。


Color text_editor/theme/highlighting/executing_line_color 🔗

脚本编辑器中,调试器执行行图标(显示在装订线中)的颜色。


Color text_editor/theme/highlighting/folded_code_region_color 🔗

脚本编辑器的背景行高亮颜色,用于折叠代码区块。


Color text_editor/theme/highlighting/function_color 🔗

脚本编辑器中,函数调用的颜色。

注意:当使用 GDScript 语法高亮器时,这将被语法主题中为函数定义(例如:func _ready(): )配置的函数定义颜色所取代。


Color text_editor/theme/highlighting/keyword_color 🔗

脚本编辑器中,非控制流关键字的颜色(用于关键字,如 varfuncextends、...)。


Color text_editor/theme/highlighting/line_length_guideline_color 🔗

脚本编辑器中,行长参考线的颜色。“硬”行长参考线将使用该颜色绘制,而“软”行长参考线将使用其一半的不透明度绘制。


Color text_editor/theme/highlighting/line_number_color 🔗

脚本编辑器中,行号的颜色。另见 text_editor/theme/highlighting/safe_line_number_color


Color text_editor/theme/highlighting/mark_color 🔗

脚本编辑器中,有错误的行的背景颜色。这应该被设置为半透明颜色,以便它可以显示在其他的行颜色修饰之上,例如 text_editor/theme/highlighting/current_line_color


Color text_editor/theme/highlighting/member_variable_color 🔗

脚本编辑器中,对象上成员变量(例如 self.some_property)的颜色。

注意:该颜色不用于局部变量的声明和访问。


Color text_editor/theme/highlighting/number_color 🔗

脚本编辑器中,数字(整数和浮点数)的颜色。


Color text_editor/theme/highlighting/safe_line_number_color 🔗

脚本编辑器中,类型安全行号的颜色。另见 text_editor/theme/highlighting/line_number_color

注意:仅当 text_editor/appearance/gutters/highlight_type_safe_linestrue 时才显示。


Color text_editor/theme/highlighting/search_result_border_color 🔗

脚本编辑器中,搜索结果边框的颜色。该边框有助于进一步关注搜索结果。将该颜色的不透明度设置为 0 可禁用该边框。


Color text_editor/theme/highlighting/search_result_color 🔗

脚本编辑器中,搜索结果的背景色。


Color text_editor/theme/highlighting/selection_color 🔗

脚本编辑器中,当前选中文本的背景色。


Color text_editor/theme/highlighting/string_color 🔗

脚本编辑器中,字符串的颜色(单行和多行)。


Color text_editor/theme/highlighting/symbol_color 🔗

脚本编辑器中,运算符的颜色(( ) [ ] { } + - * / 等)。


Color text_editor/theme/highlighting/text_color 🔗

脚本编辑器中,所有语法高亮规则均未高亮显示的文本的颜色。


Color text_editor/theme/highlighting/text_selected_color 🔗

脚本编辑器中,文本的背景颜色。这应该被设置为半透明颜色,以便它可以显示在其他的行颜色修饰之上,例如 text_editor/theme/highlighting/current_line_color


Color text_editor/theme/highlighting/user_type_color 🔗

脚本编辑器中,用户定义的类型(使用 class_name )的颜色。


Color text_editor/theme/highlighting/word_highlighted_color 🔗

脚本编辑器中,通过选择单词而高亮显示的颜色。仅当 text_editor/appearance/caret/highlight_all_occurrencestrue 时可见。


int text_editor/theme/line_spacing 🔗

文本编辑器中使用的纵向行间距,单位为像素。


String version_control/ssh_private_key_path 🔗

指向 SSH 私钥文件的路径,用于编辑器的版本控制集成认证。


String version_control/ssh_public_key_path 🔗

指向 SSH 公钥文件的路径,用于编辑器的版本控制集成认证。


String version_control/username 🔗

用于编辑器的版本控制集成的默认用户名。


方法说明

void add_property_info(info: Dictionary) 🔗

向属性添加自定义属性信息。该字典必须包含:

var settings = EditorInterface.get_editor_settings()
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"
}

settings.add_property_info(property_info)

bool check_changed_settings_in_group(setting_prefix: String) const 🔗

检查已改变的设置中是否存在前缀为 setting_prefix 的设置项。另见 get_changed_settings()


void erase(property: String) 🔗

擦除名称由 property 指定的设置项。


PackedStringArray get_changed_settings() const 🔗

获取上次保存以来发生更改的设置项数组。请注意,成功保存后内部会将 changed_settings 清空,所以一般最适合使用该方法的地方是在处理 NOTIFICATION_EDITOR_SETTINGS_CHANGED 时。


PackedStringArray get_favorites() const 🔗

返回该游戏项目收藏的文件和目录的列表。


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

返回由 sectionkey 指定的特定于项目的元数据。如果该元数据不存在,则将返回 default。另见 set_project_metadata()


PackedStringArray get_recent_dirs() const 🔗

返回该游戏项目在文件对话框中最近访问的文件夹的列表。


Variant get_setting(name: String) const 🔗

返回由 name 指定的设置项的值。等价于在 EditorSettings 实例上使用 Object.get()


bool has_setting(name: String) const 🔗

如果由 name 指定的设置项存在则返回 true,否则返回 false


void mark_setting_changed(setting: String) 🔗

将传入的编辑器设置项标记为已更改,请参阅 get_changed_settings()。只有存在的设置(参见 has_setting())才会被接受。


void set_builtin_action_override(name: String, actions_list: Array[InputEvent]) 🔗

使用 actions_list 中定义的输入动作,覆盖内置的编辑器动作 name


void set_favorites(dirs: PackedStringArray) 🔗

设置该游戏项目收藏的文件和目录的列表。


void set_initial_value(name: StringName, value: Variant, update_current: bool) 🔗

将由 name 指定的设置项的初始值设置为 value。用于在“编辑器设置”中为“恢复”按钮提供值。如果 update_currenttrue,则该设置的当前值也会被设为 value


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

设置由 sectionkeydata 指定的特定于项目的元数据。该元数据保存在项目文件夹之外,因此不会加入到版本控制中。另见 get_project_metadata()


void set_recent_dirs(dirs: PackedStringArray) 🔗

设置该游戏项目在文件对话框中最近访问的文件夹的列表。


void set_setting(name: String, value: Variant) 🔗

将由 name 指定的设置项设置为 value。等价于在 EditorSettings 实例上使用 Object.set()