Agent Skills
返回列表
💻

Godot 导出构建

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/godot-export-qonr。

技能介绍

这个技能解决什么问题

用 Godot 打包发布版本时,导出这一步往往比写游戏本身更磨人:导出模板版本对不上编辑器、CLI 里预设名写错直接报错、Web 版打开是空白页、打包后 res:// 变成只读导致存档写不进去……这个技能把 Godot 4.3+ 的导出构建流程梳理成一套可复用的套路,覆盖从安装导出模板到产出可发布构建的完整链路。

核心能力与工作方式

技能的核心是一条清晰的导出流水线:

  • 安装导出模板:通过编辑器菜单 Manage Export Templates 下载,或离线安装 .tpz;模板版本必须与编辑器完全一致,包括 beta/rc 版本。
  • 配置导出预设:在 Project > Export 中按平台(Windows Desktop、macOS、Linux、Web、Android、iOS)设置导出路径、图标、特性开关和资源过滤规则;预设保存在 export_presets.cfg。
  • 两种导出方式:编辑器中用 Export Project(release)或 Export PCK/ZIP;自动化场景用无头 CLI,例如 --export-release "",适合接入 CI。
  • 平台特定处理:Web 构建需要 COOP/COEP 头实现跨源隔离(配合 SharedArrayBuffer);Android 需要配置 SDK/JDK 路径和签名 keystore;macOS/iOS 分发需要签名与公证。
  • 冒烟测试:发布前在目标平台实际运行验证;导出构建中 res:// 只读,写入应走 user://。

适用边界与注意点

  • 技能还提供几个实用模式:CI 友好的无头导出、以无头方式运行项目(专用服务器/测试)、运行时检测构建上下文、选择导出后仍可写的路径。
  • 明确不覆盖的场景:商店发布流程交给 steam-publish / itch-publish;服务端网络代码交给 godot-multiplayer——本技能只负责把服务器以无头方式构建出来。
  • 常见坑都有针对性说明:预设名大小写和空格敏感、Web 构建必须经 HTTP(S) 提供服务、非资源文件(如 .json)需手动加入导出过滤规则、--export-debug 与 release 的区别在于远程调试和调试检查。
  • 关于 export_presets.cfg 结构、CLI 参数、加密和各平台配置的细节,技能指向了一份更深入的参考文档。

使用场景

  • 要把 Godot 4.3 项目导出为 Windows/macOS/Linux 桌面构建,配置导出预设并指定导出路径。
  • 在 CI 流水线里用 `--export-release` 无头导出 release 构建,避免编辑器手动操作。
  • Web 版需要线程,要为服务器配置 COOP/COEP 头以启用 SharedArrayBuffer,避免空白页。
  • 计划无头运行 Godot 服务器或测试,需要正确构建并避开 `res://` 只读写入限制。

适合人员

  • 使用 Godot 4.x 的独立开发者,需要把项目打包成各平台可运行构建。
  • 搭建 CI 的构建工程师,要用命令行自动导出 release 并维护 export presets 配置。
  • 开发网页版多人游戏的开发者,需要处理 COOP/COEP 与服务器无头构建。
  • 维护 Godot 服务器的运维/后端工程师,要用无头方式运行与测试专用服务器。