FlaxEngine

محرك الكتان

Flax Engine هو محرك ألعاب ثلاثي الأبعاد حديث وعالي الجودة مكتوب بلغة C++ وC#. بدءًا من الرسومات المذهلة وحتى النصوص القوية، تم تصميمه لسير العمل بسرعة مع العديد من الميزات الجاهزة للاستخدام التي تنتظرك الآن. لمعرفة المزيد راجع الموقع (www.flaxengine.com).

يحتوي هذا المستودع على كود المصدر الكامل لـ Flax Engine (باستثناء دعم الأنظمة الأساسية المحمية بـ NDA). نرحب بأي شخص للمساهمة أو استخدام المصدر المعدل في الألعاب القائمة على الكتان.

تطوير

• الصفحة الرئيسية
• مدونة ديف
• التوثيق
• المنتدى
• خريطة الطريق

لقطات الشاشة

ابدء

اتبع الإرشادات أدناه لتجميع المحرك وتشغيله من المصدر.

ويندوز

• قم بتثبيت 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
• استنساخ الريبو (مع LFS)
• قم بتشغيل GenerateProjectFiles.bat
• افتح Flax.sln وقم بتعيين تكوين الحل على Editor.Development ومنصة الحلول على Win64
• قم بتعيين Flax (C++) أو FlaxEngine (C#) كمشروع بدء التشغيل
• ترجمة مشروع Flax (اضغط على F7 أو CTRL+Shift+B)
• اختياريًا، قم بتعيين نوع التصحيح على Managed Only (.NET Core) لتصحيح أخطاء C# فقط، أو Mixed (.NET Core) لتصحيح أخطاء كل من C++ وC#
• تشغيل الكتان (اضغط على المفتاح F5)

لينكس

• قم بتثبيت كود Visual Studio
• تثبيت .NET 8 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
  • أوبونتو: sudo apt install dotnet-sdk-8.0
• تثبيت Vulkan SDK (https://vulkan.lunarg.com/)
  • أوبونتو: sudo apt install vulkan-sdk
  • القوس: sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers
• تثبيت Git مع LFS
  • أوبونتو: sudo apt-get install git git-lfs
  • القوس: sudo pacman -S git git-lfs
  • git-lfs install
• تثبيت الحزم المطلوبة:
  • أوبونتو: sudo apt-get install libx11-dev libxcursor-dev libxinerama-dev zlib1g-dev
  • القوس: sudo pacman -S base-devel libx11 libxcursor libxinerama zlib
• تثبيت مترجم Clang (الإصدار 6 أو الأحدث):
  • أوبونتو: sudo apt-get install clang lldb lld
  • القوس: sudo pacman -S clang lldb lld
• استنساخ المستودع (باستخدام LFS)
• قم بتشغيل ./GenerateProjectFiles.sh
• افتح مساحة العمل باستخدام الكود المرئي
• البناء والتشغيل (التكوين والمهمة المسماة 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/)
• استنساخ الريبو (مع 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.

دليل مساحة العمل

• الثنائيات/ - الملفات القابلة للتنفيذ
  • محرر/ - ثنائيات محرر الكتان
  • الأدوات/ - الأدوات الثنائية
• ذاكرة التخزين المؤقت/ - مجلد ذاكرة التخزين المؤقت للبيانات المحلية الذي يستخدمه المحرك والأدوات
  • متوسط/ - الملفات المتوسطة وذاكرة التخزين المؤقت لبناء المحرك
    • اسم المشروع / - بناء بيانات ذاكرة التخزين المؤقت لكل مشروع
    • Deps/ - بناء تبعيات Flax.Build لذاكرة التخزين المؤقت
  • المشاريع/ - موقع ملفات المشروع
• المحتوى/ - الأصول والملفات الثنائية التي يستخدمها المحرك والمحرر
• التطوير/ - ملفات تطوير المحرك
  • البرامج النصية/ - البرامج النصية فائدة
• المصدر/ - موقع كود المصدر
  • Editor/ - الكود المصدري لمحرر الكتان
  • المحرك/ - الكود المصدري لمحرك الكتان
  • الأنظمة الأساسية/ - المصادر والملفات التابعة لكل نظام أساسي
    • DotNet/ - تبعيات C#
    • محرر/ - ثنائيات محرر الكتان
    • اسم النظام / - الملفات الخاصة بكل منصة
      • الثنائيات/ - الثنائيات لكل منصة
        • اللعبة/ - لعبة الكتان الثنائيات
        • ThirdParty/ - ثنائيات الطرف الثالث المعدة مسبقًا
  • تظليل/ - تظليل كود المصدر
  • ThirdParty/ - كود مصدر الطرف الثالث
  • الأدوات/ - كود مصدر أدوات التطوير

التراخيص والمساهمات

يخضع استخدام كود مصدر Flax بشكل صارم لاتفاقية ترخيص المستخدم النهائي لـ Flax Engine. إذا كنت لا توافق على هذه الشروط، بصيغتها المعدلة من وقت لآخر، فلا يُسمح لك بالوصول إلى Flax Engine أو استخدامه.

نرحب بأي مساهمات في تطوير Flax Engine من خلال طلبات السحب على GitHub. معظم عمليات التطوير النشطة لدينا تتم في الفرع الرئيسي، لذلك نفضل تلقي طلبات السحب هناك (خاصة بالنسبة للميزات الجديدة). نحاول التأكد من أن جميع التعليمات البرمجية الجديدة تلتزم بمعايير ترميز الكتان. تخضع جميع المساهمات لشروط اتفاقية ترخيص المستخدم النهائي (EULA).

أدوات SAST

PVS-Studio - محلل ثابت لرموز C وC++ وC# وJava.