- 文档
- 教程
- 游戏开发
【免费下载链接】godot-docs
Godot Engine official documentation
本文基于 godot-docs 仓库中 about/introduction.rst 编写,系统介绍 Godot Engine 的引擎定位、许可证特性、官方文档的组织结构与导航方式,帮助你快速确定学习路径并找到所需资料。读完本文你将掌握:Godot 引擎的核心能力边界、文档五大板块的用途、以及从零开始学习 Godot 的具体行动路线。
什么是 Godot Engine
Godot Engine 是一款免费且开源、由社区驱动的 2D 与 3D 游戏引擎。它没有大公司主导,由全球贡献者共同维护开发。你可以用它开发任何类型的游戏,面向任何平台发布,且没有任何使用限制(不收取版税、无需分成、无使用门槛)。
从仓库主页文档(README.md)可以看到,godot-docs 仓库保存的是 Godot 官方文档的reStructuredText(reST)源文件,通过 Sphinx 构建为 HTML 文档。本仓库即官方文档的原始资料库,对应 Godot 4.x 最新开发分支(master)。
官方对引擎的一段可复用的快速简介如下(可直接用于项目介绍或文章摘要):
Godot Engine 是一款功能完备的跨平台游戏引擎,可通过统一界面创建 2D 和 3D 游戏。它提供了全面而常用的工具集,让用户专注于制作游戏,而无需重复造轮子。游戏可通过一次点击导出到众多平台,包括主流桌面平台(Linux、macOS、Windows)、移动平台(Android、iOS),以及基于 Web 的平台和主机平台。
引擎能力速览
结合仓库中 about/list_of_features.rst(官方功能清单页),Godot 的核心能力覆盖:
| 领域 | 代表能力 |
|---|---|
| 编辑器 | 场景树编辑器、内置脚本编辑器、GDScript 调试器、可视化性能分析器、实时脚本重载、远程检查器、游戏内嵌面板 |
| 渲染 | 三种渲染器:Forward+(Vulkan/Direct3D 12/Metal)、Mobile(Vulkan 系)、Compatibility(OpenGL) |
| 2D | Sprite/Polygon/Line 渲染、2D 光照与法线贴图、TileMap、Path2D、GPU/CPU 粒子 |
| 3D | PBR 材质、实时光照与阴影、烘焙 Lightmap、VoxelGI、SDFGI、体积雾、GPU 粒子 |
| 脚本 | GDScript(Python 风格语法,但并非基于 Python)、C#(.NET 10+)、GDExtension(C/C++/Rust/D 等原生扩展) |
| 其他 | 音频总线与效果、国际化(CSV/gettext)、A* 寻路、WebSocket/WebRTC/高等级多人游戏 API、OpenXR(AR/VR) |
开始前的准备
在深入文档之前,请先根据自身情况选择合适起点:
- 如果你偏好视频学习,可先查看社区贡献的视频教程列表(详见 community/tutorials.rst 中的 "Where to start" 与 "Video tutorials" 部分)。
- 如果遇到教程或项目问题,可通过 Godot 官方社区的各类渠道寻求帮助(Discord 社区与官方论坛等)。
- 对于完全的新用户,getting_started/introduction/index.rst 开篇的 Getting Started 系列是最好的入口。
你的身份决定学习路线
仓库根目录的 index.rst 提供了一份基于读者身份的导航矩阵:
| 读者画像 | 推荐入口 |
|---|---|
| 从未做过游戏,想制作游戏 | about/introduction.rst(即本文)与 Getting Started 系列 |
| 会做游戏,想学习使用 Godot | getting_started/step_by_step/index.rst |
| 会用 Godot,想学进阶主题 | tutorials/index.rst(Manual 手册) |
| 会用 Godot,想贡献代码/文档 | Godot 贡献者文档 |
关于 Godot Engine:引擎背景与特性
引擎概况
游戏引擎是一个复杂的工具,难以用几句话完整呈现。但可以明确的是:Godot 采用宽松的 MIT 许可证,完全免费开源(详见 about/complying_with_licenses.rst)。没有任何附带条件、无版税、无隐藏要求——用户制作的游戏完全属于用户自己,甚至包括引擎代码的每一行。Godot 的开发完全独立且由社区驱动,并得到非营利组织 Godot Foundation 的支持。
许可证合规要点(对游戏开发者至关重要)
虽然本页是入门导读,但许可证是使用引擎时必须知晓的底线。根据 about/complying_with_licenses.rst:
- Godot 本身采用MIT 许可证,每个向项目提交代码的贡献者都在同一许可证下保有自己贡献的所有权。
- 唯一的合规要求:在游戏或衍生项目中包含 MIT 许可证文本。常见做法包括:在致谢画面(Credits screen)中展示、在设置菜单中提供第三方许可证页面、在桌面平台输出日志中打印许可证文本、随安装包附带许可证文件、或在游戏说明文档/致谢中提供到
godotengine.org/license的链接(官方认可的合规方式)。 - 游戏本身无需采用相同许可证,你可以自由选择任何许可证发布你的 Godot 项目,也可以制作商业游戏。
- 引擎还捆绑了部分第三方库(它们与 MIT 兼容但不受 MIT 覆盖),完整版权声明见 Godot 仓库的
COPYRIGHT.txt文件。可在分发时将该文件改名为GODOT_COPYRIGHT.txt一并附带,以清晰区分第三方声明与你的自有代码。 - 引擎提供
Engine.get_license_text()、Engine.get_license_info()、Engine.get_copyright_info()等方法,可直接从引擎二进制获取许可证信息,避免因升级引擎版本而过时。
文档的组织结构
Godot 官方文档被组织为五个主要板块,每部分面向不同读者与目的:
| 板块 | 内容与用途 |
|---|---|
| About(关于) | 本介绍页、引擎历史、许可证、作者等信息,以及常见问题 FAQ |
| Getting Started(入门) | 使用引擎制作游戏所需的全部信息,从 getting_started/introduction/index.rst 开始,是所有新用户的最佳起点 |
| Manual(手册,即 tutorials/) | 可按需以任意顺序阅读,包含各功能专题教程与文档,覆盖 2D、3D、动画、渲染、着色器、物理、网络、输入、导出、性能、UI、XR 等全领域 |
| Engine details(引擎细节) | 面向高级用户与贡献者,涵盖编译引擎、编辑器开发、C++ 模块开发等内容 |
| Class reference(类参考,即 classes/) | 完整的 Godot API 文档(所有类、函数、信号等),同样可在引擎内置的脚本编辑器中直接查阅 |
在仓库中,上述板块与根目录 index.rst 中隐藏的 toctree 结构一一对应(可参照该文件的.. toctree::部分定位各板块的入口页面)。
此外,官方还提供了大量Godot 演示项目(demo projects),供学习参考。
手册(Manual)板块的进阶入口
作为进阶读者的导航参考,根目录 index.rst 中的 Manual toctree 展示了完整的主题覆盖范围:
- 跨领域:最佳实践(
tutorials/best_practices/index.rst)、故障排查(tutorials/troubleshooting.rst)、编辑器(tutorials/editor/index.rst)、迁移指南(tutorials/migrating/index.rst) - 技术专题:2D、3D、动画、资源管线、音频、导出、IO、国际化、输入、数学、导航、网络、性能、物理、平台、插件、渲染、脚本、着色器、UI、XR(
tutorials/下对应目录)
关于本文档本身
文档的协作模式
Godot 文档由社区成员持续撰写、修正、编辑与改进。文档欢迎更多贡献者:
- 可通过在 GitHub 上提交 issue 或 PR 来报告问题、改进内容
- 可参与文档的多语言翻译工作(仓库
conf.py中supported_languages配置列出 16 种支持语言,包括简体中文 zh_Hans/zh_CN 与繁体中文 zh_Hant/zh_TW) - 可通过 Godot Contributors Chat 与文档团队沟通
许可证与署名
除classes/文件夹外,本仓库所有文档内容均采用宽松的知识共享署名 3.0(CC BY 3.0)许可证,署名归功于 "Juan Linietsky, Ariel Manzur, and the Godot Engine community",除非另有注明。classes/下的类参考文件则源自 Godot 主源码仓库,采用 MIT 许可证(详见 README.md 的 License 部分)。
如何开始你的 Godot 之旅:实操路线图
综合本文与仓库结构,建议按以下路线开始:
- 通读本文(about/introduction.rst),理解引擎定位与文档导航。
- 进入 Getting Started 系列:从 getting_started/introduction/index.rst 开始,先阅读 introduction_to_godot.rst(了解 Godot 是什么、引擎能做什么、需要什么编程基础),再依次阅读 GDScript 入门、核心概念(节点/场景/信号)、编辑器界面初览、学习新功能的方法与引擎设计哲学等页面。
- 动手实践:跟随 getting_started/step_by_step/index.rst 的逐步教程,以及 getting_started/first_2d_game/index.rst 和 getting_started/first_3d_game/index.rst 两个完整游戏项目教程。
- 按需查阅手册与类参考:遇到具体功能问题时,在
tutorials/与classes/中检索对应主题;类参考同样内置于引擎脚本编辑器,可在编辑器中直接查阅。
Have fun reading and making games with Godot Engine!
- 文档
- 教程
- 游戏开发
【免费下载链接】godot-docs
Godot Engine official documentation
相关推荐
Flame游戏引擎文档系统开发指南
Flame游戏引擎文档系统开发指南 作为Flame游戏引擎的技术文档维护者,了解如何正确编写和维护文档至关重要。本文将详细介绍Flame文档系统的技术架构和最佳
游戏开发图形学Godot引擎入门:创建2D游戏玩家场景
Godot引擎入门:创建2D游戏玩家场景 玩家场景概述 在Godot引擎中创建2D游戏时,玩家角色通常是一个独立的场景。这种模块化设计不仅便于单独测试玩家功能,
文档教程游戏开发Godot引擎文档全面解析:开源游戏开发新范式
Godot引擎文档全面解析:开源游戏开发新范式 概述:为什么Godot文档是游戏开发者的宝藏 还在为游戏引擎的学习曲线陡峭而苦恼?还在为商业引擎的授权费用和限制
文档教程游戏开发
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考