convez.ai
AgenteDevOps & InfraestruturaIntermediário
gregjoeval

Godot Template com Integração Claude Code

gregjoeval/godot-template

Template Godot 4.x com IA, testes e DevOps integrados

Ver no GitHub
InicialPluginScore · de 0 a 100

Template Copier para scaffolding de projetos Godot 4.x production-ready com tipagem estrita, testes automatizados, CI/CD completa e integração nativa com Claude Code agents. Inclui 12 pré-commit hooks, GitHub Actions, gdUnit4 testing framework e suporte opcional a multiplayer com NetworkManager.

Instalação

$npx convez-ai gregjoeval/godot-template

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Iniciar novos projetos Godot com arquitetura production-ready
  • Configurar CI/CD e quality gates automáticos para equipes de game dev
  • Integrar Claude Code agents para acelerar desenvolvimento GDScript
  • Implementar multiplayer com padrões server-authoritative

Veredito

Solução madura e bem-estruturada que elimina boilerplate repetitivo em projetos Godot. A integração com Claude Code agents e automation completa (pre-commit, CI/CD, testing) o torna especialmente valioso para equipes que priorizam qualidade e velocidade de entrega.

README

A tradução para o português deste README ainda está na fila.

godot-template

A Copier template that scaffolds production-ready Godot 4.x game projects with strict typing, automated testing, CI/CD, and optional multiplayer support.

What You Get

  • GDScript strict typing enforced by Godot's built-in type checker
  • gdtoolkit linting and formatting (100-char line limit)
  • gdUnit4 test framework with helpers and TDD workflow
  • 12 pre-commit hooks covering format, lint, type check, scene normalization, and more
  • GitHub Actions CI gate (lint, type check, smoke test, gdUnit4, scene normalization) with change detection
  • GitHub Actions build workflow for Linux/Windows exports
  • Claude Code integration with agent definitions, skills, safety hooks, and a comprehensive CLAUDE.md
  • Conventional commits via commitizen with version bumping
  • Makefile with test, test-single, lint, check, bump targets
  • Optional multiplayer scaffolding with server-authoritative NetworkManager and RPC patterns

Prerequisites

  • Python 3
  • Copier 9+
  • Godot 4.x
  • Git

Quick Start

uvx copier copy gh:gregjoeval/godot-template my-game
cd my-game

Follow the setup instructions in the generated README.md to install git hooks and tooling.

To pull template updates into an existing project:

uvx copier update

Template Options

VariableTypeDefaultDescription
project_namestrMy Godot GameHuman-readable project name
project_slugstr(derived from name)Kebab-case slug for directories and build artifacts
multiplayerboolfalseInclude NetworkManager autoload and RPC scaffolding
godot_versionstr4.6Godot version (must be 4.x)

Generated Project Structure

my-game/
  .claude/             # Claude Code agents, skills, hooks, settings
  .github/workflows/   # CI gate + build/export
  docs/                # GDScript conventions, testing conventions, decisions, principles
  scenes/              # Godot scenes (main.tscn)
  scripts/
    tools/             # Quality-gate scripts (type check, lint, normalize, etc.)
    network/           # NetworkManager (multiplayer only)
  tests_gdunit4/       # gdUnit4 tests and helpers
  .pre-commit-config.yaml
  CLAUDE.md
  Makefile
  project.godot
  pyproject.toml

Quality Gates

Generated projects include 12 pre-commit hooks:

godot-normalize · nested-generics · preload-shadows · no-warning-ignore · type-narrowing · gdformat · gdlint · shader-no-return · gdtypecheck · gdtest · commitizen

See the generated docs/gdscript-conventions.md for details on the rules these enforce.

Template Development

To test the template locally:

uvx copier copy --defaults --trust . /tmp/test-output

The template's own CI (.github/workflows/template-test.yml) generates projects with both multiplayer=false and multiplayer=true, then runs type checks, linting, and gdUnit4 tests on each.

Ver o original no GitHub

Bom para