Aulas e o jogo de aprendizado

Monte um RPG portátil

Um RPG original em um Uno com tela colorida, um joystick analógico e um piezo: mapas de tiles, um herói, diálogos, batalhas, saves e música.

This course is about the game. For the console itself on an ESP32-C3 (the screen, the pad and a menu), see Monte um console portátil de jogos.

O portátil

Toda aula abre com a mesma ligação:

  • A tela: um TFT colorido ILI9341 de 2,4 polegadas, 240 por 320, em CS 10, DC 9, SCK 13 e MOSI 11.
  • Os controles: um analógico de polegar em A0 e A1, com o clique no pino 2.
  • O som: um piezo no pino 6.
  • Os saves: os próprios 1 KB de EEPROM do Uno. Sem cartão.

O jogo

Emberfold é uma vila à beira de um rio. Uma névoa sai de uma caverna a leste do prado, e Wren, a aprendiz do acendedor de lampiões, precisa descobrir por quê.

O mapa de tiles. O mundo são dez linhas de dez caracteres na flash: T para árvore, ~ água, , grama alta, = a ponte, E o ancião, S a pedra de brasa, C a caverna. Cada tile é desenhado com alguns retângulos, o mapa inteiro uma vez, e depois disso só os tiles que mudam. A colisão é uma pergunta só: o tile à frente é caminhável?

Diálogo. As linhas ficam na flash, são desenhadas num painel abaixo do mapa uma palavra por vez com quebra de linha automática, e esperam um clique. Falar com o ancião define uma flag, o lampião, e a flag abre a caverna.

Batalhas. A cada terceiro passo na grama alta aparece um Mossling ou um Glimmerbat. As batalhas são por turnos: FIGHT, GUARD ou RUN no analógico. O dano é o ataque menos metade da defesa, mais uma rolagem de 0 a 2, nunca menor que 1. Dez pontos de experiência levam Wren ao nível 2, e o Guardião da Névoa (24 HP, ataque 6, defesa 3) é balanceado para que uma Wren de nível 2 sempre vença em quatro golpes.

Saves. A pedra de brasa cura Wren e salva um struct de 18 bytes na EEPROM: um número mágico, uma versão, a heroína inteira e um checksum. Depois de um reset, ela está de volta à pedra.

Música. Um tema de mundo, um loop de batalha e um jingle de vitória, como notas na flash tocadas com tone(), uma nota por vez, para que o jogo nunca espere a música.

O curso

Monte um RPG portátil chega lá em sete aulas, cada uma um sketch na mesma ligação:

  1. Mapas de tiles: um mundo a partir de caracteres, e um quadro para inspecioná-lo.
  2. Uma heroína: caminhada, colisões e direção.
  3. Diálogo: palavras na flash, quebra de linha e uma flag de história.
  4. Batalhas: encontros, um menu, dano, subidas de nível e um chefe.
  5. Jogos salvos: EEPROM, um número mágico e um checksum.
  6. Música: melodias que tocam enquanto o jogo roda.
  7. Projeto: uma missão curta: o jogo inteiro, um final e uma pontuação, e depois o seu próprio mundo.

Cada passo, exceto dois, é verificado no jogo rodando.