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 將專案的設定儲存在一個 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。

進階專案設定

進階專案設定

預設情況下，只會顯示部分專案設定。若要查看所有專案設定，請啟用 進階設定 切換鈕。