osu

奥苏！

一款免费获胜的节奏游戏。只需点击一下即可产生节奏！

这是 osu! 的未来版本，也是最终版本！这标志着一个开放时代的开始！目前已知并以发行代号“ lazer ”发布。就像比尖端更锋利一样。

地位

该项目正在不断发展，但我们尽力保持稳定状态。我们鼓励玩家从稳定版本的osu 中安装！客户。该项目将继续发展，直到我们最终达到大多数用户比之前的“osu!stable”版本更喜欢它的程度。

有一些资源可以作为参与和了解该项目的起点：

• 详细的发布变更日志可在官方 osu! 上找到。地点。
• 您可以详细了解我们的项目管理方法。
• 跟踪我们当前为改进游戏所做的努力。

运行奥苏！

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

最新发布：

Windows 10+ (x64)	macOS 12+（英特尔、Apple Silicon）	Linux (x64)	iOS 13.4+	安卓5+

您通常还可以从 osu! 下载适合您当前设备的版本。地点。

如果您的平台不受支持或未在上面列出，您仍然有机会运行该版本或按照以下说明手动构建它。

对于 iOS/iPadOS 用户：iOS 测试飞行链接很快就会被填满（Apple 有 10,000 个用户的硬性限制）。我们偶尔会重置它。请不要询问此事。定期回来查看链接重置或关注 Twitter 上的 peppy 以获取公告。我们的目标是在 2024 年初在移动应用商店上架该游戏。

开发自定义规则集

奥苏！旨在允许用户创建游戏玩法变化，称为“规则集”。构建其中一个可以让开发人员利用 osu! 的力量！节奏图库、游戏引擎和通用用户体验，打造新的游戏风格。要开始制定规则集，我们在这里提供了一些模板。

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

开发奥苏！

先决条件

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

• 安装了 .NET 8.0 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 （最常见）
• osu.Android.slnf
• osu.iOS.slnf

包括推荐 IDE（上面列出）的运行配置。您应该使用 IDE 提供的构建/运行功能来使事情顺利进行。当测试或构建新组件时，强烈建议您使用osu! (Tests)项目/配置。下面提供了更多相关信息。

要针对移动平台进行构建，您可能需要运行sudo dotnet workload restore如果您之前没有这样做过）。这将安装完成构建所需的 Android/iOS 工具。

从 CLI

您还可以构建并运行osu!从命令行使用单个命令：

dotnet run --project osu.Desktop

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

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

通过资源/框架修改进行测试

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

视窗：

 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 还用于更广泛的规则集。您可以使用.InspectCode.ps1从 PowerShell 运行它。或者，您可以安装 ReSharper 或使用 Rider 在您选择的 IDE 中获得内联支持。

贡献

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

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

我们喜欢奖励高质量的贡献。如果您做出了大量贡献，或者是定期贡献者，欢迎您通过 opencollective 提交费用。如果您有任何疑问，请在这样做之前随时联系 peppy。

执照

奥苏！的代码和框架已获得 MIT 许可。请参阅许可证文件以获取更多信息。 tl;dr，只要您在软件/源的任何副本中包含原始版权和许可声明，您就可以做任何您想做的事情。

请注意，这不包括“osu!”的用法。任何软件、资源、广告或促销中的“ppy”品牌，因为这受商标法保护。

另请注意，游戏资源由单独的许可证涵盖。请参阅 ppy/osu-resources 存储库以获取说明。