piggyRescue · surreal6/piggyRescue
这是一款主题为「营救海滩边游泳的小猪」的 VR 游戏,作者将其定位为历时约两个月的 Godot 与 XR 个人学习项目,基于 Godot 4.1 stable(最终在 4.1.2 测试)与 Godot XR Tools 4.1 插件开发。仓库打包了插件,并注明部分 XR Tools 文件...
Piggy Rescue 是一款以「营救海滩边游泳的小猪」为主题的 VR 小游戏。作者在 README 中把它明确界定为个人的 Godot 与 XR 学习项目,前后开发约两个月,并以「帮助其他人在学习中少走弯路」为目的把源码公开出来。
项目基于 Godot 4.1 stable 开发(最终在 4.1.2 上完成测试),依赖 Godot XR Tools 插件的 4.1 版本。README 中提供了 Vimeo 演示视频链接,成品游戏已在 SideQuest 与 Itch.io 上免费发布,作者同时接受捐赠。
需要先明确一点:这是一个「调得还不错的原型」,并非打磨过的商业作品。作者自己在文中反复强调代码未做优化、结构较杂乱,阅读时应把它当作可运行的 XR 学习样本,而不要当作工程规范的参考。
README 中明确列出的代码内特性包括:
Globals.gd 第 6 行。可以,成品已经免费发布,无需自行编译:
如果愿意支持作者,页面上也提供了捐赠入口。
为了让人能直接把仓库当学习素材打开,作者把 addons 一并打包进了代码库。但要注意,其中若干来自 XR Tools 的文件被作者修改过:
godot-xr-tools/objects/viewport_2d_in_3d.gdgodot-xr-tools/objects/virtual_keyboard.tscngodot-xr-tools/staging/loading_screen/loading_screen_shader.tresgodot-xr-tools/staging/loading_screen.tscngodot-xr-tools/staging/loading_screen.gd这些改动大多是为了实现「透明菜单,并把它渲染在所有内容之上」。作者曾把该改动作为功能提案提交,而在 XR Tools v4.2 中,Malcolm Nixon 已经提供了一套更新、更好的实现方式。也就是说,如果你使用的是较新版本的 XR Tools,这些魔改大概率不再必要。
README 列出的工具链为:Gimp、Inkscape、Penpot、Godot、Blender。其中图像与矢量素材由 Gimp / Inkscape / Penpot 处理,3D 与场景部分使用 Blender 与 Godot。
整个项目只有一个 staging 系统和一个场景,入口非常集中:
Globals.state 来驱动游戏各个状态。此外,scripts/XR_mod 文件夹里放了几个相对独立、可复用的代码片段:一个可拾取且可漂浮的物体,以及「水下摄像机音效」的实现。想快速理解项目,建议先读 Logic 节点的状态机与 UI 切换逻辑,再去看 XR_mod 中的独立模块。
作者在 README 里专门加了一段「Code alert」提醒读者:代码没有经过良好优化,实现相当简单,是一个调校得还不错的原型,但写法凌乱、组织不够有序,仓库里可能还散落着一些未使用的文件。作者表示代码仍有改进空间,并欢迎提交改进。
作者留了一个很开放的扩展点:如果想加入更多需要营救的宠物,只需要修改小猪生成器(pig spawner)对象即可。若在扩展过程中遇到问题,可以通过开 issue 的方式向作者求助。
这个仓库比较适合已经会用 Godot、正准备迈入 XR 领域的开发者:
scripts/XR_mod,把漂浮抓取、倒计时、水下摄像机这类可复用模块单独抽出来理解。需要提前有心理准备的是:在线排行榜要自行申请 Silentwolf 的 API key;仓库不包含 Android 构建环境,XR Loader、导出模板、Android Studio 与 JDK 都需要按官方文档自行补齐。
Frogatto & Friends 是一款 2D 横版动作冒险游戏,主角是一只青蛙;开发团队...
id Software 公开的初代 DOOM 源代码,限非盈利使用。README 说明:运行仍需...
NBlood 是用 EDuke32 引擎技术与开发思路对 Build 引擎游戏所做的逆向工程移...