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.

安裝外掛程式

Godot 擁有一套編輯器外掛程式機制,社群開發了大量外掛。外掛能透過新增節點、額外面板、便捷功能等方式,擴充編輯器功能。

尋找外掛程式

尋找 Godot 外掛程式的首選方式是使用 資源庫。雖然可以線上瀏覽,但直接從編輯器使用更方便。請點擊編輯器頂端的 AssetLib 分頁:

../../../_images/installing_plugins_assetlib_tab.webp

你也可以在像 GitHub 這樣的程式碼託管網站上找到資源。

備註

有些倉庫會自稱為「外掛程式」,但其實並不是*編輯器*外掛程式。這種情況多見於要用於執行中專案的腳本。這類外掛無需啟用即可使用,只需下載並將檔案解壓到你的專案資料夾即可。

判斷是否為編輯器外掛程式,一個方法是檢查外掛的倉庫裡面有沒有 addons/ 目錄,且裡面有 plugin.cfg 檔案。如果有,就是編輯器外掛程式。

安裝外掛程式

要安裝外掛程式,請將其下載為 ZIP 壓縮檔。在資源庫中,可以透過編輯器或網站上的 下載 按鈕來下載。

在 GitHub 上,如果外掛程式有標記(tags,版本),請到 Releases 分頁下載穩定版。這能確保你下載到作者標示為穩定的版本。

在 GitHub 上,若外掛沒有任何標記(tags),請使用 Download ZIP 按鈕下載最新版本的 ZIP 壓縮檔:

../../../_images/installing_plugins_github_download_zip.png

解壓 ZIP 壓縮檔,並將其中的 addons/ 資料夾移到你的專案資料夾裡。如果你的專案已經有 addons/ 資料夾,請把外掛的 addons/ 合併進來。檔案總管可能會詢問是否寫入該資料夾,請選擇 。這個過程不會覆蓋任何檔案。

啟用外掛程式

要啟用剛安裝好的外掛程式,請在編輯器上方點選 專案 > 專案設定,然後切換到 外掛程式 分頁。如果安裝正確,應該可以在清單中看到它。勾選 啟用 來啟用外掛。

../../../_images/installing_plugins_project_settings.webp

啟用外掛程式後即可馬上使用,無需重啟編輯器。同樣地,停用外掛程式也不需要重新啟動編輯器。