本页目录

Etterna(键盘向跨平台节奏游戏)

etterna · etternagame/etterna

Etterna 是一款用 C++ 编写的开源跨平台节奏游戏,项目自述定位为「以键盘操作为核心的高级节奏游戏」,仓库标签包含 game、keyboard、rhythm、stepmania。采用 MIT 许可证,README 中提供 CI、Coverity 静态扫描与 GitHub Releases 下载...

音乐节奏 多人对战 自研引擎 C++ 游戏状态管理 网络联机 音频系统 UI 系统 高级
★ Stars 655 Forks 171 License MIT 更新 2026-11-03

国内开发环境适配

Windows
官方声明支持
Linux
官方声明支持
macOS
官方声明支持
引擎 / 框架:自研引擎 暂无中文教程标记 未标记站长实测
国内构建时需注意依赖库的下载可能受网络影响,建议配置镜像源;具体依赖列表请参考 Docs/Building.md。

中文项目介绍

Etterna 是一款以键盘操作为核心的跨平台节奏游戏,其玩法与《Dance Dance Revolution》类似,但更侧重于键盘玩家的操作体验。项目最初是 StepMania 5(v5.0.12)的一个分支,随着时间推移,Etterna 已经发展为一款独立的游戏,并围绕其构建了游戏内多人模式、在线排行榜 Etterna Online 以及一个超过 4000 名玩家的社区。

根据 README 的描述,Etterna 的目标是提供一个高级的节奏游戏体验,尤其适合那些喜欢用键盘进行精准输入的玩家。项目采用 C++ 编写,遵循 MIT 许可证,并在 GitHub 上积极维护,提供了持续集成(CI)和 Coverity 静态扫描的状态徽章,以及官方 Discord 社区和开发群组入口。

技术架构分析

构建说明

Etterna 的构建细节记录在 Docs/Building.md 文件中。由于项目是跨平台的,理论上可以在任何较新版本的 Windows、macOS 或 Linux 上进行构建。README 建议开发者阅读该文档以获取完整的构建指导。

补充说明

安装指南

Etterna 支持 Windows、macOS 和 Linux 三大平台。用户可以从 GitHub Releases 页面下载对应操作系统的安装文件。

  • Windows:运行安装程序即可完成安装。
  • macOS:由于二进制文件未签名,在安装前需要先解除隔离。具体步骤是:在 Etterna dmg 文件所在目录(通常是下载文件夹)中执行命令 xattr -d com.apple.quarantine ./Etterna*.dmg,然后挂载 DMG 并将 Etterna 文件夹复制到任意位置,运行可执行文件即可。
  • Linux:通常无需额外步骤。如果遇到问题,可以参考构建说明安装必要的依赖。

文档资源

项目使用 Doxygen 和 LuaDoc 生成文档,虽然文档覆盖率仍有待完善,但已托管在 docs.etterna.dev。任何对 develop 分支的提交都会立即更新这些文档站点。

  • 最新的 C++ 文档:https://docs.etterna.dev/doxygen/html/index.html
  • 最新的 Lua 文档:https://docs.etterna.dev/ldoc/index.html

学习建议

对于想要学习节奏游戏开发或 C++ 游戏编程的开发者,Etterna 是一个值得研究的开源项目。可以从阅读构建文档开始,尝试在本地编译运行,然后通过 Issue 跟踪器和贡献指南了解如何参与改进。项目涉及的音频处理、输入判定和网络联机等模块,都是节奏游戏开发中的关键技术点。

开源许可证与版权说明

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

相似项目