osu! (lazer)

osu! (lazer) 是什么

osu! 是一款免费游玩的节奏游戏，而本仓库是其新一代、也是最终形态的官方客户端，代号 lazer。它标志着 osu! 进入开放时代：客户端完全开源，基于 C# 与自研的 osu!framework 构建，支持 osu!、taiko、catch、mania 四种经典玩法。

rhythm is just a click away!

核心特性

• 多玩法支持：内置 osu!、taiko、catch、mania 四种 ruleset。
• 跨平台：覆盖 Windows、macOS、Linux，以及 iOS、Android 移动端。
• 开放扩展：任何人都可以开发自定义 ruleset，复用谱面库、游戏引擎与通用 UX。
• 持续演进：项目长期开发，目标是最终取代旧的 osu!stable 客户端。

技术栈与结构

• 主语言：C#，依赖 .NET SDK。
• 相关仓库：osu-framework（引擎）、osu-resources（资源）。
• 推荐 IDE：Visual Studio、JetBrains Rider，或配置了 C# Dev Kit 的 VS Code。

构建时建议使用平台专属的 .slnf 解决方案筛选文件，例如：

osu.Desktop.slnf   // 最常用
osu.Android.slnf
osu.iOS.slnf

命令行快速运行：

dotnet run --project osu.Desktop

做性能测试时记得加上 -c Release，避免 Debug 配置带来的额外开销。

开发自定义 Ruleset

osu! 将玩法抽象为 ruleset，开发者可以借此打造全新的游戏方式。仓库的 Templates 目录提供了起步模板，社区也有自定义 ruleset 目录可供参考。

参与贡献

主要贡献方式包括提交 issue 与 pull request。若想参与本地化翻译，可前往 Crowdin 上的 osu! 项目。项目团队强调人类贡献，对 AI 生成内容的参与有明确态度，提交前请阅读贡献指南。