Godot: CI/CD — build HTML5 headless + deploy a GitHub Pages

[leocagli]

Objetivo

Crear un workflow de GitHub Actions que construya automáticamente el juego como HTML5 con Godot 4 headless y lo despliegue en GitHub Pages.

Alcance

• Job build: instala Godot 4 headless + plantilla de exportación HTML5, exporta a dist/
• Job deploy: sube dist/ a la rama gh-pages (o usa actions/deploy-pages)
• Reemplaza el redirect actual en index.html raíz apuntando al nuevo build
• Se ejecuta en push a main y en pull requests (build only, sin deploy)
• Cache de la instalación de Godot para acelerar runs posteriores

Referencia

Patrón de scripts existente en scripts/ del repositorio; acción oficial chickensoft-games/setup-godot.

Tareas

• Crear .github/workflows/godot-build.yml con triggers push: [main] y pull_request
• Step setup-godot: usar chickensoft-games/setup-godot@v1 con versión 4.x y plantilla HTML5
• Step export: godot --headless --export-release "HTML5" dist/index.html
• Step deploy (solo en main): peaceiris/actions-gh-pages@v3 con publish_dir: dist
• Actualizar index.html raíz para que redirija a dist/ en lugar del demo JS actual
• Añadir badge de build en README.md

Aceptación

Cada push a main genera un nuevo build HTML5 en GitHub Pages en menos de 5 minutos y el juego es accesible en la URL pública del repo sin pasos manuales.

🎁 Evidencia = reward mayor

• Si tu PR incluye capturas de pantalla mostrando esto andando end to end, entra a reward de GrantFox en esta issue.
• Si además sumás un video demo corto, califica para reward mayor.
• No es obligatorio, pero pesa mucho en la evaluación.

Qué conviene mostrar en esta issue:

• Captura del run verde de godot-build.yml en Actions con los jobs build y deploy y el tiempo total por debajo de 5 minutos.
• Captura del juego cargado desde la URL pública de GitHub Pages con la barra de direcciones visible.
• Captura de un run disparado por pull request donde se ve que corre solo el build y el deploy queda salteado.

Pegá las capturas directo en la descripción del PR, arrastrándolas al cuadro de texto de GitHub.

[Vinaystwt]

I can take this.

I’ll add a GitHub Actions workflow that installs/caches Godot 4 headless, imports the HTML5 export template, builds the project into dist/, and deploys it to GitHub Pages from main. I’ll also make sure pull requests run the build without deployment, add/adjust the root redirect to point to the latest exported build, and document the workflow/badge in the README.

I’ll keep the workflow scoped and use the existing repository scripts/patterns where available.

[leocagli]

✅ Accepted — interested contributors:

• @Vinaystwt 🥇
• @Peolite001 (flagged: automated claiming, requires review)

First quality PR referencing #48 (green CI, scope matches title) gets merged. Comment /unassign to release.

[BigJohn-dev]

Allow me fix this ASAP