FlaxEngine

Mesin Rami

Flax Engine adalah mesin game 3D modern berkualitas tinggi yang ditulis dalam C++ dan C#. Dari grafis memukau hingga skrip canggih, ini dirancang untuk alur kerja cepat dengan banyak fitur siap pakai menunggu Anda saat ini. Untuk mempelajari lebih lanjut lihat situs web (www.flaxengine.com).

Repositori ini berisi kode sumber lengkap Flax Engine (tidak termasuk dukungan platform yang dilindungi NDA). Siapapun dipersilakan untuk berkontribusi atau menggunakan sumber yang dimodifikasi dalam game berbasis Flax.

Perkembangan

• Beranda
• Blog Pengembang
• Dokumentasi
• Forum
• Peta jalan

Tangkapan layar

Memulai

Ikuti petunjuk di bawah ini untuk mengkompilasi dan menjalankan mesin dari sumber.

jendela

• Instal Visual Studio 2022 atau lebih baru
• Instal Windows 8.1 SDK atau yang lebih baru (melalui Visual Studio Installer)
• Instal perangkat Microsoft Visual C++ 2015 v140 atau yang lebih baru (melalui Penginstal Visual Studio)
• Instal .NET 8 SDK untuk Windows x64 (melalui Visual Studio Installer atau dari web)
• Instal Git dengan LFS
• Repo klon (dengan LFS)
• Jalankan GenerateProjectFiles.bat
• Buka Flax.sln dan atur konfigurasi solusi ke Editor.Development dan platform solusi ke Win64
• Tetapkan Flax (C++) atau FlaxEngine (C#) sebagai proyek startup
• Kompilasi proyek Flax (tekan F7 atau CTRL+Shift+B)
• Secara opsional atur Jenis Debug ke Hanya Terkelola (.NET Core) untuk men-debug C# saja, atau Campuran (.NET Core) untuk men-debug C++ dan C#
• Jalankan Flax (tekan tombol F5)

Linux

• Instal Kode Visual Studio
• Instal .NET 8 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
  • Ubuntu: sudo apt install dotnet-sdk-8.0
• Instal Vulkan SDK (https://vulkan.lunarg.com/)
  • Ubuntu: sudo apt install vulkan-sdk
  • Lengkungan: sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers
• Instal Git dengan LFS
  • Ubuntu: sudo apt-get install git git-lfs
  • Lengkungan: sudo pacman -S git git-lfs
  • git-lfs install
• Instal paket yang diperlukan:
  • Ubuntu: sudo apt-get install libx11-dev libxcursor-dev libxinerama-dev zlib1g-dev
  • Lengkungan: sudo pacman -S base-devel libx11 libxcursor libxinerama zlib
• Instal kompiler Clang (versi 6 atau lebih baru):
  • Ubuntu: sudo apt-get install clang lldb lld
  • Lengkungan: sudo pacman -S clang lldb lld
• Kloning repositori (dengan LFS)
• Jalankan ./GenerateProjectFiles.sh
• Buka ruang kerja dengan Kode Visual
• Bangun dan jalankan (konfigurasi dan tugas bernama Flax|Editor.Linux.Development|x64 )

Mac

• Instal XCode
• Instal .NET 8 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
• Instal Vulkan SDK (https://vulkan.lunarg.com/)
• Repo klon (dengan LFS)
• Jalankan GenerateProjectFiles.command
• Buka ruang kerja dengan XCode atau Visual Studio Code
• Bangun dan jalankan (konfigurasi Editor.Mac.Development )

Pemecahan masalah

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

Restart PC - pastikan DotNet ditambahkan ke PATH untuk eksekusi alat baris perintah.

• 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

Gunakan Visual Studio 2022, versi yang lebih lama tidak didukung oleh .NET SDK 8.

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

Instal Vulkan SDK lalu atur variabel lingkungan untuk menyediakan jalur ke SDK sebelum menjalankan GenerateProjectFiles.bat: set VULKAN_SDK=%sdk_path% .

• The NuGetSdkResolver did not resolve this SDK

Instal .NET SDK , NuGet package manager , dan NuGet targets and build tasks dalam komponen Visual Studio.

Direktori ruang kerja

• Biner/ - file yang dapat dieksekusi
  • Editor/ - Biner Editor Rami
  • Alat/ - biner alat
• Cache/ - folder cache data lokal yang digunakan oleh mesin dan alat
  • Menengah/ - file perantara dan cache untuk pembuatan mesin
    • ProjectName / - data cache pembangunan per proyek
    • Deps/ - Flax.Build dependensi membangun cache
  • Proyek/ - lokasi file proyek
• Konten/ - aset dan file biner yang digunakan oleh mesin dan editor
• Pengembangan/ - file pengembangan mesin
  • Skrip/ - skrip utilitas
• Sumber/ - lokasi kode sumber
  • Editor/ - Kode sumber Editor Rami
  • Mesin/ - Kode sumber Mesin Flax
  • Platforms/ - sumber per platform dan file ketergantungan
    • DotNet/ - ketergantungan C#
    • Editor/ - Biner Editor Rami
    • PlatformName / - file per platform
      • Biner/ - biner per platform
        • Game/ - Biner Game Rami
        • ThirdParty/ - biner Pihak ke-3 yang dibuat sebelumnya
  • Shader/ - kode sumber shader
  • Pihak Ketiga/ - Kode sumber Pihak Ketiga
  • Alat/ - kode sumber alat pengembangan

Lisensi dan Kontribusi

Penggunaan kode sumber Flax diatur secara ketat oleh Perjanjian Lisensi Pengguna Akhir Flax Engine. Jika Anda tidak menyetujui ketentuan tersebut, sebagaimana diubah dari waktu ke waktu, Anda tidak diizinkan untuk mengakses atau menggunakan Flax Engine.

Kami menyambut baik kontribusi apa pun terhadap pengembangan Flax Engine melalui permintaan tarik di GitHub. Sebagian besar pengembangan aktif kami berada di cabang master, jadi kami lebih memilih untuk menerima permintaan tarik di sana (khususnya untuk fitur baru). Kami mencoba memastikan bahwa semua kode baru mematuhi standar pengkodean Flax. Semua kontribusi diatur oleh ketentuan EULA.

Alat SAST

PVS-Studio - penganalisis statis untuk kode C, C++, C#, dan Java.