About this project
godot-ci is a Docker image and set of CI/CD templates designed to automate the export of Godot Engine games. It provides ready-to-use configuration files for GitLab CI and GitHub Actions, enabling developers to build and deploy their games to GitLab Pages, GitHub Pages, and Itch.io without manual steps.
The repository includes reference `.gitlab-ci.yml` and `.github/workflows/godot-ci.yml` files, along with a test project and live examples. It supports multiple export targets, including standard Godot exports, Mono/C# builds, and Android APK generation with custom keystores. For Android, it explains how to securely store keystore credentials as CI variables and use them in the build process.
For advanced use cases, the documentation points to external resources for GDNative/C++ compilation and custom Godot builds with modules. iOS export is noted as not yet available.
The README provides detailed setup instructions, including environment variable configuration for GitHub Pages (e.g., REMOTE_URL, GIT_EMAIL, GIT_USERNAME) and Itch.io deployments via Butler (ITCHIO_USERNAME, ITCHIO_GAME, BUTLER_API_KEY). Troubleshooting tips cover common issues like missing export presets, mismatched preset names, and authentication errors with Butler.
Overall, godot-ci simplifies the process of setting up continuous integration and delivery for Godot projects, making it easier for developers to distribute their games across multiple platforms.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.