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.

Checking the stable version of the documentation...

프로젝트 설정

물리, 렌더링 및 창 설정을 포함하여 프로젝트 실행을 제어하기 위해 변경할 수 있는 수십 가지 설정이 있습니다. 이러한 설정은 프로젝트 설정 창, 코드에서 변경하거나 project.godot 파일을 수동으로 편집하여 변경할 수 있습니다. ProjectSettings 클래스에서 전체 설정 목록을 볼 수 있습니다.

내부적으로 Godot는 INI 형식의 일반 텍스트 파일인 project.godot 파일에 프로젝트 설정을 저장합니다. 이는 사람이 읽을 수 있고 버전 제어에 친화적이지만 편집하기에는 가장 편리하지 않습니다. 따라서 프로젝트 설정 창을 사용하여 이러한 설정을 편집할 수 있습니다. 프로젝트 설정를 열려면 메인 메뉴에서 **프로젝트 > 프로젝트 설정**를 선택하세요.

../../_images/project_settings_basic.webp

프로젝트 설정 창

프로젝트 설정 창은 주로 일반 탭의 설정을 변경하는 데 사용됩니다. 또한 입력 맵, Localization, Globals, :ref:`Plugins <doc_installing_plugins_enabling_a_plugin>`에 대한 탭이 있습니다. 기본값 가져오기. 이러한 다른 탭의 사용법은 다른 곳에 문서화되어 있습니다.

프로젝트 설정 재정의하기

프로젝트 설정 창의 일반 탭은 인스펙터와 매우 유사하게 작동합니다. 검사기 속성과 마찬가지로 변경할 수 있는 프로젝트 설정 목록이 표시됩니다. 왼쪽에는 관련 설정 그룹을 선택하는 데 사용할 수 있는 범주 목록이 있습니다. 필터 설정 필드를 사용하여 특정 설정을 검색할 수도 있습니다.

각 설정에는 기본값이 있습니다. 각 속성 옆에 있는 원형 화살표 재설정 버튼을 클릭하면 설정을 기본값으로 재설정할 수 있습니다.

프로젝트 설정 재정의하기

:ref:`set_setting() <class_ProjectSettings_method_set_setting>`을 사용하여 코드에서 설정 값을 변경할 수 있습니다.

ProjectSettings.set_setting("application/run/max_fps", 60)
ProjectSettings.set_setting("display/window/size/mode", DisplayServer.WINDOW_MODE_WINDOWED)

그러나 많은 프로젝트 설정은 게임이 시작될 때 한 번만 읽혀집니다. 그 이후에는 ``set_setting()``로 설정을 변경해도 아무런 효과가 없습니다. 대신 대부분의 설정에는 Engine 또는 :ref:`DisplayServer <class_DisplayServer>`과 같은 런타임 클래스에 해당하는 속성이나 메서드가 있습니다.

Engine.max_fps = 60
DisplayServer.window_set_mode(DisplayServer.WINDOW_MODE_WINDOWED)

일반적으로 프로젝트 설정은 Engine, PhysicsServer2D, PhysicsServer3D, RenderingServer 또는 Window 클래스. ProjectSettings 클래스 참조에서 설정은 동등한 런타임 속성 또는 메서드에 연결됩니다.

프로젝트 설정 재정의하기

get_setting() 또는 :ref:`get_setting_with_override() <class_ProjectSettings_method_get_setting_with_override>`을 사용하여 프로젝트 설정을 읽을 수 있습니다.

var max_fps = ProjectSettings.get_setting("application/run/max_fps")
var window_mode = ProjectSettings.get_setting("display/window/size/mode")

많은 프로젝트 설정은 시작 시 한 번만 읽혀지기 때문에 프로젝트 설정의 값이 더 이상 정확하지 않을 수 있습니다. 이러한 경우에는 런타임에 해당하는 속성이나 메서드에서 값을 읽는 것이 좋습니다.

var max_fps = Engine.max_fps
var window_mode = DisplayServer.window_get_mode()

정적 함수

텍스트 편집기를 사용하여 project.godot 파일을 열고 프로젝트 설정을 수동으로 변경할 수 있습니다. project.godot 파일에 특정 설정에 대해 저장된 값이 없는 경우 이는 암시적으로 해당 설정의 기본값입니다. 즉, 파일을 수동으로 편집하는 경우 설정 이름 과 값을 모두 작성해야 할 수도 있습니다.

일반적으로 ``project.godot``를 수동으로 편집하는 것보다 프로젝트 설정 창을 사용하는 것이 좋습니다.

프로젝트 설정 재정의하기

../../_images/project_settings_advanced.webp

프로젝트 설정 재정의하기

기본적으로 일부 프로젝트 설정만 표시됩니다. 모든 프로젝트 설정을 보려면 고급 설정 토글을 활성화하세요.