osu

osu!

Un jeu de rythme gratuit à gagner. Le rythme est à portée de clic !

Il s’agit de la future – et dernière – itération d’osu! client de jeu qui marque le début d'une ère ouverte ! Actuellement connu et publié sous le nom de code « lazer ». Comme dans plus pointu que tranchant.

Statut

Ce projet est en développement constant, mais nous faisons de notre mieux pour maintenir les choses dans un état stable. Les joueurs sont encouragés à installer à partir d'une version parallèle à leur stable osu! client. Ce projet continuera à évoluer jusqu'à ce que nous atteignions finalement le point où la plupart des utilisateurs le préfèrent à la version précédente "osu!stable".

Quelques ressources sont disponibles comme points de départ pour s’impliquer et comprendre le projet :

• Les journaux de modifications détaillés de la version sont disponibles sur le site officiel d'osu! site.
• Vous pouvez en apprendre davantage sur notre approche de la gestion de projet.
• Suivez nos efforts actuels pour améliorer le jeu.

Exécuter osu !

Si vous cherchez simplement à donner un coup de fouet au jeu, vous pouvez récupérer la dernière version pour votre plate-forme :

Dernière version :

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

Vous pouvez également généralement télécharger une version pour votre appareil actuel à partir du site osu! site.

Si votre plate-forme n'est pas prise en charge ou n'est pas répertoriée ci-dessus, il est toujours possible que vous puissiez exécuter la version ou la créer manuellement en suivant les instructions ci-dessous.

Pour les utilisateurs iOS/iPadOS : Le lien iOS testflight se remplit très rapidement (Apple a une limite stricte de 10 000 utilisateurs). Nous le réinitialisons de temps en temps. S'il vous plaît, ne posez pas de questions à ce sujet. Revenez régulièrement pour les réinitialisations de liens ou suivez Peppy sur Twitter pour les annonces. Notre objectif est de proposer le jeu sur les magasins d’applications mobiles début 2024.

Développer un ensemble de règles personnalisées

osu! est conçu pour permettre des variations de jeu créées par l'utilisateur, appelées « ensembles de règles ». En construire un permet à un développeur d'exploiter la puissance d'osu! bibliothèque de beatmaps, moteur de jeu et UX générale pour un nouveau style de gameplay. Pour commencer à travailler sur un ensemble de règles, nous avons quelques modèles disponibles ici.

Vous pouvez voir quelques exemples d’ensembles de règles personnalisés en visitant le répertoire des ensembles de règles personnalisés.

Développer osu!

Conditions préalables

Veuillez vous assurer d'avoir les prérequis suivants :

• Une plate-forme de bureau avec le SDK .NET 8.0 installé.

Lorsque vous travaillez avec la base de code, nous vous recommandons d'utiliser un IDE avec complétion de code intelligente et coloration syntaxique, comme la dernière version de Visual Studio, JetBrains Rider ou Visual Studio Code avec le plug-in EditorConfig et C# Dev Kit installé.

Téléchargement du code source

Clonez le dépôt :

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

Pour mettre à jour le code source avec la dernière validation, exécutez la commande suivante dans le répertoire osu :

git pull

Bâtiment

Depuis un IDE

Vous devez charger la solution via l'un des fichiers .slnf spécifiques à la plate-forme, plutôt que via le fichier .sln principal. Cela réduira les dépendances et masquera les plates-formes dont vous ne vous souciez pas. Les fichiers .slnf valides sont :

• osu.Desktop.slnf (le plus courant)
• osu.Android.slnf
• osu.iOS.slnf

Les configurations d'exécution pour les IDE recommandés (répertoriés ci-dessus) sont incluses. Vous devez utiliser la fonctionnalité Build/Run fournie par votre IDE pour faire avancer les choses. Lorsque vous testez ou construisez de nouveaux composants, il est fortement encouragé d'utiliser osu! (Tests) projet/configuration. Plus d’informations à ce sujet sont fournies ci-dessous.

Pour créer pour les plates-formes mobiles, vous devrez probablement exécuter sudo dotnet workload restore si vous ne l'avez pas déjà fait. Cela installera les outils Android/iOS requis pour terminer la construction.

Depuis la CLI

Vous pouvez également créer et exécuter osu ! depuis la ligne de commande avec une seule commande :

dotnet run --project osu.Desktop

Lors de l'exécution locale pour effectuer tout type de test de performances, assurez-vous d'ajouter -c Release à la commande build, car la surcharge liée à l'exécution avec la configuration Debug par défaut peut être importante (en particulier lors de tests avec des modifications de framework local comme ci-dessous).

Si la construction échoue, essayez de restaurer les packages NuGet avec dotnet restore .

Tests avec des modifications de ressources/framework

Parfois, il peut être nécessaire de tester les modifications apportées aux ressources osu ou au framework osu. Cela peut être rapidement réalisé à l'aide des commandes incluses :

Fenêtres :

 UseLocalFramework.ps1
UseLocalResources.ps1

macOS/Linux :

 UseLocalFramework.sh
UseLocalResources.sh

Notez que ces commandes supposent que vous avez extrait le(s) projet(s) concerné(s) dans les répertoires adjacents :

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

Analyse des codes

Avant de valider votre code, veuillez exécuter un formateur de code. Ceci peut être réalisé en exécutant dotnet format dans la ligne de commande ou en utilisant la commande Format code dans votre IDE.

Nous avons adopté des analyseurs multiplateformes intégrés au compilateur. Ils peuvent fournir des avertissements lorsque vous éditez, construisez dans l'IDE ou à partir d'une ligne de commande, comme s'ils étaient fournis par le compilateur lui-même.

JetBrains ReSharper InspectCode est également utilisé pour des ensembles de règles plus larges. Vous pouvez l'exécuter depuis PowerShell avec .InspectCode.ps1 . Vous pouvez également installer ReSharper ou utiliser Rider pour obtenir une assistance en ligne dans l'EDI de votre choix.

Contribuer

Lorsqu'il s'agit de contribuer au projet, les deux principales choses que vous pouvez faire pour aider sont de signaler les problèmes et de soumettre des demandes d'extraction. Veuillez vous référer aux directives de contribution pour comprendre comment aider de la manière la plus efficace possible.

Si vous souhaitez contribuer aux efforts de localisation, rendez-vous sur crowdin.

Nous aimons récompenser les contributions de qualité. Si vous avez apporté une contribution importante ou si vous êtes un contributeur régulier, vous pouvez soumettre une dépense via opencollective. Si vous avez des questions, n'hésitez pas à contacter Peppy avant de le faire.

Licence

osu! Le code et le framework de sont sous licence MIT. Veuillez consulter le fichier de licence pour plus d'informations. tl;dr, vous pouvez faire ce que vous voulez à condition d'inclure l'avis original de droit d'auteur et de licence dans toute copie du logiciel/de la source.

Veuillez noter que cela ne couvre pas l'utilisation du "osu!" ou la marque « ppy » dans tout logiciel, ressource, publicité ou promotion, car elle est protégée par le droit des marques.

Veuillez également noter que les ressources du jeu sont couvertes par une licence distincte. Veuillez consulter le référentiel ppy/osu-resources pour des éclaircissements.