项目设置

你可以通过更改数十种设置来控制项目的运行，包括物理、渲染和窗口设置。这些设置可以通过 项目设置 窗口、代码或手动编辑 project.godot 文件来修改。你可以在 ProjectSettings 类中查看完整的设置列表。

在内部，Godot 将项目的设置存储在一个 project.godot 文件中，这是一个 INI 格式的纯文本文件。虽然这种格式易于阅读且对版本控制友好，但直接编辑并不太方便。因此，可以通过 项目设置 窗口来编辑这些设置。要打开项目设置，请从主菜单中选择 项目 > 项目设置。

项目设置窗口

项目设置 窗口主要用于更改 常规 标签中的设置。此外，还有 输入映射、本地化、全局变量、插件 和 导入默认值 标签。这些其他标签的使用已在其他地方有文档说明。

修改项目设置

项目设置窗口的常规选项卡与检查器类似，显示的是项目设置列表，可以像检查器属性一样进行修改。左侧是类别列表，可以选择相关的设置组。还可以使用过滤设置框搜索特定的设置。

每个设置都有一个默认值。可以通过点击每个属性旁边的圆形箭头重置按钮，将设置恢复为默认值。

通过代码修改项目设置

你可以在代码中使用 set_setting() 来修改设置的值：

GDScriptC#

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

然而，许多项目设置都只会在游戏启动时读取一次。在此之后，使用 set_setting() 更改设置就不会产生效果了。不过大多数设置在 Engine、DisplayServer 等运行时类上都有相应的属性或方法：

GDScriptC#

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

通常，项目设置会在运行时复制到以下类中：Engine、PhysicsServer2D、PhysicsServer3D、RenderingServer、Viewport、Window。在 ProjectSettings 类的参考文档中，设置会链接到其对应的运行时属性或方法。

读取项目设置

你可以使用 get_setting() 或 get_setting_with_override() 来读取项目设置：

GDScriptC#

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

由于许多项目设置仅在启动时读取一次，项目设置中的值可能不再准确。在这种情况下，最好从运行时的等效属性或方法中读取值：

GDScriptC#

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

手动编辑 project.godot

你可以使用文本编辑器打开 project.godot 文件并手动更改项目设置。需要注意的是，如果 project.godot 文件中没有存储某个特定设置的值，那么该设置将隐式采用其默认值。这意味着，如果你要手动编辑该文件，你可能需要同时写入设置的名称和值。

一般来说，建议使用项目设置窗口，不建议手动编辑 project.godot。

高级项目设置

高级项目设置

默认情况下只会显示部分项目设置。要查看所有项目设置，请启用高级设置切换按钮。