Módulo 9 · Aula 9.2 · Formas prontas, materiais e modelos com licença

Objetivos de aprendizagem

1. Montar objetos com as formas prontas do Godot (BoxMesh, SphereMesh, CapsuleMesh, CylinderMesh, PlaneMesh, TorusMesh).
2. Criar e salvar um material (StandardMaterial3D) e mudar cor, aspereza, metal, emissão e transparência.
3. Trazer um modelo .glb para o projeto e usá-lo várias vezes.
4. Ler a licença de um modelo de terceiros e registrar os créditos.

Pré-requisitos

Aula 9.1.

Materiais

Godot 4.7; exemplos/laboratorio-3d (cena materiais.tscn); projeto chave-da-porteira (pastas materiais/ e modelos/).

Conceitos

Malha (mesh) e nó. O MeshInstance3D é o nó; a malha é a forma que ele mostra. O Godot já traz formas prontas: caixa, esfera, cápsula, cilindro, plano e rosca (TorusMesh). O sertanejo do Chave da Porteira é feito só delas: cápsula (corpo), esfera (cabeça), caixa (nariz) e dois cilindros (chapéu).

Material. A malha diz a forma; o material diz a aparência. O StandardMaterial3D tem dezenas de opções; cinco bastam para começar:

Material em arquivo. Salvo como .tres (como o Resource da Aula 8.8), o mesmo material serve para muitos objetos. Mudou o arquivo, mudam todos. O Chave da Porteira tem nove materiais na pasta materiais/.

Modelo pronto. Formas mais complicadas (uma árvore, uma casa) vêm em arquivos de modelo. O formato recomendado pelo Godot é o glTF (.glb ou .gltf). Ao copiar o arquivo para a pasta do projeto, o Godot importa sozinho, e o modelo passa a funcionar como uma cena: dá para instanciar quantas vezes quiser.

O mandacaru do curso. O arquivo modelos/mandacaru.glb foi gerado por um script do próprio curso (ferramentas/gerar_mandacaru.gd): cinco cápsulas verdes salvas em glTF. É o mesmo tipo de arquivo que se baixa de um banco de modelos ou se exporta do Blender (Aula 9.8). Uso livre no curso.

Licença. Modelo achado na internet não é "de graça" só porque dá para baixar. Antes de usar, leia a licença:

Bancos conhecidos de modelos para jogos: Kenney (kenney.nl, que informa licença CC0 nos seus pacotes) e Quaternius (quaternius.com). Nesta versão do curso nenhum modelo foi baixado deles: confira a licença na página de cada pacote no dia em que for usar.

Arquivo de créditos. Todo projeto que usar algo de terceiros tem um CREDITOS.md com: nome do recurso, autor, link, licença e data em que foi baixado. É o mesmo cuidado do Módulo 5 com desenhos e do Módulo 7 com sons.

Exemplos

Na cena materiais.tscn, cinco esferas iguais com materiais diferentes, e um sol que dá a volta em 8 segundos:

Tutorial passo a passo

Parte A. Olhar materiais (60 min)

1. No laboratório, rode materiais.tscn. Observe cada esfera enquanto o sol gira. Qual muda mais? Qual quase não muda? (A de emissão brilha sozinha.)
2. No projeto chave-da-porteira, aba Arquivos, pasta materiais: dois cliques em taipa.tres. O Inspetor mostra a esfera de prévia e as seções Albedo, Metallic, Roughness, Emission. Compare com ouro.tres.

Parte B. Fazer o seu material (120 min)

3. Na sua cena da Aula 9.1, selecione o cubo. No Inspetor, abra Mesh → Material (ou Surface Material Override) e escolha New StandardMaterial3D.
4. Mude Albedo → Color, depois Roughness e Metallic. Execute.
5. Clique na setinha do material → Salvar e grave como materiais/meu_material.tres. Use o mesmo arquivo em outro objeto.

Parte C. Montar um objeto com formas (120 min)

6. Monte uma "cadeira de balanço", um "pote de barro" ou um "pé de mandacaru" só com formas prontas e materiais. Mínimo: quatro formas e dois materiais.
7. Clique com o botão direito no nó raiz do objeto → Salvar Ramo como Cena... para virar uma cena reutilizável.

Parte D. Modelo .glb e licença (100 min)

8. Abra cenas/labirinto.tscn do Chave da Porteira. Os seis Mandacaru dentro de Enfeites são o mesmo arquivo modelos/mandacaru.glb.
9. Copie mandacaru.glb para o seu projeto (pela aba Arquivos ou pelo Windows). Arraste o arquivo para a janela 3D: aparece um mandacaru. Arraste mais dois.
10. Leia, em dupla, a licença de um pacote de modelos de um dos bancos citados (o professor projeta a página). Escrevam o CREDITOS.md como se fossem usar um modelo dele.

Imagens

• ../../../recursos/imagens/godot/laboratorio-3d-tela-materiais.png: as cinco esferas com os rótulos.
• ../../../recursos/imagens/godot/captura-godot3d-material-taipa.png: o material da parede no Inspetor.
• ../../../recursos/imagens/godot/captura-godot3d-material-ouro.png: o material da chave, com reflexo de metal na prévia.
• ../../../recursos/imagens/godot/captura-godot3d-jogador.png: o sertanejo feito de formas prontas.

Indicação da interface

O texto New StandardMaterial3D, Salvar Ramo como Cena..., Tornar Único e os nomes da janela do .glb foram lidos das traduções do Godot 4.7.2. A janela do .glb, o menu do botão direito e o arrastar para a janela 3D não foram fotografados.

O código completo

chave-da-porteira/materiais/ouro.tres (um material salvo é um arquivo de texto):

[gd_resource type="StandardMaterial3D" format=3]

[resource]
albedo_color = Color(0.95, 0.76, 0.19, 1)
metallic = 0.9
roughness = 0.25

Trecho de chave-da-porteira/ferramentas/gerar_mandacaru.gd (só para o professor; o aluno não precisa escrever isto):

var documento := GLTFDocument.new()
var estado := GLTFState.new()
var erro := documento.append_from_scene(raiz, estado)
if erro == OK:
	erro = documento.write_to_filesystem(estado, "res://modelos/mandacaru.glb")

Explicação do código

• O .tres guarda só o que mudou do padrão: cor, metal e aspereza.
• GLTFDocument é a parte do Godot que lê e escreve glTF. O script monta o mandacaru com cápsulas e salva tudo num .glb. Para rodar: Godot --headless --path . -s ferramentas/gerar_mandacaru.gd.

Resultado esperado

Um objeto montado com formas e materiais próprios, um material salvo e reutilizado, três mandacarus vindos do mesmo .glb e um CREDITOS.md de exemplo.

Problemas comuns

Exercício guiado

Por que o curso salvou os materiais em arquivos .tres em vez de criar um material dentro de cada parede? (Resposta: as 72 paredes usam o mesmo material; mudando o arquivo, todas mudam juntas, e o Godot desenha mais rápido quando os objetos repetem material, como mostra a Aula 9.7.)

Desafio individual

Crie um material "barro molhado": cor de barro, Roughness baixo. Compare com o barro seco (Roughness 1).

Desafio avançado (opcional)

Faça uma lamparina: um cilindro com material de emissão amarelo e uma OmniLight3D dentro. A chave do Chave da Porteira usa esse truque (nó Brilho).

Critérios de avaliação

• Objeto com pelo menos quatro formas e dois materiais.
• Material salvo e reaproveitado.
• CREDITOS.md com os cinco campos.

Checklist de conclusão

• Comparei as cinco esferas
• Criei e salvei um material
• Montei um objeto com formas prontas
• Usei o mandacaru .glb três vezes
• Escrevi um CREDITOS.md

Extensão

Procure em casa três objetos e diga, para cada um, que Roughness e Metallic você usaria.