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...
功能列表
Godot 是一個功能豐富的遊戲引擎。有很多東西可以學習。本頁面將介紹如何使用線上手冊、內建程式碼參考、參與線上社群,從而學習新功能、新技術。
充分利用本手冊
你正在閱讀的是使用者手冊,講解的是引擎中用到的概念和提供的功能。學習新的專題時,你可以先瀏覽本網站上的對應章節。你可以使用左側功能表查看專題,也可以借助搜索欄找到特定的頁面。如果存在與主題對應的頁面,裡面通常還會連結到其他相關內容。
本手冊附有類的參考部分,解釋每個 Godot 類的可用功能和屬性。手冊部分涵蓋了常用的功能、概念以及如何使用編輯器等內容,參考部分主要介紹如何使用 Godot 的腳本API(應用程式設計發展介面),可以線上和離線存取,建議在 Godot 編輯器中通過幫助 -> 搜索或按 F1 離線瀏覽。
要線上瀏覽,請轉到手冊的 Class Reference 部分。
類參考手冊頁面會展示:
這個類在繼承結構中的位置。你可以點擊頂部的連結跳轉到父類,查看某個型別所繼承的屬性和方法。
這個類的角色與使用概要。
這個類的屬性、方法、訊號、列舉、場景的解釋。
連結到深入介紹手冊頁面。
備註
如果手冊或類參考文獻缺失或資訊不足,請在官方 GitHub倉庫 godot-docs 中提交 Issue 來報告它。
您可以按住 Ctrl (macOS 請按 Cmd),然後將滑鼠游標移到類別、屬性、方法、訊號或常數等文字上方,文字會加上底線,接著按下 Ctrl + 滑鼠左鍵 (macOS 請按 Cmd + 滑鼠左鍵) 即可跳到該處。
學會像程式師一樣思考
傳授程式基礎和程式設計員思維已經超出Godot文件的範圍。如果你剛開始程式設計,我們建議閱讀以下兩個優秀的免費教學開始:
GDQuest's Learn GDScript From Zero is a free and open source interactive tutorial for absolute beginners to learn to program with Godot's GDScript language. It is available as a desktop application or in the browser.
如果你更喜歡閱讀書籍,免費電子書 Automate The Boring Stuff With Python Al Sweigart著。
與社群共同學習
Godot 的使用者社群在不斷地增長。如果你遇到問題或需要幫助以更好地理解如何實作某件事情,你可以在許多活躍社群中向其他使用者尋求幫助。
提問與尋找既有解答的最佳地點是官方的 Godot 論壇。回覆會出現在搜尋引擎結果並被保存,讓其他使用者也能從討論中受益。發問後,你可以將該連結分享至其他社群平台。提問前,請先在該網站或以你慣用的搜尋引擎查找可能已解決你問題的答案。
善於提問並提供細節會幫助別人更快更好地回答你。在提出問題時,我們建議包括以下資訊:
描述你的目標 。你要解釋你在設計上想要達到什麼目的。如果您在弄清楚如何使解決方案發揮作用時遇到困難,那麼可能會有不同的、更簡單的解決方案來實作相同的目標。
如果涉及到錯誤,請分享確切的錯誤資訊。你可以在編輯器的除錯器底部面板上點擊複製錯誤圖示來複製確切的錯誤資訊。瞭解它的內容可以幫助社群成員更好地識別你是如何觸發錯誤的。
如果涉及程式碼, 分享程式碼範例 。其他使用者在沒有看到您的程式碼的情況下將無法説明您解決問題。直接以文字形式分享程式碼。為此,您可以將一段簡短的程式碼片段複製並貼上到聊天框中,或使用 Pastebin 之類的網站來共用長檔。
分享你的“場景”面板的截圖 ,以及你寫的程式碼。你寫的大部分程式碼都會影響你的場景中的節點。因此,你應該把這些場景看成是你的原始程式碼的一部分。
另外,請不要用手機拍照,低畫質和螢幕反光會讓圖片難以理解。您的作業系統應該有內建工具可以使用 PrtSc (Print Screen) 鍵來截圖(macOS:全螢幕截圖請使用 Cmd + Shift + 3,更多資訊請參考這裡 )。
或者,你可以在 Windows 上使用 ShareX,或在 Windows/macOS/Linux 上使用 Flameshot。
分享你的遊戲錄影對 發現遊戲中的問題 同樣是很有用的。你可以使用 OBS 或者 Screen to GIF 來捕獲你的螢幕。
然後你可以使用像 streamable 或雲服務提供者的服務,免費上傳和分享你的影片。
如果你在使用非穩定版本的 Godot,請說明你正在使用的版本。由於非穩定版 Godot 的可用功能和介面會快速反覆運算,你所得到的答案可能大不相同。
遵循這些規範可以最大化你找到所需答案的機會。既節省你的時間,也節省幫助你的人的時間。
命令列教學
本手冊旨在提供一個全面的 Godot 功能參考以便查閱。除了 2D 和 3D 遊戲的入門教學系列外,本手冊不包含實作具體某種遊戲的教學。如果你需要關於 RPG 遊戲、平臺跳躍遊戲或者其他型別遊戲的創作教學,請參見 教學與資源 ,這裡面包含了 Godot 社群所製作的內容。