osu

오스!

무료로 승리할 수 있는 리듬 게임입니다. 리듬은 클릭 한 번으로 가능합니다!

이것이 osu의 미래이자 마지막 반복입니다! 오픈 시대의 시작을 알리는 게임 클라이언트! 현재 릴리스 코드명 " lazer "로 알려져 있으며 릴리스되었습니다. 최첨단보다 더 날카롭습니다.

상태

이 프로젝트는 지속적으로 개발 중이지만 안정적인 상태를 유지하기 위해 최선을 다하고 있습니다. 플레이어는 안정적인 osu! 와 함께 릴리스에서 설치하는 것이 좋습니다. 고객. 이 프로젝트는 대부분의 사용자가 이전 "osu!stable" 릴리스보다 선호하는 지점에 도달할 때까지 계속 발전할 것입니다.

프로젝트에 참여하고 이해하기 위한 출발점으로 몇 가지 리소스를 사용할 수 있습니다.

• 자세한 릴리스 변경 로그는 공식 osu에서 확인할 수 있습니다! 대지.
• 프로젝트 관리에 대한 당사의 접근 방식에 대해 자세히 알아볼 수 있습니다.
• 게임 개선을 위한 현재 노력을 추적하세요.

달리는 오스!

게임을 한번 체험해 보고 싶다면 플랫폼에 맞는 최신 릴리스를 다운로드하세요.

최신 릴리스:

윈도우 10 이상(x64)	macOS 12+(인텔, 애플 실리콘)	리눅스(x64)	iOS 13.4+	안드로이드 5+

일반적으로 osu!에서 현재 장치에 대한 버전을 다운로드할 수도 있습니다. 대지.

플랫폼이 지원되지 않거나 위에 나열되지 않은 경우에도 아래 지침에 따라 릴리스를 실행하거나 수동으로 빌드할 수 있는 기회가 있습니다.

iOS/iPadOS 사용자의 경우 : iOS testflight 링크는 매우 빠르게 채워집니다(Apple의 사용자 제한은 10,000명입니다). 가끔 재설정합니다. 이에 대해 묻지 마십시오. 정기적으로 링크 재설정을 확인하거나 트위터에서 Peppy를 팔로우하여 공지사항을 확인하세요. 우리의 목표는 2024년 초에 모바일 앱 스토어에 게임을 출시하는 것입니다.

사용자 정의 규칙 세트 개발

오스! "규칙 세트"라고 하는 사용자가 만든 게임플레이 변형을 허용하도록 설계되었습니다. 이들 중 하나를 구축하면 개발자는 osu!의 강력한 기능을 활용할 수 있습니다. 새로운 스타일의 게임플레이를 위한 비트맵 라이브러리, 게임 엔진, 일반 UX. 규칙 세트 작업을 시작하려면 여기에서 몇 가지 템플릿을 사용할 수 있습니다.

사용자 정의 규칙 세트 디렉토리를 방문하면 사용자 정의 규칙 세트의 몇 가지 예를 볼 수 있습니다.

osu를 개발 중!

전제 조건

다음 전제조건이 충족되었는지 확인하십시오.

• .NET 8.0 SDK가 설치된 데스크톱 플랫폼.

코드베이스 작업 시 최신 버전의 Visual Studio, JetBrains Rider 또는 EditorConfig 및 C# Dev Kit 플러그인이 설치된 Visual Studio Code와 같이 지능형 코드 완성 및 구문 강조 기능이 있는 IDE를 사용하는 것이 좋습니다.

소스 코드 다운로드

저장소를 복제합니다.

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

소스 코드를 최신 커밋으로 업데이트하려면 osu 디렉터리 내에서 다음 명령을 실행하세요.

git pull

건물

IDE에서

기본 .sln 이 아닌 플랫폼별 .slnf 파일 중 하나를 통해 솔루션을 로드해야 합니다. 이렇게 하면 종속성이 줄어들고 관심 없는 플랫폼이 숨겨집니다. 유효한 .slnf 파일은 다음과 같습니다.

• osu.Desktop.slnf (가장 일반적)
• osu.Android.slnf
• osu.iOS.slnf

위에 나열된 권장 IDE에 대한 실행 구성이 포함되어 있습니다. 작업을 진행하려면 IDE에 제공된 빌드/실행 기능을 사용해야 합니다. 새로운 구성요소를 테스트하거나 구축할 때 osu! (Tests) 프로젝트/구성. 이에 대한 자세한 정보는 아래에 제공됩니다.

모바일 플랫폼용으로 빌드하려면 이전에 실행하지 않은 경우 sudo dotnet workload restore 실행해야 할 가능성이 높습니다. 빌드를 완료하는 데 필요한 Android/iOS 도구가 설치됩니다.

CLI에서

osu!를 빌드하고 실행할 수도 있습니다! 단일 명령을 사용하여 명령줄에서:

dotnet run --project osu.Desktop

모든 종류의 성능 테스트를 수행하기 위해 로컬로 실행하는 경우 기본 Debug 구성으로 실행하는 오버헤드가 클 수 있으므로 빌드 명령에 -c Release 추가해야 합니다(특히 아래와 같이 로컬 프레임워크 수정으로 테스트하는 경우).

빌드가 실패하면 dotnet restore 사용하여 NuGet 패키지를 복원해 보세요.

리소스/프레임워크 수정을 통한 테스트

때로는 osu-resources 또는 osu-framework의 변경 사항을 교차 테스트해야 할 수도 있습니다. 이는 포함된 명령을 사용하여 신속하게 수행할 수 있습니다.

윈도우:

 UseLocalFramework.ps1
UseLocalResources.ps1

macOS/리눅스:

 UseLocalFramework.sh
UseLocalResources.sh

이 명령은 인접한 디렉터리에 관련 프로젝트가 체크아웃되어 있다고 가정합니다.

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

코드 분석

코드를 커밋하기 전에 코드 포맷터를 실행하세요. 이는 명령줄에서 dotnet format 실행하거나 IDE에서 Format code 명령을 사용하여 수행할 수 있습니다.

우리는 일부 크로스 플랫폼 컴파일러 통합 분석기를 채택했습니다. IDE 내부 또는 명령줄에서 편집하거나 빌드할 때 마치 컴파일러 자체에서 제공하는 것처럼 경고를 제공할 수 있습니다.

JetBrains ReSharper InspectCode는 더 광범위한 규칙 세트에도 사용됩니다. . .InspectCode.ps1 사용하여 PowerShell에서 실행할 수 있습니다. 또는 ReSharper를 설치하거나 Rider를 사용하여 선택한 IDE에서 인라인 지원을 받을 수 있습니다.

기여

프로젝트에 기여할 때 도움을 주기 위해 할 수 있는 두 가지 주요 일은 문제 보고와 풀 요청 제출입니다. 가능한 가장 효과적인 방법으로 도움을 주는 방법을 이해하려면 기여 지침을 참조하세요.

현지화 노력에 도움을 주고 싶다면 Crowdin으로 가세요.

우리는 양질의 기여에 대해 보상하는 것을 좋아합니다. 고액 기부자이거나 정기 기부자라면 opencollective를 통해 비용을 제출해 주시기 바랍니다. 질문이 있으시면, 시작하기 전에 Peppy에 먼저 문의해 주세요.

특허

오스! 의 코드와 프레임워크는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이센스 파일을 참조하십시오. 간단히 말해, 소프트웨어/소스 사본에 원본 저작권 및 라이센스 고지를 포함하는 한 원하는 것은 무엇이든 할 수 있습니다.

"osu!"의 사용법은 여기에 포함되지 않습니다 . 또는 소프트웨어, 리소스, 광고 또는 프로모션에 "ppy" 브랜드를 사용하는 행위는 상표법에 의해 보호됩니다.

게임 리소스에는 별도의 라이선스가 적용된다는 점도 참고하세요. 자세한 내용은 ppy/osu-resources 저장소를 참조하세요.