Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Aprendendo novas funcionalidades

Godot is a feature-rich game engine. There is a lot to learn about it. This page explains how you can use the online manual, built-in class reference, and join online communities to learn new features and techniques.

Fazendo a maior parte deste manual

O que você está lendo agora é o manual do usuário. Ele documenta cada um dos conceitos da engine e recursos disponíveis. Ao aprender um novo tópico, você pode começar navegando na seção correspondente deste site. O menu à esquerda permite explorar tópicos amplos, enquanto a barra de pesquisa o ajudará a encontrar páginas mais específicas. Se existir uma página para um determinado tema, ela geralmente será vinculada a um conteúdo relacionado.

O manual tem uma referência de classe complementar que explica as funções e propriedades disponíveis de cada classe do Godot enquanto você programa. Embora o manual cubra recursos gerais, conceitos e como usar o editor, a referência é sobre o uso da API de script (Application Programming Interface) do Godot. Você pode acessá-lo online e offline. Recomendamos navegar pela referência off-line, no editor Godot. Para fazer isso, vá em Ajuda -> Buscar Ajuda ou pressione F1.

Para navegar por ela online, vá para a seção Referência de Classes do manual.

A página de referência de classe informa:

1. Onde a classe existe na hierarquia de herança. Você pode clicar nos links superiores para ir para as classes pai e ver as propriedades e métodos que um tipo herda.

   

2. Um resumo da função e dos casos de uso da classe.

3. Uma explicação das propriedades, métodos, sinais, enumerações e constantes da classe.

4. Links para páginas de manual detalhando ainda mais a classe.

Nota

Se o manual ou a referência de classe estiverem ausentes ou contiverem informações insuficientes, por favor, abra uma issuei no repositório oficial do GitHub godot-docs para relatar o problema.

Você pode segurar Ctrl (macOS Cmd) e, em seguida, passar o mouse sobre um texto como o nome de uma classe, propriedade, método, sinal ou constante para sublinhá-lo e, em seguida, Ctrl + Clique (macOS Cmd + Clique) para pular para ele.

Aprender a pensar como um programador

Ensinar os fundamentos sobre programação e a forma que os desenvolvedores de jogos pensam está fora do escopo da documentação do Godot. Se você for novo na programação, recomendamos dois recursos excelentes para começar:

1. O Learn GDScript From Zero do GDQuest (Aprenda GDScript Do Zero) é um tutorial interativo livre e de código aberto para pessoas totalmente iniciantes para aprenderem a programar com a linguagem GDScript do Godot. Está disponível como uma aplicação desktop ou no navegador.

2. Se você preferir leitura, dê uma olhada neste ebook gratuito Automate The Boring Stuff With Python escrito por Al Sweigart.

Aprenda com a comunidade

Godot tem uma comunidade crescente de usuários. Se você está preso em um problema ou precisa de ajuda para entender melhor como conseguir algo, você pode pedir ajuda a outros usuários em uma das muitas comunidades ativas.

O melhor lugar para fazer perguntas e encontrar as já respondidas é o Fórum Oficial do Godot. Essas respostas aparecem nos resultados dos buscadores e são salvas, permitindo que outros usuários se beneficiem das discussões na plataforma. Depois de fazer uma pergunta, você pode compartilhar o link em outras plataformas sociais. Antes de fazer uma pergunta, procure as respostas existentes que possam resolver o seu problema neste site ou usando o mecanismo de pesquisa de sua preferência.

Formular boas perguntas e fornecer detalhes ajudará os outros a te responderem com mais rapidez e qualidade. Ao fazer perguntas, recomendamos incluir as seguintes informações:

1. Descreva seu objetivo. Você quer explicar o que está tentando alcançar em termos de design. Se você está tendo problemas para descobrir como fazer uma solução funcionar, pode haver uma solução diferente e mais fácil que atinja o mesmo objetivo.

2. Se houver um erro envolvido, compartilhe a mensagem de erro original. Você pode copiar a mensagem de erro no painel inferior do Depurador do editor clicando no ícone Copiar Erro. Saber o que ele diz pode ajudar os membros da comunidade a identificar melhor como você acionou o erro.

3. Se tem código envolvido, compartilhe um trecho do código. Outros usuários não vão conseguir te ajudar sem olhar o seu código. Compartilhe o código como texto diretamente. Você pode copiar e colar um trecho do código no chat, ou usando um site como Pastebin para compartilhar arquivos grandes.

4. Compartilhe uma captura de tela do seu painel Cena junto com seu código escrito. A maior parte do código que você escreve afeta os nós em suas cenas. Como resultado, você deve pensar nessas cenas como parte de seu código-fonte.

   

   Além disso, não tire fotos com seu telefone, pois a baixa qualidade e os reflexos da tela podem dificultar a compreensão da imagem. Seu sistema operacional deve ter uma ferramenta integrada para fazer capturas de tela com a tecla PrtSc (Print Screen) (macOS: use Cmd + Shift + 3 para uma captura de tela inteira, mais informações aqui).

   Alternativamente, você pode usar um programa como ShareX no Windows, ou Flameshot no Windows/macOS/Linux.

5. Compartilhar um vídeo do seu jogo rodando também pode ser bem útil para solucionar problemas do seu jogo. Você pode usar programas como OBS Studio e Screen to GIF para capturar sua tela.

   Você pode então usar serviços como streamable ou algum armazenamento em nuvem para enviar e compartilhar seus vídeos de graça.

6. Se você não está usando a versão estável do Godot, por favor diga a versão que você está usando. A resposta pode variar já que funcionalidades e a interface mudam rapidamente.

Seguir essas diretrizes maximizará suas chances de obter a resposta que procura. Eles economizarão tempo para você e para as pessoas the ajudando.

Tutoriais da Comunidade

Este manual tem como objetivo fornecer uma referência abrangente dos recursos do Godot. Com exceção das séries de introdução ao 2D e ao 3D, ele não contém tutoriais para implementar gêneros específicos de jogos. Se você está procurando um tutorial sobre como criar um jogo de interpretação de papéis, um jogo de plataforma ou outro gênero, consulte Tutoriais e recursos, que lista conteúdos produzidos pela comunidade do Godot.