本页目录

Ball2Box(Godot 休闲抛球闯关游戏)

ball2box · dulvui/ball2box

Ball2Box 是一款用 Godot Engine 3.x 与 GDScript 开发的休闲抛球闯关游戏:滑动屏幕把球抛向箱子,README 称包含 100 多个关卡。项目开源、无广告、无追踪,支持 iOS、Android、Linux 和 Web;README 提供 Google Play、F-Droid、Flathu...

休闲 Godot GDScript 角色控制 物理系统 关卡管理 音频系统 初级
★ Stars 8 Forks 2 License 未明确 更新 2025-10-23

国内开发环境适配

Windows
未知
Linux
官方声明支持
macOS
未知
引擎 / 框架:Godot 暂无中文教程标记 未标记站长实测
Godot 3.x 编辑器需自行获取,官方下载源在国内可能较慢,建议使用镜像待核验;Google Play、F-Droid、Flathub、itch.io 分发页面在国内访问可能受限,可改从 Codeberg Releases 获取构建产物;仓库未提供导出预设,Android/iOS 导出需自备签名与 SDK 环境。

中文项目介绍

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/,包含背景音乐与打击音效;
  • 2D 资源包含图标、箱子贴图、背景图、暂停按钮与各类 UI 图标,另有 game/assets/patterns/ 下的平铺图案;
  • 3D 资源以 .obj 模型形式放在 game/assets/obj/,README 列出了圆环球、星星、排球、足球、八爪球等不同球体外观;
  • 字体使用 game/assets/font/manrope.thin.otf。

也就是说,这个“2D 玩法 + 多种球体外观”的组合,是通过轻量的 3D 资源来实现的,这对想研究小体量 Godot 项目资源组织方式的读者比较有参考价值。

构建与运行

README 的 Setup 一节给出了最简流程:安装最新版本的 Godot 编辑器,检出仓库,然后用编辑器打开 game/project.godot。涉及移动端导出等更细的操作,README 建议直接查阅 Godot 官方文档。

export_presets.cfg

导出配置不会随仓库直接提供。要导出 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 用相当长的篇幅逐项列出授权,这部分对二次使用非常重要:

  • 代码:Ball2Box 本体为 GNU AGPL v3.0 or later,版权归 Simon Dalvai(2020);Godot Engine 自身为 MIT。
  • 音频:背景音乐 “The heist” 来自 audiohub.com,CC-BY-4.0;军鼓与镲片音效来自 LMMS 素材库,CC0-1.0。
  • 2D 素材:作者自制部分为 CC-BY-SA-4.0;图标与图案包分别来自 kenney.nl 的 Game Icons、Patterns Pack、Patterns Pack 2,均为 CC0-1.0;复制/粘贴图标来自 Google material-design-icons,Apache-2.0。
  • 3D 素材:圆环球为作者自制 CC-BY-SA-4.0;星星(Savino)为 CC0;排球(PatelDev)与足球(siixarn)为 CC-BY-4.0;Octoball(EZduzziteh)为 CC-BY-3.0。
  • 字体:Manrope(sharanda)采用 SIL Open Font License。

如果打算在自己的项目中复用这些资源,需要逐项核对署名要求:CC0 基本无约束,而 CC-BY、CC-BY-SA 系列则要求保留作者信息,AGPL 对代码分发有更强的传染性约束。

学习建议

Ball2Box 适合作为 Godot 3.x 的入门参照项目:打开 project.godot 就能看到完整的场景与脚本结构,输入方式单一、资源清单清晰,便于对照理解 Godot 中场景、节点、脚本与导出配置之间的关系。

阅读顺序上,可以先看 game/src/ 下的场景与脚本,理解一次投掷的输入与物理表现如何实现;再对照 README 的素材清单,看美术、音频、字体是如何被拆分与标注授权的;最后尝试按 Setup 一节复现一次本地运行,并参照示例文件补全 Android 导出配置。若希望跟进 Godot 4.x 的迁移实践,可以关注仓库 issue #6 的进展。

开源许可证与版权说明

许可证标识:未明确。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目