Referências técnicas — A Marcha da Lanterna
Versão 1.5.3 · motor engine-vertical · para quem vai manter o jogo.
Tecnologia
Motor engine-vertical (pacote motor-tiro-vertical): Motor de shooter vertical a pé dirigido por configuração. Um jogo é um games/<slug>/. Primeiro jogo: A Marcha da Lanterna.
- Linguagem e build: TypeScript ^5.9.2 estrito, Vite ^7.1.3, testes em Vitest ^3.2.4. Dependências de execução: 0.
- Desenho em Canvas 2D; telas e diálogos em DOM. Som: PSG próprio em Web Audio; os únicos arquivos de áudio são os da trilha orquestral, a padrão (
audio/partida1.webm,audio/partida1.m4a,audio/partida2.webm,audio/partida2.m4a,audio/partida3.webm,audio/partida3.m4a), baixada só sob demanda, com a 8-bit tocando enquanto carrega (src/plataforma/som/trilhaArquivo.ts,index.ts). - Ficha:
tecnico.tecnologia: html5-js; plataformasdesktopemobile.
Leis do motor
src/core/é puro. Semdocument,window,navigator,localStorage,setTimeout,requestAnimationFrame,performance,Math.randomouDate.now. Tempo entra como passo fixo; aleatoriedade, porRngsemeado (core/rng.ts). O núcleo emite eventos; a plataforma desenha e toca. Garantido portests/pureza.test.ts(varre o texto dos arquivos desrc/core/).- Nenhuma string visível cravada no código. Todo texto vem de
config.textos(exceção única: o dicionário mínimo de erro de carga noindex.html). - Nenhum
ifpor jogo. Diferença entre jogos vira campo de config. resolverConfig()é a única porta para a config crua (defaults + validação; lança com mensagem clara).- Números vivem na config (velocidades, vidas, dano, cadências, padrões de chefe, trechos, ondas).
- Acessibilidade entra junto com a feature: teclado, contraste medido, nenhuma informação só por cor, todo som com equivalente visual,
prefers-reduced-motion, nenhum clarão de tela inteira, nada > 3 Hz. - Determinismo:
passo(estado, entrada, config)com a mesma semente e a mesma sequência de entradas produz o mesmo estado. É o que torna o playtest automatizado e o relatório de bug reproduzíveis.
Som
| arquivo | papel |
|---|---|
api.ts | contrato Som (não muda) |
sintetizador.ts | PSG próprio: 3 pulsos (12,5/25/50 % por série de Fourier numa PeriodicWave) + ruído de 1 bit com período; envelope por nota, vibrato ~, deslize ^, volume 0–15 por canal (2 dB/passo). criarTocador: agenda pelo currentTime com 150 ms de antecedência (o setInterval de 25 ms só bombeia a fila); cada nota é recalculada de início + (volta × tiques + t) × s/tique, então o loop é exato por construção; pausa/retoma do mesmo ponto |
musicas.ts | as 8 composições originais como texto + o leitor que as compila (puro, testável) |
efeitos.ts | POR_EVENTO: um Record com todo TipoEvento (o tsc reclama de evento novo — pegou o portaoAberto do núcleo); teto de 8 vozes, tiros com no máx. 2 vozes e 1 a cada 50 ms |
trilhaArquivo.ts | suno-studio opcional: webm/opus → m4a, carga sob demanda, loopStart/loopEnd (segundos); falha → toca a versão chip |
index.ts | criarSom(config?) → SomDetalhado (é um Som, e expõe posicao()/niveis() para a página de escuta) |
Para o main.ts: criarSom({ trilhaArquivo: cfg.trilhaArquivo }) (ou criarSom()); começa desligado e não toca o Web Audio até ligar(true) (chamar no gesto). tocar() com o som desligado só anota a faixa (a capa pede 'entrada' ao abrir e ela começa quando a pessoa liga o som). eventos() já troca a música em chefeEntra → chefe (1,1 s depois do acorde), farolAceso, fimDeJogo, vitoria. Pedir a mesma função de novo não reinicia (inclusive faixa sem loop já terminada), e tocar() de uma função nova desfaz a pausa da música. Sem Web Audio, tudo vira silêncio sem erro (try/catch em toda entrada pública).
Mistura: música = volume × 0,65 (35 % abaixo dos efeitos no mesmo ajuste); avisos num barramento próprio = max(efeitos, música), nunca abaixo da música, e cada aviso abaixa a música para 55 % por 0,4 s. Medido em render offline (Chromium): música RMS ≈ −30 a −32 dBFS efetivos (Entrada −30, Vitória −31,7, Farol −30,9), avisos ≈ −25 dBFS (+5 a 8 dB, +5 dB a mais com o abaixamento); picos dos tiros 6–9 dB abaixo dos picos dos avisos; nenhuma faixa passa de −5,6 dBFS de pico.
| função | tom | BPM | compassos | duração | forma | loop |
|---|---|---|---|---|---|---|
| entrada | Ré maior (♭VII e ♭III emprestados) | 144 | 24 | 40,0 s | A1 A2 B1 B2 A1 A2 | sim |
| partida1 (Bosque) | Mi menor | 132 | 32 | 58,2 s | a b a b c d a b | sim |
| partida2 (Charco) | Lá menor, shuffle 2/3 | 120 | 32 | 64,0 s | a b a c d d a c | sim |
| partida3 (Cidadela) | Dó menor harmônico | 144 | 32 | 53,3 s | a c a c d e a c | sim |
| chefe | Fá♯ menor | 150 | 16 | 25,6 s | a a b a | sim |
| farolAceso | Ré maior (I–IV–V–I) | 156 | 3 | 4,6 s + 0,3 s de soltura | F | não |
| vitoria | Ré maior (I, IV, V, V/V, ♭VII; nenhum menor) | 160 | 20 | 30,0 s + 0,3 s de soltura | I A1 A2 A3 A4 F | não |
| fimDeJogo | Ré menor | 108 | 2 | 4,4 s + 0,4 s de soltura | F | não |
Resolução e orientação
- Vista lógica 352 × 640 (11 × 20 tiles de 32 px): a câmera chegou 1,5× mais perto a pedido do dono, depois de jogar a 1.0.0 no desktop ("fica bem pequeno"). A arte não mudou de tamanho (Íris 32 × 48, inimigos 32 px, chefes 176–192 px): a vista encolheu, então tudo aparece 1,5× maior. Antes era 544 × 960 (17 × 30), o dobro de detalhe do step-05.
LARGURA(352) é a dimensão lateral eALTURA(640) a de à frente. Escala inteira quando couber (em pixels do aparelho); a sobra vira moldura temática. - Modo horizontal = a mesma simulação girada. O núcleo não sabe de orientação: a plataforma gira a vista 90° quando a tela está deitada ("à frente" vira a direita, e a vista fica 640 × 352). Entrada e desenho fazem a conversão; o Estado e os eventos são os mesmos nos dois modos.
- Superfícies (chão, campo, água, piso) desenhadas em placas grandes e lisas, de baixo contraste: a grade de tiles nunca aparece. Cenário calmo, quem joga em contraste alto (pedido do usuário no step-05).
- Coordenadas de MUNDO com y para baixo. A fase é uma grade de
colunas = 11×linhastiles; altura do mundoH = linhas × 32. A câmera écameraY= y do topo da tela no mundo: começa emH − 640e diminui com a rolagem (cameraY -= velocidadeRolagem × dt). EmcameraY = 0a rolagem para e começa o chefe na arena (as 20 linhas do topo do mapa são a arena). - Tela = mundo − (0, cameraY). Íris vive em coordenadas de mundo e é presa ao retângulo visível (com margem de 16 px nas laterais; à frente e atrás o sprite pode encostar na borda —
heroina.margemFrente, 1.2.2, pedido do dono; antes Íris não passava de 35 % da altura a contar do topo). Na arena, a frente para na caixa do chefe e a 80 px (heroina.distanciaMinimaTiro) do ponto de disparo mais baixo dele (1.2.3). Inimigo que entra pela frente não fere por contato nos primeirosheroina.contatoNaEntradas.
Passo e tempo
PASSO = 1/60 s.dtefetivo =PASSO × config.velocidadeDoJogo[ajuste] × dificuldade.fatorRolagemsó para a ROLAGEM; inimigos e tiros usamPASSO × velocidadeDoJogo(o ajuste de acessibilidade desacelera tudo; a dificuldade Branda desacelera só a rolagem).- A plataforma roda o acumulador (passo fixo a 60 Hz, no máximo 5 passos por quadro).
- Cartela do chefe (1.2.3):
config.tempos.cartelaDoChefe(1,6 s) é a fonte única: a plataforma mostra o nome do chefe por esse tempo, e o primeiro golpe de cada chefe esperamax(entrada, cartelaDoChefe)s de jogo depois dechefeEntra— nenhum aviso, projétil ou dano de contato antes (toda ameaça forte tem aviso visível).
Estrutura de arquivos
A pasta publicada (build congelado 1.5.3)
| arquivo | tamanho |
|---|---|
audio/partida2.webm | 391,2 KB |
audio/partida2.m4a | 389,0 KB |
audio/partida1.m4a | 382,1 KB |
audio/partida1.webm | 381,2 KB |
audio/partida3.m4a | 354,7 KB |
audio/partida3.webm | 345,8 KB |
sprites/chefe-cervo.webp | 314,7 KB |
jogo.js | 183,0 KB |
sprites/iris.webp | 174,3 KB |
sprites/chefe-arauto.webp | 136,9 KB |
capa-paisagem.webp | 85,5 KB |
og.jpg | 82,8 KB |
sprites/chefe-matriarca.webp | 79,7 KB |
capa-retrato.webp | 74,2 KB |
atlas-fase3.png | 66,8 KB |
atlas.png | 65,7 KB |
index.html | 36,5 KB |
estilo.css | 19,3 KB |
fonte/VT323-latin.woff2 | 17,9 KB |
game.yaml | 12,0 KB |
logo-escuro.svg | 5,4 KB |
fonte/OFL.txt | 4,4 KB |
logo-claro.svg | 3,9 KB |
icon-512.png | 2,1 KB |
icon-192.png | 0,8 KB |
favicon.svg | 0,7 KB |
manifest.webmanifest | 0,6 KB |
versao.json | 0,0 KB |
cenas/ (18 arquivos: vídeos de vitória, pôsteres e pinturas) | 3,94 MB |
A documentação (manual.html, manual-do-usuario.pdf, tecnico.html e img/) é publicada ao lado e não é carregada pelo jogo.
O motor
src/core/ PURO
tipos.ts contrato (este documento em código) — Estado, Entrada, Evento, Config resolvida
rng.ts mulberry32 + seedDe (cópia do engine-letras)
resolverConfig.ts a porta única
mapa.ts gerarMapa(faseCfg, rng): grade de tiles a partir de `trechos` (corredor transitável garantido)
colisao.ts AABB, tile sólido/perigoso/lento, empurrão da borda
heroina.ts movimento, tiro, dano, invulnerabilidade, escudo, bomba
armas.ts padrões das 4 armas × 3 níveis → novos projéteis
inimigos.ts comportamentos por `comportamento` (não por nome do inimigo)
chefes.ts máquinas de estado dos chefes (por `padrao`, não por nome)
fase.ts ondas/pedras por trecho, marcos, transição fase→chefe→farol
partida.ts criarPartida(), passo(), continuar(), iniciarFase()
pontuacao.ts pontos, vida extra, comparador e Top 5 por dificuldade
src/arte/ DADOS PUROS de pixel art (paleta + sprites em grade de caracteres) — step-04
src/plataforma/ tudo que toca o navegador
laco.ts requestAnimationFrame + acumulador, pausa por visibilidade
entrada.ts teclado, toque (arrasto relativo), Gamepad API → Entrada
atlas.ts sprites de dados → ImageBitmap/canvas em cache (1×, desenhados com escala inteira)
render.ts câmera, tiles, entidades, efeitos (a partir de eventos), HUD em canvas
telas.ts DOM: capa (contrato da 1ª página), dificuldade, pausa, fim, final, recordes, folhas
armazenamento.ts localStorage protegido por try/catch (som, trilha, recordes, fases liberadas, ajustes)
atualizacao.ts versao.json: ao abrir, ao voltar à aba, a cada 15 min; 1 tentativa por versão e aba
som/sintetizador.ts PSG: 3 canais de pulso (largura 12,5/25/50 %) + ruído; volume por canal; Web Audio
som/musicas.ts composições ORIGINAIS como dados (8 funções)
som/efeitos.ts efeitos sintetizados, mapeados de Evento
som/trilhaArquivo.ts trilha suno-studio opcional (arquivo, sob demanda, só se a config declarar)
src/main.ts integração: telas ↔ partida ↔ render ↔ som
games/<slug>/config.json regras, números, fases, chefes, textos, visual
games/<slug>/public/ og.jpg, favicon.svg, ícones, capa webp, fonte
| arquivo | o que faz |
|---|---|
vite.config.ts | plugins: config do jogo (config.json + textos.json + visual.json; resolverConfig roda no build), atlas, primeira pintura (LQIP no <head>), auto-atualização (versao.json, ?v=, manifesto com ícones purpose: any), prévia de link (og/twitter a partir da identidade; recusa sem og.jpg 1200×630), script clássico iife (abre por file://) |
scripts/gerar-atlas.mjs | as strings de src/arte/ viram UM PNG indexado (24 cores + transparente) e um mapa de quadros |
index.html · src/styles/{tokens,jogo}.css | DOM das telas; tokens de cor (reserva no CSS, valores de visual.cores escritos pelo main.ts) |
src/main.ts | integração telas ↔ núcleo ↔ render ↔ som. Toda importação do núcleo passa pela porta src/core/index.ts (criarPartida, passo, continuar, pular, definirVelocidade, estadoDaGrelha, posicoesOrbitais, ranking puro); o som é criarSom() de som/index.ts (som nulo de reserva se falhar) |
src/plataforma/laco.ts | rAF + acumulador de passo fixo 60 Hz, máx. 5 passos/quadro sem dívida; pausa ao perder foco ou esconder a aba |
src/plataforma/entrada.ts | teclado, toque (arrasto relativo; tiro automático; botão Lanterna), Gamepad API; guarda a sobra do arrasto que o núcleo corta (teto de 96 px) |
src/plataforma/atlas.ts | carrega o PNG por <img>; desenho, silhueta (contorno de acerto/invulnerável), sprite ampliado para as folhas |
src/plataforma/superficies.ts | o chão por pisos.ts: placas 64×64 por semente, água/mata/lava com borda orgânica (senoides, deslocamento ≤ 8 px), caminho que segue o corredor, adesivos raros; pedaços de 480 px em cache |
src/plataforma/render.ts · hud.ts · efeitos.ts · cenas.ts | canvas 352×640 em pé ou 640×352 deitado (mundo girado), na resolução da tela (1 a 3 px do canvas por px lógico; 1.4.0); Íris da folha de 128 px (irisDaFolha, pixel art de reserva); tiles vivos (tábua, grelha, cristal), avisos (chão, água, mira tracejada, fagulhas, borda), luz da lanterna, anel da bomba, Bruma (topo e laterais do Arauto), HUD, barra do chefe; cenas do farol e final |
src/plataforma/telas.ts · folhas.ts | capa (contrato da 1ª página), dificuldade + treino, pausa, farol, fim, final, recordes; diálogos com 3 saídas e fundo inerte; folha única Detalhes · Conteúdo · Créditos com bestiário gerado da config |
src/plataforma/armazenamento.ts · atualizacao.ts · legendas.ts · texto.ts · dados.ts · somNulo.ts | localStorage que nunca lança; vigia de versão com trava por aba; legendas de efeitos; U+200C das ligaduras; tipos de textos/visual; som de reserva |
games/a-marcha-da-lanterna/textos.json | TODO texto visível |
games/a-marcha-da-lanterna/visual.json | tokens de cor, capa, pintura por fase, animação por sub-estado, cores dos efeitos (novo; não é do núcleo) |
games/a-marcha-da-lanterna/public/ | capas, og.jpg, logos, favicon, ícones, fonte/VT323-latin.woff2 + OFL.txt, cenas/, sprites/iris.webp (folha da Íris, 1.4.0) |
src/plataforma/cenaVitoria.ts | a cena de vitória (vídeo → pinturas → pixel art), pulável, teto de 15 s |
tests/plataforma-*.test.ts | 1ª página no DOM, varredura de texto cravado, U+200C, atualização sem laço, laço/entrada/escala/giro, diálogos, cena de vitória, folha da Íris |
API do núcleo
| função | o que faz |
|---|---|
resolverConfig(cru) → ConfigResolvida | a porta única; defaults + validação; lança ConfigInvalida com todos os problemas |
criarPartida(cfg, { dificuldade, semente, faseInicial, treino, velocidade?, testeInvulneravel? }) | começa na cartela da fase |
passo(estado, entrada, cfg) | muta e devolve o mesmo objeto; estado.eventos zerado e preenchido |
continuar(estado, cfg) | só em fimDeJogo com continuação: volta ao último marco, pontos 0, vidas e corações cheios |
pular(estado, cfg) | pula a cartela ou a cena do farol (também zera e preenche eventos — a vitoria pode sair daqui) |
definirVelocidade(estado, cfg, i) | ajuste de acessibilidade 100/85/70 % (índice em velocidadeDoJogo) |
estadoDaGrelha(linha, tempoFase, cfg) | apagada / aviso / acesa, para desenhar a grelha |
posicoesOrbitais, caixaDoCorpo, caixaDoPontoFraco, faixaLivre, limitesDaHeroina | geometria para desenho |
compararRecordes, registrarRecorde, entraNoTop, normalizarApelido, contaParaRecorde, bonusDaFase | ranking puro (guardar é da plataforma) |
opcoes.testeInvulneravel existe só para o playtest; a config do jogo não tem como ligá-lo.
criarPartida(cfg: ConfigResolvida, opcoes: { dificuldade: IdDificuldade; semente: number; faseInicial: number; treino: boolean }): Estado
passo(estado: Estado, entrada: Entrada, cfg: ConfigResolvida): Estado // muta e devolve o mesmo objeto; zera e preenche estado.eventos
continuar(estado: Estado, cfg: ConfigResolvida): Estado // volta ao último marco, pontos = 0, gasta 1 continuação
A plataforma lê estado.eventos depois de cada passo (som, partículas, legendas, HUD) e nunca muda o estado por fora da API.
Eventos
tiro, acerto, inimigoDerrotado, pedraTrinca, pedraQuebra, itemColetado, dano, escudoAbsorveu, bomba, aviso (com tipoAviso: chao, agua, mira, fagulha, borda), chefeEntra, chefeEstagio, chefeDerrotado, vidaExtra, farolAceso, faseCompleta, marco, caiu (perdeu vida), fimDeJogo, vitoria. Cada evento leva x, y (mundo) e os dados que o desenho e o som precisam. Todo evento sonoro tem desenho: a regra de acessibilidade é testada (tests/eventos-com-desenho.test.ts).
Mapa
| char | tile | colide | efeito |
|---|---|---|---|
. | chão | não | — |
# | sólido (tronco, pedra, muro, pilar) | sim | bloqueia Íris e projéteis de Íris |
~ | água / lava | sim para Íris, não para tiros | bloqueia Íris |
^ | espinho | não | dano ao tocar |
, | lama | não | velocidade × 0,5 |
= | ponte | não | — (chão sobre ~) |
% | tábua podre | não | afunda 1,5 s depois de pisada → vira ~ (aviso: range e escurece) |
g | grelha de fogo | não | ciclo da config; acesa = dano; aviso 0,7 s antes |
P | portão | sim | abre (vira .) quando os cristais c do mesmo portão são destruídos |
c | cristal da porta | sim | 4 de vida; alvo de tiro |
o | vitória-régia (1.2.0, só no rio do Charco) | sim para Íris, não para tiros | é água para Íris (bloqueia, como ~); o Sapo-Arqueiro pousa nela; desenho: tiles.fase2.vitoriaRegia / vitoriaRegiaFlor sobre a água, fora da grade: no centro do tile somado a deslocamentoDaVitoria(l, c) (core/mapa.ts, função pura da posição, ±6 × ±5 px; o Sapo pousa no mesmo ponto). Desde a 1.2.1 são poucas: ~1 a cada 10 tiles de água, nunca encostadas umas nas outras, um par por bloco de rio onde cabe |
Pedras-Rúnicas são ENTIDADES (não tiles), colidem como sólido e aguentam 3 acertos.
Cada fase é uma lista de trechos, de baixo para cima. Um trecho tem tipo (o gerador sabe desenhar clareira, trilha, bosque-denso, rio-com-pontes, tabuas, ruinas, ponte-de-pedra, patio, canais-de-lava, grelhas, portao, arena), linhas, e as listas ondas (inimigo, quantidade, formação, atraso em segundos a partir da entrada do trecho na tela) e pedras (item do glifo). O gerador garante um corredor transitável de pelo menos 3 tiles em todo o percurso. Marcos (continuação) ficam no meio da fase e na porta da arena.
Configuração
Um jogo é a pasta games/a-marcha-da-lanterna/. O build une os três arquivos, roda resolverConfig() e para com a lista de problemas se a config for inválida.
| arquivo | o que tem neste jogo |
|---|---|
config.json | versão 1.5.3; 3 dificuldades; 4 armas × 3 níveis; 12 inimigos; 3 chefes; 7 projéteis; 3 fases com 13 / 15 / 20 trechos e 12 / 15 / 19 Pedras-Rúnicas; rolagem 44 / 52 / 60 px/s; velocidades 100 % / 85 % / 70 %; vida extra a cada 30.000; Top 5; tempos.cartelaDoChefe 1,6 s; tempos.fatorDaAproximacao 2 (a rolagem sem inimigo nem onda até a arena) |
textos.json | todo texto visível: 25 blocos, 27 causas de queda com dica, 26 legendas de efeitos. O build embute o arquivo no index.html (#textos-do-jogo); o gerador desta página confere que é o mesmo |
visual.json | tokens de cor (17), capa, pintura por fase (3), animações, cenas de vitória, terreno da folha Conteúdo (7 peças); o mapa da folha da Íris (heroinaFolha: quadro de 128 px, 14 ações entre as duas vistas); o mapa das folhas dos chefes (chefesFolha: 9 poses pintadas, 3 px de arquivo por px do jogo) |
public/ | capas, og.jpg, logos, favicon, ícones, fonte/ (VT323 + OFL.txt), cenas/, sprites/iris.webp (a folha da Íris, renderizada do modelo 3D), sprites/chefe-cervo.webp, sprites/chefe-matriarca.webp, sprites/chefe-arauto.webp (os chefes pintados, cada folha baixada só na fase do seu chefe) |
Dificuldades (config)
| Dificuldade | Corações por vida | Vidas | Continuações | Rolagem | Vida dos chefes |
|---|---|---|---|---|---|
| Branda | 5 | 3 | sem limite | 80 % | 80 % |
| Padrão | 3 | 3 | 3 | 100 % | 100 % |
| Lendária | 1 | 3 | nenhuma | 100 % | 100 % |
Build, testes e como reproduzir
Abrir o jogo sem build: abrir index.html da pasta publicada pelo navegador (file://). Não há servidor, nem pedido para fora da pasta além de versao.json, que é da própria pasta.
$env:JOGO='a-marcha-da-lanterna'; npm run build # dist/a-marcha-da-lanterna/ (abre por file://)
npx vitest run # 30 arquivos, 364 testes (contagem de hoje: arquivos em tests/, testes no vitest de hoje)
node scripts/teste-atualizacao.mjs # portão da atualização (servidor de verdade; rode sozinho)
node scripts/teste-atualizacao.mjs --sabotar # tem de REPROVAR (trava desligada)
node scripts/contraste.mjs # contraste da capa no pixel pintado
node scripts/medir-revisao.mjs # R2–R7 e N1–N4 em 7 tamanhos, por file:// (FOTOS=<pasta> fotografa)
node scripts/contraste-cidadela.mjs <vitrine> <saida> # contorno de Íris × piso na fase 3, nas duas vistas
node scripts/capturas.mjs a-marcha-da-lanterna <saida> [prefixo] # capa, folhas, partida, pausa (3 larguras)
node scripts/capturas-partida.mjs a-marcha-da-lanterna <saida> [prefixo] # fase 1 inteira, relógio adiantado
npx vite build --mode vitrine --outDir <tmp>; node scripts/capturas-vitrine.mjs <tmp> <saida> # jogo inteiro, robô invulnerável
O modo vitrine só existe no build de vitrine: o robô do playtest do núcleo (tests/robo.ts) joga no lugar da pessoa, com Íris invulnerável (testeInvulneravel, que a UI não expõe). No build de produção o Vite troca a condição por false e o bloco some — conferido: nem __vitrine nem criarRobo aparecem no jogo.js.
Contagem do vitest run feito na geração desta página (04/11/2026): 364 testes verdes. O build 1.5.3 congelado tem estes md5 (o build-report ainda não tem a seção 1.5.3: são os md5 medidos agora no build congelado):
| arquivo | md5 | no build-report |
|---|---|---|
jogo.js | e7a145d4c0659c07963ad9e076f4590f | — |
estilo.css | a9a15eed2aa2bacca52d3677e17fac49 | — |
index.html | a29b501f70fd1521c2f091bfdd8ddb10 | — |
atlas.png | 90af9ab1f41e62e564c6092f2f06aea6 | — |
atlas-fase3.png | 366a0f6ed77a057ec465d0c4505e5512 | — |
sprites/iris.webp | 0f2fd5b2531541e2d81b8fd75485827c | — |
sprites/chefe-cervo.webp | 611bafa68b6754e8611404f620ced689 | — |
sprites/chefe-matriarca.webp | a59a71a22d418a62400b1485ab13d117 | — |
sprites/chefe-arauto.webp | e96f87845e86d61d10afe37710005b82 | — |
versao.json | 277375e0fcad4eaf1758d90aea3dad80 | — |
Esta documentação é gerada por squads/games-creator/scripts/docs-motor-vertical.mjs, e as capturas que faltavam ao step-07b por capturas-doc-motor-vertical.mjs.
Atualização automática
versao.json publicado: {"versao": "1.5.3"}, igual a config.versao e à ficha. O index.html carimba ?v=1.5.3 em 3 endereços.
O jogo confere a versão ao abrir, ao voltar à aba e a cada 15 minutos, com uma tentativa de recarga por versão e por aba (src/plataforma/atualizacao.ts). Durante a partida, nada aparece. A faixa “Versão nova disponível. Atualizar agora” surge dentro do diálogo aberto (pausa, fim, final, recordes); na capa, a troca é calada.
Peso medido
| item | cru | gzip (nível 9) | teto |
|---|---|---|---|
jogo.js | 183,0 KB | 61,9 KB | 70,0 KB gzip |
estilo.css | 19,3 KB | 5,0 KB | — |
index.html (com os textos) | 36,5 KB | 11,3 KB | — |
cenas/ | 3,94 MB | — | — |
| pasta do jogo | 7,55 MB (7.548.231 bytes) | — | 5,00 MB (151 % usado) |
Os vídeos de vitória são baixados só quando o chefe entra, e só o da orientação atual. Com o pedido de menos movimento, nenhum vídeo é baixado. A trilha orquestral (audio/, 2244,0 KB nos dois formatos) é baixada com o som ligado, uma faixa por fase quando a fase começa, e num formato só; sem som, ou com a 8-bit escolhida na pausa, não se baixa. A pasta passa do teto de 5,00 MB; o que se baixa ao abrir e jogar, antes dos vídeos e das faixas orquestrais, fica bem abaixo dele.
Acessibilidade medida
Ficha: teclado sim, contraste AA sim, legenda ou texto alternativo sim, sem dependência de cor sim, tolerância de tempo sim.
Tabela medida pelo QA independente na versão 1.2.0 (v14/qa-report.md), a última passada que mediu a acessibilidade inteira:
| Campo | Resultado | Medição |
|---|---|---|
| Teclado | ✔ | Capa, folhas, dificuldade e Treino por Tab e Enter. Partida deitada com setas giradas. Pausa com P e Esc. Bônus por Enter quando o foco está no botão (ver o ajuste 1). |
| Contraste — texto | ✔ | De 8,82 a 14,47:1. Subtítulo sob as letras: mínimo de 6,50:1 (qa3-03-saida.txt, qa3-03b-saida.txt). |
| Contraste — projéteis | ✔ | Fases 1 e 2 como no ciclo 2: contorno de 3,75 a 4,52:1, núcleo de 3,09 a 3,86:1. Fase 3: núcleo 10,80:1 (creme) e 9,45:1 (pálido) sobre #2E2A40. |
| Legenda do som | ✔ | Fora do campo nas 3 telas medidas, 24 px, e nomeia quem avisa. |
| Sem dependência de cor | ✔ | Anel tracejado parado no Cogumelo e no Javali; formas como no ciclo 2. |
| Tolerância de tempo | ✔ | Branda e Velocidade 100/85/70 %. O bônus não some sozinho (10 s conferidos). Pausa ao girar. Continuar sem contagem. |
| Fotossensível — jogo | ✔ | Em pé, 390×844, 180 quadros a 60 Hz, com e sem movimento reduzido: 0 inversões ≥ 10 % por segundo na Cidadela, no Arauto e na bomba. Pior quadro: 6,4 % da tela mudando (qa3-05-saida-390x844.txt). Deitado: não repeti neste ciclo; no ciclo 2 deu 0 inversões |
| Fotossensível — vídeos | ✔ | 6 vídeos: 0 inversões ≥ 10 % por segundo; maior salto 0,010; vermelho saturado 0 %. |
| prefers-reduced-motion | ✔ | Nenhum .mp4 baixado: entram o JPG e a pintura. Sem tremor, créditos parados. |
| Alvos de toque | ✔ | Em pé: Pausa 88×56, Lanterna 146×56. Deitado (844×390): Pausa 94×56, Lanterna 94×60. Seguir 216×56, Pular 96×50. |
| Legibilidade | ✔ | VT323, como no ciclo 2. |
QA da versão 1.2.3 (qa-report.md): APROVAR. Regressão rápida:
| Item | Resultado | Evidência |
|---|---|---|
| G4 — autocontenção | PASS | Os src/href são ./…?v=1.2.3. As URLs absolutas só aparecem em og:* e twitter:image. 7 pedidos, 0 fora da pasta (qa6-teclado-saida.txt). |
| G5 — console limpo | PASS | 0 mensagens: teclado, capa em 5 telas, vitrine nas 2 orientações. |
| G6 — jogável até o fim | PASS | Vitrine até o final e os recordes, em pé (390×844) e deitado (1366×768) (vitrine-*.txt). |
Peso e file:// | PASS | 4.565.908 bytes (91 % do teto). 0 console. no jogo.js. Abre por file://. |
| Teclado | PASS | Ordem do Tab, foco 3 px, Esc fecha as folhas e devolve o foco, Esc volta da dificuldade. |
| Vídeos | PASS | Retrato em pé, 16:9 deitado, todos tocando. 0 pedidos no carregamento e na 1ª travessia. |
| Bônus espera o botão | PASS | 10 s depois de cada cena, nas 3 fases e nas 2 orientações. |
| Charco — mapa (30 sementes) | PASS | 450 corpos de água, todos atravessando a largura. Vitórias-régias em 8,1 % da água, 0 vizinhas. 291 colunas de tábua com terra nas pontas. Fase 1 sem água (qa6-mapa-saida.txt). |
Privacidade
Os recordes e as preferências ficam só neste aparelho. Nada é enviado.
Chaves de localStorage que o jogo.js publicado usa: mv:a-marcha-da-lanterna:v1:prefs, mv:a-marcha-da-lanterna:v1:recordes, mv:a-marcha-da-lanterna:v1:fase (preferências, recordes por dificuldade e fase mais alta liberada para treino). Em sessionStorage: mv:atualizacao-tentada (a trava de uma recarga por versão). Numa sessão de leitura que abriu o jogo, começou uma partida e trocou um ajuste na pausa, o aparelho ficou com: mv:a-marcha-da-lanterna:v1:prefs. Todo acesso passa por try/catch (armazenamento.ts): sem armazenamento, o jogo funciona e só não guarda.
Pedidos de rede vistos ao abrir, começar uma partida e pausar (servidor local de leitura): ./index.html, ./jogo.js, ./estilo.css, ./fonte/VT323-latin.woff2, ./logo-escuro.svg, ./capa-paisagem.webp, ./atlas.png, ./versao.json, ./sprites/iris.webp, ./sprites/chefe-cervo.webp, ./sprites/chefe-matriarca.webp, ./sprites/chefe-arauto.webp. Nenhum sai da pasta do jogo.
Requisitos
- Navegador com Canvas 2D. Web Audio é opcional: sem ele, o jogo fica mudo e funciona.
- Controle: Gamepad API, opcional.
- Abre por
file://e em qualquer hospedagem estática. Ficha: plataformas desktop e mobile. - Telas fotografadas e medidas na revisão visual e na documentação: 320x568, 390x844, 568x320, 844x390, 1366x768 e 1920x1080.
Procedência e revisões
Revisão de propriedade intelectual (step-08): APROVAR. Jogo original do gênero. Referência de gênero declarada: Knightmare (Konami, MSX, 1986). Compartilha só convenções do gênero (rolagem vertical, tiro para a frente, recipiente de item, chefe por fase, bomba). Nome, personagens, arte e som são próprios, auditados no step-08 em 02/11/2026.
Conteúdo clínico: gates.conteudo_clinico: false; não há fonte clínica.
Referências de gênero (ritmo e dificuldade, não fonte de conteúdo)
- https://cemeterygames.com/2009/12/19/knightmare-msx-1986/ — calibração de gênero (contagem de fases, recipientes de item, chefe por fase, curva de dificuldade, cuidado com contraste de projétil); consultado em 01/11/2026.
- https://www.youtube.com/watch?v=xUnW2Ca2IOQ — referência de ritmo de rolagem e densidade, indicada pelo usuário; consultado em 01/11/2026.
Créditos
| Produção | Dentistas.com.br |
| Autor | Júlio César Ventura Cardoso |
| Arte da capa, das cenas de vitória e dos chefes | gerada com IA no OpenArt (Nano Banana Pro; vídeos com Kling 3 Omni) |
| Íris no jogo | quadros renderizados do modelo 3D da Íris, modelado por código no Blender pelo squad games-creator |
| Pixel art | criada em código pelo squad games-creator do Opensquad |
| Música e efeitos | compostos e sintetizados pelo squad games-creator, sem arquivo de terceiro |
| Trilha orquestral | as três fases, feitas no Suno a partir de faixas do jogo |
| Álbum da trilha | A Marcha da Lanterna, com as faixas do jogo, em 8-bit, e as orquestrais: Ouvir no Musicplay.club (abre em nova aba) |
| Fonte | VT323, de Peter Hull — SIL Open Font License 1.1 |
| Modelo de IA | Opus 5.5 |
| Motor | engine-vertical, TypeScript e Canvas 2D, sem dependência de execução |
Trilha orquestral, a padrão (config.trilhaArquivo.credito): Bosque, Charco e Cidadela, versões orquestrais: suno-studio (Suno), a partir de faixas chip do jogo (a do Charco parte do Charco v3, composto para ela). A folha Créditos do jogo também a cita.
Fora de escopo
- Conta, ranking online e servidor: o placar é local.
- Trilha em arquivo nas outras fases: a config declara faixa só para
partida1,partida2,partida3; nas demais músicas, mesmo com a orquestral ligada, toca a trilha chip. - Controle (gamepad) nos menus: só na partida.
- Multi-idioma: um idioma por jogo (
pt-BR).
Pendências registradas pelo motor
- QA com gente: calibrar dificuldade (o robô é melhor que uma pessoa), sobretudo a grelha da Cidadela (o pisoteio do Cervo saiu na 1.4.0).
src/plataforma/render.tspode usarposicoesOrbitais(chefe, cfg)em vez de recalcular a órbita.
Dívida técnica declarada pelo QA: funções-fábrica acima de 60 linhas, mantidas com motivo (ver o histórico).
Histórico de versões
Resumo da ficha e, em cada versão, o registro completo do build-report.
| versão | o que mudou (ficha) |
|---|---|
1.5.3 | o endereço novo do perfil no Musicplay.club nos links do álbum |
1.5.2 | o link do álbum da trilha no Musicplay.club nos créditos |
1.5.1 | trilha orquestral (Suno) como padrão e a 8-bit como opção na pausa, o tiro na ponta da besta (altura do cotovelo), a espera vazia antes de cada chefe pela metade e a cena de vitória parada no último quadro até o botão Continuar |
1.5.0 | chefes pintados em alta resolução (OpenArt, Nano Banana Pro), uma folha por chefe carregada só na fase dele |
1.4.0 | Íris de 128 px renderizada do modelo 3D v2, campo na resolução da tela e chefes só com o tiro normal (sem pisoteio, girinos nem espiral) |
1.3.2 | vídeos de vitória refeitos com a Íris v2 (sem capa, cabelo solto) |
1.3.1 | Íris redesenhada pelo modelo 3D v2 (sem capa, cabelo solto), pinturas repintadas e trilha Suno nas três fases |
1.3.0 | chefes com projéteis reconhecíveis (flechas, lodo, girinos, corvos) e trilha orquestral do Suno no menu |
1.0.0 | 1º QA (544×960) |
1.1.0 | câmera 1,5×, modo horizontal, vídeos, VT323 e correções do ciclo 1 |
1.2.0 | correções do ciclo 2, enguia só na água, vitórias-régias, vídeo em retrato, bônus esperando o botão |
1.2.1 | vitórias-régias poucas e discretas, tábua podre redesenhada, Padrão de volta ao nível anterior |
1.2.2 | Íris avança até a borda da frente (nos dois modos), carência de contato na entrada, salto do sapo sempre termina |
1.2.3 | primeiro golpe dos chefes só depois da cartela (tempos.cartelaDoChefe) |
1.2.4 | textos do Morcego-Folha e do Musguinho fiéis ao comportamento |
1.4.0
Íris de 128 px renderizada do modelo 3D v2, campo na resolução da tela e chefes só com o tiro normal (sem pisoteio, girinos nem espiral)
1.4.0O build-report ainda não tem a seção 1.4.0; este é o registro do motor (engine-vertical/NUCLEO.md).
"No ataque dos chefões, deixe apenas os tiros normais de cada um (flechas, por exemplo) mas não, por exemplo, aquele ataque massivo com monte de galhos enchendo a tela." O "monte de galhos" era a trinca de chão que avisava o pisoteio do Cervo, pintada na faixa inteira da arena. Os nomes dos padrões ficaram (a config os escolhe por nome); o resto saiu.
- Cervo de Raízes: fica no posto e repete
mirar(0,8 s, chifres acesos e as linhas tracejadas) →flechas(soltar, 0,8 s) →peito(janela de 2,6 s; 2,2 no estágio 2). A rajada vem a cada ~4 s (eram ~9 s com o pisoteio). Saíramaviso,pisoteio,retorno,peito2e os parâmetrosvelocidadePisoteio,bandaY,aviso,retorno. - Matriarca do Lodo: cospe as bolas de lodo miradas (boca aberta = janela), mergulha e ressurge onde as bolhas de aviso sobem. As bolas continuam se partindo em 3 respingos. Saíram o estado
invocaregirinos,invocar,velocidadeGirino,voltasGirino; na instância, o projétilgirinoe a frase dele. - Arauto da Bruma: o leque de
orbes(3) corvos mirado em Íris a cadaintervaloOrbe(1,6 s), a luta inteira. A Bruma continua fechando as laterais no estágio 3 (não é tiro: é a arena que aperta, e cada Lanterna a faz recuar). Saíramdirecoes,intervaloEspiral,giroEspiral,corredor,oscilacao,arco. - Validação:
PROJETEIS_DO_PADRAOpede um papel só por chefe (flecha,bolha,orbe). - Testes (
chefes.test.ts, "pedido do dono (03/11/2026)"): cada chefe só lança a forma dele (a Matriarca, bola e respingos, nunca girino); o Cervo não sai do posto, não pinta trinca de chão e mantém a mira avisada; o mergulho da Matriarca segue avisado pelas bolhas; nenhum chefe fica mais de 5 s sem atirar (o Arauto, 2 s) e a janela abre em mais de 40 % da luta. No Arauto, todo disparo dos estágios 2 e 3 é um leque centrado em Íris, nunca mais de 9 corvos na tela. - Dificuldade: na partida automática de teste nenhum chefe acertou Íris, e o robô chega à fase 3 em todas as partidas na Lendária (eram 67 %). Combina com o pedido; o dono aprovou a 1.4.0 assim, sem compensação.
versao1.4.0 (config e ficha), junto com a Íris de 128 px da plataforma (verPLATAFORMA.md).
1.3.0
chefes com projéteis reconhecíveis (flechas, lodo, girinos, corvos) e trilha orquestral do Suno no menu
1.3.0O build-report ainda não tem a seção 1.3.0; este é o registro do motor (engine-vertical/NUCLEO.md).
"Os chefões jogam um monte de coisas repetidas no jogador, mas o que são??? Muito confusas... E exageradas." A troca: cada chefe atira um OBJETO que se lê de relance, em menor número e maior.
- Cervo de Raízes: as colunas de raízes saíram. No lugar, a rajada de flechas de madeira (
flechaMadeira: haste de madeira, ponta de pedra, penas pálidas).- Ciclo
aviso → pisoteio → retorno → peito → mirar → flechas → peito2(o pisoteio não mudou). mirar(mira= 0,8 s): a cabeça baixa, as pontas dos chifres acendem em pálido (spritecervoRaizes.mirar) e a mira trava onde Íris está; uma linha tracejada de 170 px (MIRA_DA_FLECHA) por flecha mostra o leque. Eventoavisomira. Na posemiraros chifres vêm baixos, sobre os ombros: no retrato, a barra do chefe cobre ~52 px do alto da arena, e as pontas acesas ficam abaixo dela (revisão).flechas(flecha de 58 px de quadro, haste longa): o leque sai pelas mesmas linhas — 3 flechas em 30° no estágio 1, 5 em 48° no 2 (flechas,lequeFlecha), do focinho (saidaDosDisparos= 20 px). As flechas respeitam os 80 px; não há mais exceção.soltar(0,8 s) é a pausa depois da rajada. Parâmetros que saíram:colunas,larguraColuna,duracaoRaiz.
- Ciclo
- Matriarca do Lodo: a bolha virou bola de lodo (
bolaLodo, marrom-esverdeada, com rastro que pinga), que se parte em 3 respingos de lodo (respingoLodo, um borrão de lama em estrela de 5 pontas; a bola tem só um pingo curto, para não parecer girino). Ao partir, o eventoacertolevaestouro: 'bolaLodo'e a plataforma desenhaefeitos.estouro.bolaLodo(3 quadros, 0,27 s) — a bola nunca some calada, nem quando os respingos não nascem por estarem a menos de 80 px de Íris. Os girinos ganharam cabeça redonda com olhos e cauda que ondula, e caíram para 5 e 6 por cardume (eram 8 e 10). - Arauto da Bruma: orbes e fagulhas viraram corvos de névoa (
corvoNevoa, o mesmo sprite nos dois papéis): corpo e asas em noite, bordo de ataque em névoa, contorno pálido para ler sobre a obsidiana. Espiral de 10 e 12 direções (eram 16 e 18), com a mesma regra do corredor livre, e — depois da revisão — só no arco de 140° voltado para Íris (arco, padrão 360 no catálogo), com 0,55 s no estágio 3 (era 0,5). Os corvos que ameaçam são os mesmos; os que subiam para baixo da barra ou saíam pelas laterais deixaram de existir. Corvos na tela, com o robô jogando: estágio 2 pico 13 (era 26), estágio 3 pico 14 e média ~10 (eram 35 e 26). Teste: pico ≤ 15. - Orientação: os sprites desses projéteis apontam para +x e a plataforma os gira para a velocidade (
visual.jogo.projeteisOrientados; o giro é no mundo, então vale na vista deitada). - Caixa de acerto ≤ corpo visível: o centro do quadro é o centro da caixa, e todo pixel a menos de
raiodele é opaco (teste). Raios: flecha 4 (a ponta de pedra), bola 11, respingo 4, girino 6 (a cabeça), corvo 5. - Testes (
chefes.test.ts): contagem, mira e aviso da rajada (cada flecha sai por uma linha avisada ≥ 0,8 s antes; a do meio aponta para Íris); quantidades de girinos e corvos; corredor da espiral; caixa dentro do sprite; Íris colada no Cervo não suprime rajada. - Dificuldade (régua do QA, Padrão, 250 ms, 16 partidas; as 8 primeiras são as do QA):
| vitórias | continuações (média) | quedas (média) | dano dos chefes* | |
|---|---|---|---|---|
| 1.2.4 (antes) | 12/16 | 2,25 | 8,5 | raiz 30, orbe 5, girino 4, bolha 2, Cervo 7 (+ pedaços de bolha somados em "gota" 40) |
| 1.3.0 sem compensar (flecha 210 px/s, leque 56° no estágio 2) | 13/16 | 1,81 | 7,25 | flecha 4, respingo 26, corvo 5, girino 3, Cervo 8 |
| 1.3.0 com compensação (flecha 250 px/s, leque 48°) | 12/16 | 1,88 | 7,4 | flecha 12, respingo 15, corvo 3, girino 1, bola 1, Cervo 8 |
| 1.3.0 final (+ arco de 140° no Arauto, 0,55 s no estágio 3) | 12/16 | 1,88 | 7,4 | idêntico à linha de cima (corvo 3) |
* número de eventos dano por causa, somado nas 16 partidas. A raiz do Cervo dava ~30 acertos e a flecha não chegou a isso: a compensação (flecha mais rápida e leque mais fechado no estágio 2) devolveu parte. As vitórias voltaram a 12/16; as continuações ficaram um pouco abaixo (1,88 contra 2,25), dentro do ruído de 16 partidas — a Cidadela (espinho, grelha, Cavaleiro) segue decidindo quem perde. Nada além disso foi mexido.
versaonão mudou aqui (fica para quem fechar a versão).
1.2.4
textos do Morcego-Folha e do Musguinho fiéis ao comportamento
1.2.402/11/2026. Build congelado. jogo.js b1912f9e0985b148959deefcef8b1490 (só a versão mudou) · index.html ab5724abde54db2328851dfd1681c546 (os textos moram nele) · versao.json 25299596b34539cfb4e78a6a6cf9a33b; o resto igual ao da 1.2.3. 320 testes verdes, medir-revisao passa nas 8 telas.
| texto | antes | depois |
|---|---|---|
| Morcego-Folha | "Voa em bando de cinco, numa onda." | "Voa em bando de quatro, numa onda." (a config usa bandos de 4 nas 6 ondas) |
| Musguinho | "Gnomo de musgo. Desce em linha reta." | "Gnomo de musgo. Desce devagar, puxando para o seu lado." (deriva até 20 px/s rumo a Íris) |
| dica do Musguinho | "Ele só desce em linha reta: saia da coluna dele e atire de baixo." | "Ele desce puxando para o seu lado: não espere — atire antes que ele chegue." |
Os demais textos de inimigos, chefes e itens foram conferidos contra a config, números incluídos, e batem. Uma observação: a descrição do Lanterneiro Afogado não diz que ele também dispara uma gota. Está incompleta, mas não é falsa.
1.2.3
primeiro golpe dos chefes só depois da cartela (tempos.cartelaDoChefe)
1.2.3Gabriel Gameplay 🕹️ · 02/11/2026, 03h53. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata do dist, mais o game.yaml.
| arquivo | md5 |
|---|---|
jogo.js | 6569f949ca1d5e7abecdafaf14bf82d9 |
estilo.css | 4cbbefd83f8105ef3534ec3d0b5b1c86 |
index.html | 822078f72fcb552a9370984ad6287afe |
versao.json | 9de5077b63164f0758fcfb2fbd9c4e7d |
| atlas, vídeos e demais | iguais aos da 1.2.2 (PLATAFORMA.md) |
Peso: JS 58,6 KB gzip · pasta 4,56 MB · versão 1.2.3 = ficha. Verificação: 320 testes verdes e tsc limpo, às 03h52.
| # | origem | como foi resolvido |
|---|---|---|
| C4 | revisão visual (verificação do 1.2.2) | no celular deitado, Som compacto (20 px, alvo ≥ 44 px) e JOGAR de volta a 32 px; JOGAR = 2,37× a área do Som; checagem permanente JOGAR ≥ 1,5× Som em todas as telas |
| cartela × 1º golpe | revisão visual (observação) → decisão do runner pelo GDD ("toda ameaça forte tem aviso antes") | tempos.cartelaDoChefe (1,6 s) é fonte única: a plataforma desenha a cartela por esse tempo, e o chefe não avisa, não atira e não fere por contato antes dele (Arauto: 2 s, por causa da descida) |
| atalho na arena | achado do núcleo | colada sob o chefe, Íris suprimia os disparos dele (regra dos 80 px). Agora, na arena, a frente dela para a 80 px do ponto de disparo (heroina.distanciaMinimaTiro, fonte única); toda rajada sai inteira, e os 3 chefes acertam Íris parada na frente |
| calibração | — | Padrão (250 ms, 8 sementes): 6/8, 2,5 continuações (antes 2,375), dentro do intervalo de 95 % medido pelo QA (2,08–2,61) |
Capturas: capturas/p11-*.
1.2.2
Íris avança até a borda da frente (nos dois modos), carência de contato na entrada, salto do sapo sempre termina
1.2.2Gabriel Gameplay 🕹️ · 02/11/2026, 02h37. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata do dist, mais o game.yaml.
| arquivo | md5 |
|---|---|
jogo.js | 9f4fb48c642a66be6bd0b5f4d2aa1b33 |
estilo.css | 0035daec8195cfd83a9ad2794aae9e68 |
index.html | ccd42c1335066abb9fc23240cb41ec14 |
atlas.png / atlas-fase3.png | 3bfd16c765f784b1aa639d15623f26ce / 0df4be8cbb2ca8e451f514e7c61ee0a6 |
| vídeos, pôsteres, pinturas, fonte, capas | iguais aos da 1.2.1 (tabela completa no PLATAFORMA.md) |
Peso: JS 58,5 KB gzip · pasta 4,56 MB · versao.json = 1.2.2 = ficha.
Verificação: 317 testes verdes e tsc limpo, rodados por mim às 02h35 com a máquina livre. Duas rodadas sob CPU disputada (196 s e 238 s, outras sessões rodando Chromium) acusaram "1 error" sem teste reprovado. Fica registrado como fragilidade de tempo da suíte sob carga: rodada isolada passa limpa.
O que mudou
| # | origem | como foi resolvido |
|---|---|---|
| avanço | pedido do dono ("até mais perto da margem direita, na mesma distância mínima da esquerda"; "nos dois modos") | heroina.margemFrente = 0, com Íris a 180 px/s até encostar. Não havia amortecimento: o teto antigo de 35 % andava com a rolagem. Na arena, Íris para na caixa do chefe. Inimigo que entra pela frente não fere por contato nos primeiros 0,5 s (heroina.contatoNaEntrada). Com Íris colada na frente, 0 projéteis nascem a menos de 80 px. Padrão em 7/8 com 2,375 continuações (régua de 250 ms), sem mudança além do ruído |
| avanço × HUD | consequência | em pé, com Íris sob a faixa do HUD, HUD, barra do chefe e cartela ficam com 35 % de opacidade; deitado, a frente é a borda direita, livre de interface |
| C3 | revisão visual (verificação do 1.2.1) | iPhone SE: capa a 568 × 320 com logo de 141 px na faixa da arte, subtítulo de 20 px e JOGAR compacto; cartelas abaixo do HUD e da barra do chefe, nunca maiores que o campo; nome do chefe nunca com reticências (16 px na faixa estreita) e mostrado uma vez só; 568 × 320 e 320 × 568 fixos no medir-revisao |
| PI-2 | revisão de PI | Créditos: "Arte da capa e das cenas de vitória: gerada com IA no OpenArt (Nano Banana Pro; vídeos com Kling 3 Omni)" |
| PI-5 | revisão de PI (opcional, adotada) | Cavaleiro de Cinza sem chifres (elmo liso com viseira de grade), silhueta 4,12 / 4,29 na Cidadela; 4 notas trocadas (Charco ×2, Cidadela, Vitória), com no máximo 4 intervalos iguais a qualquer melodia conhecida |
| sapo | registro do QA | o salto termina mesmo saindo da faixa da tela |
Capturas: capturas/p10-*.
1.2.1
vitórias-régias poucas e discretas, tábua podre redesenhada, Padrão de volta ao nível anterior
1.2.1Gabriel Gameplay 🕹️ · 02/11/2026, 00h40. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata de engine-vertical/dist/a-marcha-da-lanterna/, mais o game.yaml.
| arquivo | md5 |
|---|---|
jogo.js | d90a6c54128d62c80bb457be1cbcd1ec |
index.html | af35cec676b01138f36277f69c9a113c |
atlas.png / atlas-fase3.png | ccab31321153e8d26f4349c64c72fbbe / f78d2ba58fb41682647e180b4c77f55c |
| CSS, vídeos, pôsteres, pinturas, fonte, capas, ícones | iguais aos da 1.2.0 (tabela completa no PLATAFORMA.md) |
Peso: JS 57,8 KB gzip · pasta 4,56 MB (91 % do teto de 5 MB) · versao.json = 1.2.1 = ficha.
Verificação: 24 arquivos e 303 testes verdes, rodados por mim às 00h38. Uma rodada anterior, sob carga (196 s), acusou 1 erro de tempo; as rodadas seguintes, 303/303. Fica registrado como instabilidade de tempo sob CPU disputada.
O que mudou desde a 1.2.0
| # | origem | como foi resolvido |
|---|---|---|
| C1 | revisão visual (ciclo 3) + decisão do dono "poucas e discretas" | vitórias-régias em ~8 % dos tiles de água, nunca vizinhas, com par para o sapo; folha no tom da água (#1F5C5A), 3 variantes, fora da grade por deslocamentoDaVitoria(l, c) (o sapo pousa no mesmo ponto); bordas fortes do Charco de 1,0 a 3,2 % |
| C2 | revisão visual (ciclo 3) | tábua podre desenhada como tábuas de ponte com musgo, em 3 quadros que mudam pela forma; no mapa, só como ponte extra alinhada, com terra nas pontas (0 tábuas soltas em 50 sementes × 3 fases) |
| QA-1 | QA (ciclo 3) | o foco vai para "Seguir a marcha" ao pular o vídeo por toque ou clique |
| QA-2 | QA (ciclo 3) + decisão do dono "voltar ao nível anterior" | Sapo-Arqueiro mais justo (cadência 3,0 s, aviso 0,6 s, leque 44°, alcance de 300 px); Padrão a 2,25 continuações médias com reação de 250 ms (6 a 7 de 8 vitórias conforme a amostra) |
| QA-3 | QA (ciclo 3) | celular pequeno deitado (568 × 320): campo de 320 × 176 para 376 × 207. O resto é limite conhecido (PLATAFORMA.md) |
| mapa | achado nas capturas p9 | ruinas() não escreve mais água no meio da grama (vira entulho #); água só em rio, campo de lava e lago da arena (0 fora do lugar em 50 sementes × 3 fases) |
| borda | achado nas capturas p9 | borda sólida do Charco em musgo escuro #2F4A2A (lia como poça em #1F5C5A) |
Capturas: capturas/p9-*.
1.2.0
correções do ciclo 2, enguia só na água, vitórias-régias, vídeo em retrato, bônus esperando o botão
1.2.0Gabriel Gameplay 🕹️ · 01/11/2026, 20h50. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata de engine-vertical/dist/a-marcha-da-lanterna/, mais o game.yaml. O md5 de cada arquivo está no PLATAFORMA.md § 1.2.0.
| arquivo | md5 |
|---|---|
jogo.js | dcc38a33aa6dd3dc6a6eccfe97076e79 |
estilo.css | a907ce6b2580a23d27f2120136f83d50 |
index.html | 574c939272d2936e87151ff48b86604d |
cenas/vitoria-fase1.mp4 / -retrato.mp4 | a0b9026ef99b7f752da7419656173e89 / 1e79d040b17e55258c776a2d16032725 |
cenas/vitoria-fase2.mp4 / -retrato.mp4 | fe2615247cc8c6ff189808a8d4b6f42c / 110a557569de38c91ce484ab547ca2b8 |
cenas/vitoria-fase3.mp4 / -retrato.mp4 | 9aff30e538f57a1785a903f02ed70662 / ffe2e498363cfcc0980e3dd8244c2ec9 |
Peso: JS 57,1 KB gzip (teto 60) · CSS 4,8 KB · pasta 4,56 MB (teto 5 MB). Os 6 vídeos foram recodificados em CRF 33: 3,90 → 3,13 MB, com 4 quadros conferidos a olho; os originais seguem em assets/cenas/. versao.json = 1.2.0 = ficha.
Verificação: 24 arquivos e 296 testes verdes; tsc limpo, rodado por mim às 20h50.
Required changes atendidos (ciclo 2)
| # | origem | como foi resolvido |
|---|---|---|
| N1 | revisão visual | no celular deitado, o nome do chefe tem até 80 % da faixa do HUD (24 px numa faixa de 30), ao lado da barra |
| N2 | revisão visual | no celular deitado, Pausa e Lanterna ficam nas margens laterais, sem cobrir o campo; sem margem de 96 px, o palco reserva uma |
| N3 | revisão visual | farol, fim, final e recordes ganham corpo que rola e rodapé separado, com sombra e "Role para ver mais ▾" |
| N4 + QA-1 | revisão visual + QA | legendas fora do campo nas duas orientações (entre o campo e a barra de toque; coluna na margem esquerda no celular deitado; faixa de baixo nos demais), com max-content |
| N5 | revisão visual + decisão do dono | vídeo 9:16 em pé e 16:9 deitado; só o arquivo da orientação atual, só quando o chefe entra; girar durante o vídeo troca o arquivo no mesmo ponto |
| N6 | revisão visual | muralha da Cidadela em placas calmas de 64 px, sem grade; piso #2E2A40; contorno de Íris 3,48:1 em pé e 3,46:1 deitado |
| QA-3 | QA | anel de aviso também no Javali |
| QA-4 | QA | plural correto ("Nenhum coração." / "Resta 1 coração." / "Restam N corações."), e o anúncio diz o que atingiu Íris |
| QA-5 | QA | sem o atlas: tela de falha amigável, sem erro de página |
| bônus | decisão do dono | o quadro de bônus espera "Seguir a marcha" (10 s sem sumir, nas 3 fases e nas 2 orientações) |
| enguia | defeito relatado pelo dono | a enguia só salta de uma linha de rio perto de Íris, por cima da ponte (0 saltos sobre terra e 0 avisos de água fora da água, em 50 sementes); vitórias-régias (o) no Charco, e o sapo pousa nelas (0 pousos em ~); inimigos fixos só em chão firme; o resolverConfig recusa enguia sem rio |
Funções acima de 60 linhas
São 11: as 7 da plataforma listadas no ciclo 1 e mais 4 em som/. Mantidas pelo mesmo motivo (fábricas com estado numa clausura). Ficam como dívida técnica declarada.
Capturas: capturas/p8-*.
1.1.0
câmera 1,5×, modo horizontal, vídeos, VT323 e correções do ciclo 1
1.1.0Gabriel Gameplay 🕹️ · 01/11/2026, 18h30. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata de engine-vertical/dist/a-marcha-da-lanterna/. Ninguém mexe nele até o veredito do ciclo 2.
| arquivo | md5 |
|---|---|
jogo.js | 54cb02238d768e259458ad3e6e6e3ccf |
estilo.css | 2ae896eb8e06d84e98121cfff3e030b4 |
index.html | 5574c8e002b1e2e18aaec14ff1a0570c |
cenas/vitoria-fase1.mp4 | a07a3bb42d2fd40fa10e2477bd492adc |
cenas/vitoria-fase2.mp4 | 339098a2f9412d569f76dc90486fa787 |
cenas/vitoria-fase3.mp4 | 24e61990a7f2a59797b4f50732b47d97 |
Peso: JS 54,5 KB gzip (teto 60) · CSS 4,5 KB · pasta 3,3 MB (teto 5 MB) · versao.json = 1.1.0 = ficha.
Verificação: vitest com 22 arquivos e 268 testes verdes; tsc limpo, rodado por mim às 18h30. Abre por file:// com console limpo e sem pedidos externos.
Pedidos do dono incorporados (depois da 1.0.0)
| pedido | como ficou |
|---|---|
| Tudo 50 % maior | câmera 1,5×: a vista vai de 17 × 30 para 11 × 20 tiles (352 × 640). Fases e chefes reajustados; o robô vence na Branda e na Padrão |
| Modo horizontal | com a tela deitada, a mesma simulação é girada (640 × 352). Íris de perfil, inimigos virados para a esquerda; entrada e HUD giram junto; girar o aparelho pausa |
| Vídeo na vitória sobre o chefe | 3 vídeos de 9 s (OpenArt: Nano Banana Pro + Kling 3 Omni), carregados quando o chefe entra; puláveis; pinturas paradas com movimento reduzido |
| Fonte | VT323 em tudo, no lugar da Pixelify Sans |
Required changes atendidos
| # | veredito de origem | como foi resolvido |
|---|---|---|
| R1/Q1 | revisão visual + QA: fonte ilegível | VT323 (escolha do dono), num token único --fonte lido também pelo canvas; grade 16/24/32/48; ligaduras desligadas + U+200C; Pixelify removida do public |
| R2 | texto do canvas < 11 px | texto do canvas tem 28–48 px na tela; nome do chefe vai para o DOM; legendas a 24 px; nada abaixo de 20 px |
| R3 | folha abre rolada | scrollTop = 0 depois de abrir |
| R4 | links de 19 px | alvo ≥ 44 px |
| R5 | cartela mais larga que o canvas | medida contra o retângulo do canvas |
| R6 | primário abaixo da dobra | teto de altura no farol, no final e nos recordes |
| R7 | rolagem lateral a 320 px | minmax(0, 1fr); e o defeito novo achado nas capturas p7 (palavra partida "Dentistas.c/om.br" com a VT323): rótulo sobre valor até 560 px e desenho sobre texto até 380 px; o medir-revisao.mjs passou a checar palavra partida |
| R8 | legendas cobrindo a ação | legendas fora da área de jogo |
| R9 | "[a balista mira]" em toda fase | legenda nomeia o inimigo que avisa |
| R10 | franja colorida no texto do canvas | texto no DOM / canvas sem LCD |
| R11 | contraste da Cidadela | piso escuro #2B2730, contorno cobre para quem joga na fase 3 (atlas-fase3.png), lava calma #4A2A22 com borda #B8322E; Íris 3,70:1 (vertical) e 3,65:1 (horizontal) |
| Q2 | P não sai da pausa | borda de tecla; teste sabotado reprova |
| Q3 | aviso do Cogumelo-Vigia invisível | sprite inchar redesenhado (difere do parado em 504–569 de 1024 px), anel de aviso, quadros 0 → 1 uma só vez (quadroDoAviso, testado) |
| Q4 | grama quadrada sob pedras no caminho | o sólido sobre o caminho é pintado sobre o caminho; testado |
| Q-conteúdo | espinho causa 44 % do dano e não era explicado | seção "Terreno" no Conteúdo, com 7 itens e o desenho de cada um |
| Q5 | build trocado durante o QA | versão 1.1.0, md5 acima, pasta congelada |
| — | subtítulo da capa 3,64:1 a 320 × 568 | véu próprio do bloco de título em retrato baixo: 9,28:1; pior caso da capa 7,34:1 |
Funções acima de 60 linhas (mantidas, com motivo)
criarRender (489), criarSuperficies (391), criarEfeitos (153), criarEntrada (149), criarCenaDeVitoria (148), montar do atlas (113), criarDialogos (74). São fábricas com estado mútuo numa clausura; as funções internas têm menos de 60 linhas, e as partes puras foram extraídas e testadas. Quebrar agora espalharia estado mutável às vésperas do build congelado. Fica como dívida técnica declarada.
Capturas do laço: capturas/p7-*.
1.0.0
1º QA (544×960)
1.0.0Run 2026-11-01-091453 · step-06 · Gabriel Gameplay 🕹️ · 01/11/2026.
O motor novo squads/games-creator/engine-vertical/ foi construído em três frentes paralelas, com contrato comum (ARQUITETURA.md, src/core/tipos.ts, src/plataforma/som/api.ts):
- núcleo:
NUCLEO.md; - plataforma:
PLATAFORMA.md; - som:
SOM.md.
Build: $env:JOGO='a-marcha-da-lanterna'; npm run build (PowerShell) → dist/a-marcha-da-lanterna/, copiado para output/2026-11-01-091453/jogo/, com a ficha game.yaml dentro.
Arquivos
| arquivo (jogo publicado) | KB | gzip |
|---|---|---|
index.html | 15,8 | 4,1 |
jogo.js (núcleo + plataforma + som + config resolvida) | 167,4 | 56,8 (teto 60) |
estilo.css | 13,5 | 3,8 (teto 20) |
atlas.png (os 128 sprites, PNG indexado gerado no build) | 58,1 | — |
capa-paisagem.webp / capa-retrato.webp | 78,3 / 69,1 | — |
og.jpg 1200 × 630 | 79,3 | — |
logo-escuro.svg / logo-claro.svg / favicon.svg / icon-192.png / icon-512.png | 5,4 / 3,9 / 0,7 / 0,8 / 2,1 | — |
fonte/PixelifySans-latin.woff2 + fonte/OFL.txt | 12,0 + 4,5 | — |
manifest.webmanifest, versao.json, game.yaml | < 5 | — |
| pasta inteira | ≈ 534 KB | teto 5 MB |
Fonte no motor: src/core/ (17 módulos), src/plataforma/ (render, superfícies, HUD, efeitos, cenas, telas, folhas, entrada, laço, atlas, armazenamento, atualização, legendas, som/), src/arte/ (dados), games/a-marcha-da-lanterna/{config,textos,visual}.json.
Funções principais
| função | responsabilidade |
|---|---|
criarPartida(cfg, opcoes) | monta o estado: mapa da fase gerado dos trechos (corredor ≥ 3 tiles garantido), Íris, câmera no pé da fase |
passo(estado, entrada, cfg) | um passo fixo de 1/60 s: rolagem, Íris, armas, inimigos por comportamento, chefes por padrão, colisões, itens, pontuação; emite eventos |
continuar(estado, cfg) | volta ao último marco, zera os pontos e gasta uma continuação |
resolverConfig(cru) | a porta única. Roda no BUILD e lista todos os problemas de uma vez; o bundle leva a config já resolvida |
laco / render / superficies | passo fixo com acumulador; canvas 544 × 960; chão calmo pintado por pisos.ts em pedaços cacheados |
telas / folhas | capa com o contrato da 1ª página; dificuldade e treino; pausa; farol; fim; final; recordes; folha única Detalhes · Conteúdo · Créditos |
criarSom() | PSG próprio (3 pulsos + ruído), 8 composições originais, efeitos por evento; abre mudo |
Verificações do próprio build
- Tipos e testes:
npx tsc --noEmit -p .limpo;npx vitest runcom 19 arquivos e 234 testes verdes, rodado por mim em 01/11, 16h33. Cada frente sabotou o próprio teste para provar que ele reprova. - Arquivo local: abre por
file://sem erro no console e sem pedido para fora da pasta (Playwright).grepporsrc/hrefexternos noindex.htmlencontrou 0. A única ocorrência de "http" nojogo.jsé a URL do jogo emidentidade.url, que é texto. - Jogo inteiro atravessado no build de vitrine, com o robô do núcleo e Íris invulnerável: Bosque → Cervo → farol → Charco → Matriarca → farol → Cidadela → Arauto (3 estágios) → farol → final → recorde salvo, console limpo (capturas
p5-vitrine-*). No build de produção, a fase 1 foi jogada de verdade até o fim de jogo e o continuar (p3-partida-*). - Playtest do núcleo, sem invulnerabilidade, com o robô:
| dificuldade | resultado | |---|---| | Branda | vence 100 % | | Padrão | vence 100 % | | Lendária | chega à fase 3, vence 0 % |
O robô reage melhor que uma pessoa, então falta a calibração com gente.
- Contrato da 1ª página, testado no DOM:
- os botões Detalhes · Conteúdo · Créditos;
- "Som: desligado/ligado" por palavra, começando desligado e com a preferência salva;
- JOGAR como protagonista.
- Atualização automática:
versao1.0.0 igual à da ficha,versao.jsone?v=.scripts/teste-atualizacao.mjspassa e, com--sabotar, reprova (laço de recarga detectado). - Contraste da capa, medido no pixel pintado: ≥ 5,83:1 em 1366, 390 e 320 px.
- Ligaduras da Pixelify Sans:
font-variant-ligatures: noneno CSS e U+200C no canvas, com teste. - Som: 76 testes e 8,2 KB gzip; avisos 5 a 8 dB acima da música. Escuta aprovada pelo dono em 01/11, depois de duas reescritas (Entrada e Vitória).
Desvios do GDD
| o que | por quê |
|---|---|
| Resolução 544 × 960 (17 × 30 tiles de 32 px), e não 270 × 480 | pedido do usuário no step-05: dobro da resolução e do detalhe; 17 colunas inteiras (272 → 544) em vez de 270 |
| Vida dos chefes 120 / 150 / 280 (GDD: 60 / 90 / 140) | com a vida do GDD as lutas duravam 17 a 64 s; o próprio GDD pede de 60 a 120 s. Medido no playtest |
| Arauto: estágio 2 ao quebrar os 4 escudos, estágio 3 a 45 % da vida; a Bruma deixa uma largura livre mínima de 224 px e cada bomba a recua 120 px | o GDD não dava os gatilhos; os números garantem um corredor sempre existente |
| Raízes do Cervo podem nascer a menos de 80 px de Íris (até a 1.2.4) | eram terreno, com 0,8 s de aviso no chão, e não projétil disparado. Na 1.3.0 as raízes saíram: o Cervo atira flechas, e a regra dos 80 px vale sem exceção |
| 3 vidas no total, e Íris mantém a arma ao cair | menos punição em cascata; a dificuldade já vem da rolagem |
| Inimigos e projéteis inimigos ignoram o terreno | só Íris e os tiros dela colidem com sólido; evita inimigo preso em tronco |
| Carregamento com progresso por recurso, não por bytes | sob file:// não há fetch para medir bytes |
resolverConfig() roda no build e não no navegador | o validador pesava ~4 KB gzip e passava o teto de 60 KB; continua sendo a única porta, e config inválida PARA o build |
| Controle (gamepad) só na partida | os menus usam teclado, mouse e toque |
Problemas conhecidos (vistos por mim nas capturas, para o QA confirmar)
- Legibilidade da fonte da interface: a Pixelify Sans renderizada fecha o "C" em "O" ("Oonteúdo", "Oervo de Raízes" na barra do chefe) e deixa o "B" com cara de "G" ("Gruma", "Gestiário", "Gosque"). A plataforma relatou também "Z" parecido com "2" e "5" com "S". Afeta capa, folhas e HUD.
- Fase 1: pedras e troncos sobre o caminho de terra são pintados com um quadrado de grama atrás (
p5-partida-390x844.png, pedras no meio do caminho). - Celular (390 × 844): faixas escuras grandes acima e abaixo da área de jogo (efeito do 9:16 com escala inteira). Avaliar se a moldura temática deveria ocupar esse espaço.
Fora deste build
manual.htmlemanual-do-usuario.pdf: step-09. Os links em Detalhes já apontam para eles.- Trilha suno-studio: adiada para a 1.x por decisão do dono no step-05; entrou na 1.3.0 (Bosque) e na 1.3.1 (Charco e Cidadela), como opção do menu de pausa.
- Calibração de dificuldade com pessoas: QA.