⌘ + K abre o terminal interativo
Masmorra ASCII
Aprenda Dart construindo um
roguelike em ASCII no terminal — do primeiro
print a um MUD com masmorra, padrões de design e jogo executável.
$ cat sobre.md
Lenda da masmorra
Não um manual que encosta na prateleira: uma descida em espiral ao coração de uma linguagem moderna, com um jogo de texto como mapa e bússola.
-
Aprender fazendo
Cada capítulo avança um jogo real, executável. Nada de "exemplo 7.3" perdido na página seguinte: o que você aprende vai parar no código que você roda.
-
Linear e narrativo
Do primeiro `print` ao boss final, a descida é gradual. Epígrafes míticas amarram conceitos técnicos a uma jornada que dá vontade de continuar.
-
Código por capítulo
A pasta `code/steps/step-NN/` guarda o estado do jogo ao fim de cada capítulo. Compare seu progresso com snapshots coerentes com a narrativa.
-
Dart de verdade
Sintaxe, tipos, classes, mixins, null safety, async/await, testes, padrões de design. O ecossistema todo, em contexto.
$ ls livro/partes/
Atos e jornada
Seis partes que vão do primeiro `print` à arquitetura completa do jogo, em ritmo coerente com a curva de aprendizado.
- PARTE I
A Primeira Tocha
Caps. 1–7
Fundamentos Dart, terminal, null safety, coleções, arte ASCII e o primeiro game loop.
Explorar parte - PARTE II
Sangue, Ouro e Aço
Caps. 8–14
Classes, herança, mixins, enums, sealed classes, parser de comandos e combate por turnos.
Explorar parte - PARTE III
A Masmorra Desperta
Caps. 15–21
Grids 2D, buffer de renderização, geração procedural, campo de visão e dungeon crawl.
Explorar parte - PARTE IV
O Mercador e a Escada
Caps. 22–27
Economia, loja, generics, pattern matching, progressão XP, múltiplos andares e boss final.
Explorar parte - PARTE V
A Forja do Código
Caps. 28–32
Refatoração, testes unitários, async/await, persistência em JSON e testes golden.
Explorar parte - PARTE VI
A Mente dos Monstros
Caps. 33–37
Design patterns (Strategy, Command, Factory, Observer), máquinas de estado e síntese do jogo completo.
Explorar parte
$ ls code/steps/
Jornada
Trinta e sete capítulos, cada um com um snapshot de código executável. Filtre por título para encontrar o que precisa.
- step-01 Parte 1
Cap. 1 — Seu primeiro programa Dart
- step-02 Parte 1
Cap. 2 — Conversando com o terminal
- step-03 Parte 1
Cap. 3 — Decisões e repetições
- step-04 Parte 1
Cap. 4 — Null safety, o escudo contra crashes
- step-05 Parte 1
Cap. 5 — Coleções, o inventário do herói
- step-06 Parte 1
Cap. 6 — Arte ASCII e StringBuffer
- step-07 Parte 1
Cap. 7 — O game loop, o coração do jogo
- step-08 Parte 2
Cap. 8 — Classes: dando vida ao jogador
- step-09 Parte 2
Cap. 9 — Construtores e encapsulamento
- step-10 Parte 2
Cap. 10 — Herança: a família dos inimigos
- step-11 Parte 2
Cap. 11 — Mixins: poderes compartilhados
- step-12 Parte 2
Cap. 12 — Enums e o parser de comandos
- step-13 Parte 2
Cap. 13 — Ouro, Armas e Inventário
- step-14 Parte 2
Cap. 14 — Combate por turnos
- step-15 Parte 3
Cap. 15 — Da Sala ao Tile: Pensando em 2D
- step-16 Parte 3
Cap. 16 — TelaAscii: O Buffer de Renderização
- step-17 Parte 3
Cap. 17 — Aleatoriedade com Propósito
- step-18 Parte 3
Cap. 18 — Geração Procedural: Cavernas e Corredores
- step-19 Parte 3
Cap. 19 — Campo de Visão e a Névoa de Guerra
- step-20 Parte 3
Cap. 20 — Entidades no Mapa: Inimigos, Itens, Escadas
- step-21 Parte 3
Cap. 21 — Dungeon Crawl: Juntando Tudo
- step-22 Parte 4
Cap. 22 — Economia: Preços, Drops e Balanceamento
- step-23 Parte 4
Cap. 23 — A Loja do Mercador: UI e Fluxo
- step-24 Parte 4
Cap. 24 — Generics e Pattern Matching: Sistema de Eventos
- step-25 Parte 4
Cap. 25 — Progressão: XP, Níveis e Habilidades
- step-26 Parte 4
Cap. 26 — Múltiplos Andares e o Boss Final
- step-27 Parte 4
Cap. 27 — Dungeon Run Completo: A Jornada Épica
- step-28 Parte 5
Cap. 28 — Refatoração Guiada: Code Smells e Limpeza Estrutural
- step-29 Parte 5
Cap. 29 — Testes Unitários com package:test
- step-30 Parte 5
Cap. 30 — Async, Await e o Tempo na Masmorra
- step-31 Parte 5
Cap. 31 — Persistência em JSON
- step-32 Parte 5
Cap. 32 — Organização de Projeto: lib/, test/, pubspec.yaml
- step-33 Parte 6
Cap. 33 — Testes Golden e HUD ASCII Polido
- step-34 Parte 6
Cap. 34 — Strategy e Command: Inimigos que Pensam
- step-35 Parte 6
Cap. 35 — Factory e Observer: O Mundo Reage
- step-36 Parte 6
Cap. 36 — Máquinas de Estado: Patrulha, Alerta e Perseguição
- step-37 Parte 6
Cap. 37 — Síntese: O Jogo Completo, Polido e Pronto
Nenhum capítulo bate com esse filtro.
$ ls livro/pos-textual/
Compêndio e links
Apêndices, glossário e referências auxiliares que complementam o livro.
-
Apêndice A
Referência rápida de Dart
-
Apêndice B
MUD em rede
-
Apêndice C
Achievements
-
Apêndice D
Glossário
-
Apêndice E
Terminal e ANSI
-
Apêndice F
Records e Extensions
-
Apêndice G
Pergaminhos resolvidos — gabaritos dos Desafios
-
Apêndice H
Lore da Masmorra — origem, geografia, bestiário
-
Epílogo
Reflexão sobre a jornada.
$ cat roadmap.md
Próximas fronteiras
O livro não morre na última página. Veja o que está em planejamento.
- Concluído
Lore da Masmorra
Bestiário, geografia dos cinco andares, origem do calabouço e personagens. Apêndice H + página visual /lore.
- Concluído
Guia do Iniciante Absoluto
Pré-requisito opcional antes do Capítulo 1, para quem nunca programou. Onze capítulos curtos com instalação, primeiro programa e vocabulário mínimo.
- Eventual
Tradução para inglês
Versão internacional do livro com o jogo intacto.
- Eventual
Modo endless e leaderboard
Após o boss do andar 5, opção de continuar descendo indefinidamente. Recordes globais opcionais.