osu

osu!

Un juego de ritmo libre para ganar. ¡El ritmo está a solo un clic de distancia!

¡Esta es la versión futura (y final) del osu! ¡Cliente de juego que marca el comienzo de una era abierta! Actualmente conocido y publicado con el nombre clave de lanzamiento " lazer ". Como en más nítido que vanguardista.

Estado

Este proyecto está en constante desarrollo, pero hacemos todo lo posible para mantener las cosas en un estado estable. ¡Se anima a los jugadores a instalar desde una versión junto con su osu estable! cliente. Este proyecto continuará evolucionando hasta que finalmente lleguemos al punto en que la mayoría de los usuarios lo prefieran a la versión anterior "osu!stable".

Hay algunos recursos disponibles como puntos de partida para involucrarse y comprender el proyecto:

• ¡Los registros de cambios de lanzamiento detallados están disponibles en el osu oficial! sitio.
• Puede obtener más información sobre nuestro enfoque de gestión de proyectos.
• Realice un seguimiento de nuestros esfuerzos actuales para mejorar el juego.

¡Corriendo osu!

Si solo estás buscando darle una oportunidad al juego, puedes obtener la última versión para tu plataforma:

Última versión:

Ventanas 10+ (x64)	macOS 12+ (Intel, Apple Silicon)	Linux (x64)	iOS 13.4+	Androide 5+

¡Generalmente también puedes descargar una versión para tu dispositivo actual desde osu! sitio.

Si su plataforma no es compatible o no figura en la lista anterior, todavía existe la posibilidad de ejecutar la versión o compilarla manualmente siguiendo las instrucciones a continuación.

Para usuarios de iOS/iPadOS : el enlace de prueba de iOS se llena muy rápido (Apple tiene un límite estricto de 10.000 usuarios). Lo reiniciamos de vez en cuando. Por favor no preguntes sobre esto. Vuelve a consultar periódicamente para ver si se restablecen los enlaces o sigue a Peppy en Twitter para ver los anuncios. Nuestro objetivo es llevar el juego a las tiendas de aplicaciones móviles a principios de 2024.

Desarrollar un conjunto de reglas personalizado

osu! está diseñado para permitir variaciones de juego creadas por el usuario, llamadas "conjuntos de reglas". ¡Construir uno de estos permite al desarrollador aprovechar el poder del osu! Biblioteca de mapas de ritmos, motor de juego y UX general para un nuevo estilo de juego. Para comenzar a trabajar en un conjunto de reglas, tenemos algunas plantillas disponibles aquí.

Puede ver algunos ejemplos de conjuntos de reglas personalizados visitando el directorio de conjuntos de reglas personalizados.

Desarrollando osu!

Requisitos previos

Asegúrese de tener los siguientes requisitos previos:

• Una plataforma de escritorio con el SDK .NET 8.0 instalado.

Al trabajar con el código base, recomendamos utilizar un IDE con finalización de código inteligente y resaltado de sintaxis, como la última versión de Visual Studio, JetBrains Rider o Visual Studio Code con el complemento EditorConfig y C# Dev Kit instalado.

Descargando el código fuente

Clonar el repositorio:

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

Para actualizar el código fuente a la última confirmación, ejecute el siguiente comando dentro del directorio osu :

git pull

Edificio

Desde un IDE

Debe cargar la solución a través de uno de los archivos .slnf específicos de la plataforma, en lugar del .sln principal. Esto reducirá las dependencias y ocultará las plataformas que no le interesan. Los archivos .slnf válidos son:

• osu.Desktop.slnf (el más común)
• osu.Android.slnf
• osu.iOS.slnf

Se incluyen configuraciones de ejecución para los IDE recomendados (enumerados anteriormente). Debe utilizar la funcionalidad Construir/Ejecutar proporcionada por su IDE para que todo funcione. Al probar o crear nuevos componentes, se recomienda encarecidamente utilizar osu! (Tests) proyecto/configuración. Más información sobre esto se proporciona a continuación.

Para compilar para plataformas móviles, es probable que necesites ejecutar sudo dotnet workload restore si no lo has hecho anteriormente. Esto instalará las herramientas de Android/iOS necesarias para completar la compilación.

Desde CLI

¡También puedes construir y ejecutar osu! desde la línea de comandos con un solo comando:

dotnet run --project osu.Desktop

Cuando ejecute localmente para realizar cualquier tipo de prueba de rendimiento, asegúrese de agregar -c Release al comando de compilación, ya que la sobrecarga de ejecutar con la configuración Debug predeterminada puede ser grande (especialmente cuando se prueba con modificaciones del marco local como se muestra a continuación).

Si la compilación falla, intente restaurar los paquetes NuGet con dotnet restore .

Pruebas con modificaciones de recursos/marco

A veces puede ser necesario realizar pruebas cruzadas de cambios en osu-resources o osu-framework. Esto se puede lograr rápidamente usando los comandos incluidos:

Ventanas:

 UseLocalFramework.ps1
UseLocalResources.ps1

MacOS/Linux:

 UseLocalFramework.sh
UseLocalResources.sh

Tenga en cuenta que estos comandos suponen que tiene los proyectos relevantes desprotegidos en directorios adyacentes:

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

Análisis de código

Antes de enviar su código, ejecute un formateador de código. Esto se puede lograr ejecutando dotnet format en la línea de comando o usando el comando Format code en su IDE.

Hemos adoptado algunos analizadores integrados de compilador multiplataforma. Pueden proporcionar advertencias cuando está editando, compilando dentro del IDE o desde la línea de comandos, como si las proporcionara el propio compilador.

JetBrains ReSharper InspectCode también se utiliza para conjuntos de reglas más amplios. Puede ejecutarlo desde PowerShell con .InspectCode.ps1 . Alternativamente, puede instalar ReSharper o usar Rider para obtener soporte en línea en el IDE de su elección.

Contribuyendo

Cuando se trata de contribuir al proyecto, las dos cosas principales que puedes hacer para ayudar son informar problemas y enviar solicitudes de extracción. Consulte las pautas de contribución para comprender cómo ayudar de la manera más efectiva posible.

Si desea ayudar con los esfuerzos de localización, diríjase a crowdin.

Nos encanta recompensar las contribuciones de calidad. Si ha realizado una contribución importante o es un colaborador habitual, puede enviar un gasto a través de opencollective. Si tiene alguna pregunta, no dude en comunicarse con peppy antes de hacerlo.

Licencia

osu! El código y el marco de trabajo tienen la licencia MIT. Consulte el archivo de licencia para obtener más información. tl;dr puede hacer lo que quiera siempre que incluya el aviso de licencia y derechos de autor originales en cualquier copia del software/fuente.

Tenga en cuenta que esto no cubre el uso de "osu!" o marca "ppy" en cualquier software, recurso, publicidad o promoción, ya que está protegida por la ley de marcas.

Tenga en cuenta también que los recursos del juego están cubiertos por una licencia independiente. Consulte el repositorio ppy/osu-resources para obtener aclaraciones.