本页目录

melonJS:HTML5 2D/3D 游戏引擎

melonJS · melonjs/melonJS

melonJS 是一个面向 JavaScript/TypeScript 的 HTML5 游戏引擎,支持 2D 与 3D,提供 WebGL/WebGPU 渲染、内置物理、Tiled 地图与 glTF 支持,以及 WebAudio 音频。项目以 MIT 协议开源,仓库标注欢迎贡献;具体平台兼容性与版本状态待核...

动作游戏 平台跳跃 自研引擎 其他 角色控制 跳跃与重力 关卡管理 游戏状态管理 中级
★ Stars 314 Forks 16 License MIT 更新 2026-08-24

国内开发环境适配

Windows
官方声明支持
Linux
官方声明支持
macOS
未知
引擎 / 框架:自研引擎 暂无中文教程标记 未标记站长实测
从源码运行需先安装 Ruby,再安装 Gosu 与 MiniGL;Gosu 在部分系统上需要本地图形/音频开发库,国内网络下 gem 安装可能较慢,建议配置镜像源。安装包可从 GitHub Releases、itch.io 与 Steam 获取,具体可访问性待核验。

中文项目介绍

Super Bombinhas 是一款用 Ruby 编写的 2D 复古平台跳跃游戏。根据项目 README 的描述,它的灵感来自《超级马力欧世界》等经典平台作品,但加入了一项独特的机制:角色切换。玩家可以在游戏过程中更换角色,这一设计让传统平台跳跃玩法多了一层策略与变化。

游戏基于 Ruby 生态中的 Gosu 与 MiniGL 两个库构建。Gosu 是 Ruby 社区常用的 2D 游戏开发库,MiniGL 则是作者本人维护的、面向 Gosu 的辅助库,用于简化游戏开发中的常见工作。项目以完整可玩游戏的形式发布,安装包可从 GitHub Releases、itch.io 与 Steam 获取,README 也引导玩家前往 itch.io 查看更详细的介绍与实机演示视频。

补充说明

版本 1.5.0 更新要点

README 在开头专门列出了 1.5.0 版本的主要变化:

  • 引入 old school 与 casual 两种模式,为不同偏好的玩家提供难度或节奏上的选择;
  • 对多个关卡的设计进行了改进;
  • 对关卡编辑器做了改进并修复了若干问题。

这些更新说明项目在发布后仍在持续打磨关卡体验与配套工具,而不仅仅是完成一个可运行的原型。

画面与素材

README 提供了多张截图与一段 GIF 动图,用于展示游戏的实际画面,其中包括游戏场景截图以及关卡编辑器的界面截图。这些素材直接放在仓库的 screenshot 目录下,读者可以在 GitHub 页面直接查看,从而对游戏的视觉风格形成直观印象。

从素材组织方式也能看出,游戏的图像、音乐与图块资源分别存放在 data/img、data/song 与 data/tileset 等目录中,代码与资源分离,便于替换与二次创作。

如何运行

README 给出了从源码运行游戏的步骤,整体流程对熟悉 Ruby 的开发者比较友好:

  1. 安装 Ruby。Windows 用户可使用 RubyInstaller,Linux 用户可使用 RVM。
  2. 安装 Gosu 与 MiniGL,具体安装方式参见 MiniGL 仓库中的说明。
  3. 克隆本仓库。
  4. 在仓库目录下打开命令行或终端,执行 ruby game.rb 启动游戏。

需要注意的是,README 并未逐一列出各操作系统的完整依赖清单,实际安装 Gosu 时可能还需要系统层面的图形与音频库支持,这部分需参考 Gosu 与 MiniGL 各自的文档。

授权与说明

README 的 Remarks 一节交代了几项重要信息:

  • 源代码以 GNU GPLv3 许可证分发;图像与声音素材(data/img、data/song、data/tileset 目录的内容)则以 Creative Commons Attribution-ShareAlike 4.0 许可证分发。也就是说,代码与美术资源采用不同的授权条款,二次使用时应分别遵守。
  • 作者说明游戏主要由其本人进行了较为充分的测试,但仍可能存在 bug,发现问题欢迎反馈。这提示玩家与贡献者对稳定性保持合理预期。
  • 原声音乐的作者为 Zergananda 与 Francesco Corrado。
  • 仓库中的 bundle.rb 并非游戏源码的一部分,而是作者用来把全部源码打包成单个文件的工具脚本。
  • 用于制作全部关卡的关卡编辑器是独立项目,托管在 super-bombinhas-editor 仓库中。

学习建议

对于想学习 Ruby 游戏开发的读者,这个项目提供了一个完整的参考样本:它展示了如何用 Gosu 与 MiniGL 组织一个包含多关卡、角色切换、关卡编辑器配套流程的平台跳跃游戏,也展示了代码与美术资源分离、双许可证管理的工程实践。建议先按 README 步骤把游戏跑起来,再结合关卡编辑器仓库理解关卡数据的组织方式。由于 README 未提供更细的架构文档,深入阅读源码前可先联系作者获取项目结构说明。

开源许可证与版权说明

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

相似项目