godot-export-builds

Automates multi-platform Godot exports with headless pipelines, CI workflows, and platform signing scripts.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/DecioLuvier/Shatterless --skill godot-export-builds-decioluvier
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: godot-export-builds
Source: https://github.com/DecioLuvier/Shatterless/tree/main/.claude/skills/godot/references/godot-export-builds
Command: npx skills add https://github.com/DecioLuvier/Shatterless --skill godot-export-builds-decioluvier

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Shipping a Godot game to Windows, Linux, macOS, Android, iOS, or Web involves repetitive export presets, signing credentials, notarization, and CI configuration that are error-prone when done manually through the editor UI. ## Core Features & Use Cases - Headless Export Pipelines: PowerShell and Bash scripts run --headless --export-release builds across multiple presets without opening the editor. - Platform Release Plumbing: Scripts cover Android keystore signing via environment variables, macOS codesign/notarization steps, SteamPipe uploads via steamcmd, and PCK patch loading for delta updates. - CI/CD & Optimization: A GitHub Actions workflow pinned to Godot 4.7 templates, plus build size reports, feature-flag stripping with OS.has_feature, and SCons module stripping for custom templates. - Use Case: A team preparing a Steam release can run the headless pipeline to produce Windows/Linux builds, sync the version string from git tags, and upload depots with the SteamPipe script using credentials from environment variables. ## Quick Start Ask the agent to set up a headless CI export pipeline for your Godot 4.7 project targeting Windows and Web with release templates.

Frequently Asked Questions about godot-export-builds

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export a Godot game from the command line?▼

Run godot with --headless --export-release followed by the preset name and output path, for example godot --headless --export-release "Windows Desktop" builds/game.exe. The skill provides PowerShell and Bash scripts that loop over multiple presets automatically.

How to set up Godot CI/CD with GitHub Actions?▼

Use the included export_ci_github_actions.yml workflow, which checks out the repo, downloads Godot 4.7 editor and export templates, runs the export, and uploads artifacts with actions/upload-artifact@v4. Presets must match your export_presets.cfg.

How do I sign an Android release build in Godot without committing the keystore?▼

Inject keystore path, alias, and password through environment variables using the export_android_signing_env.ps1 script, and reference those variables in the export preset. Never commit keystore files or passwords to the repository.

Does macOS distribution require notarization for Godot games?▼

Yes, direct distribution outside the Mac App Store requires codesigning with a Developer ID and notarization via xcrun notarytool, or Gatekeeper will block the app. Steam or App Store distribution can substitute for this requirement.

How do I reduce Godot export build size?▼

Exclude authoring files like .md and .psd through export filters, use release templates instead of debug, enable VRAM compression appropriate to the platform, and optionally strip unused engine modules with the SCons custom build script.

Can Godot export patches or DLC without rebuilding the full game?▼

Yes, export a PCK file and mount it at runtime with ProjectSettings.load_resource_pack(path, true), which lets same-path resources override the base pack. The export_pck_patch_loader.gd script implements this delta update pattern.