← Voltar ao jogo

Referências técnicas — A Marcha da Lanterna

Versão 1.5.3 · motor engine-vertical · para quem vai manter o jogo.

Números medidos no build congelado em 04/11/2026. Manual do jogador: manual.html e PDF ilustrado.

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.

Leis do motor

  1. src/core/ é puro. Sem document, window, navigator, localStorage, setTimeout, requestAnimationFrame, performance, Math.random ou Date.now. Tempo entra como passo fixo; aleatoriedade, por Rng semeado (core/rng.ts). O núcleo emite eventos; a plataforma desenha e toca. Garantido por tests/pureza.test.ts (varre o texto dos arquivos de src/core/).
  2. 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 no index.html).
  3. Nenhum if por jogo. Diferença entre jogos vira campo de config.
  4. resolverConfig() é a única porta para a config crua (defaults + validação; lança com mensagem clara).
  5. Números vivem na config (velocidades, vidas, dano, cadências, padrões de chefe, trechos, ondas).
  6. 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.
  7. 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

arquivopapel
api.tscontrato Som (não muda)
sintetizador.tsPSG 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.tsas 8 composições originais como texto + o leitor que as compila (puro, testável)
efeitos.tsPOR_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.tssuno-studio opcional: webm/opus → m4a, carga sob demanda, loopStart/loopEnd (segundos); falha → toca a versão chip
index.tscriarSom(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çãotomBPMcompassosduraçãoformaloop
entradaRé maior (♭VII e ♭III emprestados)1442440,0 sA1 A2 B1 B2 A1 A2sim
partida1 (Bosque)Mi menor1323258,2 sa b a b c d a bsim
partida2 (Charco)Lá menor, shuffle 2/31203264,0 sa b a c d d a csim
partida3 (Cidadela)Dó menor harmônico1443253,3 sa c a c d e a csim
chefeFá♯ menor1501625,6 sa a b asim
farolAcesoRé maior (I–IV–V–I)15634,6 s + 0,3 s de solturaFnão
vitoriaRé maior (I, IV, V, V/V, ♭VII; nenhum menor)1602030,0 s + 0,3 s de solturaI A1 A2 A3 A4 Fnão
fimDeJogoRé menor10824,4 s + 0,4 s de solturaFnão

Resolução e orientação

Passo e tempo

Estrutura de arquivos

A pasta publicada (build congelado 1.5.3)

arquivotamanho
audio/partida2.webm391,2 KB
audio/partida2.m4a389,0 KB
audio/partida1.m4a382,1 KB
audio/partida1.webm381,2 KB
audio/partida3.m4a354,7 KB
audio/partida3.webm345,8 KB
sprites/chefe-cervo.webp314,7 KB
jogo.js183,0 KB
sprites/iris.webp174,3 KB
sprites/chefe-arauto.webp136,9 KB
capa-paisagem.webp85,5 KB
og.jpg82,8 KB
sprites/chefe-matriarca.webp79,7 KB
capa-retrato.webp74,2 KB
atlas-fase3.png66,8 KB
atlas.png65,7 KB
index.html36,5 KB
estilo.css19,3 KB
fonte/VT323-latin.woff217,9 KB
game.yaml12,0 KB
logo-escuro.svg5,4 KB
fonte/OFL.txt4,4 KB
logo-claro.svg3,9 KB
icon-512.png2,1 KB
icon-192.png0,8 KB
favicon.svg0,7 KB
manifest.webmanifest0,6 KB
versao.json0,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
arquivoo que faz
vite.config.tsplugins: 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.mjsas strings de src/arte/ viram UM PNG indexado (24 cores + transparente) e um mapa de quadros
index.html · src/styles/{tokens,jogo}.cssDOM das telas; tokens de cor (reserva no CSS, valores de visual.cores escritos pelo main.ts)
src/main.tsintegraçã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.tsrAF + 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.tsteclado, 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.tscarrega o PNG por <img>; desenho, silhueta (contorno de acerto/invulnerável), sprite ampliado para as folhas
src/plataforma/superficies.tso 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.tscanvas 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.tscapa (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.tslocalStorage 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.jsonTODO texto visível
games/a-marcha-da-lanterna/visual.jsontokens 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.tsa cena de vitória (vídeo → pinturas → pixel art), pulável, teto de 15 s
tests/plataforma-*.test.ts1ª 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çãoo que faz
resolverConfig(cru) → ConfigResolvidaa 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, limitesDaHeroinageometria para desenho
compararRecordes, registrarRecorde, entraNoTop, normalizarApelido, contaParaRecorde, bonusDaFaseranking 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

chartilecolideefeito
.chãonão—
#sólido (tronco, pedra, muro, pilar)simbloqueia Íris e projéteis de Íris
~água / lavasim para Íris, não para tirosbloqueia Íris
^espinhonãodano ao tocar
,lamanãovelocidade × 0,5
=pontenão— (chão sobre ~)
%tábua podrenãoafunda 1,5 s depois de pisada → vira ~ (aviso: range e escurece)
ggrelha de fogonãociclo da config; acesa = dano; aviso 0,7 s antes
Pportãosimabre (vira .) quando os cristais c do mesmo portão são destruídos
ccristal da portasim4 de vida; alvo de tiro
ovitó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.

arquivoo que tem neste jogo
config.jsonversã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.jsontodo 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.jsontokens 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)

DificuldadeCorações por vidaVidasContinuaçõesRolagemVida dos chefes
Branda53sem limite80 %80 %
Padrão333100 %100 %
Lendária13nenhuma100 %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):

arquivomd5no build-report
jogo.jse7a145d4c0659c07963ad9e076f4590f—
estilo.cssa9a15eed2aa2bacca52d3677e17fac49—
index.htmla29b501f70fd1521c2f091bfdd8ddb10—
atlas.png90af9ab1f41e62e564c6092f2f06aea6—
atlas-fase3.png366a0f6ed77a057ec465d0c4505e5512—
sprites/iris.webp0f2fd5b2531541e2d81b8fd75485827c—
sprites/chefe-cervo.webp611bafa68b6754e8611404f620ced689—
sprites/chefe-matriarca.webpa59a71a22d418a62400b1485ab13d117—
sprites/chefe-arauto.webpe96f87845e86d61d10afe37710005b82—
versao.json277375e0fcad4eaf1758d90aea3dad80—

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

itemcrugzip (nível 9)teto
jogo.js183,0 KB61,9 KB70,0 KB gzip
estilo.css19,3 KB5,0 KB—
index.html (com os textos)36,5 KB11,3 KB—
cenas/3,94 MB——
pasta do jogo7,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:

CampoResultadoMediçã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:

ItemResultadoEvidência
G4 — autocontençãoPASSOs 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 limpoPASS0 mensagens: teclado, capa em 5 telas, vitrine nas 2 orientações.
G6 — jogável até o fimPASSVitrine até o final e os recordes, em pé (390×844) e deitado (1366×768) (vitrine-*.txt).
Peso e file://PASS4.565.908 bytes (91 % do teto). 0 console. no jogo.js. Abre por file://.
TecladoPASSOrdem do Tab, foco 3 px, Esc fecha as folhas e devolve o foco, Esc volta da dificuldade.
VídeosPASSRetrato em pé, 16:9 deitado, todos tocando. 0 pedidos no carregamento e na 1ª travessia.
Bônus espera o botãoPASS10 s depois de cada cena, nas 3 fases e nas 2 orientações.
Charco — mapa (30 sementes)PASS450 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

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)

Créditos

ProduçãoDentistas.com.br
AutorJúlio César Ventura Cardoso
Arte da capa, das cenas de vitória e dos chefesgerada com IA no OpenArt (Nano Banana Pro; vídeos com Kling 3 Omni)
Íris no jogoquadros renderizados do modelo 3D da Íris, modelado por código no Blender pelo squad games-creator
Pixel artcriada em código pelo squad games-creator do Opensquad
Música e efeitoscompostos e sintetizados pelo squad games-creator, sem arquivo de terceiro
Trilha orquestralas três fases, feitas no Suno a partir de faixas do jogo
Álbum da trilhaA Marcha da Lanterna, com as faixas do jogo, em 8-bit, e as orquestrais: Ouvir no Musicplay.club (abre em nova aba)
FonteVT323, de Peter Hull — SIL Open Font License 1.1
Modelo de IAOpus 5.5
Motorengine-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

Pendências registradas pelo motor

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ãoo que mudou (ficha)
1.5.3o endereço novo do perfil no Musicplay.club nos links do álbum
1.5.2o link do álbum da trilha no Musicplay.club nos créditos
1.5.1trilha 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.0chefes 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.2ví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.0chefes com projéteis reconhecíveis (flechas, lodo, girinos, corvos) e trilha orquestral do Suno no menu
1.0.01º QA (544×960)
1.1.0câmera 1,5×, modo horizontal, vídeos, VT323 e correções do ciclo 1
1.2.0correções do ciclo 2, enguia só na água, vitórias-régias, vídeo em retrato, bônus esperando o botão
1.2.1vitó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.3primeiro golpe dos chefes só depois da cartela (tempos.cartelaDoChefe)
1.2.4textos 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)

O 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íram aviso, pisoteio, retorno, peito2 e os parâmetros velocidadePisoteio, 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 invocar e girinos, invocar, velocidadeGirino, voltasGirino; na instância, o projétil girino e a frase dele.
  • Arauto da Bruma: o leque de orbes (3) corvos mirado em Íris a cada intervaloOrbe (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íram direcoes, intervaloEspiral, giroEspiral, corredor, oscilacao, arco.
  • Validação: PROJETEIS_DO_PADRAO pede 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.
  • versao 1.4.0 (config e ficha), junto com a Íris de 128 px da plataforma (ver PLATAFORMA.md).

1.3.0

chefes com projéteis reconhecíveis (flechas, lodo, girinos, corvos) e trilha orquestral do Suno no menu

O 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 (sprite cervoRaizes.mirar) e a mira trava onde Íris está; uma linha tracejada de 170 px (MIRA_DA_FLECHA) por flecha mostra o leque. Evento aviso mira. Na pose mirar os 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.
  • 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 evento acerto leva estouro: 'bolaLodo' e a plataforma desenha efeitos.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 raio dele é 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óriascontinuações (média)quedas (média)dano dos chefes*
1.2.4 (antes)12/162,258,5raiz 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/161,817,25flecha 4, respingo 26, corvo 5, girino 3, Cervo 8
1.3.0 com compensação (flecha 250 px/s, leque 48°)12/161,887,4flecha 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/161,887,4idê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.

  • versao não mudou aqui (fica para quem fechar a versão).

1.2.4

textos do Morcego-Folha e do Musguinho fiéis ao comportamento

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

textoantesdepois
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)

Gabriel Gameplay 🕹️ · 02/11/2026, 03h53. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata do dist, mais o game.yaml.

arquivomd5
jogo.js6569f949ca1d5e7abecdafaf14bf82d9
estilo.css4cbbefd83f8105ef3534ec3d0b5b1c86
index.html822078f72fcb552a9370984ad6287afe
versao.json9de5077b63164f0758fcfb2fbd9c4e7d
atlas, vídeos e demaisiguais 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.

#origemcomo foi resolvido
C4revisã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º golperevisã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 arenaachado do núcleocolada 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

Gabriel Gameplay 🕹️ · 02/11/2026, 02h37. Build congelado: output/2026-11-01-091453/jogo/ é cópia exata do dist, mais o game.yaml.

arquivomd5
jogo.js9f4fb48c642a66be6bd0b5f4d2aa1b33
estilo.css0035daec8195cfd83a9ad2794aae9e68
index.htmlccd42c1335066abb9fc23240cb41ec14
atlas.png / atlas-fase3.png3bfd16c765f784b1aa639d15623f26ce / 0df4be8cbb2ca8e451f514e7c61ee0a6
vídeos, pôsteres, pinturas, fonte, capasiguais 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

#origemcomo foi resolvido
avançopedido 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 × HUDconsequênciaem 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
C3revisã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-2revisão de PICré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-5revisã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
saporegistro do QAo 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

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

arquivomd5
jogo.jsd90a6c54128d62c80bb457be1cbcd1ec
index.htmlaf35cec676b01138f36277f69c9a113c
atlas.png / atlas-fase3.pngccab31321153e8d26f4349c64c72fbbe / f78d2ba58fb41682647e180b4c77f55c
CSS, vídeos, pôsteres, pinturas, fonte, capas, íconesiguais 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

#origemcomo foi resolvido
C1revisã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 %
C2revisã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-1QA (ciclo 3)o foco vai para "Seguir a marcha" ao pular o vídeo por toque ou clique
QA-2QA (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-3QA (ciclo 3)celular pequeno deitado (568 × 320): campo de 320 × 176 para 376 × 207. O resto é limite conhecido (PLATAFORMA.md)
mapaachado nas capturas p9ruinas() 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)
bordaachado nas capturas p9borda 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

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

arquivomd5
jogo.jsdcc38a33aa6dd3dc6a6eccfe97076e79
estilo.cssa907ce6b2580a23d27f2120136f83d50
index.html574c939272d2936e87151ff48b86604d
cenas/vitoria-fase1.mp4 / -retrato.mp4a0b9026ef99b7f752da7419656173e89 / 1e79d040b17e55258c776a2d16032725
cenas/vitoria-fase2.mp4 / -retrato.mp4fe2615247cc8c6ff189808a8d4b6f42c / 110a557569de38c91ce484ab547ca2b8
cenas/vitoria-fase3.mp4 / -retrato.mp49aff30e538f57a1785a903f02ed70662 / 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)

#origemcomo foi resolvido
N1revisão visualno celular deitado, o nome do chefe tem até 80 % da faixa do HUD (24 px numa faixa de 30), ao lado da barra
N2revisão visualno celular deitado, Pausa e Lanterna ficam nas margens laterais, sem cobrir o campo; sem margem de 96 px, o palco reserva uma
N3revisão visualfarol, fim, final e recordes ganham corpo que rola e rodapé separado, com sombra e "Role para ver mais ▾"
N4 + QA-1revisão visual + QAlegendas 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
N5revisão visual + decisão do donoví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
N6revisão visualmuralha 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-3QAanel de aviso também no Javali
QA-4QAplural correto ("Nenhum coração." / "Resta 1 coração." / "Restam N corações."), e o anúncio diz o que atingiu Íris
QA-5QAsem o atlas: tela de falha amigável, sem erro de página
bônusdecisão do donoo quadro de bônus espera "Seguir a marcha" (10 s sem sumir, nas 3 fases e nas 2 orientações)
enguiadefeito relatado pelo donoa 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

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

arquivomd5
jogo.js54cb02238d768e259458ad3e6e6e3ccf
estilo.css2ae896eb8e06d84e98121cfff3e030b4
index.html5574c8e002b1e2e18aaec14ff1a0570c
cenas/vitoria-fase1.mp4a07a3bb42d2fd40fa10e2477bd492adc
cenas/vitoria-fase2.mp4339098a2f9412d569f76dc90486fa787
cenas/vitoria-fase3.mp424e61990a7f2a59797b4f50732b47d97

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)

pedidocomo ficou
Tudo 50 % maiorcâ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 horizontalcom 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 chefe3 vídeos de 9 s (OpenArt: Nano Banana Pro + Kling 3 Omni), carregados quando o chefe entra; puláveis; pinturas paradas com movimento reduzido
FonteVT323 em tudo, no lugar da Pixelify Sans

Required changes atendidos

#veredito de origemcomo foi resolvido
R1/Q1revisão visual + QA: fonte ilegívelVT323 (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
R2texto do canvas < 11 pxtexto do canvas tem 28–48 px na tela; nome do chefe vai para o DOM; legendas a 24 px; nada abaixo de 20 px
R3folha abre roladascrollTop = 0 depois de abrir
R4links de 19 pxalvo ≥ 44 px
R5cartela mais larga que o canvasmedida contra o retângulo do canvas
R6primário abaixo da dobrateto de altura no farol, no final e nos recordes
R7rolagem lateral a 320 pxminmax(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
R8legendas cobrindo a açãolegendas fora da área de jogo
R9"[a balista mira]" em toda faselegenda nomeia o inimigo que avisa
R10franja colorida no texto do canvastexto no DOM / canvas sem LCD
R11contraste da Cidadelapiso 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)
Q2P não sai da pausaborda de tecla; teste sabotado reprova
Q3aviso do Cogumelo-Vigia invisívelsprite inchar redesenhado (difere do parado em 504–569 de 1024 px), anel de aviso, quadros 0 → 1 uma só vez (quadroDoAviso, testado)
Q4grama quadrada sob pedras no caminhoo sólido sobre o caminho é pintado sobre o caminho; testado
Q-conteúdoespinho causa 44 % do dano e não era explicadoseção "Terreno" no Conteúdo, com 7 itens e o desenho de cada um
Q5build trocado durante o QAversão 1.1.0, md5 acima, pasta congelada
—subtítulo da capa 3,64:1 a 320 × 568vé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)

Run 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)KBgzip
index.html15,84,1
jogo.js (núcleo + plataforma + som + config resolvida)167,456,8 (teto 60)
estilo.css13,53,8 (teto 20)
atlas.png (os 128 sprites, PNG indexado gerado no build)58,1—
capa-paisagem.webp / capa-retrato.webp78,3 / 69,1—
og.jpg 1200 × 63079,3—
logo-escuro.svg / logo-claro.svg / favicon.svg / icon-192.png / icon-512.png5,4 / 3,9 / 0,7 / 0,8 / 2,1—
fonte/PixelifySans-latin.woff2 + fonte/OFL.txt12,0 + 4,5—
manifest.webmanifest, versao.json, game.yaml< 5—
pasta inteira≈ 534 KBteto 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çãoresponsabilidade
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 / superficiespasso fixo com acumulador; canvas 544 × 960; chão calmo pintado por pisos.ts em pedaços cacheados
telas / folhascapa 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 run com 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). grep por src/href externos no index.html encontrou 0. A única ocorrência de "http" no jogo.js é a URL do jogo em identidade.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: versao 1.0.0 igual à da ficha, versao.json e ?v=. scripts/teste-atualizacao.mjs passa 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: none no 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 quepor quê
Resolução 544 × 960 (17 × 30 tiles de 32 px), e não 270 × 480pedido 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 pxo 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 cairmenos punição em cascata; a dificuldade já vem da rolagem
Inimigos e projéteis inimigos ignoram o terrenosó Íris e os tiros dela colidem com sólido; evita inimigo preso em tronco
Carregamento com progresso por recurso, não por bytessob file:// não há fetch para medir bytes
resolverConfig() roda no build e não no navegadoro 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 partidaos menus usam teclado, mouse e toque

Problemas conhecidos (vistos por mim nas capturas, para o QA confirmar)

  1. 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.
  2. 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).
  3. 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.html e manual-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.