編輯器圖示

當你建立新類別並讓它可用於腳本時，編輯器介面預設會以該類別所繼承的基底類別圖示顯示。絕大多數情況下，仍建議為新類別設計專屬圖示，以提升使用者體驗。

建立圖示

要建立新圖示，請先安裝向量繪圖軟體，例如開源的 Inkscape。

將包含所有編輯器圖示的 godot 儲存庫複製到本地端：

git clone https://github.com/godotengine/godot.git

圖示必須以 SVG 格式向量圖建立，並需遵循兩項主要規範：

• 圖示尺寸必須為 16×16。於 Inkscape 可透過「檔案 > 文件屬性」設定大小。

• 線條應儘量吸附至像素，以便在低 DPI 下維持清晰。可於 Inkscape 開啟 16×16 格線協助對齊。

完成圖示設計後，將檔案儲存至剛才複製的儲存庫的 editor/icons 目錄下，檔名須符合預期類別名稱且區分大小寫。例如要為 CPUParticles2D 建立圖示，檔名應為 CPUParticles2D.svg。

亮色主題下的圖示色彩轉換

If the user has configured their editor to use a light theme, Godot will convert the icon's colors based on a set of predefined color mappings. This is to ensure the icon always displays with a sufficient contrast rate. Try to restrict your icon's color palette to colors found in the list above. Otherwise, your icon may become difficult to read on a light background.

圖示最佳化

由於編輯器會在載入時即渲染一次 SVG，因此圖示檔案應盡量保持精簡，以利高效解析。當執行 pre-commit hook 時，會自動用 svgo 工具最佳化 SVG。

備註

最佳化步驟不會明顯影響圖示品質，但會移除如輔助線等僅供編輯時用的資訊。因此，若需日後修改，建議保留原始 SVG 檔。

整合與分享圖示

若你要貢獻至 Godot 本體，請發送 Pull Request，將最佳化後的圖示加入主儲存庫的 editor/icons 目錄。重新編譯引擎後，新類別的圖示就會自動套用。

你也可以於自製模組中建立專屬的自訂圖示。如果該模組不打算整合進 Godot 主專案，則無需額外發送 Pull Request，自訂圖示會在模組內自動生效。

關於建立模組圖示的詳細說明，請參閱 建立自訂模組圖示。

疑難排解

若圖示未出現在編輯器中，請檢查：

1. 每個圖示的檔名有無遵循上述命名規範。

2. 是否已啟用 modules/svg （預設會啟用）。若未啟用 SVG 模組，編輯器將無法顯示圖示。

參考資料

• editor/icons