Chave da Porteira · referência do Módulo 9 (Projeto 6)

Um sertanejo está preso num labirinto de taipa. Ele precisa achar a chave, abrir a porteira e chegar à saída no menor tempo. O labirinto é montado pelo código a partir de um mapa de letras, a câmera vai atrás e acima do personagem, e o melhor tempo fica salvo.

Item	Valor
Ferramenta	Godot 4.7.2 (versão oficial, `Godot_v4.7.2-stable_win64.exe.zip`)
Abrir	no Gerenciador de Projetos, Importar Projeto Existente e escolher esta pasta (a que tem `project.godot`)
Renderizador	Compatibilidade
Tela	800 × 600
Cenas	`inicio.tscn` → `labirinto.tscn` → `fim.tscn`; peças: `jogador.tscn`, `chave.tscn`, `porteira.tscn`, `saida.tscn`
Autoload	`Global` (`scripts/global.gd`): tempo da partida e melhor tempo
Controles	setas ou W A S D (esquerda e direita giram, cima e baixo andam); Espaço, Enter ou clique para começar

Telas

Início: ../../../../recursos/imagens/godot/chave-da-porteira-tela-inicio.png
Perto da chave: ../../../../recursos/imagens/godot/chave-da-porteira-tela-chave.png
Porteira trancada: ../../../../recursos/imagens/godot/chave-da-porteira-tela-trancada.png
Porteira aberta: ../../../../recursos/imagens/godot/chave-da-porteira-tela-aberta.png
Fim: ../../../../recursos/imagens/godot/chave-da-porteira-tela-fim.png
Partida em GIF: ../../../../recursos/imagens/godot/chave-da-porteira.gif
Editor: ../../../../recursos/imagens/godot/captura-godot3d-*.png

Regras

O mapa tem 11 × 11 quadrados de 3 m; as paredes têm 2,5 m de altura (72 paredes).
O jogador anda a 4 m/s e gira 2,5 radianos por segundo (cerca de 143°).
Sem a chave, a porteira bloqueia e avisa "A porteira está trancada. Ache a chave!".
Com a chave, a porteira gira 100° em 0,8 s e deixa passar.
Pisar na saída termina a partida. Menor tempo vence; o primeiro tempo sempre vira o melhor.
A tela de fim só aceita tecla depois de 1 segundo.

Arquivos

Pasta / arquivo	Conteúdo	Origem e licença
`scripts/`	8 scripts em GDScript	escritos para o curso
`cenas/`	7 cenas `.tscn`	escritas para o curso
`materiais/`	9 materiais `StandardMaterial3D` (`.tres`)	escritos para o curso
`modelos/mandacaru.glb`	mandacaru feito de cápsulas, em glTF	gerado por `ferramentas/gerar_mandacaru.gd`; uso livre no curso
`ferramentas/gerar_mandacaru.gd`	script do professor que gera o `.glb`	escrito para o curso

Nenhum recurso de terceiros. Personagem, chave, porteira e saída são formas prontas do Godot. A pasta oculta .godot/ é criada pelo Godot ao importar e não vai para o repositório.

Testes realizados

Data	Teste	Resultado
30/10/2026	importação no Godot 4.7.2 (`--import`) e geração do `mandacaru.glb`	sem erros
30/10/2026	41 verificações automáticas no motor (`testes/godot/testar_porteira.gd`), duas rodadas, sem janela	41 de 41, sem avisos nem erros do Godot
30/10/2026	jogo aberto com janela (renderizador Compatibilidade, OpenGL 3.3, placa Intel Iris Xe) e fotos de cinco telas	ok
30/10/2026	passeio automático do início à saída, gravado com o Movie Maker do Godot (`--write-movie`, 15 quadros por segundo)	chave pega por volta dos 20 s, saída por volta dos 53 s; GIF montado com `modulos/modulo-10-publicacao/ferramentas/quadros_para_gif.py`
30/10/2026	medição de objetos e chamadas de desenho por quadro (Aula 9.7)	146 e 102 com sombra e neblina; 69 e 25 sem
30/10/2026	projeto aberto no editor do Godot 4.7.2; cenas, braço da câmera, porteira, materiais, ambiente, sol e scripts fotografados	ok (capturas em `recursos/imagens/godot/`)

Não testado: exportação para web e Windows (os modelos de exportação não foram baixados); partida jogada por uma pessoa do começo ao fim (o teste e o passeio automático usam teclas simuladas); controle com gamepad e toque (o jogo não tem toque); computadores do laboratório.

Histórico de correções

Primeira foto do jogo: a câmera ficava colada no chapéu (braço de 4 m em corredores de 2 m). Os corredores passaram a 3 m e a câmera foi ajustada em cinco tentativas, todas com foto; a Aula 9.4 conta o caminho.
Chão de areia saindo quase branco e sombras azuladas. Trocado o Tonemap para Linear, a luz ambiente para cor de areia (energia 0,35) e o sol para 0,9.
No primeiro teste, quatro verificações da porteira falharam. O jogo estava certo: o teste colocava o jogador a 2,7 m da porteira, fora da área Perto (2,2 m). O teste passou a usar 1,8 m.

Ideias de evolução

Duas chaves e duas porteiras (Aula 9.6), versão noite com lamparina (Aula 9.7), câmera girada pelo mouse (Aula 9.4), cronômetro com medalhas de ouro, prata e bronze, um cão de guarda como o do Cajueiral.