kohi

เครื่องมือเกม Kohi

เอ็นจิ้นนี้ทำขึ้นเป็นส่วนหนึ่งของซีรีส์เอ็นจิ้นเกม Kohi บน YouTube (ตอนนี้ถ่ายทอดสดบน Twitch) ซึ่งเราสร้างเครื่องยนต์เกมจากพื้นดินโดยใช้ C และ Vulkan

ชื่อ Kohi (コーヒー, ออกเสียงว่า "Koh-hee") เป็นการทำให้เข้าใจง่ายของคำญี่ปุ่นสำหรับ "กาแฟ" ซึ่งทำให้รู้สึกว่าฉันรักสิ่งของมากแค่ไหน

ซีรี่ส์ YouTube ดั้งเดิมตั้งอยู่ที่นี่: https://www.youtube.com/watch?v=DHPUU-DJOBM&LIST=PLV8DDW9K0JPG1BEO-RS-0MYS423CVLVTJ

สตรีม Twitch เกิดขึ้นที่นี่: https://twitch.tv/travisvroman

ลิงค์สำคัญ

สังคม

• Discord: https://discord.com/invite/ybmh9em

ลิงค์โครงการ

• เว็บไซต์: https://kohiengine.com
• เอกสาร API: https://kohiengine.com/docs/

วางแผน

Kohi เป็นเครื่องยนต์ 3 มิติตั้งแต่เริ่มต้นโดยส่วนใหญ่สร้างขึ้นตั้งแต่เริ่มต้น จะมีคำอธิบายและการสำรวจมากมายระหว่างทาง ซีรีส์เริ่มต้นจากการสอนมากขึ้นเพื่อให้ลุกขึ้นและทำงานพร้อมกับคำอธิบายกลายเป็นระดับที่สูงขึ้นเมื่อสิ่งต่าง ๆ คืบหน้าเพื่อให้การเว้นวรรค ในที่สุดเราก็เปลี่ยนไปใช้การสตรีมสดบน Twitch โดยมีการเข้ารหัสส่วนใหญ่ทำบนสตรีมด้วยงานออฟไลน์บางอย่างที่น่าสนใจน้อยกว่าที่ทำแบบออฟไลน์

การสนับสนุนแพลตฟอร์ม

Windows, Linux และ MacOS ทั้งหมดได้รับการสนับสนุนอย่างเป็นทางการ การสนับสนุน Runtime Android และ iOS อาจถูกเพิ่มลงบนถนน

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

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

ข้อกำหนดเบื้องต้นสำหรับ Windows

• ทำเพื่อ Windows: https://gnuwin32.sourceforge.net/packages/make.htm (ใช่การอัปเดตครั้งล่าสุดคือในปี 2549 แต่ถ้าไม่ยากจนทำไมต้องแก้ไข?)
• ชุมชน Visual Studio (ทำหน้าที่เป็นแบ็กเอนด์สำหรับ Clang), 2019+ ไม่เป็นไร: https://visualstudio.microsoft.com/vs/community/
• git สำหรับ windows: https://gitforwindows.org/

ข้อกำหนดเบื้องต้นสำหรับ Linux

ติดตั้งเหล่านี้ผ่านแพ็คเกจ Manager:

• git
• make
• libx11-dev
• libxkbcommon-x11-dev
• libx11-xcb-dev

ข้อกำหนดเบื้องต้นสำหรับ macOS

ติดตั้งเหล่านี้ผ่าน Homebrew หรือผู้จัดการแพ็คเกจอื่น ๆ :

• git
• make

ข้อกำหนดเบื้องต้นข้ามแพลตฟอร์ม:

คุณจะต้องติดตั้ง Clang 13+ และ Vulkan SDK ที่ติดตั้ง:

• Clang: https://releases.llvm.org/download.html
• Vulkan SDK: https://vulkan.lunarg.com/

ข้อกำหนดเบื้องต้นของปลั๊กอินเสียง

ปลั๊กอินเสียงต้องมีการติดตั้งโอเพนัล

• Linux: ใช้ตัวจัดการแพ็คเกจเพื่อติดตั้ง Openal หากยังไม่ได้ติดตั้ง (เช่น sudo apt install openal สำหรับ Ubuntu หรือ sudo pacman -S openal บน Arch)
• MacOS: ติดตั้ง Openal-Soft ผ่าน Homebrew: brew install openal-soft หมายเหตุเกี่ยวกับ M1 Macs นี้ติดตั้ง /opt/homebrew/opt/openal-soft/ โดยที่ include lib และ 'bin directories สามารถพบได้ บัญชีสคริปต์ build-all.sh สำหรับการติดตั้งเวอร์ชันนี้
• Windows: ติดตั้ง SDK จากที่นี่: https://www.openal.org/downloads/

เริ่ม

ในการเริ่มต้นใช้ข้อกำหนดเบื้องต้นทั้งหมดสำหรับแพลตฟอร์มปัจจุบันของคุณ (ดูด้านบน) หลังจากนี้โคลนที่เก็บ: git clone https://github.com/travisvroman/kohi

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

ดูวิดีโอการตั้งค่าในซีรีส์สำหรับ Windows หรือ Linux สำหรับรายละเอียด การตั้งค่า MacOS เกิดขึ้นอย่างมากในซีรีส์ที่ Video 76 เมื่อมีการเพิ่มการสนับสนุนอย่างเป็นทางการสำหรับแพลตฟอร์มนั้น

อาคาร

มีการสร้าง 2 ประเภทมีการดีบักและการเปิดตัว Debug รวมถึงสัญลักษณ์การดีบักและเหมาะสมที่สุดสำหรับการพัฒนาและการสำรวจในขณะที่การเปิดตัวเหมาะสำหรับประสิทธิภาพ นอกจากนี้ยังมี "ทำความสะอาด" เพื่อทำความสะอาดไฟล์ที่สร้างขึ้นซึ่งมีประโยชน์เมื่อสลับระหว่างการดีบัก/รีลีสหรือเมื่อเกิดข้อผิดพลาดการเชื่อมโยงแปลก ๆ เกิดขึ้นเนื่องจากไฟล์ที่หายไป (เช่นการสลับสาขา)

อาคาร: Windows

เปิดอินสแตนซ์ของคำสั่งหรือ PowerShell และเรียกใช้ไฟล์ build-debug.bat สำหรับบิลด์ดีบั๊กหรือ build-release.bat สำหรับการสร้างรุ่น นอกจากนี้ยังมี Bat clean.bat

อาคาร: Linux/MacOS

เปิดเทอร์มินัลและเรียกใช้ไฟล์ build-debug.sh สำหรับบิลด์ดีบั๊กหรือ build-release.sh สำหรับการสร้างรุ่น นอกจากนี้ยังมี clean.sh

วิ่ง

ในขณะนี้ "testbed" เป็นปฏิบัติการที่ใช้ Kohi มันควรจะทำงานด้วยไดเรกทอรีการทำงานของ /bin ในคำสั่งพร้อมท์/PowerShell ใน Windows หรือเทอร์มินัลใน Linux/MacOS, cd bin เพื่อเข้าสู่โฟลเดอร์ Bin จากนั้นเรียกใช้ testbed.exe บน Windows หรือเพียงแค่ testbed Linux/MacOS

โครงสร้างโครงการ

การแยกโครงสร้างนี้ขึ้นอยู่กับโฟลเดอร์รูทของที่เก็บ ไฟล์/โฟลเดอร์บางส่วนถูกตัดออกจากคำอธิบายนี้เนื่องจากไม่สำคัญกับภาพรวม

• kohi.core - Library ที่ใช้ร่วมกัน/.dll มีประเภท, คอนเทนเนอร์, lib สตริง, lib คณิตศาสตร์, utils, ฯลฯ รวมถึงเลเยอร์แพลตฟอร์ม (win32, linux, macOS)
• kohi.core.tests - ชุดการทดสอบหน่วยเล็ก ๆ สำหรับห้องสมุดหลัก จำเป็นต้องขยาย
• kohi.runtime - Library ที่ใช้ร่วมกัน/.dll มีตรรกะของเครื่องยนต์หลักเช่นเดียวกับระบบเครื่องยนต์หลักหลายระบบ
• kohi.plugin.audio.openal - ห้องสมุดที่ใช้ร่วมกัน/.dll มีปลั๊กอินเสียงซึ่งใช้ Openal เป็นแบ็กเอนด์เสียง
• kohi.plugin.renderer.vulkan - Library ที่ใช้ร่วมกัน/.dll มีปลั๊กอิน Vulkan Renderer ซึ่งทำหน้าที่เป็นแบ็กเอนด์เรนเดอร์ไปยังเครื่องยนต์สำหรับ Vulkan
• kohi.plugin.ui.standard - ห้องสมุดที่ใช้ร่วมกัน/.dll มี UI มาตรฐาน Kohi ซึ่งมีคอลเลกชันการใช้งานทั่วไปของการควบคุมเช่นปุ่ม, ฉลาก, กล่องข้อความ ฯลฯ นี่คือ UI โหมดที่เก็บรักษาไว้
• testbed.assets - มีสินทรัพย์ทั้งหมดที่จะโหลดโดยแอปพลิเคชันทดสอบ
• testbed.kapp - แอปพลิเคชัน/.exe แอปพลิเคชันที่ใช้งานได้มากขึ้นโหลด testbed.klib กำหนดค่า/ใช้ปลั๊กอินและไลบรารี Kohi อื่น ๆ
• testbed.klib = Library ที่ใช้ร่วมกัน/.dll มีรหัสแอปพลิเคชัน (หรือ "รหัสเกม") เฉพาะกับแอปพลิเคชัน ร้อนแรง
• kohi.tools.versiongen - แอปพลิเคชัน/.exe ยูทิลิตี้ขนาดเล็กที่สร้างเวอร์ชันโดยใช้หมายเลขรุ่นเมเจอร์และรุ่นรองผ่านและหมายเลขบิลด์และการแก้ไขที่สร้างขึ้นอัตโนมัติตามวันที่และเวลา ใช้ในการสร้างเวอร์ชันของ Kohi และปลั๊กอิน
• kohi.tools - ชุดเครื่องมือบรรทัดคำสั่ง ส่วนใหญ่ว่างเปล่าในขณะนี้ แต่จะถูกใช้เมื่อการพัฒนาบรรณาธิการเริ่มต้นขึ้น
• .vscode โฟลเดอร์ที่มีการตั้งค่าโครงการเฉพาะรหัส VS

แผนงาน

ดูที่นี่

เป้าหมาย

เป้าหมายที่นี่เป็นเรื่องง่ายเพื่อจัดหาทรัพยากรที่ฉันต้องการเมื่อเรียนรู้การพัฒนาเกม คู่มือที่สมบูรณ์เกี่ยวกับการสร้างเอ็นจิ้นเกมตั้งแต่เริ่มต้นรวมถึงการตัดสินใจออกแบบไม่เพียง แต่ ทำไม การตัดสินใจเหล่านั้นจึงเกิดขึ้น ควรสังเกตว่าในขณะที่นี่เป็น วิธี การสร้างเครื่องยนต์เกมมันไม่ใช่วิธี เดียว ที่จะสร้างได้

แน่นอนว่ายังมีเป้าหมายในการมีเอ็นจิ้นเกมที่สามารถสร้างเกมได้ เมื่อโครงการอยู่ไกลพอการทำเกมจะทำเป็นซีรีส์ในช่อง YouTube ของฉันเช่นกัน

เป็นสิ่งสำคัญที่จะต้องทราบว่าเอ็นจิ้นนี้ไม่ได้และจะไม่เป็นเวลาสักพักพร้อมการผลิต มันเป็นเครื่องมือการเรียนรู้และยังไม่ได้รับการปรับให้เหมาะสมสำหรับการใช้งานในผลิตภัณฑ์คุณภาพการผลิต สิ่งนี้จะเปลี่ยนไปในที่สุด แต่ตอนนี้มันยัง ไม่ พร้อมการผลิต

ผลงาน

ในขณะที่โครงการดำเนินไปยินดีต้อนรับการมีส่วนร่วมของชุมชนผ่านการร้องขอการดึงใน GitHub

คุณสมบัติควรได้รับการสนับสนุนผ่านชื่อสาขาในรูปแบบของ feature/<feature name> โดยที่ <feature name> ถูกแทนที่ด้วยชื่อของคุณสมบัติหรือตามหลักการของปัญหาคุณสมบัติที่รายงาน (เช่น feature/80 หรือ feature/terrain )

การแก้ไขข้อผิดพลาด จะต้อง ได้รับการสนับสนุนผ่านชื่อสาขาในรูปแบบของ bugfix/<issue#> โดยที่ <issue#> ถูกแทนที่ด้วยจำนวนปัญหาคุณสมบัติที่รายงาน (เช่น: bugfix/80 ) การแก้ไขข้อผิดพลาดจึง ต้อง มีปัญหาที่เกี่ยวข้องที่สร้างขึ้นบน GitHub

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

การมีส่วนร่วมทั้งหมดอาจมีการตรวจสอบและอาจได้รับการยอมรับหรืออาจไม่ได้รับการยอมรับหรือมีการร้องขอการเปลี่ยนแปลงก่อนที่จะได้รับการยอมรับ

สนับสนุนฉัน

ฉันกำลังพัฒนาโคฮิในเวลาว่าง ตอนนี้ฉันไม่มีสปอนเซอร์ ถ้าคุณชอบงานของฉันโปรดช่วยฉันในสถานที่เหล่านี้:

• Patreon
• Ko-fi
• สมาชิก YouTube
• สมัครสมาชิก Twitch
• สปอนเซอร์ผ่าน GitHub

ฉันขอขอบคุณอย่างมากต่อไปนี้/การสมัครสมาชิกบน YouTube และ Twitch กรุณากระจายคำ!

การสนับสนุนของคุณได้รับการชื่นชมอย่างมากและจะได้รับการลงทุนใหม่ในโครงการ