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...

Criando a cena do jogador

Com as configurações do projeto feitas, podemos começar a trabalhar no personagem controlado pelo jogador.

A primeira cena definirá o objeto Player. Um dos benefícios de criar uma cena Player separada é que podemos testá-la separadamente, mesmo antes de criarmos outras partes do jogo.

Estrutura de nós

Para começar, precisamos escolher um nó raiz para o objeto do jogador. Como regra geral, o nó raiz de uma cena deve refletir a funcionalidade desejada do objeto — o que o objeto é. No canto superior esquerdo, na aba "Cena", clique no botão "Outro Nó" e adicione um nó Area2D à cena.

Nota

A Godot também fornece o nó CharacterBody2D projetado especificamente para personagens 2D, que inclui suporte integrado para alguns dos processos explicados neste tutorial. Em muitos projetos reais, o CharacterBody2D seria uma escolha melhor para jogadores e inimigos. No entanto, este tutorial se concentra em conceitos básicos que se aplicam a uma gama mais ampla de nós e casos de uso.

Quando você adiciona o nó Area2D, o Godot exibirá o seguinte ícone de aviso ao lado dele na árvore de cena:

Esse aviso nos informa que o nó Area2D requer uma forma para detectar colisões ou sobreposições. Podemos ignorar o aviso temporariamente porque primeiro configuraremos os visuais do jogador (usando um sprite animado). Assim que os visuais estiverem prontos, adicionaremos uma forma de colisão como nó filho. Isso nos permitirá dimensionar e posicionar a forma com precisão com base na aparência do sprite.

Com a Area2D, nós podemos detectar objetos que se sobreponham ou vão de encontro ao jogador. Mude seu nome para Player com um clique duplo no nome do nó. Já que nós configuramos o nó raiz, nós agora podemos inserir nós adicionais para adicionar mais funcionalidades.

Antes de adicionarmos qualquer criança ao nó Player, queremos ter certeza de que não nos movemos acidentalmente ou redimensioná-los clicando neles. Selecione o nó e clique no ícone à direita da fechadura. Sua ferramenta de dica diz "Agrupa o nó selecionado com seus filhos. Isso faz com que o pai seja selecionado quando qualquer nó filho é clicado em visualização 2D e 3D."

Salve a cena como jogador.tscn. Clique em Cena > Salvar, ou pressione Ctrl + S no Windows/Linux ou Cmd + S no macOS.

Nota

Para esse projeto, vamos seguir as convenções de nomeação do Godot.

GDScript: Classes (nós) usam o estilo PascalCase (IniciaisMaiúsculas), variáveis e funções usam snake_case (minúsculas_separadas_por_sublinha) e constantes usam ALL_CAPS (TODAS_MAIÚSCULAS) (Veja mais em Guia de Estilo GDScript).
C#: Classes, export variables and methods use PascalCase, private fields use _camelCase, local variables and parameters use camelCase (See Guia de Estilo C#). Be careful to type the method names precisely when connecting signals.

Animação por Sprites

Click on the Player node and add (Ctrl + A on Windows/Linux or Cmd + A on macOS) a child node AnimatedSprite2D. The AnimatedSprite2D will handle the appearance and animations for our player. Notice that there is a warning symbol next to the node. An AnimatedSprite2D requires a SpriteFrames resource, which is a list of the animations it can display. Make sure AnimatedSprite2D is selected and then find the Sprite Frames property under the Animation section in the Inspector and click "[empty]" -> "New SpriteFrames":

Clique em SpriteFrames que você acabou de criar para abrir o painel "SpriteFrames":

À esquerda está uma lista de animações. Clique na animação default e renomeie para walk. Em seguida, clique no botão Adicionar Animação para criar uma segunda animação chamada up.

Find the player images in the FileSystem dock - they're in the art folder you unzipped earlier. Drag the two images for each animation, into the Animation Frames side of the panel for the corresponding animation:

playerGrey_walk1 e playerGrey_walk2 para a animação walk
playerGrey_up1 e playerGrey_up2 para a animação up

As imagens do jogador são um tanto grandes demais para a janela de jogo, então precisamos reduzir sua escala. Clique no nó AnimatedSprite e configure a propriedade Scale (escala) para (0.5, 0.5). Você pode encontrá-la no Inspetor na seção Node2D.

Finalmente, adicione um CollisionShape2D (forma de colisão 2D) como filho de Player. Isso determina a "hitbox" (caixa de acerto) do jogador, ou seja, os limites da sua área de colisão. Para este personagem, um nó CapsuleShape2D (forma cápsula 2D) é o que melhor se encaixa. Então, ao lado de "Shape" (forma) no Inspetor, clique em "[vazio]" -> "Novo CapsuleShape2D". Utilizando os dois manipuladores de tamanho, redimensione a forma para cobrir o sprite:

Quando tiver finalizado, sua cena Player deveria se parecer assim:

Depois que isso for feito, o aviso no nó Area2D desaparecerá, pois agora ele possui uma forma atribuída e pode interagir com outros objetos.

Certifique-se de salvar a cena novamente após as alterações.

Na próxima parte, adicionaremos um roteiro ao nó jogador para movê-lo e animá-lo. Depois, configuraremos a detecção de colisão para saber quando o jogador é atingido por alguma coisa.