mlm-games/Build Godot Action

Build a Godot project for multiple platforms

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jun 29, 2026
License
GPL 3.0

Pinned Snippet

workflow.ymlSHA-pinned
uses: mlm-games/godot-build-action@d8d3b12df9bef83adf3221a19770b1cd4eb675ed # v1.3.1

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
EXPORT_PRESET_NAMEName of the preset in export_presets.cfg to use (e.g., "Windows Desktop", "Linux/X11", "macOS", "Android arm64")yes
GODOT_VERGodot version to use (e.g., 4.5-stable). If empty, latest stable 4.x is used.no""
PROJECT_DIRLocation of the Godot project in the repositoryno.
DEBUG_MODEUse --export-debug instead of --export-releasenofalse
GODOT_PREVIEW_BUILDSUse Godot preview builds (from godot-builds repo)nofalse
BUTLER_UPLOADUpload to itch.io using butlernofalse
BUTLER_CREDENTIALSButler API key (itch.io)no""
ITCH_USER_SLASH_GAMEItch.io target in the format "user/game"no""
RELEASE_KEYSTOREEncrypted/armored release keystore (Android). Will be decrypted using KEYSTORE_PASSPHRASE.no""
KEYSTORE_PASSPHRASEPassphrase used to decrypt the keystoreno""
KEY_ALIASAndroid signing key aliasno""
KEY_PASSWORDAndroid signing key passwordno""
EXPORT_DIRDirectory to export files into (relative to project dir)nobuilds
INSTALL_BLENDERInstall Blender (for .blend imports)nofalse
BLENDER_VERSIONBlender version to install (e.g., 3.6.5 or 4.4.3)no4.4.3
IMPORT_TIMEOUTTimeout for import process in minutesno60
VERBOSE_IMPORTEnable verbose output during importnotrue
ANDROID_SDK_API_LEVELAndroid platform API level to install (e.g., 35)no35
ANDROID_BUILD_TOOLSAndroid Build-Tools version to install (e.g., 35.0.0)no35.0.0
ANDROID_NDK_VERSIONAndroid NDK version to install (r28b recommended for Godot 4.5)no28.1.13356709
namedescription
buildPath to the build output directory
version_nameVersion name from export_presets.cfg
version_codeVersion code from export_presets.cfg