FlaxEngine

เครื่องยนต์แฟลกซ์

Flax Engine เป็นเอนจิ้นเกม 3D สมัยใหม่คุณภาพสูงที่เขียนด้วย C++ และ C# ตั้งแต่กราฟิกที่น่าทึ่งไปจนถึงสคริปต์ที่ทรงพลัง ได้รับการออกแบบมาเพื่อขั้นตอนการทำงานที่รวดเร็วพร้อมคุณสมบัติที่พร้อมใช้งานมากมายรอคุณอยู่ในขณะนี้ หากต้องการเรียนรู้เพิ่มเติม โปรดดูที่เว็บไซต์ (www.flaxengine.com)

พื้นที่เก็บข้อมูลนี้มีซอร์สโค้ดแบบเต็มของ Flax Engine (ไม่รวมการรองรับแพลตฟอร์มที่ได้รับการป้องกัน NDA) ทุกคนสามารถมีส่วนร่วมหรือใช้แหล่งดัดแปลงในเกมที่ใช้ Flax ได้

การพัฒนา

• หน้าแรก
• บล็อกการพัฒนา
• เอกสารประกอบ
• ฟอรั่ม
• แผนการทำงาน

ภาพหน้าจอ

เริ่มต้นใช้งาน

ทำตามคำแนะนำด้านล่างเพื่อคอมไพล์และรันเอ็นจิ้นจากแหล่งที่มา

หน้าต่าง

• ติดตั้ง Visual Studio 2022 หรือใหม่กว่า
• ติดตั้ง Windows 8.1 SDK หรือใหม่กว่า (ผ่าน Visual Studio Installer)
• ติดตั้งชุดเครื่องมือ Microsoft Visual C++ 2015 v140 หรือใหม่กว่า (ผ่าน Visual Studio Installer)
• ติดตั้ง .NET 8 SDK สำหรับ Windows x64 (ผ่าน Visual Studio Installer หรือจากเว็บ)
• ติดตั้ง Git ด้วย LFS
• โคลน repo (พร้อม LFS)
• เรียกใช้ GenerateProjectFiles.bat
• เปิด Flax.sln และตั้งค่าการกำหนดค่าโซลูชันเป็น Editor.Development และแพลตฟอร์มโซลูชันเป็น Win64
• ตั้งค่า Flax (C++) หรือ FlaxEngine (C#) เป็นโครงการเริ่มต้น
• คอมไพล์โครงการ Flax (กด F7 หรือ CTRL+Shift+B)
• คุณสามารถเลือกตั้งค่าประเภทการดีบักเป็น Managed Only (.NET Core) เพื่อดีบัก C#-only หรือ แบบผสม (.NET Core) เพื่อดีบักทั้ง C++ และ C#
• เรียกใช้ Flax (กดปุ่ม F5)

ลินุกซ์

• ติดตั้งโค้ด Visual Studio
• ติดตั้ง .NET 8 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
  • Ubuntu: sudo apt install dotnet-sdk-8.0
• ติดตั้ง Vulkan SDK (https://vulkan.lunarg.com/)
  • Ubuntu: sudo apt install vulkan-sdk
  • Arch: sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers
• ติดตั้ง Git ด้วย LFS
  • Ubuntu: sudo apt-get install git git-lfs
  • โค้ง: sudo pacman -S git git-lfs
  • git-lfs install
• ติดตั้งแพ็คเกจที่จำเป็น:
  • Ubuntu: sudo apt-get install libx11-dev libxcursor-dev libxinerama-dev zlib1g-dev
  • อาร์ค: sudo pacman -S base-devel libx11 libxcursor libxinerama zlib
• ติดตั้งคอมไพเลอร์ Clang (เวอร์ชัน 6 หรือใหม่กว่า):
  • Ubuntu: sudo apt-get install clang lldb lld
  • อาร์ค: sudo pacman -S clang lldb lld
• โคลนที่เก็บ (ด้วย LFS)
• เรียกใช้ ./GenerateProjectFiles.sh
• เปิดพื้นที่ทำงานด้วย Visual Code
• สร้างและรัน (การกำหนดค่าและงานชื่อ Flax|Editor.Linux.Development|x64 )

แม็ค

• ติดตั้ง XCode
• ติดตั้ง .NET 8 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
• ติดตั้ง Vulkan SDK (https://vulkan.lunarg.com/)
• โคลน repo (พร้อม LFS)
• เรียกใช้ GenerateProjectFiles.command
• เปิดพื้นที่ทำงานด้วย XCode หรือ Visual Studio Code
• สร้างและเรียกใช้ (ตัวแก้ไขการกำหนดค่า Editor.Mac.Development )

การแก้ไขปัญหา

• Could not execute because the specified command or file was not found.

รีสตาร์ทพีซี - ตรวจสอบให้แน่ใจว่า DotNet ถูกเพิ่มใน PATH สำหรับการทำงานของเครื่องมือบรรทัดคำสั่ง

• Microsoft.NET.TargetFrameworkInference.targets(141,5): error NETSDK1045: The current .NET SDK does not support targeting .NET 8.0. Either target .NET 5.0 or lower, or use a version of the .NET SDK that supports .NET 8.0

ใช้ Visual Studio 2022 .NET SDK 8 ไม่รองรับเวอร์ชันเก่า

• Building for Windows without Vulkan rendering backend (Vulkan SDK is missing)

ติดตั้ง Vulkan SDK จากนั้นตั้งค่าตัวแปรสภาพแวดล้อมเพื่อจัดเตรียมเส้นทางไปยัง SDK ก่อนที่จะรัน GenerateProjectFiles.bat: set VULKAN_SDK=%sdk_path%

• The NuGetSdkResolver did not resolve this SDK

ติดตั้ง .NET SDK , NuGet package manager และ NuGet targets and build tasks ในส่วนประกอบ Visual Studio

ไดเร็กทอรีพื้นที่ทำงาน

• ไบนารี/ - ไฟล์ปฏิบัติการ
  • Editor/ - ไบนารีของ Flax Editor
  • เครื่องมือ/ - ไบนารีเครื่องมือ
• แคช/ - โฟลเดอร์แคชข้อมูลภายในเครื่องที่ใช้โดยกลไกและเครื่องมือ
  • ระดับกลาง/ - ไฟล์ระดับกลางและแคชสำหรับการสร้างกลไก
    • ชื่อโครงการ / - ข้อมูลแคชการสร้างต่อโครงการ
    • Deps/ - Flax.Build แคชการสร้างการพึ่งพา
  • โครงการ/ - ตำแหน่งไฟล์โครงการ
• เนื้อหา/ - เนื้อหาและไฟล์ไบนารี่ที่ใช้โดยกลไกและโปรแกรมแก้ไข
• การพัฒนา/ - ไฟล์การพัฒนาเครื่องยนต์
  • สคริปต์/ - สคริปต์ยูทิลิตี้
• แหล่งที่มา/ - ตำแหน่งซอร์สโค้ด
  • ตัวแก้ไข/ - ซอร์สโค้ด Flax Editor
  • เครื่องยนต์/ - ซอร์สโค้ดของ Flax Engine
  • Platforms/ - แหล่งที่มาต่อแพลตฟอร์มและไฟล์อ้างอิง
    • DotNet/ - การพึ่งพา C#
    • Editor/ - ไบนารีของ Flax Editor
    • PlatformName / - ไฟล์ต่อแพลตฟอร์ม
      • ไบนารี/ - ไบนารีต่อแพลตฟอร์ม
        • เกม/ - ไบนารีเกม Flax
        • ThirdParty/ - ไบนารีของบุคคลที่สามที่สร้างไว้ล่วงหน้า
  • Shaders/ - ซอร์สโค้ดของ shaders
  • ThirdParty/ - ซอร์สโค้ดของบุคคลที่สาม
  • เครื่องมือ/ - ซอร์สโค้ดเครื่องมือพัฒนา

ใบอนุญาตและการบริจาค

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

เรายินดีรับการมีส่วนร่วมในการพัฒนา Flax Engine ผ่านการดึงคำขอบน GitHub การพัฒนาที่ดำเนินการอยู่ส่วนใหญ่ของเราอยู่ในสาขาหลัก ดังนั้นเราจึงต้องการรับคำขอดึงที่นั่น (โดยเฉพาะอย่างยิ่งสำหรับคุณสมบัติใหม่) เราพยายามตรวจสอบให้แน่ใจว่าโค้ดใหม่ทั้งหมดเป็นไปตามมาตรฐานการเข้ารหัส Flax การสนับสนุนทั้งหมดอยู่ภายใต้ข้อกำหนดของ EULA

เครื่องมือ SAST

PVS-Studio - ตัววิเคราะห์แบบคงที่สำหรับโค้ด C, C++, C# และ Java