亚麻发动机

亚麻引擎是用C++和C#编写的高质量现代3D游戏引擎。从令人惊叹的图形到强大的脚本 - Flax可以为你的游戏提供一切。专为快速工作流程而设计，有许多现成的功能正等着你。要了解更多信息，请参阅网站 （www.flaxengine.com）。

该存储库包含亚麻引擎的完整源代码（不包括受NDA保护的平台支持）。欢迎任何人在基于亚麻的游戏中贡献或使用修改后的源代码。

发展

• 主页
• 开发博客
• 文档
• 论坛
• 路线图

截图

开始

按照以下说明从源代码编译和运行引擎。

窗户

• 安装 Visual Studio 2022 或更高版本
• 安装 Windows 8.1 SDK 或更高版本（通过 Visual Studio Installer）
• 安装 Microsoft Visual C++ 2015 v140 工具集或更高版本（通过 Visual Studio Installer）
• 安装 .Net 7 SDK（通过 Visual Studio Installer 或从 Web 安装)
• 使用 LFS 安装 Git
• 克隆存储库（使用 LFS）
• 运行生成项目文件.bat
• 打开解决方案配置并将其设置为编辑器。开发和解决方案平台到 Win64

  Flax.sln

• 将 Flax （C++） 或 FlaxEngine （C#） 设置为启动项目
• 编译亚麻项目（按 F7 或 Ctrl+Shift+B）
• 运行亚麻（按 F5 键）

Linux目录

• 安装视觉工作室代码
• 安装 .Net 7 SDK （https://dotnet.microsoft.com/en-us/download/dotnet/7.0)
  • 乌班图：

    sudo apt install dotnet-sdk-7.0

• 安装 Vulkan SDK （https://vulkan.lunarg.com/)
  • 乌班图：

    sudo apt install vulkan-sdk

  • 拱：

    sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers

• 使用 LFS 安装 Git
  • 乌班图：

    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 7 SDK （https://dotnet.microsoft.com/en-us/download/dotnet/7.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 7.0.  Either target .NET 5.0 or lower, or use a version of the .NET SDK that supports .NET 7.0

使用 Visual Studio 2022，.NET SDK 7 不支持旧版本。

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

安装 Vulkan SDK，然后设置一个环境变量，以便在运行 GenerateProjectFiles 之前提供 SDK 的路径.bat：。

set VULKAN_SDK=%sdk_path%

• The NuGetSdkResolver did not resolve this SDK

安装 ，并在 Visual Studio 组件中安装。

.NET SDK

NuGet package manager

NuGet targets and build tasks

工作区目录

• 二进制文件/ - 可执行文件
  • 编辑器/ - 亚麻编辑器二进制文件
  • 工具/ - 工具二进制文件
• Cache/ - 引擎和工具使用的本地数据缓存文件夹
  • 中间/ - 用于引擎构建的中间文件和缓存
    • 项目名称/ - 每个项目生成缓存数据
    • Deps/ - Flax.Build dependencies build cache
  • 项目/ - 项目文件位置
• 内容/ - 引擎和编辑器使用的资产和二进制文件
• 开发/ - 引擎开发文件
  • 脚本/ - 实用程序脚本
• 源/ - 源码位置
  • 编辑器/ - 亚麻编辑器源代码
  • 引擎/ - 亚麻引擎源代码
  • 平台/ - 每个平台的源和依赖项文件
    • DotNet/ - C# 依赖项
    • 编辑器/ - 亚麻编辑器二进制文件
    • 平台名称/ - 每个平台的文件
      • 二进制文件/ - 每个平台的二进制文件
        • 游戏/ - 亚麻游戏二进制文件
        • 第三方/ - 预构建的第三方二进制文件
  • 着色器/ - 着色器源代码
  • 第三方/ - 第三方源代码
  • 工具/ - 开发工具源代码

许可和贡献

使用亚麻源代码受亚麻引擎最终用户许可协议的严格约束。如果你不同意这些不时修订的条款，你将不被允许访问或使用亚麻引擎。

我们欢迎通过 GitHub 上的拉取请求对 Flax Engine 开发做出任何贡献。我们的大多数活跃开发都在 master 分支中，因此我们更喜欢在那里接受拉取请求（特别是对于新功能）。我们尝试确保所有新代码都符合Flax编码标准。所有贡献均受 EULA 条款的约束。