O teu primeiro modelo
Dez minutos, do início ao fim: desenha algo, dá-lhe espessura, e obtém um .glb que o teu jogo pode carregar.
1. Começar um projeto
O Flatty abre num selecionador. Lista os projetos que abriste antes — por isso numa execução genuinamente primeira é vazio, enquanto o de baixo já foi usado uma vez.
Carrega em Novo projeto. O navegador de ficheiros abre, e quer uma coisa: a pasta onde o teu projeto vai viver.
Navega até onde guardas o teu trabalho, depois digita um nome na linha sob a listagem — nuvem fofa serve — e carrega em Criar. Cria uma pasta com esse nome dentro daquela em que estás, que é tudo o que é um projeto.
A linha no fundo explica exatamente o que vai ser escrito, por isso nunca há adivinhação:
-> /home/you/sprites/fluffy cloud/project.fdraw
A pasta é o projeto. Não há biblioteca nem base de dados: um projeto é qualquer pasta contendo um ficheiro
project.fdraw, e pode estar em qualquer lado. Move-o, copia-o, coloca-o num pen drive — continua um projeto. O nome no painel Projeto é teu para mudar sempre que quiseres.
2. Desenhar algo
Está a ver a tela, grande e no canto superior esquerdo, com as ferramentas, as cores e a lista de camadas numa faixa por baixo. À direita estão as duas vistas do que está a fazer: o modelo em cima e o seu desenho de linhas por baixo. Pinte na tela com o botão esquerdo do rato.
Desenha um blob sólido — uma nuvem, um rosto, um escudo, o que quiseres. Mantém simples e mantém tocando o fundo da tela se é uma personagem; é aí que vai o pivo do modelo, por isso uma personagem desenhada na borda inferior fica em pé no chão no teu jogo.
Algumas coisas a experimentar logo:
| Faz isto | Obtém isto |
|---|---|
| [ e ] | pincel mais pequeno e maior |
| Ctrl+arrastar | pintar com a segunda cor |
| Shift+arrastar | apagar de volta para transparente |
| Alt+clique | tirar uma cor da tela |
| G, depois clica | inundar uma zona com enchimento |
| U | formas — uma linha, uma caixa, uma elipse, um polígono |
| S, ou o botão direito na tela | o Canivete Suíço — cores, ferramentas e camadas sob o cursor |
| Ctrl+Z | desfazer |
| Ctrl+P | pedir qualquer coisa pelo nome — cada painel e cada comando |
Esse último vale a pena experimentar cedo. A maioria do que Flatty pode fazer vive num painel que ainda não colocaste no ecrã, e a paleta de comandos é como o encontras sem ter aprendido onde está.
Observa o painel direito enquanto trabalhas. O modelo é reconstruído enquanto desenhas — nunca estás à espera de uma pré-visualização.
3. Dar profundidade
O modelo é atualmente uma laje plana. Muda isso no painel Camadas.
Clica no separador de título de qualquer painel — a pequena etiqueta preenchida no seu canto superior esquerdo, lendo Tela 2D com um ponto de intercalação depois — e escolhe Camadas. Acima da lista de camadas há um cartão para a camada em que estás, e o seu primeiro controlo deslizante é Profundidade. Arrasta-o e observa a forma sair.
O deslizador por baixo é a outra metade do que transforma uma pilha de camadas em relevo. Desvio Z move a laje desta camada para frente ou para trás através do volume, por isso um nariz pode ficar em frente de um rosto em vez de dentro dele.
Dois números mais, vale a pena um momento, ambos no painel Projeto:
- Paredes laterais → Sombrear escurece a cor dos lados extrudidos em relação à face frontal. Mais baixo é mais escuro. Isto é o que impede um modelo parecer um adesivo.
- Colocação no mundo → Px / unidade define a escala: em 16, um sprite de 64 pixels tem 4 unidades de mundo de largura.
4. Observar apropriadamente
No painel 3D, arrastra com o botão esquerdo para orbitar, usa a roda para te aproximares, e arrastra com o botão do meio para deslocar. O ícone no canto denominado Órbita livre muda para um ângulo fixo — frente, trás, esquerda, direita, topo ou isométrico — que é a forma honesta de verificar uma silhueta.
O terceiro ícone ao longo dessa linha é como o modelo é sombreado. Flatty são as tuas cores exatamente como as pintaste, e é para o qual deves voltar antes de decidir que uma sombra está errada; os três ao lado são formas estilizadas de ver o mesmo modelo, e as imagens neste livro usam uma delas.
Não importa qual escolhas, a exportação não é afetada — ver A vista 3D.
5. Guardar e exportar
Ctrl+S guarda o projeto. Ctrl+E exporta o modelo. Tudo o que sai de um desenho tem um botão próprio no painel Exportação, que a chave de configuração no canto inferior direito da janela te colocará para fora.
A tua pasta de projeto agora parece assim:
fluffy cloud/
project.fdraw the drawing — this is your work
exports/
2026-08-21_144312_fluffy_cloud.glb an archive, never overwritten
2026-08-21_144312_fluffy_cloud.meshes.json
latest/
fluffy_cloud.glb the one your game loads
fluffy_cloud.meshes.json
Cada exportação é escrita duas vezes. Uma vez com um carimbo de tempo que nunca é substituído, por isso uma semana de trabalho ainda está lá para voltares. E uma vez em latest/ sob um nome fixo, porque o caminho no código do teu jogo não pode mudar cada vez que carregas em exportar.
6. Carregar no teu jogo
m := rl.LoadModel("sprites/fluffy cloud/exports/latest/fluffy_cloud.glb")
// A uma linha que tens de adicionar: o ficheiro pede filtragem de vizinho mais próximo,
// mas o carregador glTF do raylib não aplica esse pedido, por isso os teus pixels saem
// desfocados a menos que o digas novamente aqui.
for _, mat := range m.GetMaterials() {
if tex := mat.GetMap(rl.MapAlbedo).Texture; tex.ID != 0 {
rl.SetTextureFilter(tex, rl.FilterPoint)
}
}
rl.DrawModel(m, playerPos, 1, rl.White) // o pivo está incorporado — nenhum desvio necessário
Isto é toda a integração. Nenhuma etapa de conversão, nenhuma definição de importação, nenhum material a reconstruir.
Para onde ir em seguida
- Camadas e profundidade — o capítulo que faz as formas deixarem de parecer lajes
- Arte em linha — o mesmo modelo traçado como SVG, seis formas diferentes. Ninguém espera por este
- Cor — as duas cores, a roda, paletas e transparência
- Exportar para o teu jogo — pivôs, escala, Blender, e o que realmente está no ficheiro