Godot 持续集成工具
为 Godot 项目提供持续集成支持,辅助自动构建与发布流程
🧠 在 AI 创作链路中的位置
位于游戏工程与发行链路中,自动化执行项目构建和验证任务。
所属阶段:🛠️ 工程 · 传统工具,负责把 AI 产物打磨/接入到可交付的管线里
工具介绍
godot-ci 是面向 Godot 的持续集成工具,用于将游戏项目接入自动化构建与测试流程。它适合需要反复导出、验证和发布项目的开发者与团队,具体能力取决于部署配置。
核心能力
- 面向 Godot 项目
- 支持持续集成流程
- 可衔接自动构建与测试任务
👍 优点
- 有助于减少重复发布操作
- 适合建立稳定的项目交付流程
⚠️ 局限
- 需要配置持续集成环境
- 社区项目,文档与支持有限
典型使用场景
- 为 Godot 游戏设置自动构建流程
- 在提交后自动导出并验证游戏版本
使用教程
- 1
准备项目与发布凭据
在本地创建 Godot 项目并确认可正常运行;进入 GitHub 或 GitLab 仓库的 Settings、Secrets,添加 Itch.io API Key 等发布凭据。
- 2
配置容器导出参数
依据仓库文档编写 Docker 导出配置,指定 Godot 版本、导出预设、项目目录和产物路径;先用本地命令验证镜像能够生成游戏。
- 3
接入 GitHub Actions
在仓库 Actions 页面新建工作流,复制 godot-ci 的 GitHub Actions 模板,填写导出配置与 Secrets 名称,并确认构建产物上传步骤。
- 4
或接入 GitLab CI
打开 GitLab 项目的 CI/CD 页面,复制仓库提供的 GitLab CI 模板并加入 .gitlab-ci.yml,在 Variables 中配置同名凭据后提交。
- 5
运行并检查导出产物
提交配置文件触发流水线,在 Actions 的运行记录或 GitLab CI 页面查看日志,确认导出成功、压缩包生成且下载产物与预期一致。
- 6
启用自动部署
按目标启用 GitHub Pages、GitLab Pages 或 Itch.io 模板,填写站点路径与上传信息;重新运行流水线,检查公开地址或游戏页面。
💡 实用技巧
- 固定 Godot 镜像版本,避免升级后导出失败
- 先手动导出一次,再接入自动流水线
- 密钥只放在 Secrets 或 Variables 中
- 为 Pages 配置正确的站点基础路径
⚠️ 常见坑
- 导出预设名称与配置文件不一致会失败
- 首次触发流水线前必须提交模板文件
完整图文教程:Godot CI 入门:容器化导出与发布
📖 同类工具怎么选
本分类覆盖从游戏导出、平台提交到上线运营的发行链路。选择时应先确认目标市场、DRM政策、商店分成与开发者资质,再结合引擎和自动化需求选用 Steamworks、Epic、Game Jolt 或 GOG,并用 Godot 官方文档及 godot-ci 打通构建与部署。
阅读《独立游戏发行与平台接入指南》