gamedev-skills/awesome-gamedev-agent-skills / skills/godot/godot-export
godot-export
VerifiedExports Godot 4.7 projects: templates, export_presets.cfg for desktop, Web and Android, command-line exports and web COOP/COEP headers. Use on "No export template found", a blank web build, a SharedArrayBuffer error or files missing after export. Not for tests in CI (`godot-gdscript-headless-testing`), store uploads (`steam-publish`, `itch-publish`) or netcode (`godot-multiplayer`).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.9 KB |
| references/presets-and-cli.md | markdown | 5.1 KB |
references/presets-and-cli.md
View on GitHub# Export presets & CLI reference (Godot 4.7)
Depth companion to `godot-export`.
Contents: export_presets.cfg; Useful command-line flags; Custom feature tags; Web (HTML5)
specifics; Android; macOS / iOS; PCK patching & DLC; Encryption.
## export_presets.cfg
Generated/edited by *Project > Export*; commit it so CI and teammates share presets. It is
an INI-style file with a `[preset.N]` block per preset and a matching `[preset.N.options]`
block. Example shape (do not hand-author from scratch — let the editor create it):
```ini
[preset.0]
name="Windows Desktop"
platform="Windows Desktop"
runnable=true
export_path="build/windows/game.exe"
custom_features=""
exclude_filter=""
include_filter=""
[preset.0.options]
binary_format/embed_pck=false
application/icon="res://icon.ico"
application/product_name="My Game"
codesign/enable=false
```
Godot 4.7 stores ordinary, shareable export settings in `export_presets.cfg` and
confidential options (keystore passwords, encryption keys) in
`.godot/export_credentials.cfg`. Keep the credentials file out of version control;
provide it securely or inject the required secrets in CI rather than committing them.
## Useful command-line flags
```
godot --headless run without a window/GPU
--path <dir> project directory (where project.godot is)
--export-release "<preset>" <out> export a release build
--export-debug "<preset>" <out> export a debug build
--export-pack "<preset>" <out> export only the .pck/.zip data (extension decides)
--export-patch "<preset>" <out> export only files changed vs. the base packs
--patches <a.pck,b.pck> base packs for --export-patch (comma-separated)
--install-android-build-template install the Gradle template before exporting
--quit-after <frames> auto-quit after N main-loop iterations (smoke tests)
--main-pack <file.pck> run a specific data pack
--verbose detailed logging
-- <args> pass args to your game (OS.get_cmdline_user_args())
```
Use the exact preset `name` (case/space-sensitive). Run from the project dir or pass
`--path`. Exit code is non-zero on export failure — check it in CI.
## Custom feature tags
Add tags under a preset's *Features* (or `custom_features`) and branch at runtime with
`OS.has_feature("tag")`. Common built-ins: `web`, `windows`, `macos`, `linux`, `android`,
`ios`, `mobile`, `pc`, `debug`, `release`, `editor`, `template`, `dedicated_server`,
`64`/`32`. Use a `demo` tag to ship a content-limited build from the same project.
## Web (HTML5) specifics
- Output is `index.html` + `.js`/`.wasm`/`.pck`. Serve over HTTP(S).
- *Thread Support* (`variant/thread_support`) is **off by default** since 4.3; a
single-threaded build runs on any static host. Threaded builds need **cross-origin
isolation**:
- `Cross-Origin-Opener-Policy: same-origin`
- `Cross-Origin-Embedder-Policy: require-corp`
Without these, `SharedArrayBuffer` is unavailable and the engine errors or falls back.
- itch.io: enable "This file will be played in the browser" and the SharedArrayBuffer
support option. GitHub Pages can't set the headers — keep threads off, use a host that
can, or enable the PWA option *Ensure Cross Origin Isolation Headers*, whose service
worker adds them.
- Reduce size: enable compression, trim unused features, and consider the
"Extensions Support" toggle only if needed.
## Android
- Set Android SDK + OpenJDK paths in Editor Settings > Export > Android.
- Install the Android build template (Project > Install Android Build Template) for custom
Gradle builds / plugins.
- Provide a **debug keystore** (auto for debug) and a **release keystore** for store
builds. Add the `INTERNET` permission for networked games.
- Choose architectures (arm64-v8a is standard for modern devices).
## macOS / iOS
- macOS distribution: enable codesign, provide an Apple Developer ID, and notarize the
`.app`/`.dmg`; otherwise Gatekeeper blocks it.
- iOS: exports an Xcode project; build/sign/submit through Xcode.
## PCK patching & DLC
Export extra content as a separate `.pck` and load it at runtime:
```gdscript
var ok := ProjectSettings.load_resource_pack("user://dlc1.pck") # mounts into res://
```
A patch pack can override or add files. Use `--export-pack` to produce packs in CI, or
`--export-patch "<preset>" out.pck --patches base.pck` to pack only files that changed since
the base pack.
## Encryption
PCK encryption does **not** work with the official templates: the game fails to load its
data at startup. You must compile your own export templates with the same key in the
`SCRIPT_AES256_ENCRYPTION_KEY` environment variable and select them as custom templates.
Then set the 64-hex-char key in the preset's *Encryption* tab (or
`GODOT_SCRIPT_ENCRYPTION_KEY` for CLI exports), enable "Encrypt Exported PCK", and add
include filters — with empty filters nothing is encrypted. Client-side encryption deters casual
inspection but cannot fully protect assets on a user's machine — don't store true secrets
in the build.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |