机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

奥苏！

一款免费赢取的节奏游戏。节奏只需轻轻一击！

这是 osu! 游戏客户端的未来——也是最终版本，它标志着开放时代的开始！目前以发布代号“lazer”知名并发布。意为比最尖端更锋利。

状态

此项目正在持续开发中，但我们会尽最大努力保持其稳定状态。建议玩家在其稳定的 osu! 客户端旁边安装发行版。该项目将会持续发展，直到大多数用户更喜欢它而不是之前的“osu!stable”版本。

有一些资源可作为起点，帮助您参与并了解该项目：

• 详细的发布更新日志可在 官方 osu! 网站 上查看。
• 您可以了解更多关于我们 项目管理 的方法。
• 跟踪我们当前在 改进游戏 方面的努力。

正在运行 osu!

如果您只是想尝试游戏，可以获取适用于您平台的最新版本：

最新版本：

您通常也可以从 osu! 网站 下载适用于您当前设备的版本。

如果您的平台不受支持或未在上述列表中，也仍有机会运行该发布版或按照以下说明手动构建。

对于 iOS/iPadOS 用户：iOS TestFlight 链接很快就会满（Apple 对用户数量有 10,000 人的硬限制）。我们会偶尔重置链接。请不要对此进行询问。请定期查看链接是否重置，或在 Twitter 上关注 peppy 以获取公告。我们的目标是尽快将游戏上线至移动应用商店，以免受此限制影响。

开发自定义规则集

osu! 旨在允许用户创建的游戏玩法变体，称为“规则集”。构建其中一个规则集可以让开发者利用 osu! 的谱面库、游戏引擎以及通用用户体验来创建新的玩法风格。要开始开发规则集，我们提供了一些模板，可在这里获取。

你可以通过访问自定义规则集目录查看一些自定义规则集的示例。

开发 osu!

先决条件

请确保你具备以下先决条件：

• 一台已安装正确 .NET SDK 的桌面平台。

在处理代码库时，我们建议使用具有智能代码补全和语法高亮功能的 IDE，例如最新版的 Visual Studio、JetBrains Rider，或安装了 EditorConfig 和 C# Dev Kit 插件的 Visual Studio Code。

下载源代码

克隆代码仓库：

git clone https://github.com/ppy/osu
cd osu

要将源代码更新到最新提交，请在 osu 目录中运行以下命令：

git pull

构建

来自 IDE

你应该通过特定平台的 .slnf 文件加载解决方案，而不是主 .sln 文件。这将减少依赖并隐藏你不关心的平台。有效的 .slnf 文件有：

• osu.Desktop.slnf (most common)
• osu.Android.slnf
• osu.iOS.slnf

推荐 IDE（如上所列）的运行配置已包含。你应使用 IDE 提供的构建/运行功能来开始操作。在测试或构建新组件时，强烈建议使用 osu! (Tests) 项目/配置。更多信息请参见 下面。

要为移动平台构建，如果之前没有运行过 sudo dotnet workload restore，你可能需要先运行它。这将安装完成构建所需的 Android/iOS 工具。

从命令行

你也可以通过命令行用一条命令构建并运行 osu!：

dotnet run --project osu.Desktop

在本地运行进行任何类型的性能测试时，请确保在构建命令中添加 -c Release，因为使用默认 Debug 配置运行的开销可能很大（尤其是在使用如下本地框架修改进行测试时）。

如果构建失败，请尝试使用 dotnet restore 恢复 NuGet 包。

使用资源/框架修改进行测试

有时可能需要交叉测试 osu-resources 或 osu-framework 的更改。可以使用随附命令快速实现：

Windows：

UseLocalFramework.ps1
UseLocalResources.ps1

macOS / Linux：

UseLocalFramework.sh
UseLocalResources.sh

请注意，这些命令假设您已将相关项目签出到相邻的目录中：

|- osu            // this repository
|- osu-framework
|- osu-resources

代码分析

在提交代码之前，请运行代码格式化工具。你可以通过在命令行中运行 dotnet format ，或者在你的 IDE 中使用 Format code 命令来实现。

我们采用了一些跨平台、编译器集成的分析工具。当你在 IDE 中编辑、构建或在命令行中构建时，它们可以提供警告，就好像这些警告是由编译器本身提供的一样。

JetBrains ReSharper InspectCode 也被用于更广泛的规则集。你可以在 PowerShell 中运行 .\InspectCode.ps1 。或者，你可以安装 ReSharper 或使用 Rider 来在你选择的 IDE 中获得内联支持。

贡献

在参与项目时，你可以做的两件主要事情是报告问题和提交拉取请求。请参阅 贡献指南 以了解如何以最有效的方式提供帮助。

如果你希望帮助本地化工作，请前往 crowdin。

我们的团队相信人类贡献。任何由 AI/LLM 创建、记录或辅助的贡献——无论是问题报告还是拉取请求——通常会被关闭并锁定，不再进行进一步讨论。

许可证

osu! 的代码和框架是根据 MIT 许可 许可的。有关更多信息，请参阅 许可文件。简而言之，只要在软件/源代码的任何副本中包含原始版权和许可声明，你可以随意使用。

请注意，这 不涵盖 在任何软件、资源、广告或推广中使用“osu!”或“ppy”品牌，因为这是受商标法保护的。

还请注意，游戏资源受单独的许可覆盖。请参阅 ppy/osu-resources 仓库以获取相关说明。