หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>ซอร์สโค้ดอื่น ๆ
ดาวน์โหลด

โอสึ! โลโก้

โอสึ!

สถานะการสร้าง

เกมจังหวะที่ชนะฟรี จังหวะเพียงไม่กี่ คลิก !

นี่คืออนาคต – และครั้งสุดท้าย – การทำซ้ำของ osu! ไคลเอนต์เกมที่เป็นจุดเริ่มต้นของยุคเปิด! ปัจจุบันเป็นที่รู้จักและวางจำหน่ายภายใต้ชื่อรหัสการเปิดตัว " lazer " คมชัดยิ่งกว่าล้ำสมัย

สถานะ

โครงการนี้อยู่ระหว่างการพัฒนาอย่างต่อเนื่อง แต่เราพยายามอย่างดีที่สุดเพื่อรักษาสิ่งต่าง ๆ ให้อยู่ในสถานะที่มั่นคง ผู้เล่นควรติดตั้งจากรุ่นวางจำหน่ายควบคู่ไปกับ osu ที่เสถียร! ลูกค้า. โปรเจ็กต์นี้จะมีการพัฒนาต่อไปจนกว่าเราจะไปถึงจุดที่ผู้ใช้ส่วนใหญ่ชอบมันมากกว่ารีลีส "osu!stable" รุ่นก่อนหน้าในที่สุด

มีแหล่งข้อมูลบางส่วนเป็นจุดเริ่มต้นในการมีส่วนร่วมและทำความเข้าใจโครงการ:

  • บันทึกการเปลี่ยนแปลงโดยละเอียดมีอยู่ใน osu อย่างเป็นทางการ! เว็บไซต์.
  • คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับแนวทางการจัดการโครงการของเรา
  • ติดตามความพยายามในปัจจุบันของเราในการปรับปรุงเกม

วิ่งสิ!

หากคุณกำลังมองหาที่จะเล่นเกม คุณสามารถดาวน์โหลดเวอร์ชันล่าสุดสำหรับแพลตฟอร์มของคุณได้:

รุ่นล่าสุด:

วินโดวส์ 10+ (x64) macOS 12+ (อินเทล, แอปเปิล ซิลิคอน) ลินุกซ์ (x64) ไอโอเอส 13.4+ แอนดรอยด์ 5+

โดยทั่วไปคุณยังสามารถดาวน์โหลดเวอร์ชันสำหรับอุปกรณ์ปัจจุบันของคุณได้จาก osu! เว็บไซต์.

หากแพลตฟอร์มของคุณไม่รองรับหรือไม่ได้อยู่ในรายการข้างต้น ยังมีโอกาสที่คุณจะเรียกใช้รุ่นหรือสร้างด้วยตนเองได้โดยทำตามคำแนะนำด้านล่าง

สำหรับผู้ใช้ iOS/iPadOS : ลิงก์ทดสอบเที่ยวบินของ iOS เต็มเร็วมาก (Apple จำกัดจำนวนผู้ใช้ไว้ที่ 10,000 คน) เรารีเซ็ตเป็นครั้งคราว กรุณาอย่าถามเกี่ยวกับเรื่องนี้. กลับมาตรวจสอบการรีเซ็ตลิงก์เป็นประจำหรือติดตามประกาศอย่างรวดเร็วบน Twitter เป้าหมายของเราคือการวางจำหน่ายเกมบน App Store บนมือถือในต้นปี 2024

การพัฒนาชุดกฎที่กำหนดเอง

โอสึ! ได้รับการออกแบบมาเพื่ออนุญาตรูปแบบการเล่นเกมที่ผู้ใช้สร้างขึ้นเรียกว่า "ชุดกฎ" การสร้างหนึ่งในนั้นทำให้นักพัฒนาสามารถควบคุมพลังของ osu ได้! ไลบรารีบีทแมป เอ็นจิ้นเกม และ UX ทั่วไปสำหรับการเล่นเกมรูปแบบใหม่ เพื่อเริ่มต้นทำงานกับชุดกฎ เรามีเทมเพลตบางส่วนอยู่ที่นี่

คุณสามารถดูตัวอย่างชุดกฎที่กำหนดเองได้โดยไปที่ไดเรกทอรีชุดกฎที่กำหนดเอง

พัฒนาโอสุ!

ข้อกำหนดเบื้องต้น

โปรดตรวจสอบให้แน่ใจว่าคุณมีข้อกำหนดเบื้องต้นดังต่อไปนี้:

  • แพลตฟอร์มเดสก์ท็อปที่ติดตั้ง .NET 8.0 SDK

เมื่อทำงานกับโค้ดเบส เราขอแนะนำให้ใช้ IDE ที่มีการเติมโค้ดอัจฉริยะและการเน้นไวยากรณ์ เช่น Visual Studio, JetBrains Rider เวอร์ชันล่าสุด หรือโค้ด Visual Studio พร้อมติดตั้งปลั๊กอิน 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 ที่แนะนำ (ตามรายการด้านบน) ไว้ด้วย คุณควรใช้ฟังก์ชัน Build/Run ที่ให้มาของ IDE ของคุณเพื่อให้สิ่งต่างๆ ดำเนินต่อไป เมื่อทำการทดสอบหรือสร้างส่วนประกอบใหม่ ขอแนะนำเป็นอย่างยิ่งให้คุณใช้ osu! (Tests) โครงการ/การกำหนดค่า ข้อมูลเพิ่มเติมเกี่ยวกับสิ่งนี้มีให้ด้านล่าง

หากต้องการสร้างสำหรับแพลตฟอร์มมือถือ คุณจะต้องเรียกใช้ sudo dotnet workload restore หากยังไม่เคยดำเนินการมาก่อน สิ่งนี้จะติดตั้งเครื่องมือ Android/iOS ที่จำเป็นสำหรับการสร้างให้เสร็จสมบูรณ์

จาก CLI

คุณยังสามารถสร้างและรัน osu! จากบรรทัดคำสั่งด้วยคำสั่งเดียว: 

dotnet run --project osu.Desktop

เมื่อรันภายในเครื่องเพื่อทำการทดสอบประสิทธิภาพใดๆ ตรวจสอบให้แน่ใจว่าได้เพิ่ม -c Release ให้กับคำสั่ง build เนื่องจากค่าใช้จ่ายในการรันด้วยการกำหนด Debug เริ่มต้นอาจมีขนาดใหญ่ (โดยเฉพาะเมื่อทดสอบด้วยการแก้ไขเฟรมเวิร์กภายในเครื่องตามด้านล่าง)

หากบิลด์ล้มเหลว ให้ลองกู้คืนแพ็คเกจ NuGet ด้วย dotnet restore

การทดสอบด้วยการแก้ไขทรัพยากร/เฟรมเวิร์ก

บางครั้งอาจจำเป็นต้องทดสอบข้ามการเปลี่ยนแปลงในทรัพยากร osu หรือกรอบงาน osu สามารถทำได้อย่างรวดเร็วโดยใช้คำสั่งที่ให้มา:

หน้าต่าง: 

 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 ได้ หากคุณมีคำถามใดๆ โปรดติดต่อ Peppy ก่อนดำเนินการดังกล่าว

ใบอนุญาต

โอสึ! รหัสและกรอบงานของได้รับอนุญาตภายใต้ใบอนุญาตของ MIT โปรดดูไฟล์ใบอนุญาตสำหรับข้อมูลเพิ่มเติม tl;dr คุณสามารถทำทุกอย่างที่คุณต้องการได้ตราบใดที่คุณรวมประกาศเกี่ยวกับลิขสิทธิ์และใบอนุญาตดั้งเดิมไว้ในสำเนาของซอฟต์แวร์/แหล่งที่มา

โปรดทราบว่าการดำเนินการนี้ ไม่ครอบคลุมถึง การใช้คำว่า "osu!" หรือการสร้างแบรนด์ "ppy" ในซอฟต์แวร์ ทรัพยากร การโฆษณา หรือการส่งเสริมการขาย เนื่องจากได้รับการคุ้มครองตามกฎหมายเครื่องหมายการค้า

โปรดทราบว่าทรัพยากรเกมได้รับการคุ้มครองโดยใบอนุญาตแยกต่างหาก โปรดดูที่เก็บข้อมูล ppy/osu-resources เพื่อการชี้แจง

ขยาย
ข้อมูลเพิ่มเติม
แอปที่เกี่ยวข้อง
แนะนำสำหรับคุณ
ข้อมูลที่เกี่ยวข้อง ทั้งหมด