osu

osu!

Um jogo de ritmo grátis para ganhar. O ritmo está a apenas um clique de distância!

Esta é a iteração futura – e final – do osu! cliente de jogo que marca o início de uma era aberta! Atualmente conhecido e lançado sob o codinome " lazer ". Mais nítido do que de ponta.

Status

Este projeto está em constante desenvolvimento, mas fazemos o possível para mantê-lo estável. Os jogadores são incentivados a instalar a partir de uma versão junto com seu osu estável! cliente. Este projeto continuará a evoluir até chegarmos ao ponto em que a maioria dos usuários o prefere à versão anterior "osu!stable".

Alguns recursos estão disponíveis como pontos de partida para se envolver e compreender o projeto:

• Changelogs detalhados do lançamento estão disponíveis na página oficial do osu! site.
• Você pode aprender mais sobre nossa abordagem ao gerenciamento de projetos.
• Acompanhe nossos esforços atuais para melhorar o jogo.

Correndo osu!

Se você deseja apenas experimentar o jogo, pode obter a versão mais recente para sua plataforma:

Último lançamento:

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

Geralmente, você também pode baixar uma versão para o seu dispositivo atual no site do osu! site.

Se a sua plataforma não for suportada ou não estiver listada acima, ainda há uma chance de você executar a versão ou construí-la manualmente seguindo as instruções abaixo.

Para usuários de iOS/iPadOS : O link de teste do iOS enche muito rápido (a Apple tem um limite rígido de 10.000 usuários). Nós o redefinimos ocasionalmente. Por favor, não pergunte sobre isso. Volte regularmente para redefinições de link ou siga o Peppy no Twitter para anúncios. Nosso objetivo é colocar o jogo nas lojas de aplicativos móveis no início de 2024.

Desenvolvendo um conjunto de regras personalizado

osu! foi projetado para permitir variações de jogo criadas pelo usuário, chamadas de "conjuntos de regras". Construir um deles permite que um desenvolvedor aproveite o poder do osu! biblioteca de beatmap, mecanismo de jogo e UX geral para um novo estilo de jogo. Para começar a trabalhar em um conjunto de regras, temos alguns modelos disponíveis aqui.

Você pode ver alguns exemplos de conjuntos de regras customizados visitando o diretório de conjuntos de regras customizados.

Desenvolvendo osu!

Pré-requisitos

Certifique-se de ter os seguintes pré-requisitos:

• Uma plataforma de desktop com o SDK do .NET 8.0 instalado.

Ao trabalhar com a base de código, recomendamos usar um IDE com preenchimento de código inteligente e realce de sintaxe, como a versão mais recente do Visual Studio, JetBrains Rider ou Visual Studio Code com o EditorConfig e o plug-in C# Dev Kit instalados.

Baixando o código fonte

Clone o repositório:

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

Para atualizar o código-fonte para o commit mais recente, execute o seguinte comando dentro do diretório osu :

git pull

Prédio

De um IDE

Você deve carregar a solução por meio de um dos arquivos .slnf específicos da plataforma, em vez do .sln principal. Isso reduzirá dependências e ocultará plataformas com as quais você não se importa. Os arquivos .slnf válidos são:

• osu.Desktop.slnf (mais comum)
• osu.Android.slnf
• osu.iOS.slnf

As configurações de execução para os IDEs recomendados (listados acima) estão incluídas. Você deve usar a funcionalidade Build/Run fornecida do seu IDE para fazer as coisas funcionarem. Ao testar ou construir novos componentes, é altamente recomendável que você use o osu! (Tests) projeto/configuração. Mais informações sobre isso são fornecidas abaixo.

Para compilar para plataformas móveis, você provavelmente precisará executar sudo dotnet workload restore caso ainda não tenha feito isso. Isso instalará as ferramentas Android/iOS necessárias para concluir a compilação.

Da CLI

Você também pode construir e executar o osu! na linha de comando com um único comando:

dotnet run --project osu.Desktop

Ao executar localmente para fazer qualquer tipo de teste de desempenho, certifique-se de adicionar -c Release ao comando de construção, pois a sobrecarga da execução com a configuração Debug padrão pode ser grande (especialmente ao testar com modificações de estrutura local, conforme abaixo).

Se a compilação falhar, tente restaurar os pacotes NuGet com dotnet restore .

Teste com modificações de recursos/estrutura

Às vezes pode ser necessário fazer testes cruzados de alterações no osu-resources ou no osu-framework. Isso pode ser alcançado rapidamente usando os comandos incluídos:

Windows:

 UseLocalFramework.ps1
UseLocalResources.ps1

macOS/Linux:

 UseLocalFramework.sh
UseLocalResources.sh

Observe que esses comandos pressupõem que você tenha feito check-out dos projetos relevantes em diretórios adjacentes:

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

Análise de código

Antes de enviar seu código, execute um formatador de código. Isso pode ser conseguido executando dotnet format na linha de comando ou usando o comando Format code em seu IDE.

Adotamos alguns analisadores integrados ao compilador e multiplataforma. Eles podem fornecer avisos quando você está editando, construindo dentro do IDE ou na linha de comando, como se fossem fornecidos pelo próprio compilador.

JetBrains ReSharper InspectCode também é usado para conjuntos de regras mais amplos. Você pode executá-lo no PowerShell com .InspectCode.ps1 . Alternativamente, você pode instalar o ReSharper ou usar o Rider para obter suporte embutido no IDE de sua escolha.

Contribuindo

Quando se trata de contribuir para o projeto, as duas principais coisas que você pode fazer para ajudar são relatar problemas e enviar solicitações pull. Consulte as diretrizes de contribuição para entender como ajudar da maneira mais eficaz possível.

Se você deseja ajudar nos esforços de localização, acesse crowdin.

Adoramos recompensar contribuições de qualidade. Se você fez uma grande contribuição ou é um contribuidor regular, você pode enviar uma despesa via opencollective. Se você tiver alguma dúvida, sinta-se à vontade para entrar em contato com Peppy antes de fazê-lo.

Licença

osu! O código e a estrutura do são licenciados sob a licença do MIT. Consulte o arquivo de licença para obter mais informações. dr você pode fazer o que quiser, desde que inclua os direitos autorais originais e o aviso de licença em qualquer cópia do software/fonte.

Observe que isso não cobre o uso da expressão "osu!" ou marca "ppy" em qualquer software, recurso, publicidade ou promoção, pois isso é protegido pela lei de marcas registradas.

Observe também que os recursos do jogo são cobertos por uma licença separada. Por favor, consulte o repositório ppy/osu-resources para esclarecimentos.