Phaser 2 / CE 归档示例集（phaser-ce-examples）

Falling Time 是一款体量不大但结构完整的街机向下落躲避游戏，玩法血脉来自经典的 Fall Down 系列。屏幕中的场景会持续向上推进，玩家操控一颗球，必须不断从每层平台上预留的缺口掉落到下一层，一旦球没有及时穿过缺口、被推到画面顶端的平台压住，游戏便宣告结束。整个体验围绕“判断落点—横向移动—穿过缝隙”这一个循环高速重复展开，随着推进节奏加快，留给玩家观察与操作的时间被不断压缩，形成典型的街机式紧张感。

在内容构成上，游戏并不依赖复杂剧情或关卡列表，而是把全部乐趣压在单局节奏与操作手感上。画面由一层层带有缺口的横向平台堆叠而成，缺口的位置逐层变化，玩家需要一边预判下一层缺口出现的位置，一边调整球的横向位置，避免被上方逼近的边缘挤压。这种极简的画面结构天然适合小屏幕：信息量少、元素轮廓清晰、判定直观，因此项目在 README 中特别说明它针对低分辨率屏幕做了优化，这也是它能够顺畅跑在掌机上的原因之一。

技术选型上，Falling Time 使用纯 C 语言配合 SDL 2 编写，图像资源通过 SDL2_image 载入，音效与音乐依赖 SDL2_mixer，界面文字与数字则交给 SDL2_ttf 渲染。构建系统采用 CMake，仓库里同时给出了 PC 与掌机两套入口。值得注意的是项目内置了一份自行修改过的 Chipmunk 2D 物理库：球体的运动、与平台的接触与碰撞反馈都由这套物理系统驱动，README 明确提醒它无法直接用标准版 Chipmunk 替换，这意味着源码中的物理部分与游戏逻辑存在一定耦合，阅读或改造时需要把自定义改动一并考虑进去，而不能简单地把该目录替换为上游发行版。

核心特性

平台与构建方面，README 给出的路径相当明确。面向 PC 时，执行 cmake . && make 即可得到可运行的窗口化 SDL 程序，属于标准的 CMake 工作流，编译前需要自行准备 C 编译器与上述四个 SDL 2 相关库。面向 GCW-Zero 掌机时，需要先按开发者文档安装对应的工具链，然后运行 pkg/make_opk.sh 打包脚本，生成可在 OpenDingux 系统上安装运行的 opk 包。也就是说，这个项目从源码到实际可玩，中间只隔着“装依赖—跑 CMake—打包”这三步，没有额外的资源转换或神秘脚本。

授权方面，代码以 GPL 第 2 版发布，而美术、音频等素材的具体许可并不与代码完全一致，README 指示读者查阅仓库中的 COPYRIGHT 文件获取逐项说明。这一点在二次分发或商业使用时需要格外留意：不能仅凭“代码是 GPL”就推断所有素材都可以随意使用，素材的署名与复用条件应当以 COPYRIGHT 文件为准。

从学习价值看，Falling Time 很适合作为“如何用 C 和 SDL 2 把一个小点子做成完整游戏”的样本。它的代码量可控，却覆盖了一个小型游戏所需的主要环节：主循环与固定节奏的更新、键盘/掌机按键输入处理、精灵与背景的渲染、音效播放、字体文本绘制，以及把第三方物理库嵌进自研游戏逻辑的做法。对于想了解 SDL 2 项目如何组织 CMake 构建、如何同时兼顾桌面与低分辨率掌机目标的读者，它也能提供一份真实可参照的工程结构。

技术要点

需要提醒的是，仓库 README 篇幅不长，主要提供玩法说明、构建步骤与授权信息，并未给出在线试玩地址或详细的 API 文档，因此上手方式就是克隆源码、按依赖列表装库、自行编译。依赖项相对分散（SDL2、SDL2_image、SDL2_mixer、SDL2_ttf 四者缺一不可），在国内环境下从源码编译时需要提前准备好这些开发包；若使用系统包管理器，通常需要安装对应的 -dev / -devel 开发包而非仅运行时库，具体包名视发行版而定，需自行核验。