Unity - Builder

(Not affiliated with Unity Technologies)

GitHub Action to build Unity projects for different platforms.

Part of the GameCI open source project.

How to use

Find the docs on the GameCI documentation website.

Unity editor image version fallback

For local Docker builds using official unityci/* editor images, the action checks whether the requested image tag exists on Docker Hub. If the tag returns HTTP 404, it searches for the closest older compatible Unity editor version in the same minor version, then the same major version. The Docker platform, build module, and image revision must match.

The selected image and editor version are passed together to the game-ci build CLI as --customImage and --engineVersion. An existing tag is never replaced. Registry errors or unavailable lookup results leave the originally requested version unchanged.

Fallback is skipped when customImage is set, when running on macOS, or for non-Docker providers such as providerStrategy=local-system. Custom-built editor images are therefore unaffected.

Docker shared memory

The GameCI CLI defaults Docker shared memory to 1025m. For projects that require more, set the dockerShmSize action input explicitly:

# After merging into BasisVR/unity-builder:
- uses: BasisVR/unity-builder@main
  with:
    projectPath: MyUnityProject
    targetPlatform: StandaloneWindows64
    dockerShmSize: 2g

The action continues to run on Node 24 and delegates builds to the game-ci/cli binary.

Related actions

Visit the GameCI Unity Actions status repository for related Actions.

Community

Feel free to join us on and engage with the community.

Contributing

To help improve the documentation, please find the docs repository.

To contribute to Unity Builder, kindly read the contribution guide.

Support us

GameCI is free for everyone forever.

You can support us at OpenCollective.

Licence

This repository is MIT licensed.

This includes all contributions from the community.