FlaxEngine

Льняной двигатель

Flax Engine — это высококачественный современный игровой движок 3D, написанный на C++ и C#. От потрясающей графики до мощных сценариев — он создан для быстрого рабочего процесса и содержит множество готовых к использованию функций, которые ждут вас прямо сейчас. Чтобы узнать больше, посетите сайт (www.flaxengine.com).

Этот репозиторий содержит полный исходный код Flax Engine (за исключением поддержки платформ, защищенных NDA). Любой может внести свой вклад или использовать измененный исходный код в играх на основе Flax.

Разработка

• Домашняя страница
• Блог разработчиков
• Документация
• Форум
• Дорожная карта

Скриншоты

Начиная

Следуйте инструкциям ниже, чтобы скомпилировать и запустить движок из исходного кода.

Окна

• Установите Visual Studio 2022 или новее.
• Установите Windows 8.1 SDK или новее (через установщик Visual Studio).
• Установите набор инструментов Microsoft Visual C++ 2015 v140 или новее (через установщик Visual Studio).
• Установите .NET 8 SDK для Windows x64 (через установщик Visual Studio или через Интернет).
• Установите Git с помощью LFS
• Репозиторий клонов (с LFS)
• Запустите GenerateProjectFiles.bat.
• Откройте Flax.sln и установите для конфигурации решения значение Editor.Development , а для платформы решения — Win64.
• Установите Flax (C++) или FlaxEngine (C#) в качестве запускаемого проекта.
• Скомпилируйте проект Flax (нажмите F7 или CTRL+Shift+B)
• При необходимости установите для типа отладки значение «Только управляемый» (.NET Core) для отладки только C# или «Смешанный» (.NET Core) для отладки как C++, так и C#.
• Запустите Flax (нажмите клавишу F5)

Линукс

• Установить код Visual Studio
• Установите пакет SDK для .NET 8 (https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
  • Ubuntu: sudo apt install dotnet-sdk-8.0
• Установите Vulkan SDK (https://vulkan.lunarg.com/)
  • Ubuntu: sudo apt install vulkan-sdk
  • Арка: sudo pacman -S spirv-tools vulkan-headers vulkan-tools vulkan-validation-layers
• Установите Git с помощью LFS
  • Ubuntu: sudo apt-get install git git-lfs
  • Арка: sudo pacman -S git git-lfs
  • git-lfs install
• Установите необходимые пакеты:
  • Ubuntu: sudo apt-get install libx11-dev libxcursor-dev libxinerama-dev zlib1g-dev
  • Арка: sudo pacman -S base-devel libx11 libxcursor libxinerama zlib
• Установите компилятор Clang (версия 6 или новее):
  • Ubuntu: sudo apt-get install clang lldb lld
  • Арка: sudo pacman -S clang lldb lld
• Клонировать репозиторий (с помощью LFS)
• Запустите ./GenerateProjectFiles.sh
• Открытая рабочая область с визуальным кодом
• Сборка и запуск (конфигурация и задача с именем Flax|Editor.Linux.Development|x64 )

Мак

• Установить XCode
• Установите пакет SDK для .NET 8 (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.

Каталог рабочей области

• Бинарники/ - исполняемые файлы
  • Editor/ — двоичные файлы редактора Flax
  • Инструменты/ - двоичные файлы инструментов
• Cache/ — локальная папка кэша данных, используемая движком и инструментами.
  • Intermediate/ - промежуточные файлы и кеш для сборки движка
    • ProjectName / — данные кэша сборки для каждого проекта.
    • Deps/ — кеш построения зависимостей Flax.Build
  • Projects/ - расположение файлов проекта
• Content/ — ресурсы и двоичные файлы, используемые движком и редактором.
• Development/ - файлы разработки движка
  • Scripts/ - служебные скрипты
• Source/ - расположение исходного кода
  • Editor/ — исходный код редактора Flax
  • Engine/ — исходный код Flax Engine
  • Платформы/ — исходные коды и файлы зависимостей для каждой платформы.
    • DotNet/ — зависимости C#
    • Editor/ — двоичные файлы редактора Flax
    • ИмяПлатформы / — файлы для каждой платформы
      • Двоичные файлы/ — двоичные файлы для каждой платформы
        • Game/ - Бинарные файлы Flax Game
        • ThirdParty/ — готовые двоичные файлы сторонних разработчиков.
  • Shaders/ - исходный код шейдеров
  • ThirdParty/ — сторонний исходный код
  • Tools/ — исходный код инструментов разработки.

Лицензирование и вклады

Использование исходного кода Flax строго регулируется Лицензионным соглашением с конечным пользователем Flax Engine. Если вы не согласны с этими условиями, в которые время от времени вносятся поправки, вам не разрешается получить доступ к Flax Engine или использовать его.

Мы приветствуем любой вклад в разработку Flax Engine через запросы на включение на GitHub. Большая часть нашей активной разработки находится в основной ветке, поэтому мы предпочитаем принимать запросы на включение туда (особенно для новых функций). Мы стараемся убедиться, что весь новый код соответствует стандартам кодирования Flax. Все взносы регулируются условиями EULA.

Инструменты SAST

PVS-Studio — статический анализатор кода C, C++, C# и Java.