FlaxEngine

Motor de linho

Flax Engine é um motor de jogo 3D moderno de alta qualidade escrito em C++ e C#. De gráficos impressionantes a scripts poderosos, ele foi projetado para um fluxo de trabalho rápido com muitos recursos prontos para uso esperando por você agora. Para saber mais consulte o site (www.flaxengine.com).

Este repositório contém o código-fonte completo do Flax Engine (excluindo suporte a plataformas protegidas por NDA). Qualquer pessoa pode contribuir ou usar a fonte modificada em jogos baseados em Flax.

Desenvolvimento

• Página inicial
• Blog do desenvolvedor
• Documentação
• Fórum
• Roteiro

Capturas de tela

Começando

Siga as instruções abaixo para compilar e executar o mecanismo a partir do código-fonte.

Windows

• Instale o Visual Studio 2022 ou mais recente
• Instale o SDK do Windows 8.1 ou mais recente (por meio do Visual Studio Installer)
• Instale o conjunto de ferramentas Microsoft Visual C++ 2015 v140 ou mais recente (por meio do Visual Studio Installer)
• Instale o SDK do .NET 8 para Windows x64 (por meio do Visual Studio Installer ou da web)
• Instale o Git com LFS
• Clonar repositório (com LFS)
• Execute GenerateProjectFiles.bat
• Abra Flax.sln e defina a configuração da solução para Editor.Desenvolvimento e plataforma de solução para Win64
• Defina Flax (C++) ou FlaxEngine (C#) como projeto de inicialização
• Compile o projeto Flax (pressione F7 ou CTRL+Shift+B)
• Opcionalmente, defina o tipo de depuração como somente gerenciado (.NET Core) para depurar somente C# ou misto (.NET Core) para depurar C++ e C#
• Execute Flax (pressione a tecla F5)

Linux

• Instale o código do Visual Studio
• Instale o SDK do .NET 8 (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
  • Ubuntu: sudo apt install dotnet-sdk-8.0
• Instale o Vulkan SDK (https://vulkan.lunarg.com/)
  • Ubuntu: sudo apt install vulkan-sdk
  • Arco: sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers
• Instale o Git com LFS
  • Ubuntu: sudo apt-get install git git-lfs
  • Arco: sudo pacman -S git git-lfs
  • git-lfs install
• Instale os pacotes necessários:
  • Ubuntu: sudo apt-get install libx11-dev libxcursor-dev libxinerama-dev zlib1g-dev
  • Arco: sudo pacman -S base-devel libx11 libxcursor libxinerama zlib
• Instale o compilador Clang (versão 6 ou posterior):
  • Ubuntu: sudo apt-get install clang lldb lld
  • Arco: sudo pacman -S clang lldb lld
• Clone o repositório (com LFS)
• Execute ./GenerateProjectFiles.sh
• Abra o espaço de trabalho com código visual
• Construir e executar (configuração e tarefa chamada Flax|Editor.Linux.Development|x64 )

Mac

• Instale o XCode
• Instale o SDK do .NET 8 (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
• Instale o Vulkan SDK (https://vulkan.lunarg.com/)
• Clonar repositório (com LFS)
• Execute GenerateProjectFiles.command
• Abra o espaço de trabalho com XCode ou Visual Studio Code
• Construir e executar (configuração Editor.Mac.Development )

Solução de problemas

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

Reinicie o PC - certifique-se de que DotNet seja adicionado ao PATH para execução de ferramentas de linha de comando.

• 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

Use o Visual Studio 2022, versões mais antigas não são suportadas pelo .NET SDK 8.

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

Instale o Vulkan SDK e defina uma variável de ambiente para fornecer o caminho para o SDK antes de executar GenerateProjectFiles.bat: set VULKAN_SDK=%sdk_path% .

• The NuGetSdkResolver did not resolve this SDK

Instale .NET SDK , NuGet package manager e NuGet targets and build tasks em componentes do Visual Studio.

Diretório do espaço de trabalho

• Binários/ - arquivos executáveis
  • Editor/ - Binários do Editor Flax
  • Ferramentas/ - binários de ferramentas
• Cache/ - pasta de cache de dados local usada pelo mecanismo e pelas ferramentas
  • Intermediário/ - arquivos intermediários e cache para construção do mecanismo
    • ProjectName / - dados de cache de compilação por projeto
    • Deps/ - Dependências Flax.Build construindo cache
  • Projetos/ - localização dos arquivos do projeto
• Conteúdo/ - ativos e arquivos binários usados ​​pelo mecanismo e editor
• Desenvolvimento/ - arquivos de desenvolvimento do mecanismo
  • Scripts/ - scripts utilitários
• Fonte/ - localização do código fonte
  • Editor/ - Código fonte do Editor Flax
  • Motor/ - código fonte do motor Flax
  • Plataformas/ - fontes e arquivos de dependência por plataforma
    • DotNet/ - Dependências C#
    • Editor/ - Binários do Editor Flax
    • PlatformName / - arquivos por plataforma
      • Binários/ - binários por plataforma
        • Jogo/ - Binários do jogo Flax
        • ThirdParty/ - binários de terceiros pré-construídos
  • Shaders/ - código fonte dos shaders
  • Terceiro/ - código fonte de terceiros
  • Ferramentas/ - código fonte das ferramentas de desenvolvimento

Licenciamento e Contribuições

O uso do código-fonte do Flax é estritamente regido pelo Contrato de Licença de Usuário Final do Flax Engine. Se você não concordar com esses termos, conforme alterados de tempos em tempos, você não terá permissão para acessar ou usar o Flax Engine.

Agradecemos qualquer contribuição para o desenvolvimento do Flax Engine por meio de solicitações pull no GitHub. A maior parte do nosso desenvolvimento ativo está no branch master, então preferimos receber solicitações pull lá (principalmente para novos recursos). Tentamos garantir que todo novo código esteja de acordo com os padrões de codificação Flax. Todas as contribuições são regidas pelos termos do EULA.

Ferramentas SAST

PVS-Studio - analisador estático para código C, C++, C# e Java.