Files

T

mr.zeroandClaude Fable 5 463cce6a52 Add CI builder image and use it in the pipeline

builder.Dockerfile bakes the build step's dependencies into
git.teletype.hu/internal/* so the pipeline no longer installs
packages on every run.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-31 19:17:14 +02:00

2.5 KiB

Raw Blame History

godot-tools

CI/CD templates for Godot (4.x) game projects, in the same spirit as ebitengine-tools and tic80-tools.

example-makefile.make — project Makefile: local dev targets (build, run, web, export, watch, clean) plus the Woodpecker pipeline targets (ci-version, ci-export, ci-upload, ci-update).
example-woodpecker.yaml — Woodpecker pipeline: version → build (headless web export in the barichello/godot-ci image) → upload (scp to the droparea) → update (calls the teletypegames /update endpoint with platform=godot).
example-export_presets.cfg — minimal export_presets.cfg with the Web preset the Makefile exports. Threads are disabled (variant/thread_support=false, Godot 4.3+) so the build runs without COOP/COEP (cross-origin isolation) headers.
example-tasks.json — VS Code .vscode/tasks.json with the common dev tasks: Run (godot --path ., default build task, Cmd+Shift+B), Edit, Export Web and Make build.

Usage in a game repo

Copy example-makefile.make to Makefile and set PROJECT (the web build is packaged as $(PROJECT)-$(VERSION).html.zip).
Copy example-export_presets.cfg to export_presets.cfg (or merge the Web preset into your existing presets). Keep the preset name in sync with EXPORT_PRESET in the Makefile.
Copy example-woodpecker.yaml to .woodpecker.yaml and add the droparea_ssh_password / update_secret_key secrets in Woodpecker. Match the godot-builder image tag to the Godot version the project is made with (e.g. 4.6) — the underlying barichello/godot-ci image ships the matching export templates.
Copy example-tasks.json to .vscode/tasks.json.

The pipeline uploads $(PROJECT)-$(VERSION).html.zip to the droparea, then triggers /update?platform=godot&name=$(PROJECT)&version=$(VERSION).

Builder image

builder.Dockerfile wraps barichello/godot-ci (editor + web export templates) with make/zip preinstalled as git.teletype.hu/internal/godot-builder, so the build step no longer runs apt-get on every run. The tag tracks the Godot version:

docker build --platform linux/amd64 -f builder.Dockerfile \
  --build-arg GODOT_VERSION=4.6 \
  -t git.teletype.hu/internal/godot-builder:4.6 .
docker push git.teletype.hu/internal/godot-builder:4.6

Detailed documentation lives on the wiki: /development/godot.

2.5 KiB Raw Blame History

godot-tools

Usage in a game repo

Builder image

2.5 KiB

Raw Blame History