ball2box · dulvui/ball2box
Ball2Box 是一款用 Godot Engine 3.x 与 GDScript 开发的休闲抛球闯关游戏:滑动屏幕把球抛向箱子,README 称包含 100 多个关卡。项目开源、无广告、无追踪,支持 iOS、Android、Linux 和 Web;README 提供 Google Play、F-Droid、Flathu...
Ball2Box 是一个使用 Godot Engine 3.x 与 GDScript 编写的小型休闲游戏,出自开发者 Simon Dalvai 之手。README 用一句话概括了玩法:滑动屏幕把球抛出,命中箱子,一共 100 多个关卡。作品以开源方式发布,README 明确说明游戏无广告、无追踪,并面向 iOS、Android、Linux 与 Web 四个平台构建。
项目在 README 顶部直接给出多个获取入口,包括 Google Play(包名 com.salvai.ultimatetoss)、F-Droid(com.simondalvai.ball2box)、Codeberg Releases、Flathub(org.simondalvai.ball2box)以及 itch.io 页面,方便不同平台与不同分发偏好的玩家安装。源码以 AGPL v3.0 或更高版本授权,作者自制的素材使用 CC-BY-SA-4.0。
项目基于 Godot Engine 3.x,主语言是 GDScript,游戏工程放在 game/ 目录下,入口是 game/project.godot。README 也说明正在跟踪向 Godot 4.x 的迁移,对应 issue #6,也就是说当前主线仍是 3.x 版本。
从 README 的结构可以看出工程组织的几条线索:
game/src/,授权说明中列出的通配符是 game/src/**.tscn 与 game/src/**.gd,说明界面/关卡由场景文件与 GDScript 脚本共同构成;game/assets/audio/,包含背景音乐与打击音效;game/assets/patterns/ 下的平铺图案;.obj 模型形式放在 game/assets/obj/,README 列出了圆环球、星星、排球、足球、八爪球等不同球体外观;game/assets/font/manrope.thin.otf。也就是说,这个“2D 玩法 + 多种球体外观”的组合,是通过轻量的 3D 资源来实现的,这对想研究小体量 Godot 项目资源组织方式的读者比较有参考价值。
README 的 Setup 一节给出了最简流程:安装最新版本的 Godot 编辑器,检出仓库,然后用编辑器打开 game/project.godot。涉及移动端导出等更细的操作,README 建议直接查阅 Godot 官方文档。
导出配置不会随仓库直接提供。要导出 Android 或 iOS,需要复制对应平台的示例文件并填入自己的配置,例如 Android:
cp game/export_presets.android.example game/export_presets.cfg
这一步很关键,因为 export_presets.cfg 通常包含签名、包名等与本机环境相关的信息,示例文件的作用是提供模板,避免敏感或机器相关的配置进入版本库。
从 README 的描述看,Ball2Box 的核心循环非常精简:玩家用手指滑动产生一次投掷,球沿物理轨迹飞出,目标是落进/击中箱子。难度递进依靠关卡数量来体现,README 给出的规模是“超过 100 关”。
这种设计让项目具备两个特征:
README 没有展开具体的道具、评分或失败机制,因此本文不对这些细节做推测。开发者把功能与待办事项集中放在仓库的 ROADMAP.md 中,README 的 Roadmap 一节只做指向,想了解后续计划需要直接阅读该文件。
游戏内的所有文案及其多语言翻译集中在同一个 CSV 文件:game/assets/i18n/UltimateTossi18n.csv(文件名沿用了项目早期的名字 UltimateToss)。各应用商店的页面描述则放在 store-pages/ 目录下。README 欢迎通过 Pull Request 修正错别字或新增语言,因此对翻译贡献者而言,改动面很小、上手成本低。
README 用相当长的篇幅逐项列出授权,这部分对二次使用非常重要:
如果打算在自己的项目中复用这些资源,需要逐项核对署名要求:CC0 基本无约束,而 CC-BY、CC-BY-SA 系列则要求保留作者信息,AGPL 对代码分发有更强的传染性约束。
Ball2Box 适合作为 Godot 3.x 的入门参照项目:打开 project.godot 就能看到完整的场景与脚本结构,输入方式单一、资源清单清晰,便于对照理解 Godot 中场景、节点、脚本与导出配置之间的关系。
阅读顺序上,可以先看 game/src/ 下的场景与脚本,理解一次投掷的输入与物理表现如何实现;再对照 README 的素材清单,看美术、音频、字体是如何被拆分与标注授权的;最后尝试按 Setup 一节复现一次本地运行,并参照示例文件补全 Android 导出配置。若希望跟进 Godot 4.x 的迁移实践,可以关注仓库 issue #6 的进展。
NBlood 是用 EDuke32 引擎技术与开发思路对 Build 引擎游戏所做的逆向工程移...
Frogatto & Friends 是一款 2D 横版动作冒险游戏,主角是一只青蛙;开发团队...
id Software 公开的初代 DOOM 源代码,限非盈利使用。README 说明:运行仍需...