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 儲存庫以取得說明。