osu

Osu!

Ein kostenloses Rhythmus-Spiel. Rhythmus ist nur einen Klick entfernt!

Dies ist die zukünftige – und letzte – Iteration des OSU! Spiel-Client, der den Beginn einer offenen Ära markiert! Derzeit bekannt unter dem Release-Codenamen „ Lazer “ und veröffentlicht unter diesem. Schärfer als modern.

Status

Dieses Projekt wird ständig weiterentwickelt, wir tun jedoch unser Bestes, um die Dinge in einem stabilen Zustand zu halten. Spielern wird empfohlen, eine Version zusammen mit ihrem stabilen OSU zu installieren! Kunde. Dieses Projekt wird sich weiterentwickeln, bis wir irgendwann den Punkt erreichen, an dem die meisten Benutzer es der vorherigen „osu!stable“-Version vorziehen.

Als Ausgangspunkte für die Mitarbeit und das Verständnis des Projekts stehen Ihnen einige Ressourcen zur Verfügung:

• Detaillierte Versionsänderungsprotokolle sind im offiziellen OSU verfügbar! Website.
• Erfahren Sie mehr über unseren Ansatz im Projektmanagement.
• Verfolgen Sie unsere aktuellen Bemühungen zur Verbesserung des Spiels.

Laufen osu!

Wenn Sie das Spiel einfach einmal ausprobieren möchten, können Sie sich die neueste Version für Ihre Plattform holen:

Neueste Veröffentlichung:

Windows 10+ (x64)	macOS 12+ (Intel, Apple Silicon)	Linux (x64)	iOS 13.4+	Android 5+

Sie können im Allgemeinen auch eine Version für Ihr aktuelles Gerät vom osu herunterladen! Website.

Wenn Ihre Plattform nicht unterstützt wird oder oben nicht aufgeführt ist, besteht dennoch die Möglichkeit, die Version auszuführen oder sie manuell zu erstellen, indem Sie die folgenden Anweisungen befolgen.

Für iOS-/iPadOS-Benutzer : Der iOS-Testflug-Link füllt sich sehr schnell (Apple hat ein festes Limit von 10.000 Benutzern). Wir setzen es gelegentlich zurück. Bitte fragen Sie nicht danach. Schauen Sie regelmäßig vorbei, um zu erfahren, ob Links zurückgesetzt werden, oder folgen Sie peppy auf Twitter, um Ankündigungen zu erhalten. Unser Ziel ist es, das Spiel Anfang 2024 in den mobilen App-Stores zu veröffentlichen.

Entwickeln eines benutzerdefinierten Regelsatzes

Osu! ist so konzipiert, dass vom Benutzer erstellte Spielvarianten, sogenannte „Regelsätze“, möglich sind. Der Bau eines davon ermöglicht es einem Entwickler, die Leistungsfähigkeit des OSU zu nutzen! Beatmap-Bibliothek, Spiel-Engine und allgemeine UX für einen neuen Gameplay-Stil. Um mit der Arbeit an einem Regelsatz zu beginnen, stehen hier einige Vorlagen zur Verfügung.

Sie können einige Beispiele für benutzerdefinierte Regelsätze sehen, indem Sie das Verzeichnis für benutzerdefinierte Regelsätze besuchen.

Osu entwickeln!

Voraussetzungen

Bitte stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllen:

• Eine Desktop-Plattform mit installiertem .NET 8.0 SDK.

Bei der Arbeit mit der Codebasis empfehlen wir die Verwendung einer IDE mit intelligenter Codevervollständigung und Syntaxhervorhebung, z. B. der neuesten Version von Visual Studio, JetBrains Rider oder Visual Studio Code mit installiertem EditorConfig- und C# Dev Kit-Plugin.

Herunterladen des Quellcodes

Klonen Sie das Repository:

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

Um den Quellcode auf den neuesten Commit zu aktualisieren, führen Sie den folgenden Befehl im osu -Verzeichnis aus:

git pull

Gebäude

Von einer IDE

Sie sollten die Lösung über eine der plattformspezifischen .slnf Dateien und nicht über die Haupt .sln laden. Dadurch werden Abhängigkeiten reduziert und Plattformen ausgeblendet, die Sie nicht interessieren. Gültige .slnf Dateien sind:

• osu.Desktop.slnf (am häufigsten)
• osu.Android.slnf
• osu.iOS.slnf

Ausführungskonfigurationen für die empfohlenen IDEs (oben aufgeführt) sind enthalten. Sie sollten die bereitgestellte Build/Run-Funktionalität Ihrer IDE verwenden, um die Dinge in Gang zu bringen. Beim Testen oder Erstellen neuer Komponenten wird dringend empfohlen, das osu! (Tests) Projekt/Konfiguration. Weitere Informationen hierzu finden Sie weiter unten.

Um für mobile Plattformen zu erstellen, müssen Sie wahrscheinlich sudo dotnet workload restore ausführen, sofern Sie dies noch nicht getan haben. Dadurch werden die zum Abschließen des Builds erforderlichen Android-/iOS-Tools installiert.

Von CLI

Sie können auch osu erstellen und ausführen! über die Befehlszeile mit einem einzigen Befehl:

dotnet run --project osu.Desktop

Wenn Sie lokal ausführen, um Leistungstests jeglicher Art durchzuführen, stellen Sie sicher, dass Sie -c Release zum Build-Befehl hinzufügen, da der Overhead der Ausführung mit der Standard Debug -Konfiguration groß sein kann (insbesondere beim Testen mit lokalen Framework-Änderungen wie unten).

Wenn der Build fehlschlägt, versuchen Sie, NuGet-Pakete mit dotnet restore wiederherzustellen.

Testen mit Ressourcen-/Framework-Änderungen

Manchmal kann es notwendig sein, Änderungen an den OSU-Ressourcen oder dem OSU-Framework gegenseitig zu testen. Mit den mitgelieferten Befehlen lässt sich das schnell erreichen:

Windows:

 UseLocalFramework.ps1
UseLocalResources.ps1

macOS / Linux:

 UseLocalFramework.sh
UseLocalResources.sh

Beachten Sie, dass diese Befehle davon ausgehen, dass Sie die entsprechenden Projekte in benachbarten Verzeichnissen ausgecheckt haben:

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

Code-Analyse

Bevor Sie Ihren Code festschreiben, führen Sie bitte einen Codeformatierer aus. Dies kann erreicht werden, indem Sie dotnet format in der Befehlszeile ausführen oder den Befehl Format code in Ihrer IDE verwenden.

Wir haben einige plattformübergreifende, in den Compiler integrierte Analysatoren eingeführt. Sie können beim Bearbeiten, Erstellen in der IDE oder über die Befehlszeile Warnungen ausgeben, als ob sie vom Compiler selbst bereitgestellt würden.

JetBrains ReSharper InspectCode wird auch für umfassendere Regelsätze verwendet. Sie können es über PowerShell mit .InspectCode.ps1 ausführen. Alternativ können Sie ReSharper installieren oder Rider verwenden, um Inline-Unterstützung in der IDE Ihrer Wahl zu erhalten.

Mitwirken

Wenn es darum geht, zum Projekt beizutragen, können Sie vor allem zwei Dinge tun, indem Sie Probleme melden und Pull-Anfragen einreichen. Bitte beachten Sie die Beitragsrichtlinien, um zu verstehen, wie Sie am effektivsten helfen können.

Wenn Sie bei der Lokalisierung helfen möchten, wenden Sie sich an crowdin.

Wir lieben es, qualitativ hochwertige Beiträge zu belohnen. Wenn Sie einen großen Beitrag geleistet haben oder ein regelmäßiger Beitragszahler sind, können Sie gerne eine Ausgabe über opencollective einreichen. Wenn Sie Fragen haben, können Sie sich vorher gerne an peppy wenden.

Lizenz

Osu! Der Code und das Framework von sind unter der MIT-Lizenz lizenziert. Weitere Informationen finden Sie in der Lizenzdatei. Tl;dr Sie können tun und lassen, was Sie wollen, solange Sie den ursprünglichen Urheberrechts- und Lizenzhinweis in jede Kopie der Software/Quelle einfügen.

Bitte beachten Sie, dass dies nicht die Verwendung des „osu!“ abdeckt . oder „ppy“-Branding in jeglicher Software, Ressourcen, Werbung oder Verkaufsförderung, da dies durch das Markenrecht geschützt ist.

Bitte beachten Sie auch, dass Spielressourcen einer separaten Lizenz unterliegen. Weitere Informationen finden Sie im ppy/osu-resources-Repository.