StepMania 跨平台音乐节奏游戏（跳舞机）

这个仓库是 HTML5 网页游戏 Pappu Pakia 的一个教学修改版。原版游戏由 Rishabh 负责编码、Kushagra 负责美术，是为 2012 年 GitHub Game Off 活动制作的作品。Udacity 课程《Version Control Using Git and Github》（ud775）的 Caroline Buckey 和 Sarah Spikes 在原仓库基础上做了改动，加入了若干刻意引入的 Bug 和其他调整，这些 Bug 并非原作者所写。其目的不是让学习者单纯玩通游戏，而是把仓库当作一个「故障现场」：通过阅读提交历史、比对不同版本、追溯代码变化，找出究竟是哪一个提交把 Bug 带了进来，从而在真实代码库上练习 Git 的排查能力。

从玩法上看，这是一个以「悬浮—坠落」为核心的单键操作游戏。玩家操控小角色 pappu，点击鼠标或在触屏上轻点即可向上抬升，松手后角色持续下坠，一旦碰到画面上边界或下边界即告结束。关卡中会随机出现 fork、branch 之类的障碍物；还有被称作 pakia 的敌人，分为三种：悲伤型会把角色拉过去，开心型会把角色推开，愤怒型则直接致死。玩家需要与它们保持安全距离。可收集物方面，金币按颜色分档计分，黄色 50 分、粉色 100 分、红色 500 分、蓝色 1000 分；星星提供短时间的无敌状态；浆果会生成克隆体，克隆体会摧毁沿途一切障碍。作者特意让碰撞判定不那么严格，以降低难度、改善手感。按 Enter 或空格键可以重新开始游戏。

核心特性

技术实现上，原版作者明确说明没有使用任何游戏库、物理引擎或框架，全部逻辑与物理均为自研代码，只借助 jQuery 完成少量、快速的 DOM 操作。这意味着游戏循环、重力与速度积分、碰撞检测、障碍与收集物生成、分数与状态切换等，都是相对朴素但完整的原生实现，对于想了解「不用引擎如何写一个小游戏」的读者有一定参考价值。运行方式也非常轻量：修改版不需要任何构建步骤，直接在浏览器中打开仓库根目录的 index.html 即可游玩。

比较有意思的是它与课程主题的呼应。按照当年 Game Off 活动的规则，作者尝试把 fork、branch、push、pull、clone 等版本控制概念融入游戏表达：关卡里的障碍对应 fork 与 branch，敌人的推拉行为对应 push 与 pull，浆果生成的克隆体对应 clone。这种把 Git 术语「游戏化」的设计，与 Udacity 用它来讲 Git 的组合相当自然——玩家在游戏里躲避 fork 与 branch，学习者在仓库里追踪引入 Bug 的那次提交，两条线索彼此照应。

技术要点

平台与获取方面，仓库本身是纯静态前端文件，理论上任何带现代浏览器的桌面或移动系统都能直接打开运行，但项目并未对具体操作系统作出官方支持声明，因此各平台的实际表现仍属待核验；移动端虽然 README 提到支持触屏轻点，具体兼容性同样未经本页实测。原始未修改版本的在线试玩地址在 README 中给出，但它是原作者的页面，并非本教学修改版的托管地址，访问可用性需自行确认。此外仓库已标注为弃用并进入归档流程，学习者仍可 fork 到自己的账号，但不能再向该仓库提交 PR；遇到与课程内容相关的问题，官方建议前往 Udacity 的知识论坛提问，或因其他原因受阻时提交支持工单。

适合学习的地方在于：这是一个体量不大、历史清晰、Bug 位置已知的代码库，非常适合练习 git log、git blame、按关键字搜索历史改动（如 git log -S）、用 git bisect 二分定位回归，以及 checkout 到旧提交与当前版本对比差异等操作。需要注意的地方也很明确：这是为教学而人为注入缺陷的版本，其中的「Bug」并非真实开发事故，代码本身也不应被当作游戏架构或前端最佳实践来学习；项目年代较早，缺少测试、构建脚本和依赖管理，现代浏览器下的兼容细节与移动端手感都建议自行核验后再作判断。