FlaxEngine

Moteur de lin

Flax Engine est un moteur de jeu 3D moderne de haute qualité écrit en C++ et C#. Des graphismes époustouflants aux scripts puissants, il est conçu pour un flux de travail rapide avec de nombreuses fonctionnalités prêtes à l'emploi qui vous attendent dès maintenant. Pour en savoir plus, consultez le site Web (www.flaxengine.com).

Ce référentiel contient le code source complet du Flax Engine (à l'exclusion du support des plates-formes protégées par NDA). Tout le monde est invité à contribuer ou à utiliser la source modifiée dans les jeux basés sur Flax.

Développement

• Page d'accueil
• Blog des développeurs
• Documentation
• Forum
• Feuille de route

Captures d'écran

Commencer

Suivez les instructions ci-dessous pour compiler et exécuter le moteur à partir des sources.

Fenêtres

• Installez Visual Studio 2022 ou une version plus récente
• Installez le SDK Windows 8.1 ou version ultérieure (via Visual Studio Installer)
• Installez l'ensemble d'outils Microsoft Visual C++ 2015 v140 ou version ultérieure (via Visual Studio Installer)
• Installez le SDK .NET 8 pour Windows x64 (via Visual Studio Installer ou à partir du Web)
• Installer Git avec LFS
• Cloner le dépôt (avec LFS)
• Exécutez GenerateProjectFiles.bat
• Ouvrez Flax.sln et définissez la configuration de la solution sur Editor.Development et la plate-forme de solution sur Win64.
• Définir Flax (C++) ou FlaxEngine (C#) comme projet de démarrage
• Compilez le projet Flax (appuyez sur F7 ou CTRL+Maj+B)
• Définissez éventuellement le type de débogage sur Géré uniquement (.NET Core) pour déboguer C# uniquement, ou Mixte (.NET Core) pour déboguer à la fois C++ et C#.
• Exécutez Flax (appuyez sur la touche F5)

Linux

• Installer le code Visual Studio
• Installez le SDK .NET 8 (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
  • Ubuntu : sudo apt install dotnet-sdk-8.0
• Installez le SDK Vulkan (https://vulkan.lunarg.com/)
  • Ubuntu : sudo apt install vulkan-sdk
  • Arch : sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers
• Installer Git avec LFS
  • Ubuntu : sudo apt-get install git git-lfs
  • Arch : sudo pacman -S git git-lfs
  • git-lfs install
• Installez les packages requis :
  • Ubuntu : sudo apt-get install libx11-dev libxcursor-dev libxinerama-dev zlib1g-dev
  • Arch : sudo pacman -S base-devel libx11 libxcursor libxinerama zlib
• Installez le compilateur Clang (version 6 ou ultérieure) :
  • Ubuntu : sudo apt-get install clang lldb lld
  • Arch : sudo pacman -S clang lldb lld
• Cloner le dépôt (avec LFS)
• Exécutez ./GenerateProjectFiles.sh
• Espace de travail ouvert avec Visual Code
• Construire et exécuter (configuration et tâche nommée Flax|Editor.Linux.Development|x64 )

Mac

• Installer XCode
• Installez le SDK .NET 8 (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
• Installez le SDK Vulkan (https://vulkan.lunarg.com/)
• Cloner le dépôt (avec LFS)
• Exécutez GenerateProjectFiles.command
• Ouvrir un espace de travail avec XCode ou Visual Studio Code
• Construire et exécuter (configuration Editor.Mac.Development )

Dépannage

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

Redémarrez le PC - assurez-vous que DotNet est ajouté à PATH pour l'exécution des outils de ligne de commande.

• 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

Utilisez Visual Studio 2022, les anciennes versions ne sont pas prises en charge par .NET SDK 8.

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

Installez le SDK Vulkan, puis définissez une variable d'environnement pour fournir le chemin d'accès au SDK avant d'exécuter GenerateProjectFiles.bat : set VULKAN_SDK=%sdk_path% .

• The NuGetSdkResolver did not resolve this SDK

Installez .NET SDK , NuGet package manager et NuGet targets and build tasks dans les composants Visual Studio.

Répertoire de l'espace de travail

• Binaires/ - fichiers exécutables
  • Editor/ - Binaires de l'éditeur Flax
  • Outils/ - outils binaires
• Cache/ - dossier de cache de données local utilisé par le moteur et les outils
  • Intermédiaire/ - fichiers intermédiaires et cache pour la construction du moteur
    • ProjectName / - données de cache de build par projet
    • Deps/ - Cache de création de dépendances Flax.Build
  • Projets/ - emplacement des fichiers du projet
• Contenu/ - actifs et fichiers binaires utilisés par le moteur et l'éditeur
• Développement/ - fichiers de développement moteur
  • Scripts/ - scripts utilitaires
• Source/ - emplacement du code source
  • Éditeur/ - Code source de l'éditeur Flax
  • Moteur/ - Code source du moteur Flax
  • Plateformes/ - sources par plateforme et fichiers de dépendance
    • DotNet/ - Dépendances C#
    • Editor/ - Binaires de l'éditeur Flax
    • PlatformName / - fichiers par plateforme
      • Binaires/ - binaires par plateforme
        • Jeu/ - Binaires du jeu Flax
        • ThirdParty/ - binaires tiers prédéfinis
  • Shaders/ - code source des shaders
  • ThirdParty/ - Code source tiers
  • Outils/ - code source des outils de développement

Licences et cotisations

L'utilisation du code source de Flax est strictement régie par le contrat de licence d'utilisateur final de Flax Engine. Si vous n'acceptez pas ces conditions, telles que modifiées de temps à autre, vous n'êtes pas autorisé à accéder ou à utiliser Flax Engine.

Nous acceptons toute contribution au développement de Flax Engine via des demandes d'extraction sur GitHub. La majeure partie de notre développement actif se déroule dans la branche master, nous préférons donc y effectuer des pull request (en particulier pour les nouvelles fonctionnalités). Nous essayons de nous assurer que tout nouveau code respecte les normes de codage Flax. Toutes les contributions sont régies par les termes du CLUF.

Outils SAST

PVS-Studio - analyseur statique pour le code C, C++, C# et Java.