Flax Engine Containers

Build and deploy your Flax Engine games automatically in the cloud using containerized CI/CD pipelines!

Note: This is a non-official project and is not affiliated with Flax.

Overview

This project provides Docker containers with Flax Engine pre-installed, enabling seamless integration into CI/CD workflows for game development. Build your games automatically in the cloud across multiple platforms!

A sample project demonstrating usage with GitLab CI/CD is available at: https://gitlab.com/brmassa/flax-container-sample-project

Base Image

The containers are built on top of the official .NET SDK image, which is based on Debian.

Supported Platforms

• Linux (AMD64)
• Windows (AMD64)
• Android (ARM64)
• Xbox One
• Windows Store

Usage

The containers utilize standard Flax terminal commands for building games. Integration depends on your specific CI/CD pipeline and remote repository.

GitLab CI/CD

To use with GitLab CI/CD, create a .gitlab-ci.yml file in your project's root directory:

build:
  image: registry.gitlab.com/brmassa/flax-container:linux_amd64-latest  # Or use a fixed version like flax-container:linux_amd64-1.7.6407.2
  stage: build
  script:
    - /flax/Binaries/Editor/Linux/Release/FlaxEditor -project ./ -std -null -headless -build "Release.Linux_x64"
    - mv Output/Linux_x64 MyApp  # Rename the output folder
  artifacts:
    paths:
      - MyApp  # GitLab CI will automatically create a zip file with this folder

GitHub Actions

Support for GitHub Actions is in progress. See issue #3 for updates.

Known Issues

Windows Builds Failing

There's an ongoing investigation into Windows build failures. For updates, please refer to issue #1.

Android Builds Failing

Android builds are currently not functional as the Android SDK is not yet installed in the image. This is being addressed in issue #2.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Flax Engine - The game engine that powers this project
• .NET SDK - The base image for our containers

For any questions or support, please open an issue in the GitHub repository.