osu

osu!

Permainan ritme yang gratis untuk dimenangkan. Irama hanya dengan sekali klik !

Ini adalah iterasi masa depan – dan final – dari osu! klien game yang menandai awal era terbuka! Saat ini dikenal dan dirilis dengan nama kode rilis " lazer ". Seperti lebih tajam dari yang mutakhir.

Status

Proyek ini terus dikembangkan, namun kami melakukan yang terbaik untuk menjaga keadaan tetap stabil. Pemain didorong untuk menginstal dari rilis bersama osu! klien. Proyek ini akan terus berkembang hingga kami mencapai titik di mana sebagian besar pengguna lebih menyukainya dibandingkan rilis "osu!stable" sebelumnya.

Beberapa sumber daya tersedia sebagai titik awal untuk terlibat dan memahami proyek:

• Log perubahan rilis terperinci tersedia di situs resmi osu! lokasi.
• Anda dapat mempelajari lebih lanjut tentang pendekatan kami terhadap manajemen proyek.
• Lacak upaya kami saat ini untuk meningkatkan permainan.

Menjalankan osu!

Jika Anda hanya ingin mencoba game ini, Anda dapat mengambil rilis terbaru untuk platform Anda:

Rilis terbaru:

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

Biasanya Anda juga dapat mengunduh versi untuk perangkat Anda saat ini dari osu! lokasi.

Jika platform Anda tidak didukung atau tidak tercantum di atas, masih ada kemungkinan Anda dapat menjalankan rilis atau membuatnya secara manual dengan mengikuti petunjuk di bawah.

Untuk pengguna iOS/iPadOS : Tautan testflight iOS terisi dengan sangat cepat (Apple memiliki batas maksimum 10.000 pengguna). Kami mengatur ulangnya sesekali. Tolong jangan bertanya tentang ini. Periksa kembali secara teratur untuk penyetelan ulang tautan atau ikuti peppy di twitter untuk pengumuman. Tujuan kami adalah meluncurkan game ini di toko aplikasi seluler pada awal tahun 2024.

Mengembangkan seperangkat aturan khusus

osu! dirancang untuk memungkinkan variasi gameplay yang dibuat pengguna, yang disebut "aturan". Membangun salah satu dari ini memungkinkan pengembang untuk memanfaatkan kekuatan osu! perpustakaan beatmap, mesin game, dan UX umum untuk gaya gameplay baru. Untuk mulai mengerjakan kumpulan aturan, kami memiliki beberapa templat yang tersedia di sini.

Anda dapat melihat beberapa contoh kumpulan aturan khusus dengan mengunjungi direktori kumpulan aturan khusus.

Mengembangkan osu!

Prasyarat

Harap pastikan Anda memiliki prasyarat berikut:

• Platform desktop dengan .NET 8.0 SDK terinstal.

Saat bekerja dengan basis kode, sebaiknya gunakan IDE dengan penyelesaian kode cerdas dan penyorotan sintaksis, seperti versi terbaru Visual Studio, JetBrains Rider, atau Visual Studio Code dengan EditorConfig dan plugin C# Dev Kit terinstal.

Mengunduh kode sumber

Kloning repositori:

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

Untuk memperbarui kode sumber ke komit terbaru, jalankan perintah berikut di dalam direktori osu :

git pull

Bangunan

Dari IDE

Anda harus memuat solusi melalui salah satu file .slnf khusus platform, bukan .sln utama. Ini akan mengurangi ketergantungan dan menyembunyikan platform yang tidak Anda pedulikan. File .slnf yang valid adalah:

• osu.Desktop.slnf (paling umum)
• osu.Android.slnf
• osu.iOS.slnf

Konfigurasi jalankan untuk IDE yang direkomendasikan (tercantum di atas) disertakan. Anda harus menggunakan fungsionalitas Build/Run yang disediakan pada IDE Anda untuk menjalankannya. Saat menguji atau membuat komponen baru, sangat disarankan Anda menggunakan osu! (Tests) proyek/konfigurasi. Informasi lebih lanjut mengenai hal ini disediakan di bawah.

Untuk membangun platform seluler, Anda mungkin perlu menjalankan sudo dotnet workload restore jika Anda belum pernah melakukannya sebelumnya. Ini akan menginstal peralatan Android/iOS yang diperlukan untuk menyelesaikan pembangunan.

Dari CLI

Anda juga dapat membangun dan menjalankan osu! dari baris perintah dengan satu perintah:

dotnet run --project osu.Desktop

Saat menjalankan secara lokal untuk melakukan pengujian kinerja apa pun, pastikan untuk menambahkan -c Release ke perintah build, karena overhead menjalankan dengan konfigurasi Debug default bisa besar (terutama saat menguji dengan modifikasi kerangka kerja lokal seperti di bawah).

Jika build gagal, coba pulihkan paket NuGet dengan dotnet restore .

Pengujian dengan modifikasi sumber daya/kerangka kerja

Terkadang diperlukan pengujian silang terhadap perubahan pada osu-resources atau osu-framework. Ini dapat dicapai dengan cepat menggunakan perintah yang disertakan:

jendela:

 UseLocalFramework.ps1
UseLocalResources.ps1

macOS/Linux:

 UseLocalFramework.sh
UseLocalResources.sh

Perhatikan bahwa perintah ini mengasumsikan Anda telah memeriksa proyek yang relevan di direktori yang berdekatan:

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

Analisis kode

Sebelum melakukan kode Anda, jalankan pemformat kode. Hal ini dapat dicapai dengan menjalankan dotnet format di baris perintah, atau menggunakan perintah Format code di IDE Anda.

Kami telah mengadopsi beberapa penganalisis terintegrasi kompiler lintas platform. Mereka dapat memberikan peringatan ketika Anda mengedit, membangun di dalam IDE atau dari baris perintah, seolah-olah disediakan oleh kompiler itu sendiri.

JetBrains ReSharper InspectCode juga digunakan untuk kumpulan aturan yang lebih luas. Anda dapat menjalankannya dari PowerShell dengan .InspectCode.ps1 . Alternatifnya, Anda dapat menginstal ReSharper atau menggunakan Rider untuk mendapatkan dukungan inline di IDE pilihan Anda.

Berkontribusi

Ketika berkontribusi pada proyek, dua hal utama yang dapat Anda lakukan untuk membantu adalah melaporkan masalah dan mengirimkan permintaan penarikan. Silakan lihat pedoman berkontribusi untuk memahami cara membantu seefektif mungkin.

Jika Anda ingin membantu upaya pelokalan, kunjungi crowdin.

Kami senang memberi penghargaan atas kontribusi yang berkualitas. Jika Anda telah memberikan kontribusi yang besar, atau merupakan kontributor tetap, Anda dipersilakan untuk mengirimkan pengeluaran melalui opencollective. Jika Anda memiliki pertanyaan, jangan ragu untuk menghubungi Peppy sebelum melakukannya.

Lisensi

osu! Kode dan kerangka kerja dilisensikan di bawah lisensi MIT. Silakan lihat file lisensi untuk informasi lebih lanjut. tl;dr Anda dapat melakukan apa pun yang Anda inginkan selama Anda menyertakan pemberitahuan hak cipta dan lisensi asli dalam salinan perangkat lunak/sumber apa pun.

Harap dicatat bahwa ini tidak mencakup penggunaan perintah "osu!" atau pencitraan merek "ppy" dalam perangkat lunak, sumber daya, iklan, atau promosi apa pun, karena hal ini dilindungi oleh undang-undang merek dagang.

Harap perhatikan juga bahwa sumber daya game dilindungi oleh lisensi terpisah. Silakan lihat repositori ppy/osu-resources untuk klarifikasi.