osu

осу!

Бесплатная ритм-игра. Ритм на расстоянии одного клика !

Это будущая и последняя версия osu! игровой клиент, знаменующий начало открытой эры! В настоящее время известен и выпущен под кодовым названием « lazer ». То есть острее, чем ультрасовременный.

Статус

Этот проект находится в постоянной разработке, но мы делаем все возможное, чтобы поддерживать его в стабильном состоянии. Игрокам рекомендуется установить версию из релиза вместе со своей стабильной версией osu! клиент. Этот проект будет продолжать развиваться до тех пор, пока мы в конечном итоге не достигнем точки, когда большинство пользователей предпочтут его предыдущей «osu!stable» версии.

Несколько ресурсов доступны в качестве отправной точки для участия и понимания проекта:

• Подробные журналы изменений выпуска доступны на официальном сайте osu! сайт.
• Вы можете узнать больше о нашем подходе к управлению проектами.
• Отслеживайте наши текущие усилия по улучшению игры.

Бегу осу!

Если вы просто хотите оживить игру, вы можете скачать последнюю версию для своей платформы:

Последний выпуск:

Windows 10+ (x64)	macOS 12+ (Intel, Apple Silicon)	Линукс (х64)	iOS 13.4+	Андроид 5+

Вы также можете загрузить версию для вашего текущего устройства с сайта osu! сайт.

Если ваша платформа не поддерживается или не указана выше, у вас все равно есть шанс запустить выпуск или собрать его вручную, следуя инструкциям ниже.

Для пользователей iOS/iPadOS : ссылка на тестовый полет iOS заполняется очень быстро (у Apple есть жесткий лимит в 10 000 пользователей). Мы периодически его сбрасываем. Пожалуйста, не спрашивайте об этом. Регулярно проверяйте обновления ссылок или следите за объявлениями в Твиттере Peppy. Наша цель — разместить игру в магазинах мобильных приложений в начале 2024 года.

Разработка индивидуального набора правил

осу! разработан, чтобы позволить пользователям создавать варианты игрового процесса, называемые «наборами правил». Создание одного из них позволяет разработчику использовать возможности osu! библиотека бит-карт, игровой движок и общий UX для нового стиля игрового процесса. Чтобы начать работу над набором правил, у нас есть несколько шаблонов, доступных здесь.

Вы можете увидеть некоторые примеры пользовательских наборов правил, посетив каталог пользовательских наборов правил.

Развиваем осу!

Предварительные условия

Пожалуйста, убедитесь, что у вас есть следующие предпосылки:

• Платформа настольных компьютеров с установленным пакетом SDK для .NET 8.0.

При работе с базой кода мы рекомендуем использовать интегрированную среду разработки с интеллектуальным завершением кода и подсветкой синтаксиса, например последнюю версию Visual Studio, JetBrains Rider или Visual Studio Code с установленным плагином EditorConfig и C# Dev Kit.

Загрузка исходного кода

Клонируем репозиторий:

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, необходимые для завершения сборки.

Из интерфейса командной строки

Вы также можете собрать и запустить osu! из командной строки с помощью одной команды:

dotnet run --project osu.Desktop

При локальном запуске для любого типа тестирования производительности обязательно добавьте -c Release к команде сборки, так как накладные расходы при запуске с конфигурацией Debug по умолчанию могут быть большими (особенно при тестировании с локальными модификациями инфраструктуры, как показано ниже).

Если сборка не удалась, попробуйте восстановить пакеты NuGet с помощью dotnet restore .

Тестирование с модификациями ресурсов/фреймворка

Иногда может потребоваться перекрестное тестирование изменений в osu-ресурсах или osu-framework. Этого можно быстро добиться с помощью включенных команд:

Окна:

 UseLocalFramework.ps1
UseLocalResources.ps1

macOS/Линукс:

 UseLocalFramework.sh
UseLocalResources.sh

Обратите внимание, что эти команды предполагают, что соответствующие проекты извлечены из соседних каталогов:

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

Анализ кода

Прежде чем зафиксировать код, запустите форматировщик кода. Этого можно добиться, запустив dotnet format в командной строке или используя команду Format code в вашей IDE.

Мы внедрили несколько кроссплатформенных анализаторов, интегрированных в компилятор. Они могут выдавать предупреждения при редактировании, сборке внутри IDE или из командной строки, как если бы они были предоставлены самим компилятором.

JetBrains ReSharper InspectCode также используется для более широких наборов правил. Вы можете запустить его из PowerShell с помощью .InspectCode.ps1 . Кроме того, вы можете установить ReSharper или использовать Rider, чтобы получить встроенную поддержку в выбранной вами IDE.

Содействие

Когда дело доходит до участия в проекте, две основные вещи, которые вы можете сделать, — это сообщить о проблемах и отправить запросы на включение. Пожалуйста, ознакомьтесь с рекомендациями по участию, чтобы понять, как помочь наиболее эффективным способом.

Если вы хотите помочь с локализацией, посетите Crowdin.

Мы любим вознаграждать качественный вклад. Если вы сделали крупный пожертвование или являетесь постоянным спонсором, вы можете сообщить о расходах через opencollective. Если у вас есть какие-либо вопросы, не стесняйтесь обратиться к Пеппи, прежде чем делать это.

Лицензия

осу! Код и платформа распространяются по лицензии MIT. Дополнительную информацию см. в файле лицензии. tl;dr, вы можете делать все, что захотите, при условии, что вы включите оригинальное уведомление об авторских правах и лицензии в любую копию программного обеспечения/источника.

Обратите внимание, что это не распространяется на использование "osu!" или брендинг «ppy» в любом программном обеспечении, ресурсах, рекламе или рекламных акциях, поскольку это защищено законом о товарных знаках.

Также обратите внимание, что на игровые ресурсы распространяется отдельная лицензия. Пожалуйста, обратитесь к репозиторию ppy/osu-resources для получения разъяснений.