Godot官方示例项目实战指南：30+个Demo教你从跑通到发布
【免费下载链接】godot-demo-projectsDemonstration and Template Projects项目地址: https://gitcode.com/GitHub_Trending/go/godot-demo-projects
如果你刚装好Godot，面对官方示例仓库里几十个项目不知道该从哪下手，这篇就是给你看的。godot-demo-projects是 Godot Engine 官方的演示项目库，每个文件夹都是一个独立可运行的完整项目，覆盖 2D/3D、物理、寻路、渲染、移动端和联网。它和文档的区别在于：文档告诉你"怎么调API"，这些 Demo 直接给你一份能跑的完整答案，包括场景怎么搭、资源怎么组织。下面按"先跑通一个 → 挑方向深挖 → 解决发布问题"的路子带你过一遍。
十五分钟跑通第一个Demo：子弹雨
我选 bullet_shower 作为你的第一个项目，因为它的规则一句话能说清：屏幕右侧不断有子弹飞过来，鼠标控制的小人躲子弹，被碰到就换成哭脸。项目里总共就两个脚本：bullets.gd 管子弹，player.gd 管玩家。
五步走：
- 克隆仓库：
git clone https://gitcode.com/GitHub_Trending/go/godot-demo-projects - 打开 Godot 的项目管理器，点右侧Scan按钮
- 选中仓库里
2d/bullet_shower这个目录（里面有project.godot的文件夹就是一个独立项目） - 双击项目打开，按 F5 运行。小人跟随鼠标，表情在笑脸/哭脸之间切换
- 打开
bullets.gd，把子弹数量改一下再按 F5，观察画面变化
这段代码决定整个Demo的"压力值"，改它最直接：
const BULLET_COUNT = 500 # 改成 1000 看看掉不掉帧 const SPEED_MIN = 20 # 最慢子弹速度（像素/秒） const SPEED_MAX = 80 # 最快子弹速度改BULLET_COUNT到 1000 或 2000，游戏依然流畅——这就是这个Demo存在的意义。它没用"每颗子弹一个场景实例"的常规做法，而是通过底层的PhysicsServer2D（绕过场景树直接操控物理引擎的接口）批量管理所有子弹：碰撞体用一行PhysicsServer2D.body_create()创建，500 颗子弹的绘制集中在一个_draw()函数里一次完成。剩下的细节都在bullets.gd里，代码很短，值得逐行读完。
这里有个坑：玩家脚本里的碰撞回调叫_on_body_shape_entered(_body_id: RID, ...)，参数是RID而不是节点引用。初学可能会疑惑"为什么不用我熟悉的body: Node2D"，答案和上面一样——走底层接口时，对象用不透明的 RID 标识，这是高性能玩法的代价之一。
跑通之后，别急着走。把player.gd里position = input_event.position - Vector2(0, 16)的偏移量从 16 改成 0 再运行，看看小人和鼠标指针重合后体验有什么不同——这种"改一行看效果"的习惯，比单纯读代码学得快。
按"它解决什么问题"挑Demo看
Demo 库按 2d/3d/audio 等目录组织，但学习时按目录翻效率不高。换个思路：先想清楚你的游戏要解决什么问题，再对号入座。
点击地面让角色绕开障碍物：网格寻路
问题定义：玩家点了屏幕右边，角色要自己规划一条不穿墙的路线走过去。这是回合制游戏、塔防、Roguelike 里最常见的 AI 需求。
navigation_astar 用的是AStarGrid2D（专为方格地图设计的 A* 寻路对象）。核心思路就三步：
- 在
_ready()里设置寻路区域大小和格子尺寸，把 TileMap 上所有已铺格子标记为不可通行 - 点击地面时调
get_point_path(起点, 终点)拿到一串格点路径 - 角色每帧朝下一个路点移动，走到达标距离就弹出该点，取下一个
和 2D 导航多边形（NavigationRegion2D，适合角色在连续空间游走）相比，网格寻路更适合有明确格子的玩法：
| 方案 | 效果 | 复杂度 | 适合场景 |
|---|---|---|---|
| AStarGrid2D | 路径贴合格子，天然带"回合数"概念 | 低 | 回合制、战棋、Roguelike |
| 导航多边形 | 路径连续平滑，可动态改障碍 | 中 | 即时制 2D 游戏 |
| 导航网格分块 | 大世界按需加载寻路区域 | 高 | 开放世界 |
你可以试着改一下：在pathfind_astar.gd里找到set_point_solid(pos)，把"全部格子设为障碍"改成"隔一个设一个"，看看角色在迷宫格点间走位的样子。3D 侧的对应方案在 3d/navigation/，思路一致，只是把格子换成了烘焙的导航网格。
一千个对象还不掉帧：底层Server优化
问题定义：你的游戏里出现"满屏弹幕""上百个敌人"这类场景，每个对象都建场景实例时，CPU 开销会先于帧率报警。
上面子弹雨就是标准答案，它示范了一条清晰的性能路线：
- 碰撞体不挂节点，直接用 PhysicsServer2D 的
body_create()批量创建，用body_set_collision_mask(body, 0)关掉子弹之间的相互碰撞 - 所有绘制合并到单个 CanvasItem 的
_draw()里，一次提交给渲染器 - 场景销毁时用
free_rid()逐个释放，防止资源泄漏
官方文档把这类技巧归在"Optimization using Servers"章节，这个Demo是那个章节的最小可运行版本。你可以试着把PhysicsServer2D.body_set_collision_mask(bullet.body, 0)这行删掉再运行——子弹开始互相碰撞，游戏照跑但物理开销明显上升，这就是"碰撞掩码"存在的理由。
让光线"弹"进角落：全局光照
问题定义：一盏灯只照亮自己照得到的面，但真实世界里光会被墙面反弹，照亮它照不到的角落。模拟这种"二次光照"的技术统称Global Illumination（全局光照）。
3d/global_illumination 在一个场景里同时展示了 Godot 的几套方案：LightmapGI（预烘焙）、VoxelGI（体素化的实时全局光）、SDFGI（基于符号距离场的实时近似）、反射探针和屏幕空间效果。移动相机里的球体和立方体是动态物体，专门用来观察"静态烘焙的光如何托住动态角色"。各方案的取舍：
| 方案 | 实时性 | 性能消耗 | 典型用途 |
|---|---|---|---|
| LightmapGI | 需烘焙 | 运行时最低 | 完全静态的室内场景 |
| VoxelGI | 需预计算 | 中高 | 大型静态场景 |
| SDFGI | 完全实时 | 中 | 动态性强的场景 |
经验提示：新手最容易踩的误区是拿 VoxelGI 去套动态场景。它的预计算结果对"世界没变"有隐含假设，角色频繁穿越不同光环境时效果会穿帮——先用 LightmapGI 烘一个静态底子，再补动态光源，是多数项目的稳妥组合。
想动手的话，打开项目切一遍全局光照模式（项目设置里的渲染项），同一关在不同模式下的角落亮度差异，比读十页文档直观。
Demo跑起来了，发布还差什么
版本不匹配打不开项目，是最常见的第一个坑。
现象：用 4.2 的编辑器打开仓库，项目列表里要么找不到，要么打开后全是红色报错。原因：仓库按分支对应不同引擎版本，master分支的 Demo 只和开发版引擎兼容，每个稳定版有同名分支。解决：看项目project.godot里的config/features声明的版本，去拉对应分支：
# 4.3 稳定版引擎就拉 4.3 分支 git clone -b 4.3 https://gitcode.com/GitHub_Trending/go/godot-demo-projects平台差异是第二个坑。Godot 有三套渲染管线，不同平台该用哪套，直接决定了画面表现和帧率：
| 平台 | 渲染器 | 特点 |
|---|---|---|
| 桌面 | Forward+ | 效果最全，光追类效果可选 |
| 移动 | Mobile | 省电，特性有限制 |
| Web | Compatibility | 兼容面最广，加载最轻 |
Demo 的project.godot里其实已经写明了推荐配置，比如子弹雨的renderer/rendering_method="gl_compatibility"就是在告诉引擎：这个项目按兼容性管线跑。你发布前要做的事很机械：确认目标平台，把渲染器和窗口缩放策略（[display]段）对齐，然后实测帧率。移动端 Demo 的传感器数据（加速度计、陀螺仪）在桌面上拿到的是空值，mobile/sensors/ 的 README 特意提醒了这点——真机测试不可跳过。
按"你想做什么"找路
Demo 看完只是起点，下一步取决于你要做什么类型的项目：
- 想做 2D 平台跳跃 → 看 2d/platformer/ 和 2d/physics_platformer/ → 重点留意前者用 CharacterBody2D、后者用 RigidBody2D 的两套角色控制器写法差异，后者还能做出跷跷板、骑敌这种物理互动
- 想做 3D 小游戏 → 看 3d/squash_the_creeps/ → 重点留意 3D 版的"躲怪物"结构和角色碰撞层的划分，它和 2D 版 dodge_the_creeps 是同一个玩法，对比着读能看懂 2D/3D 节点体系的对应关系
- 想做移动端游戏 → 看 mobile/multitouch_cubes/ 和 mobile/sensors/ → 重点留意多点触控事件的坐标换算和传感器权限
- 想做联机 → 看 networking/multiplayer_pong/ → 重点留意场景树的同步写法，它把网络同步压进了一个最小案例里
配套资源直达：
- 官方文档：https://docs.godotengine.org/en/stable/
- API 参考：https://docs.godotengine.org/en/stable/classes/
- 社区中心：https://godotengine.org/community/
Demo 最好的用法不是通关，而是拆开：每个项目都足够小，小到你能在一晚上内把它的每一行都读一遍。选一个离你的目标最近的，改它，直到它变成你的东西。
【免费下载链接】godot-demo-projectsDemonstration and Template Projects项目地址: https://gitcode.com/GitHub_Trending/go/godot-demo-projects
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
