Empire.

A visão canónica e como usar este dossiê

Integração de 07/10: o relatório territorial foi comparado na íntegra; §§92–96 completam as especificações e rastreiam A01–A12, AUD-CIV-01–18 e T01–T50. O RG-28 já entrou na main; o seu protótipo é a baseline desta leitura. Portos, contratos completos e remessas continuam desenvolvimentos pendentes.

Empire é um kingdom-builder 2D em pixel art, com exploração lateral, moeda física, pessoas que trabalham e combatem no mundo, uma ameaça noturna com memória e um império cuja identidade nasce do território e das escolhas do jogador. A partida começa antes do reino: um imperador, uma carroça e três cidadãos sem ofício atravessam a natureza; o jogador escolhe onde fundar e transforma esse lugar num acampamento, povoado e, muito mais tarde, numa rede territorial.

Esta revisão integra as decisões do painel, o Documento Mestre de 05/10, os relatórios de floresta e subsolo e as ADRs posteriores à v6. As regras foram atualizadas nas secções que as descrevem. A Parte XIV explica a integração de Civilization VII e Manor Lords, os contratos ainda por implementar e a rastreabilidade das respostas. O histórico mantém-se no Git e nas ADRs; não constitui uma segunda versão ativa do design.

Os pilares atuais

As referências e o que cada uma acrescenta

Kingdom sustenta a leitura lateral, os gestos simples, a moeda física e a gestão por presença. Civilization VII inspira o valor estratégico da posição, assentamentos com funções diferentes, progressão por fases e grupos políticos que podem crescer. Manor Lords inspira a coerência entre trabalho, recursos, ambiente e crescimento orgânico. A tradução concreta para Empire está na §87: não introduz automaticamente hexágonos, turnos, famílias, cadeias industriais, novas moedas ou quotas de felicidade.

O contrato de leitura

• Decidido significa que a direção está autorizada por uma resposta ou pedido do dono identificado.
• Implementado exige correspondência no código e validação do comportamento; uma aprovação não basta.
• Publicado exige o commit efetivamente servido. Um ramo ou PR aberto não é produção.
• Proposto identifica uma hipótese de desenho ou um valor ainda em _proposed. Não se remove essa etiqueta por uma aprovação de outro assunto.
• Adiado preserva a escolha de não executar agora. Substituído conserva a proveniência, mas deixa de reger a cláusula em conflito.

O dossiê é a especificação integrada. Decisões explícitas posteriores prevalecem na cláusula afetada e obrigam à sua atualização; ADRs explicam a razão e a migração. CSVs descrevem os valores executados, incluindo os provisórios. Código descreve o que existe, não transforma uma divergência em regra desejada. A §86 resolve os conflitos conhecidos; a §91 conserva as respostas consultadas.

O que existe e o que se está a construir

A revisão começou em bafeb112aa6b9b7162d78fe3053da62c9d6c47ec e foi reconciliada em 07/10 com main/ba743da3a616d27a7df581646e9e7356134c89c8, confirmado como produção READY na Vercel. Já existe jogo Solo com fundação livre, moeda e trabalho físico, monarcas, progressão da sede, floresta persistente e subsolo. A arte renovada, o HUD, a tocha na mão e as correções do PR #92 integram agora essa base publicada. A §90 identifica a versão e os limites da verificação.

O despertar social, a assinatura ambiental completa, a rede de povoações, a sucessão escolhida completa, o quarto imperador e os modos online conservam critérios de aceitação próprios. Não se apresentam como entregues por terem sido aprovados no painel.

As estimativas de horas, mercado e calendário das primeiras versões são históricas, não um compromisso atualizado. A ordem atual é: estabilizar e tornar coerente o ciclo Solo; validar a abertura e progressão; completar território e sociedades; validar sucessão e campanha; construir a rede online. O backlog continua a ser a unidade de execução e o dossiê o contrato de produto.

O que a arte já decidiu — e o que ainda não

Medi as tuas duas cenas pixel a pixel, e agora medi também as cinco capturas das referências que deste — pelo mesmo processo. Há uma distinção que a v2 não fez e devia: algumas medições dizem-te como desenhas, e essas valem sempre; outras dizem-te o que está naquela imagem, e essas não valem nada enquanto o cenário não estiver terminado. As das referências pertencem à primeira categoria, e são a parte nova desta secção.

O que vale, e vai continuar a valer

Estas medições são propriedades de como desenhas e do desenho de personagem, que já está resolvido — não daquela composição em particular. Uma cena por acabar mede-as tão bem como uma acabada.

O que ainda está em aberto

Isto não se lê na arte atual. São decisões de design por tomar, e a §38 tem-nas na lista desta semana.

As três referências, medidas — não descritas

Deste-me três jogos e disseste que queres cenários assim. Não me limitei a olhar: passei as cinco capturas pelo mesmo processo que usei nas tuas cenas. O período da grelha de pixel de cada imagem sai por análise espectral do perfil de bordas — é invariante ao redimensionamento, por isso funciona mesmo em capturas da Steam já reescaladas e comprimidas. Dividindo a altura da imagem por esse período obtém-se a tela efetiva: a altura, em pixels de arte, a que o jogo foi realmente desenhado.

"Detalhe de 1 px" = fração de sequências horizontais de cor com um só pixel de comprimento, na grelha do próprio jogo. "Contorno 1 px" = fração de sequências escuras com um só pixel. A estimativa de tamanho de paleta não é fiável a partir de JPEG e ficou de fora.

O que os números querem dizer, em desenho

As camadas Aseprite já são um sistema de equipamento

Esta parte mantém-se inteira, e é a mais valiosa. Os teus ficheiros separam Body, Face, Shield, Sword, Equipments. As cenas confirmam a intenção: os aldeões são corpos-base creme com cabelo, barba e objeto na mão a mudar. Um corpo, dezenas de personagens. O pipeline exporta por camada, nunca achatado. §22 formaliza em cinco slots — e é isto que torna viável teres seis povos.

A gramática visual — o que a arte realmente prova

Kingdom, desmontado peça a peça

Para superares o Kingdom precisas de saber exatamente porque é que ele funciona. Thomas van den Berg e Marco Bancale acertaram em coisas que parecem acidentais e não são — e falharam em coisas que ninguém corrigiu em oito anos.

As sete decisões que o fazem funcionar

Os números reais do Two Crowns — referência de escala, não modelo

Estes são os valores publicados do jogo que queres superar. Usa-os para uma coisa só: calibrar a escala. A estrutura da tua economia é diferente da dele (§06) — o Kingdom não tem casas de produção, não tem conversão de matéria em capacidade, não tem comércio, não tem manutenção de tropas nem ganância. O que vale a pena herdar é a legibilidade destes números, não a forma como se ganham.

Onde o Kingdom falha — e é aí que entras

O mercado, com números, sem consolo

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

Esta secção não existia na v2 e devia. Vais gastar dois a três anos nisto. Convém saberes exatamente contra o que estás a jogar antes de escreveres a primeira linha — e, mais importante, quais são os números que tens de atingir para que valha a pena.

O estado do Steam em 2026

A matemática das wishlists

É a única equação de marketing que precisas de saber, e determina quando lanças. A conversão da primeira semana depende do número de wishlists acumuladas — mais wishlists convertem melhor, não só mais:

Os três jogos que provam que é possível

O que isto muda no plano

• A página de Steam entra cedo — Fase 3, não Fase 6. Wishlists acumulam durante meses; não se compram no fim.
• A demo é uma arma, não um subproduto. O Thronefall entrou no Next Fest de junho de 2022 e ficou em 15.º lugar em seguidores ganhos entre ~1 000 jogos. Lançou treze meses depois. §36 copia esse calendário.
• Um GIF de 6 segundos vale mais do que um sistema. O teu castelo-árvore com a mancha da Podridão a chegar no horizonte é o GIF. Constrói-o cedo e mostra-o durante dois anos.

Cada império é um povo diferente

Os povos dão identidade à arquitetura, à economia, à defesa e às relações políticas. O território natural existe primeiro; sociedades e culturas ocupam-no e transformam-no ao longo da campanha (§88).

Os seis povos, e mais dois

Nomes de trabalho. A Geada e a Bruma integram a mesma campanha conforme Q-152; Bruma substitui Paul (Q-175). São oito povos, cuja implementação e crescimento social têm estados próprios. O que interessa é a lógica: terreno → arquitetura → economia → defesa → tropa única. Nunca inventes um povo sem preencher as cinco colunas.

Os cinco pilares

O dia, a noite e A Podridão

Um dia dura 360 segundos reais. Cada fase tem uma função de jogo distinta e um estado visual inequívoco — cor da luz ambiente, som, e comportamento das tropas. O jogador nunca precisa de olhar para um relógio.

A Podridão — especificação completa

A tua ideia de "uma sombra que vai de encontro ao império invocando inimigos até chegar" é a mecânica mais original da lista. Merece ser um sistema de primeira classe, não um spawner disfarçado.

Como o jogador interage com ela

• Ver — a mancha é visível no horizonte durante o crepúsculo. O jogador consegue estimar a que horas chega, e isso é uma decisão: avançar mais uma plantação ou recuar já?
• Atrasar — fogueiras, barris de fogo e terreno consagrado abrandam-na. Cada segundo de atraso é uma vaga de invocação a menos. A fogueira é a das rondas noturnas: 3 moedas, o abrandamento do barril, e é lá que se compra o archote — o item que se leva para explorar de noite. Arde um tempo e acaba; fora das muralhas e da luz, sem ele, a noite traz inimigos de qualquer lado (Q-029).
• Desviar — pontes e o nível subterrâneo permitem que ela passe por baixo ou por cima do teu império se o caminho de superfície estiver selado. Isto é uma tática avançada, não um bug.
• Alimentar — deixar sacrifícios (animais, tropas fracas, ouro) reduz a massa. Sinistro, eficaz, e mecanicamente honesto: transformas economia em segurança.

Os dois gestos de gestão e as ações de combate

Painel de 30/09/2026 — ADR 0043. As fissuras no chão podem vir de um lado ou de dois, à sorte, conservando o orçamento total. O limiar de dois lados continua no dia 12 e as primeiras dez noites mantêm a curva anterior (Q-179, ADR 0043). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Ritmo atual do contrato: a §89 reconcilia Q-239–Q-243. O limite de estreia 3/6/9 foi contestado; primeira noite funda na 12 e rampa de sete noites receberam aprovação no contexto da proposta. A implementação da auditoria de 09/10 usa rampa de sete noites e primeiro pico na noite 12; o valor de estreia continua pendente da Q-240. Antes da fundação, dia visual e despertar social não se confundem (§25).

Tocha e acordo futuro (Q-247, resposta de 07/10): a tocha de mão serve inicialmente como ferramenta de iluminação sem desgaste. Mais adiante, um acordo desfavorável poderá permitir à Podridão corrompê-la e torná-la consumível. “Metade do jogo” indica a intenção de progressão, não uma percentagem ou noite fixada. O gatilho, consumo, recuperação e relação com emboscadas ainda precisam de especificação. Na baseline, a tocha ilumina e o archote comprado protege; não se infere que a nova resposta tenha aprovado proteção gratuita.

Produção, conversão e comércio

Território e circulação: §92 especifica capacidade e produção; §95 distingue comércio abstrato de remessa com conservação de stock. O RG-28 valida implantação, mas ainda não demonstra a cadeia logística física inteira.

A economia do Kingdom tem um circuito: moeda entra, coisa sai. A tua tem três, e é aí que o jogo deixa de ser um clone. O Kingdom serve-te de referência para uma coisa só — escala e legibilidade, números pequenos que são objetos físicos no chão. A estrutura é tua.

Os três circuitos

Moedas e matérias

Três moedas com velocidades diferentes, e uma quarta camada que não é moeda e nunca entra num inventário.

Circuito 1 — produção

Circuito 2 — as casas de produção, e a decisão que as define

Cada matéria tem uma casa que a processa, e cada casa oferece a mesma decisão binária: moeda agora, ou capacidade depois. Uma regra, cinco instâncias. É a tua ideia dos animais e do cozinheiro, generalizada a toda a economia.

Circuito 3 — comércio

Estava em falta no documento e é o item que amarra a economia à conquista. Um povo conquistado e mantido vivo abre uma rota entre o território dele e a tua capital.

Os cinco sorvedouros

A curva, e o dia da asfixia

Meta de design: o jogador está sempre a perder terreno lentamente, e a única forma de recuperar é conquistar. Isto força o jogo para a frente e mata o turtling infinito. A produção cresce a 1,12^(d−1) sobre a base construída, o comércio a 1,08^(d−1) por rota, e o custo de sobreviver à noite a 1,22^(d−1) a partir de 6,1.

Como ler: o dia da asfixia é aquele em que a linha roxa passa a verde — o ponto em que sobreviver custa mais do que produzes. Alvo de design: entre o dia 9 e o dia 14, e o número fica verde quando estás dentro do intervalo. Põe as rotas de comércio a 2 e vê os quatro dias que a conquista te compra — é essa a mensagem económica do jogo inteiro; cada rota vale cerca de dois dias, com retorno decrescente. E repara numa propriedade importante deste modelo: mesmo com tudo no máximo, a asfixia chega ao dia 28. A curva cruza sempre. É exatamente isso que impede o problema que o criador do Kingdom admitiu — nenhuma economia, por melhor que seja, deixa o jogador confortável para sempre.

Relações económicas e ambientais: a §87 liga os três circuitos ao lugar, à disponibilidade de pessoas, aos percursos e à perda de habitats. O armazenamento físico conserva limites. O perfil imperial pode ser desbloqueado para novo começo; evolução ganha-se de novo (§16). Não se criam novos recursos ou consumos domésticos pela analogia com Manor Lords.

O modelo de combate, com a matemática feita

Esta secção não existia na v2, e é a mais perigosa de deixar por escrever. Num jogo de controlo indireto, o combate não pode ser emocionante — tem de ser legível. O jogador não comanda ninguém; só decide quem existe, onde está e o que traz vestido. Se ele não conseguir prever o resultado antes de a noite começar, o jogo parece aleatório.

As quatro regras de resolução

Tabela mestra de unidades

Criaturas da Podridão — a tabela de invocação

Tempo até matar — a tabela que evita desastres

Segundos que uma unidade demora a matar cada criatura, já com a penalização de precisão do arqueiro em campo aberto. É esta tabela que diz se uma noite é sobrevivível antes de a jogares. A linha do arqueiro em campo faz a conta com 1/3 e é por isso aproximada (≈): os dados usam accuracy_open = 0,34 (§19, §44), 2% ao lado.

Ocupação de linha — como 300 unidades cabem num eixo

O mundo é 1.5D, portanto o combate acontece numa linha. Sem regras, tudo se empilha num pixel. A solução não é física — é uma regra de dados:

Moral, fuga e a presença do rei

Um único modificador com raio, e três consequências:

• Muro cai → tropas com vida < 30% e custo ≤ 4 fogem para o núcleo.
• Rei em campo → nenhuma tropa foge dentro de um raio de 260 px. A defesa aguenta — e o rei pode morrer. É a decisão tática de maior risco do jogo.
• Impulso Vigília (§15) → ninguém foge esta noite, ao preço de −30% de vida em todas as tropas amanhã.

Escopo dos monarcas: só imperadores são controláveis (§08); “classe Arqueiro” em contratos técnicos refere o perfil imperial pertinente. O sangramento é exclusivo da sua flecha (Q-201). Ataque, habilidade, golpe em área e empurrão usam as decisões Q-184/Q-185. O tiro do escudeiro evoluído tem o contrato e as propostas da Q-246.

Imperadores, companhias e desbloqueios

Só os imperadores são controláveis. Cada perfil reúne identidade, combate, autoridade soberana e companhia própria; tropas, ofícios, diplomatas e companheiros atuam sob IA. As antigas classes controláveis e a troca livre entre dois corpos vivos foram substituídas pelas Q-195–Q-202. Os identificadores técnicos de classe que ainda existem no código são mecanismos internos, não opções adicionais de personagem para o jogador.

Escolha inicial e identidade

Uma campanha nova apresenta os três perfis iniciais completos. Confirmar a escolha inicia a partida. Explorar permite descobrir outros imperadores e desbloqueá-los para a campanha e para novos começos, conforme as regras de legado da §16. Desbloquear um perfil não concede outra coroa nem troca imediatamente quem governa.

Não há quarto perfil inicial incompleto. O antigo conceito do Cavaleiro Enterrado deve ser reconciliado com este quarto imperador em UN-33; esta revisão não autoriza criar uma personagem jogável redundante. O Cavaleiro Selado permanece conteúdo de tropa sob IA, com o vínculo à montaria descrito nos dados de conteúdo.

A companhia é contratada, não oferecida

A caravana inicial tem três cidadãos sem ofício. Depois de fundar, o posto próximo da sede permite formar a companhia correspondente ao monarca por sete moedas; a formação usa uma pessoa disponível. Os fundadores já pertencem ao grupo e passam ao reino na fundação; recém-chegados são recrutados pelo gesto da moeda antes de receber ofício. Fontes: Q-223, ADR 0066 e arrival.csv.

Monarca e companhia evoluem juntos por feitos de batalha. O parâmetro de cinco vitórias conjuntas foi aprovado no contexto da Q-232 e está em dados; não se recupera a antiga evolução genérica de qualquer corpo jogável por uma moeda no marco. A condição conta mortes inimigas reais, com proximidade/faixa válidas e sem aliados; a correção desse caminho foi integrada pelo PR #92 na base publicada identificada na §90.

Cada perfil mantém vida, ferimentos, experiência, bolsa, flechas, recargas e vínculo de companhia. Trocar, viajar, gravar ou carregar não enche a aljava nem cura. O escudeiro Arqueiro só dispara na sua forma evoluída, com patrono vivo e condições de combate válidas. Os números de ataque e a discussão entre aljava partilhada ou reserva própria continuam na Q-246; a decisão de seis flechas por moeda não os aprova por associação.

Troca de imperador: a sucessão é a chave

A escolha de outro imperador exige um herdeiro preparado. O jogador desloca-se à Casa do Herdeiro, escolhe um perfil desbloqueado e disponível segundo as regras da campanha, e transfere o governo numa única operação. O ciclo de preparação reinicia; a nova falta de sucessor é um risco real. Não basta encontrar um imperador vivo e premir Interagir. A §15 define preparação, incumprimento e recuperação dos bónus.

Um imperador perdido definitivamente naquela campanha fica indisponível nela, salvo ressurreição válida no prazo do ritual (§16). Os desbloqueios persistentes voltam a permitir escolhê-lo num novo começo conforme Q-195/Q-206. Solo conserva uma única coroa soberana, incluindo durante queda, roubo, troca e sucessão pendente. Coop/PvP têm topologia própria na §18.

Controlos e funções

Ataque e habilidade são ações independentes: teclado/rato, comando e toque oferecem o mesmo conjunto de ações, com apresentação adaptada. Segurar ataque repete à cadência; segurar CORRER consome fôlego e soltar termina a corrida. Os tempos de fôlego de trinta e cinquenta segundos são decisões da Q-216, implementadas por dados; parado recupera mais depressa (Q-208). Nia ordena o serviço pago do Bardo; marcar não dispara uma flecha. A interface explica disponibilidade, custo e recuperação sem exigir conhecimento do código.

O companheiro do trono, como a mascote que segue alimentação, é conteúdo separado da companhia real e não substitui escudeiro ou Bardo. Trepador, montarias e variantes de povos mantêm-se como conteúdo faseado; nenhum deles reabre classes controláveis antigas.

Aceitação: começar com cada perfil; contratar a companhia; ficar sem moeda/munição; evoluir pela batalha; gravar e retomar; tentar trocar sem herdeiro; trocar com herdeiro; perder o perfil e verificar disponibilidade. O teste deve percorrer o fluxo completo, não apenas alterar diretamente um nível de personagem.

As tropas que fazem o reino andar

Muralhas, torres e a Casa de Treino

Implantação territorial: a ADR 0077/RG-28 já faz o pagamento consultar fontes no local real; obras antigas pagas ou erguidas conservam compatibilidade explícita. A §92 amplia o contrato; água, construção de porto, operação e rota são estados distintos na §93.

Leitura dos números: as tabelas refletem os CSV da baseline, incluindo campos ainda em _proposed. O estágio é apenas uma condição: território protegido, apoio populacional, materiais/desbloqueios e maturidade também contam (Q-222/Q-227/Q-233). A Casa do Herdeiro exige o máximo atual, Fortaleza. A Capital é posterior e depende de uma rede real (§88).

A estrutura que as tuas cenas sugerem, e que vale a pena adotar: uma sede escolhida pelo jogador e edifícios ao longo da linha de solo, protegidos por muralhas que o jogador ergue para os dois lados. O núcleo é a sede: o monarca escolhe livremente um local válido e funda sem custo; depois a sede sobe por estágios pagos e levantados como um muro (ADR 0066). É o que defendes. Se cair, cai a partida.

A sede: da Clareira à Fortaleza

O reino não nasce castelo. O monarca explora com a caravana e três cidadãos sem ofício. Ao parar num local válido, sem outra interação prioritária, pode confirmar a fundação gratuita. A sede e as bancas passam a usar essa coordenada, sem deslocar as ruínas e passagens do terreno. Cada melhoria posterior é um degrau do núcleo: paga-se inteira, quem está presente levanta-a (§55), e o estágio de antes continua a servir enquanto o seguinte se ergue. Subir não cura: a sede passa ao estágio novo com a mesma proporção de vida. Cada estágio abre obras — não as ergue: as obras, os ofícios e as armas pagam-se à parte. O estágio soma-se ao que um degrau já pedia (a estátua, a conquista, o Lenho), não o substitui. O castelo-árvore de antes é a Fortaleza.

Uma obra que nenhum estágio lista abre com a fundação. A Capital (F6) entra quando houver postos e rotas a administrar (RG-14): sem eles seria um degrau só de vida. A moeda no marco serve as melhorias e reparações da sede; a evolução conjunta de monarca e companhia resulta de feitos de batalha (Q-223/Q-232).

Os dois caminhos da muralha

Cada segmento oferece duas melhorias mutuamente exclusivas por nível. Nunca dá para ter as duas — e essa é a decisão.

O material e a silhueta mudam por povo, não por bioma. Mecanicamente idênticas, visualmente distintas: um swap de tileset e paleta por PeopleData. Custo de produção baixo, ganho de identidade alto — e é a recompensa mais visível de conquistar alguém. Nem todos os povos têm os cinco níveis: os Sob-Raiz não têm muralha nenhuma, têm labirinto.

Torres e defesas

Manutenção: reparar exige construtores disponíveis; a sede entra no trabalho de reparação ao amanhecer (Q-210/Q-224). Subir o estágio não é uma cura gratuita. Uma recomendação histórica de ter Torre Alta no dia quatro não é um prazo obrigatório: a nova abertura e a curva da noite precisam de validação conjunta.

O mundo em duas camadas

A ideia é tua: "a tela é dividida ao meio, em baixo é só paisagem, mas ao aceder a uma passagem secreta encontras níveis, porões, dungeons". Há duas formas de a construir, e a escolha entre elas é a decisão arquitetónica mais cara do projeto. Recomendo a segunda, e não por causa da arte — por causa do custo.

O resto desta secção assume a opção B.

A faixa que falta — e que é a razão de as tuas cenas parecerem planas

As três faixas acima são a divisão de jogo: quem passa onde, o que colide com o quê. Está certa e mantém-se. Mas a divisão de jogo não é a divisão de imagem, e é aí que está o buraco. Medi as capturas que enviaste, faixa a faixa, do topo do ecrã para a base:

Densidade = número médio de cores distintas numa janela de 16×16 px na grelha do próprio jogo. Saturação e valor são médias HSV por faixa.

O horizonte não é a linha do solo

É esta a confusão que produz cenas planas, e é fácil de desfazer. A linha do solo é onde as tropas pisam — a constante de jogo. O horizonte é onde as camadas distantes se encontram, e tem de ficar bastante mais alto, para haver espaço entre os dois. Esse espaço é o plano médio: colinas, linha de árvores, aldeia longínqua, a silhueta do império vizinho.

Painel de 30/09/2026 — ADR 0043. À superfície o corte continua tapado. Perto de uma boca aberta, uma criatura subterrânea abre apenas uma janela local de dither; a boca visitada permanece localmente aberta. As visitas entram no save (Q-182). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Subsolo delimitado — ADR 0046. O subsolo não é uma faixa: é feito de sítios, cada um uma fila de salas entre duas paredes de rocha, que nunca passa do tecto do lugar nem de 12 salas, e o resto do corte é terra maciça. Cada passagem do império dá para um porão (armazém, adega ou celeiro) entre os muros dela; debaixo do castelo há uma sala secreta com o alçapão num sítio sorteado; cada ruína das terras é uma masmorra presa ao segmento. As salas nascem na primeira descida, pela semente e pela chave do sítio, e ficam no save. Lá em baixo não se passa das paredes; quem cava continua a passar pela terra. A terra abre-se só por cima do sítio onde o rei está (Q-186). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Chão para além da escada — ADR 0072. Nenhum sítio acessível é só a escada: além da chegada, da folga e das margens, todo o sítio tem uma baía livre, contígua e alcançável, fora do que lá está (o contrato de área útil, underground.csv). O chão reserva-se antes de a entrada se publicar e dois sítios nunca o disputam; uma ruína ou uma falha de rocha sem chão, ou para lá do tecto de entradas do povo dela, fica sem boca. Cada entrada tem uma causa que se vê — a passagem, a sede, o arco caído, a falha de rocha de um limiar (a caverna, sem escada nem tesouro) — e a ruína só leva salas da função que teve. A cave real começa com uma largura habitável para dentro da sede e cresce um passo por estágio; o baú fica na baía, longe da subida. A recompensa de uma masmorra nasce no meio da baía na primeira descida, uma vez. Os saves antigos reparam-se uma vez ao carregar, sem mexer na boca, nos saldos nem nas recompensas. Os números são valores de ensaio (Q-244).

Montarias

Começas a pé. A velocidade a pé é deliberadamente frustrante depois do dia 6 — é o que dá valor à primeira montaria, e é a mesma técnica que faz o cavalo do Kingdom parecer uma dádiva.

As montarias morrem e ficam feridas. Uma montaria ferida recupera no estábulo em 2 dias. O Cavaleiro Selado (§08) é o caso extremo: perder a montaria é perder metade da personagem, e o ecrã diz-to (§24).

Conquistar civilizações

Em Kingdom, avançar destrói portais e acabou. Aqui, avançar é absorver uma cultura — uma forma de progresso que convive com legado, descobertas, perfis imperiais e crescimento territorial.

Como se ataca

Painel de 30/09/2026 — ADR 0043. Cada outro reino tem casa, oficina, defesas, trabalhadores, construtor, guarnição e tesouro próprio; produz, paga soldo, repõe flechas, substitui baixas, repara e enfrenta a Podridão de noite. A viagem diurna liga destinos seguros. A antiga obrigação de o rei ficar em casa (Q-178) foi substituída pela ADR 0052: monarcas exploram e lideram expedições. A continuidade de reinos distantes é aprofundada na §88. Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Pedido do dono de 02/10/2026 — ADR 0052. Todos os monarcas exploram e podem liderar uma expedição presencial; quem prefere ficar em casa envia uma incursão liderada por um Diplomata, sob IA. A viagem de dia para destino seguro continua, agora também para o monarca e a comitiva que está com ele. Cerco delegado, conquista presencial e assimilação diplomática terão um resultado comum, com uma recompensa só por objetivo (UN-20, UN-22). Desbloquear o arquétipo de um imperador não o cria: ele tem de ser encontrado.

O diplomata, os mercenários e a dívida

Estatuto desta secção: as probabilidades e dívidas abaixo são a especificação histórica e os valores da baseline, não um motor de negociação completo. Para o desenvolvimento do relatório, ler a §94 e Q-251: serviço, efetivos finitos, oferta versionada, pagamento explícito e incumprimento previsível. Não aplicar automaticamente ao novo contrato a captura aleatória, os juros exponenciais nem o reinício ilimitado de prazo por pagamento residual. A política de companhias persistentes precisa preservar os acampamentos antigos.

O recrutamento atual e a diplomacia futura são camadas diferentes. Companhias têm presença no mundo; hostilidade, serviço e lealdade exigem termos explícitos. A frase histórica “atacam sempre” não define a disponibilidade das companhias do novo modelo.

Enviar o diplomata

As probabilidades deslocam-se com o nível do diplomata e o Favor acumulado: cada 20 de Favor move 5 pontos de Captura para Dissolução. Um diplomata com 60 de Favor tem 45/50/5 (Dissolução/Contrato/Captura).

A dívida

Diplomata nível 2 — assimilação

A cada 8 dias pode assimilar um império vizinho: o império inteiro passa a ser teu, com tropas, edifícios e produção — sem combate. Requer 60 de Favor e que o império alvo tenha um rei jovem ou fraco. É a rota pacifista, e deve ser tão viável quanto a militar. Um jogador que termine a campanha sem uma única batalha ofensiva é um jogador que vai escrever sobre o teu jogo.

Painel de 30/09/2026 — ADR 0043. O mercenário das trilhas cobra soldo mesmo abaixo do limiar gratuito das tropas regulares e deserta primeiro. Depois de três contratações o acampamento fica abandonado e as obras em ruína (Q-177). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Pedido do dono de 02/10/2026 — ADR 0052. O Diplomata básico está disponível em todos os impérios: lidera incursões enquanto o monarca permanece no reino, negoceia e corre risco de captura; depois de evoluir, assimila impérios e acelera o treino de sucessores. É tropa sob IA, nunca corpo jogável. A ausência de um Diplomata evoluído não impede contratar outro básico. O resgate de prisioneiro e a dívida de mercenários ficam em registo próprio, separado da Dívida da Candeia (Q-203).

Direção adotada: os acampamentos estáticos e as probabilidades desta baseline não descrevem todo o sistema futuro. Companhias móveis, contratos com outros reinos e despertar social pertencem a RG-24 (§88). Q-203 aprova o Diplomata universal e as suas missões; a implementação completa continua em UN-18–UN-21.

Reis, ganância, impulsos e sucessão

Ganância

Cada rei — o teu e os inimigos — tem um valor de Ganância (0–100): a percentagem do rendimento diário que desaparece para os nobres. É simultaneamente o teu mostrador de dificuldade e informação tática sobre o inimigo.

Impulsos reais

Um impulso por dia. Cada um tem vantagem e desvantagem — nunca só vantagem. É a mecânica que transforma "gerir" em "apostar".

O preço em moedas (Q-014). Cada impulso tem uma base, na medida do que vale: a Colheita Forçada 3 (Q-158), a Chamada às Armas 4, a Rota Protegida 5, a Feira Livre e a Vigília 6, o Perdão Real 10. O preço de cada dia é essa base a crescer com a produção — ao mesmo ritmo que ela (§06) —, e por isso custa sempre o mesmo em dias de trabalho. O tirano paga metade. Repetir o mesmo decreto dentro de três dias custa uma vez e meia por cada vez que ele saiu: o reino cansa-se da mesma ordem, e o melhor impulso deixa de ser o único que se usa.

Sucessão: preparação, escolha e risco

A Casa do Herdeiro abre na Fortaleza (Q-222). O herdeiro permanece neutro enquanto se prepara. Pronto, o jogador vai à casa e escolhe um dos imperadores desbloqueados e elegíveis. A transferência do governo reinicia a preparação: sem outro sucessor pronto, a morte pode encerrar a campanha. Solo mantém uma única coroa soberana em todos estes estados (Q-196/Q-197/Q-202).

A Q-133 aprovava dez dias de treino, cinco moedas por dia e o atalho do Diplomata evoluído. As Q-196/Q-202 alteram o contrato: a manutenção deve ser a mais alta do jogo, e o incumprimento elimina o herdeiro. Os números da baseline não provam que o requisito novo esteja satisfeito; afinação em UN-32. Não se fixa outro preço nesta revisão.

A ganância é sorteada na sucessão por morte segundo Q-133. O comportamento da ganância numa troca voluntária continua aberto: a resposta à Q-205 descreveu o quarto imperador, sem aprovar todas as outras propostas dessa pergunta. O nome próprio e o perfil imperial são coisas diferentes; um sucessor pode ter identidade própria sem criar uma quarta classe inicial.

A §89 descreve os estados e testes. Preparar o herdeiro, mantê-lo e escolher o sucessor têm de ser uma sequência jogável, persistente e legível, não apenas uma alteração direta no estado de desenvolvimento.

Morte, ressurreição e derrota

Painel de 30/09/2026 — ADR 0043. O decay mantém as obras escolhidas e deixa as outras próprias em alicerce, com nível, caminho e variante; quaisquer mãos próprias podem reerguê-las por uma fração do investido. Semente e mapa revelado também ficam: as terras anteriores reaparecem desabitadas, sem recrutas novos ou loot (Q-171, Q-180). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Campanha e legado: o ritual de ressurreição tem de ocorrer antes do prazo; descobrir outro imperador não anula a perda do atual. Q-140 distingue desbloqueio de perfil e evolução: num jogo novo volta a ganhar-se a evolução. A Q-206 permite voltar a escolher um imperador perdido ao começar de novo. O comando destrutivo “Recomeçar do zero” da Q-164 apaga também o legado na baseline; não deve ser confundido com o novo começo que preserva desbloqueios. A apresentação e a persistência desses fluxos têm de ser reconciliadas em UN-32, sem apagar dados como consequência implícita de uma escolha de perfil.

Segredos, lore e o teu tutorial invisível

O Kingdom pode dispensar tutorial porque tem cinco mecânicas. Tu tens quarenta e oito. Os teus segredos espalhados pelo mundo são o tutorial — e é assim que ensinas sem uma única caixa de texto explicativa.

O que a estátua ensina só existe depois de achada (Q-016). Cada estátua guarda uma coisa — uma obra ou um gesto — e até o rei lá ir em pessoa essa coisa não existe no teu jogo: a obra não aceita moeda, o gesto não faz nada. A do Ferreiro, perto do castelo, guarda a Forja; a da Oferenda, fora das muralhas a leste, o sacrifício de moedas à Podridão; a do Mineiro, fora das muralhas a oeste, a escora que fecha a passagem. O que se acha é do império e passa ao herdeiro e à região seguinte. Nada do núcleo do jogo — os dois verbos, as muralhas, recrutar — fica atrás de uma estátua.

Os 12 diários — a estrutura narrativa

Doze fragmentos, três por ato, encontrados por ordem de conquista e não por ordem de escrita. Cada um tem de funcionar isolado e mudar o sentido dos anteriores. A regra: nenhum diário explica a Podridão diretamente; todos descrevem uma decisão humana que, lida em conjunto, a explica.

Biomas caóticos

Não são níveis — são modificadores de rota. Regiões onde eventos e criaturas te afetam ao atravessar:

• Campo de esporos — as tuas tropas ganham 20% de dano e perdem 15% de vida por dia enquanto lá estiverem.
• Várzea Invertida — a gravidade das faixas troca: a faixa aérea passa a andar-se, a superfície voa-se.
• Sulco Cego — sem luz; só o Cavaleiro Selado se orienta, porque já não usava os olhos.
• Mercado dos Ossos — mercenários a metade do preço, dívida ao dobro do juro.

Painel de 30/09/2026 — ADR 0043. Cada masmorra tem tesouro, guarda ou relíquia, com recompensa normal, dupla ou tripla. O sorteio persiste e o guarda não desaparece à alvorada. Não há reposição de loot ao carregar (Q-176). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Entradas com causa — ADR 0072. Uma ruína só tem interior se o povo dela ainda tem tecto de entradas opcionais (optional_max, uma por optional_spacing_px de trilho e limiar); decide-se quando o segmento nasce e fica. Uma ruína sem interior continua a ser ruína. A falha de rocha de um limiar pode abrir uma caverna natural, sem tesouro. O sorteio da recompensa continua a ser feito quando o segmento nasce, mas a recompensa só se materializa no meio da baía, na primeira descida, e uma vez.

Dois modos, ambos na Fase 8

O relatório mestre e ADR 0067/0068 definem o contrato atual. Solo funda um reino; Coop partilha um reino; PvP começa com dois reinos independentes. A implementação online continua pendente.

Arquitetura Godot 4.7.2

Motor fixado: .godot-version define 4.7.2 na baseline consultada. Exemplos de configuração são subordinados ao projeto atual e às ADRs. Integrações Steam e multiplayer desta secção são metas de plataforma; não evidência de serviços já configurados.

O Godot 4.7.2 saiu em janeiro de 2026. Nada nele muda a arquitetura abaixo — mas três coisas mudam a velocidade a que trabalhas com IA: docks móveis, previews de recursos em tempo real no Quick Open, e variáveis @export criadas por arrastar um recurso para o editor de scripts. Há também suporte para profilers de tracing (Tracy, Perfetto, Instruments), que é o que vais usar quando tiveres 300 unidades no ecrã.

Configurações de projeto — copiar tal e qual

O problema da escada de escalas — e a decisão

1280×720 é a resolução certa para a tua arte, mas tem um custo: 1080p não é múltiplo inteiro de 720p (é 1,5×), e 1080p é o ecrã mais comum do mundo.

Estrutura de pastas

res://
├─ CLAUDE.md              # contrato do agente (§28)
├─ docs/
│  ├─ design/            # este dossiê, dividido por sistema
│  └─ adr/               # decisões arquitetónicas, uma por ficheiro
├─ data/                 # TUDO o que é balanceamento (.tres)
│  ├─ peoples/           # enramados.tres, portuarios.tres...
│  ├─ units/             # enramados_arqueiro.tres, fenda_ariete.tres...
│  ├─ buildings/  biomes/  classes/  waves/  economy/
├─ src/
│  ├─ core/              # autoloads: EventBus, GameClock, SaveService, RNG
│  ├─ sim/               # simulação PURA, sem nós: economia, moral, podridão
│  ├─ actors/            # Unit, Builder, King, Mount, Creature
│  ├─ world/             # WorldGen, Chunk, Band, Camera
│  ├─ ui/  net/
├─ scenes/
├─ art/
│  ├─ source/            # .aseprite (Git LFS)
│  └─ export/            # .png + .json gerados (NÃO versionar)
├─ audio/  shaders/
└─ tests/                # gdUnit4

Dados como Resource

# src/sim/data/unit_data.gd
class_name UnitData extends Resource

@export var id: StringName
@export var display_name: String
@export_group("Combate")
@export var max_health: int = 10
@export var damage: int = 0
@export var attack_interval: float = 1.2
@export var accuracy_open: float = 0.34   # 1.0 dentro de torre
@export_group("Economia")
@export var recruit_cost: int = 1
@export var upkeep_per_day: float = 0.0
@export_group("Mundo")
@export var band: Band.Kind = Band.Kind.SURFACE
@export var move_speed: float = 26.0
@export_group("Arte")
@export var sprite_frames: SpriteFrames
@export var layer_slots: Array[StringName] = [&"body", &"face", &"weapon"]

Cada tropa é um .tres. Balancear é editar tabelas — nunca código. Isto também significa que podes gerar todos os .tres a partir de um CSV e balancear numa folha de cálculo, que é exatamente o que a tabela do §07 é.

Desempenho com centenas de unidades

Save

Um Dictionary de tipos base validados contém o estado de src/sim/ e as posições das entidades. Grava-se com FileAccess.store_var e lê-se com FileAccess.get_var(false), conforme a ADR 0007. O esquema e a migração são explícitos; nenhum Resource é carregado a partir de um save. Regras não negociáveis:

• Escreve para ficheiro temporário e só depois renomeia. Um crash a meio da escrita não pode destruir o save.
• Campo save_version: int desde a v1, com migrações explícitas. Um jogador que perca 40 horas por causa de um update não volta.
• Três slots com rotação em user://, auto-save no amanhecer de cada dia.
• Nunca uses load() num ficheiro de save. Um .tres arbitrário pode conter script embutido — é uma execução remota de código disfarçada. Grava tipos base com FileAccess.store_var(dados, false) e lê com FileAccess.get_var(false); valida os campos. Nunca uses ResourceLoader.load num save (ADR 0007, Q-036).

Steam, Steam Deck e web

• GodotSteam para conquistas, estatísticas, cloud saves e sockets. É o GDExtension padrão do ecossistema e a Valve documenta o Godot como motor suportado.
• Steam Deck: 1280×800 → 1× nativo com 40 px de barras. O ecrã do Deck é praticamente a tua tela de autoria. §26 tem os critérios de verificação.
• Web: requer cabeçalhos COOP/COEP para threads. Mantém um ramo não-threaded como reserva e reduz o escopo da demo web (texturas máx. 1024, uma música em simultâneo) em vez de esperar que corra igual ao PC.

Como as tropas e os reis decidem

O Kingdom prova que previsível vence inteligente quando o jogador não tem controlo direto. A arquitetura abaixo é deliberadamente simples na base e sofisticada só onde é preciso.

Movimento em mundo 1.5D

Não precisas de A* nem de NavigationServer2D na superfície: o mundo é uma linha. O movimento é sign(alvo.x - self.x) mais steering de separação. Complexidade real só existe em três casos:

• Mudança de faixa — grafo minúsculo de passagens e pontes. Dijkstra sobre 20–60 nós. Trivial.
• Voadoras — movimento livre em X e Y dentro da faixa aérea, com flocking leve.
• Subterrâneo — aí sim há túneis ramificados: usa NavigationRegion2D só nesta faixa.

Utilidade para as escolhas do rei inimigo

Os impérios inimigos não são scripts. Cada um avalia, uma vez por dia, um conjunto pequeno de ações com pontuação de utilidade ponderada pela sua ganância e pela idade do rei. Cinco ações, cinco fórmulas, comportamento que parece intencional — e cabe em 150 linhas.

# src/sim/ai/enemy_king_ai.gd
func choose_action(s: KingdomState) -> StringName:
    var greed := s.greed / 100.0
    var scores := {
        &"fortify":  s.wall_deficit * 1.4 + s.threat * 0.8,
        &"attack":   s.army_surplus * 1.2 - s.king_age_risk,
        &"recruit":  (1.0 - s.army_ratio) * 1.1,
        &"expand":   s.income_deficit * 0.9 * (1.0 - greed),
        &"diplomat": s.favor_ratio * 1.3,
    }
    # tiranos poupam no muro e gastam em elites
    if greed > 0.65:
        scores[&"fortify"] *= 0.45
        scores[&"recruit"] *= 1.35
    return _weighted_argmax(scores, s.rng)

Geração procedural do território

O Kingdom usa "blocos de construção modulares dispostos aleatoriamente, com vegetação de solo colocada automaticamente e cotos estratégicos de torre e muro para evitar sobreposição". É o modelo certo para ti também.

O conflito que as referências levantam — e como se resolve

Há aqui uma contradição que este documento nunca tinha nomeado, e as três referências obrigam a nomeá-la agora.

A saída não é abandonar a geração. É subir a unidade autorada e separar quem autora o quê. Seis regras, e a primeira sozinha resolve metade do problema.

A lição do Chef RPG: desenhar lugares, não fundos

O autor do Chef RPG é designer de arquitetura. Aplica desenho urbano a cada local — e é por isso que uma aldeia dele parece habitada e uma folha de assets não. São quatro ferramentas, e todas se traduzem diretamente para 1.5D.

Painel de 30/09/2026 — ADR 0043. Os oito povos têm kits, assuntos e obras locais próprios. O povo do pântano chama-se Bruma, nome de trabalho ajustável; os identificadores anteriores migram nos saves. Uma muralha própria além de um acampamento ou uma árvore vizinha abatida acaba com ele; no sítio pode erguer-se uma casa de cidadãos, até três à espera e mais caros (Q-170, Q-175). Os valores novos de balanceamento são propostas ajustáveis nas tabelas.

Civilization VII e Manor Lords: a §87 especifica influência local, cobertura, afinidade regional proposta e custo de transformação; a §88 especifica sociedades e rede territorial. O tempo de travessia é uma medição por região (Q-155), não uma extensão fixa. Geração e fundação devem reservar os mesmos recursos críticos, independentemente da ordem em que sejam executadas.

Pipeline de pixel art e a paleta mestra

Direção atual do dono (Q-235): objetos e sprites são elaborados com base em 64×64 píxeis. Esta é a referência de autoria, não uma obrigação de todos os edifícios, silhuetas, colisões ou animações terem a mesma caixa. As medidas técnicas e de ocupação continuam explícitas nos dados; assets e ampliações respeitam a grelha. A direção visual da ADR 0075 está integrada na base publicada pelo PR #92.

Família visual atual: Monarca corpulento, Nia de cabelo encaracolado e dois machados, Imperador Arqueiro encapuzado; a Podridão partilha madeira apodrecida, musgo, sombras ameixa e olhos âmbar. A sede cresce da fogueira para tendas, povoado, vila, vila fortificada e castelo-carvalho. A paisagem natural não antecipa uma cidade construída. A floresta funcional preserva espécies, estações, marca de abate e cepos. As quatro poses de caminhada e as lacunas de unidades especializadas e obras menores continuam explícitas no inventário artístico; direção aprovada não equivale a aprovação final de cada asset.

Esta secção foi reescrita à volta das três referências que deste. A especificação continua a derivar de como desenhas (§01) e a paleta continua a ser a tua — mas agora há três coisas que não havia: a lei da escala dupla, a pilha de iluminação, e a fonte arquitetónica de cada povo. O plano de produção foi refeito em consequência, e o cenário encolheu.

As três alavancas — o que cada referência ensina, e qual delas é tua

Medi as cinco capturas (§01) e fui ver como cada jogo é feito. A conclusão útil é que os três resolvem "cenário bonito" com alavancas diferentes, e que só uma delas é diretamente tua.

O veredito sobre a resolução — e porque é que ela fica onde está

A tentação, depois dos números do §01, é baixar para 640×360 e ficar em pé de igualdade com o Eastward. Não. A tua arte de personagem está desenhada a 1:1 nesta grelha, perde 6,3% dos pixels a reduzir, e é o teu ativo mais valioso e o mais difícil de refazer. A regra de ouro do §01 mantém-se: é a grelha de autoria que manda.

O que muda não é a resolução — é a densidade de desenho dentro dela. E o cálculo é direto:

A paleta de trabalho — 112 cores, sete famílias

Extraída das duas cenas (104 + 115 cores opacas, 137 únicas combinadas, 112 acima do limiar de ruído). É a rampa atual de arte em curso, não uma paleta fechada — a caixa no fim desta secção diz quando e como se fecha. Passa o rato por cima para ver o hex; clica para copiar. O botão exporta em .gpl, que a Aseprite importa diretamente.

O que existe hoje, e o que falta

A versão anterior deste documento tratava a arte como um problema resolvido. Não é — mas também não está toda por fazer, e a distinção importa muito para o calendário. O design de personagem está praticamente fechado nas figuras que já desenhaste; o cenário é que está no início.

Bloco 1 · Personagens — ≈ 32 h (16%)

Bloco 2 · Cenário — ≈ 70 h (40%) revisto na v4

As horas abaixo já contam com a lei da escala dupla (§01). Desenhar cenário com unidade de 2 px em vez de 1 px corta perto de 40% das decisões de pixel por peça — não é uma estimativa otimista, é aritmética de área. Os valores da v3 estão entre parênteses.

Bloco 4 · Luz e atmosfera — ≈ 18 h novo na v4

Bloco 3 · Criaturas, efeitos e interface — ≈ 56 h (32%)

As três saídas, e a que recomendo

B + C em conjunto resolvem-no com folga. E há uma quarta alavanca que só existe porque o design de personagem está fechado: as personagens podem entrar no jogo já. Não precisas de esperar pelo cenário para teres figuras animadas a andar num ecrã de blocos de cor — o que significa que a Fase 1 pode ter, desde cedo, uma coisa que se parece com um jogo.

A ordem por que se acaba a arte

Não é a ordem em que apetece desenhar. É a ordem que desbloqueia mais coisas por hora gasta — e começa pelas personagens precisamente porque estão prontas.

A pilha de iluminação — o Eastward em Godot, por ordem de retorno

A Pixpil monta cada cena em 3D dentro do motor, pinta um bump map à mão para cada peça, simula SSAO e passa tudo por LUTs e camadas de névoa. Tem oito pessoas e seis anos. Tu tens sábados. Mas a pilha decompõe-se, e os primeiros três degraus custam quase nada e dão a maior parte do efeito.

A profundidade, camada a camada

As seis camadas de parallax já estavam na tabela de parâmetros. O que faltava era dizer o que muda de uma para a outra — e agora os deltas são medidos nas tuas referências (§11), não inventados.

Cada povo precisa de uma fonte arquitetónica, não de uma paleta

Esta é a lição mais barata e a mais subestimada. O Eastward mistura arquitetura japonesa Showa e Taishō com Hong Kong e Xangai; o Chef RPG cruza arquitetura asiática e ocidental com cyberpunk, e o autor descreve o tema como o choque entre tradição e tecnologia. Nenhum dos dois inventou um estilo — os dois foram buscar um. É o que faz um kit parecer uma cultura em vez de um conjunto de casas.

A tua §04 define os seis povos por terreno, economia, defesa e tropa. Falta a coluna que decide como eles se desenham. Estas são propostas — o que importa é que cada uma seja um sítio real que possas ir ver, e que a fonte fique escrita no PeopleData.tres ao lado da rampa de paleta.

A gramática visual — escreve-a e não a quebres

Slots: o teu sistema modular

Os teus ficheiros já separam Body, Face, Sword, Shield, Equipments. Formaliza como cinco slots:

Cada slot é um Sprite2D filho com o mesmo AnimationPlayer. Um personagem = 5 sprites empilhados. Custo de desenho desprezável em 2D; poupança de trabalho artístico enorme — e é o que torna viável ter seis povos.

Da Aseprite ao Godot

• Autoras em art/source/<povo>/*.aseprite, uma camada por slot, tags por animação (idle, walk, attack, die).
• Godot Aseprite Wizard importa para SpriteFrames ou AnimationPlayer respeitando tags e camadas. É o plugin mais maduro do ecossistema.
• Nomenclatura obrigatória: <povo>_<entidade>_<slot>.aseprite — ex. enramados_ferreiro_body.aseprite. A IA depende disto para gerar cenas sem ver a arte.
• art/export/ é gerado e está no .gitignore. art/source/ vai para Git LFS desde o primeiro commit — migrar depois é doloroso.

Shaders que valem a pena

Iluminação

Um CanvasModulate por faixa, animado pelo GameClock, dá o ciclo dia/noite quase de graça — e o corte de solo pode ficar escuro de forma permanente, com luz só nas cavidades descobertas. PointLight2D para as fogueiras que já desenhaste (forja, forno), faróis e a própria Podridão.

Camadas que respondem ao dia

• Motor: AudioStreamInteractive e AudioStreamSynchronized, nativos do Godot desde a 4.3. Não precisas de FMOD nem Wwise — poupa licença e complexidade de export web.
• Música: uma faixa por bioma, gravada em 4 stems: base, dia, tensão, noite. O GameClock faz crossfade de volumes. A Podridão a aproximar-se sobe o stem de tensão proporcionalmente à distância — o jogador ouve-a antes de a ver do outro lado do ecrã.
• Sino da manhã: marcador sonoro do amanhecer, como no Kingdom. É o teu sinal mais importante e deve ser inconfundível.
• Aviso do crepúsculo: som distinto quando A Podridão nasce. O jogador tem de conseguir reagir sem olhar para o HUD.
• SFX: variação por pitch (±8%) em tudo o que se repete: passos, moedas, flechas. Sem isto, 300 unidades soam a metralhadora.
• Limite de vozes: máx. 24 em simultâneo, com prioridade por proximidade da câmara. Obrigatório no export web (máx. 1 stream de música).

Controlos, HUD diegético e feedback

Atualização da baseline — ADR 0078, UX-08/CV-01: o Atlas do Império unifica a linguagem da HUD. A fundação apresenta uma linha contextual; Interagir abre a ficha do sítio sem fundar nem gastar. O foco inicial é Voltar, e confirmar volta a validar pela simulação. Em janela baixa o corpo da ficha rola; a navegação mantém teclado, comando e toque. O inspetor pode mostrar fontes e alcance do território. A sua sobreposição é diagnóstico, não substitui a geografia visível.

A v2 dizia "dois verbos" e parava aí. Isto é o mapa completo. Um jogo com 48 mecânicas e dois botões só funciona se cada contexto estiver escrito — e o Steam Deck obriga-te a resolver isto antes da demo, não depois.

O mapa de comando

HUD diegético — o que existe no ecrã, e onde vive

Prioridade à leitura do mundo. Informação necessária sobre moeda, vida, munição, fôlego, dívida e disponibilidade deve continuar legível. A intenção diegética não proíbe o HUD funcional e as opções de acessibilidade. O PR #92 integrou o HUD móvel e as letras do mundo dimensionados para a leitura, com recursos e extras separados e caixas limitadas; confirmar em equipamento real continua um critério próprio.

Feedback — a lista de juice que não é opcional

Num jogo sem UI, o feedback é a interface. Cada item abaixo é barato e cada um deles falta na maioria dos clones do Kingdom:

• Moeda largada — arco parabólico, som com pitch variável, pequeno bounce e sombra. Isto acontece milhares de vezes por partida: é a animação mais importante do jogo.
• Impacto — flash branco de 80 ms, 3 px de knockback, partícula de 4 px na direção do golpe.
• Screen shake — só para o muro a cair e o Aríete a acertar. Nunca para golpes normais. Amplitude máx. 4 px, e com opção de desligar (§26).
• Amanhecer — sino + varrimento de luz da esquerda para a direita a 900 px/s + as tropas a saírem dos postos em cascata, não todas ao mesmo tempo.
• Conquista — o kit de arquitetura novo aparece na roda do rei com o ícone a ser entalhado em madeira em 6 frames.
• Cegueira do Cavaleiro Selado — vinheta que fecha até 40% do ecrã, som abafado, e a câmara deixa de antecipar o movimento. A perda tem de sentir-se.

A moeda no marco: melhorias e reparações da sede continuam contextuais e mostram o destinatário antes do pagamento. A evolução de monarca e companhia passou para feitos de batalha (Q-223/Q-232); não se ensina a antiga compra de evolução como regra atual. Corrida: manter o botão, soltar para parar (Q-193); todas as ações devem existir em toque, com alavanca e botões adaptados (Q-187).

A Última Carroça: explorar, escolher e fundar

A abertura atual é a Última Carroça, consolidada pelas ADRs 0065–0070 e pelas Q-221/Q-223/Q-231. O imperador chega com uma carroça e três cidadãos sem ofício. Não nasce castelo, pioneiro construtor, arqueiro automático nem companhia gratuita. O jogador explora para escolher onde criar raízes.

Sequência de experiência

A primeira fundação não cobra moeda; melhorias, ferramentas e companhia cobram segundo os dados. A banca do martelo permite criar o construtor antes de erguer a muralha. A exceção territorial das bancas evita a dependência circular “precisa de muro para obter construtor, precisa de construtor para obter muro”. Os restantes convites protegidos exigem o recinto correspondente.

Tempo visual e tempo social

O dia visual, o desgaste e a vida selvagem podem avançar antes da fundação. O Dia Dois civilizacional depende de fundação, primeira noite territorial resolvida e amanhecer seguinte. A correspondência entre esses relógios ainda requer o trabalho de RG-24; o calendário corrente do protótipo não é prova de que a separação já exista.

As janelas do Documento Mestre — exploração inicial, descoberta, comparação e uma fundação típica mais tarde — são objetivos de playtest. Não há obrigação de fundar ao minuto dois, vinte ou em qualquer local marcado. Uma decisão precoce é válida; uma exploração longa deve ter consequências legíveis. O orçamento de risco antes da fundação continua a ser validado no âmbito de RG-06/RG-24, sem inventar imunidade permanente ou prazo de derrota.

O que deve ser ensinado pelo mundo

1. Pessoas seguem e precisam de trabalho; moeda é um gesto com destinatário.
2. Um lugar pode ser bom para alimento e mau para defesa; não existe escolha universalmente superior.
3. Desmatar paga agora e pode retirar abrigo ou rendimento futuro; a pré-visualização explica a perda.
4. A luz permite ler e proteger o espaço conforme cada fonte; visibilidade e proteção não são a mesma regra.
5. O subsolo é um lugar explorável com chão, chegada e espaço útil, não uma escada sem destino.
6. A Podridão, o Lume e os Amargueiros pertencem ao mesmo mundo de consequências; a §83 explica como os revelar sem forçar uma morte.

Medição da abertura

Medir tempo até compreender a moeda, motivos da escolha do terreno, primeira profissão, primeiro rendimento, primeira noite e primeiro regresso. Medir por semente, monarca, dispositivo e trajetória; o piloto automático é diagnóstico e não substitui jogadores. Comparar pelo menos duas estratégias de abertura sem alterar os dados para fazer um único percurso parecer bom.

Um teste de aceitação começa pelo ecrã de escolha e usa gestos normais: seguir a caravana, explorar, parar, fundar, formar, construir, guardar e retomar. Deve provar que repetir a confirmação não duplica sede, população ou riqueza e que entrar noutro bioma não repõe a abertura.

Acessibilidade e Steam Deck Verified

Em janeiro de 2026 o Steam atualizou as etiquetas de acessibilidade e os programadores já preencheram o questionário para mais de 22 000 jogos. É agora um campo visível na loja — e é uma das poucas melhorias que aumenta o público sem custar design.

Steam Deck Verified — os critérios reais

As funcionalidades a declarar no Steam

O slider de duração do dia merece destaque: é uma linha de código (o GameClock já é uma variável), serve de acessibilidade, serve de dificuldade, e evita teres de desenhar três modos separados.

Idiomas, e porque é que quase não precisas deles

A tua maior vantagem competitiva escondida: o humor está nas caras e a sinalética é entalhada em madeira. Um jogo que precisa de mil e trezentas palavras localiza-se por uma fatura de três dígitos baixos. A maioria dos indies gasta entre 5 000 € e 30 000 € nisto. As mil e trezentas são as da Parte XIII (§75): doze frases de oferta, nove títulos, dez leis de capítulo e doze diários.

A página de loja localizada vale mais do que o jogo localizado: um utilizador chinês que veja a descrição em chinês adiciona à lista de desejos mesmo que o jogo esteja em inglês. Localiza a página de Steam para os oito idiomas no dia em que a publicares (§36).

Como fazer a IA construir isto

Escolheste o modo em que a IA escreve quase tudo e tu revês e diriges. Funciona — mas só com um repositório desenhado para isso. Estas são as regras que separam um agente produtivo de um gerador de dívida técnica.

As sete regras do repositório

Ferramentas de ligação

O ficheiro CLAUDE.md — a versão da v5 (substituída pela §69)

# Empire — contrato do agente

## O que é
Kingdom-builder 2D em pixel art, Godot 4.6, GDScript. Mundo 1.5D com tres faixas
verticais. Ver docs/design/ para os sistemas e docs/adr/ para as decisoes.

## Regras absolutas
1. Maximo 250 linhas por script. Se passar, divide antes de continuar.
2. src/sim/ NAO importa de src/actors/ e NAO usa Node, Node2D ou qualquer classe
   de cena. E logica pura. Se precisares de posicao, recebe-a como parametro.
3. Balanceamento vive em data/**/*.tres. NUNCA escrevas um numero de
   balanceamento num script. Se precisares de um valor novo, cria o campo
   @export no Resource correspondente.
4. Toda a funcao publica de src/sim/ tem teste em tests/. Escreve o teste primeiro.
5. Anota sempre os tipos: func f(x: int) -> void. Sem excecoes.
6. Nao adiciones dependencias externas sem uma ADR em docs/adr/.
7. Nao toques em art/ nem em audio/. Se faltar um asset, cria um placeholder
   de cor lisa em art/export/_placeholder/ e regista-o em docs/ASSETS_TODO.md.

## Vocabulario do dominio (usa estes nomes, em ingles no codigo)
- Band       -> faixa vertical: AERIAL | SURFACE | UNDERGROUND
- Rot        -> A Podridao, a ameaca noturna
- People     -> povo/civilizacao (Enramados, Portuarios, Fenda, Horta,
                Fornalha, SobRaiz)
- Craft      -> oficio (builder, smith, cook, diplomat, bard)
- Boost      -> impulso real
- Greed      -> ganancia do rei (0-100)
- RoyalSeed  -> Semente Real (moeda de meta-progresso)
- Favor      -> moeda de diplomacia

## Ciclo de trabalho esperado
1. Le a tarefa em docs/backlog/<id>.md
2. Escreve/atualiza o teste em tests/
3. Implementa
4. Corre: godot --headless --path . -s addons/gdUnit4/bin/GdUnitCmdTool.gd -a tests
5. So depois de verde, propoe o diff

## O que NAO fazer
- Nao inventes mecanicas. Se a spec nao cobre um caso, escreve a pergunta em
  docs/QUESTIONS.md e implementa a opcao mais simples.
- Nao refatores fora do ambito da tarefa.
- Nao adiciones comentarios que repetem o codigo.
- Nao uses load() em ficheiros de save. Ver docs/adr/0007-save-security.md

Ritmo de trabalho semanal

A biblioteca de prompts, por sistema

Pediste a melhor forma de a IA construir isto. A resposta não é um prompt gigante — é uma forma fixa de pedir, repetida trinta vezes. Um pedido vago produz 400 linhas plausíveis e erradas; um pedido com contrato produz 120 linhas revisíveis.

O molde. Usa-o sempre.

CONTEXTO   Empire, Godot 4.6, GDScript. Le CLAUDE.md e docs/design/<ficheiro>.md.
TAREFA     <uma frase, um verbo>
FICHEIROS  Cria/altera SO: <lista explicita de caminhos>
CONTRATO   Assinaturas publicas exatas:
             func nome(arg: Tipo) -> Tipo   # o que faz, numa linha
DADOS      Le de: data/<caminho>.tres — campos: <lista>
TESTES     Escreve primeiro tests/<nome>_test.gd cobrindo: <3-6 casos, com numeros>
LIMITES    Nao toques em <lista>. Maximo 250 linhas. Sem dependencias novas.
SAIDA      Diff. Depois, uma frase sobre o que ficou por fazer.

Cinco prompts reais, prontos a colar

1 · O relógio do jogo — a primeira coisa que constróis

TAREFA Implementar o GameClock: ciclo de 360 s com seis fases.
FICHEIROS src/core/game_clock.gd, tests/game_clock_test.gd
CONTRATO
  enum Phase { DAWN, MORNING, NOON, AFTERNOON, DUSK, NIGHT }
  signal phase_changed(from: Phase, to: Phase)
  signal day_started(day: int)
  func tick(delta: float) -> void
  func current_phase() -> Phase
  func phase_progress() -> float      # 0.0-1.0 dentro da fase atual
  func seconds_until(p: Phase) -> float
DADOS data/economy/clock.tres — duracoes: 15/85/40/85/30/105, day_length 360.0
TESTES
  - tick(360.0) num so passo avanca exatamente 1 dia e emite day_started(2)
  - aos 75 s a fase e MORNING e phase_progress ~= 0.706   # (75-15)/85
  - aos 15.0 s exatos ja e MORNING, nao DAWN (fronteira fechada a esquerda)
  - seconds_until(NIGHT) aos 0 s == 255.0
  - alterar day_length no .tres para 180 mantem as proporcoes
LIMITES Sem Node. E um RefCounted. Nao usa get_process_delta_time.

Repara no quarto teste: 15+85+40+85+30 = 255. Dar o número calculado ao agente é o que impede uma implementação que passa nos testes por acidente.

2 · A Podridão — o sistema que te distingue

TAREFA Implementar RotSystem: entidade com posicao, massa e invocacao.
FICHEIROS src/sim/rot_system.gd, tests/rot_system_test.gd
CONTRATO
  func spawn(day: int, side: int, map_width: float) -> void
  func tick(delta: float, consecrated: Array[Vector2]) -> Array[SpawnRequest]
  func mass() -> float
  func feed(amount: float) -> void
  func position_x() -> float
  func retreat() -> void
REGRAS
  velocidade = 14.0 + 0.9 * dia, px/s
  massa      = 40.0 + 18.0 * dia + 30.0 * fortalezas_conquistadas
             + 22.0 * amargueiros + 45.0 * amargueiros_nomeados
             + 8.0 * min(recusas_nos_ultimos_5_dias, 5)          # §74, §75
  invoca a cada 4-7 s (RNG com seed), gastando o custo de massa da criatura
  sobre terreno consagrado: velocidade * 0.6
  feed(x) reduz massa em x, minimo 0
DADOS data/rot/default.tres, data/creatures/<id>.tres   # a §70 acabou com waves/
TESTES
  - dia 1: velocidade == 14.9
  - dia 10 com 2 fortalezas, campo limpo: massa == 280.0
  - tick nao devolve SpawnRequest se massa < custo da criatura mais barata
  - 30 s sobre consagrado percorre 60% da distancia de 30 s em terreno normal
  - feed(1000) poe massa a 0, nunca negativa
  - com a mesma seed, duas corridas produzem a mesma sequencia de invocacoes
LIMITES Sem Node. Devolve pedidos; nao instancia nada.

3 · Economia — onde vive o balanceamento

TAREFA Implementar Economy: rendimento, sorvedouros e a curva de asfixia.
FICHEIROS src/sim/economy.gd, tests/economy_test.gd
CONTRATO
  func daily_income(sources: Array[SourceData], day: int) -> float
  func trade_income(routes: int, day: int) -> float   # efeito de rede a partir da 2.a
  func upkeep(troop_count: int) -> float
  func greed_cut(gross: float, greed: int) -> float
  func net_income(...) -> float
  func night_cost(day: int) -> float
  func suffocation_day(profile: EconomyProfile) -> int
REGRAS
  upkeep: 0 ate 8 tropas; 0.5/dia entre 9 e 20; 1.5/dia acima de 20
  night_cost(d) = 6.1 * pow(1.22, d - 1)
  income cresce a pow(1.12, d-1) sobre a base; upkeep e constante,
  por isso o liquido cresce mais depressa que 1.12 — ver §06
  trade_income = rotas * 4.5 * pow(1.08, d-1) * (1 + 0.10 * max(0, rotas-1))
TESTES
  - upkeep(8) == 0.0 ; upkeep(14) == 3.0 ; upkeep(25) == 13.5
  - greed_cut(100, 28) == 28.0
  - suffocation_day do perfil "equilibrado" cai entre 9 e 14  <- TESTE DE DESIGN
  - cada rota de comercio ADIA a asfixia em ~2 dias (retorno decrescente)
  - trade_income(0, d) == 0.0 para todo o d
  - greed 80 antecipa a asfixia em pelo menos 3 dias face a greed 20
LIMITES Puro. Determinista. Sem RNG.

4 · Atribuição de trabalho — o algoritmo do Kingdom

TAREFA Implementar JobBoard: atribuir tropas a postos, uma vez por fase.
FICHEIROS src/sim/job_board.gd, tests/job_board_test.gd
CONTRATO
  func post(job: JobSlot) -> void
  func assign(units: Array[UnitState], phase: int) -> Dictionary  # unit_id -> job_id
REGRAS
  score = adequacao(unidade, posto) * proximidade * urgencia(fase)
  proximidade = 1.0 / (1.0 + distancia_x / 400.0)
  a NOITE, postos de muro e torre tem urgencia 3.0; plantacao tem 0.0
  atribuicao e estavel: uma unidade so muda de posto se o score novo
  superar o atual em mais de 15% (histerese, evita tremeliques)
TESTES
  - de noite, nenhum arqueiro fica atribuido a plantacao
  - com 2 postos de muro e 5 arqueiros, exatamente 2 sao atribuidos
  - correr assign() duas vezes seguidas com o mesmo estado nao muda nada
  - uma unidade a 800 px perde para uma a 100 px com adequacao igual
LIMITES Sem Node. Sem alocacoes dentro do ciclo principal.

5 · Uma cena — o único caso em que o MCP compensa

TAREFA Montar a cena de teste de combate noturno.
USA o servidor MCP do Godot. Guarda em disco no fim.
CENA scenes/tests/night_fight.tscn
  Node2D "NightFight"
   +- Camera2D            (position 640,360; zoom 1,1)
   +- CanvasModulate      (color #1B2A4A)
   +- TileMapLayer "Ground"
   +- Node2D "Wall"       (position 640, Band.GROUND_LINE) -> scenes/buildings/wall.tscn
   +- Node2D "Spawns"     6 Marker2D em x = 1100..1400, y = Band.GROUND_LINE
   +- Node2D "Units"      (vazio; preenchido em runtime)
   +- Label "Debug"       (canto sup. esq., 12 px, mostra dia/fase/massa)
DEPOIS Corre a cena e cola as 20 primeiras linhas da consola.
LIMITES Nao alteres nenhuma cena existente.

Quatro erros que vão custar-te semanas

O código dos primeiros três dias

Isto não é pseudocódigo. É o esqueleto real do projeto, escrito para caber nas regras do §28: tipado, curto, sem nós na simulação. Cria estes quatro ficheiros e tens o motor do jogo — literalmente a Camada 1 do §00.

1 · src/core/event_bus.gd — autoload

## Único ponto de acoplamento do projeto. Sistemas emitem, cenas ouvem.
## Nada em src/sim/ conhece este ficheiro — os sistemas devolvem, não emitem.
extends Node

# Ciclo
signal phase_changed(from: int, to: int)
signal day_started(day: int)

# Economia
signal coin_dropped(world_pos: Vector2, amount: int)
signal coin_collected(unit_id: int, amount: int)
signal treasury_changed(total: int, delta: int)

# Podridão
signal rot_spawned(side: int, mass: float)
signal rot_moved(x: float, mass: float)
signal creature_requested(kind: StringName, at: Vector2)
signal rot_retreated()

# Unidades
signal unit_spawned(id: int, kind: StringName, at: Vector2)
signal unit_died(id: int, at: Vector2, dropped: StringName)
signal unit_band_changed(id: int, band: int)

# Construção
signal structure_built(kind: StringName, at: Vector2, level: int)
signal structure_destroyed(kind: StringName, at: Vector2)

2 · src/sim/game_clock.gd — puro, testável, sem Node

class_name GameClock extends RefCounted

enum Phase { DAWN, MORNING, NOON, AFTERNOON, DUSK, NIGHT }

var day: int = 1
var elapsed: float = 0.0

var _durations: PackedFloat32Array
var _day_length: float

func _init(cfg: ClockData) -> void:
    _durations = cfg.phase_durations          # [15,85,40,85,30,105]
    _day_length = 0.0
    for d in _durations:
        _day_length += d

## Devolve as transições ocorridas neste tick. Quem chama emite os sinais.
func tick(delta: float) -> Array[Dictionary]:
    var events: Array[Dictionary] = []
    var before := current_phase()
    elapsed += delta
    while elapsed >= _day_length:
        elapsed -= _day_length
        day += 1
        events.append({&"type": &"day", &"day": day})
    var after := current_phase()
    if after != before:
        events.append({&"type": &"phase", &"from": before, &"to": after})
    return events

func current_phase() -> Phase:
    var acc := 0.0
    for i in _durations.size():
        acc += _durations[i]
        if elapsed < acc:
            return i as Phase
    return Phase.NIGHT

func phase_progress() -> float:
    var acc := 0.0
    for i in _durations.size():
        if elapsed < acc + _durations[i]:
            return (elapsed - acc) / _durations[i]
        acc += _durations[i]
    return 1.0

func seconds_until(p: Phase) -> float:
    var start := 0.0
    for i in int(p):
        start += _durations[i]
    var diff := start - elapsed
    return diff if diff >= 0.0 else diff + _day_length

3 · src/sim/rot_system.gd — o coração do jogo

class_name RotSystem extends RefCounted

var active: bool = false
var x: float = 0.0
var mass: float = 0.0

var _dir: int = -1
var _speed: float = 0.0
var _next_summon: float = 0.0
var _rng: RandomNumberGenerator
var _table: Array[CreatureData]

func _init(rng: RandomNumberGenerator, table: Array[CreatureData]) -> void:
    _rng = rng
    _table = table

func spawn(day: int, side: int, map_width: float, forts: int) -> void:
    active = true
    _dir = -side
    x = map_width if side > 0 else 0.0
    _speed = 14.0 + 0.9 * day
    mass = 60.0 + 26.0 * day + 40.0 * forts
    _next_summon = _rng.randf_range(4.0, 7.0)

## Avança e devolve os pedidos de invocação. Não instancia nada.
func tick(delta: float, on_consecrated: bool) -> Array[Dictionary]:
    if not active:
        return []
    var v := _speed * (0.6 if on_consecrated else 1.0)
    x += v * delta * _dir

    var out: Array[Dictionary] = []
    _next_summon -= delta
    if _next_summon <= 0.0:
        var pick := _affordable()
        if pick != null:
            mass -= pick.mass_cost
            out.append({&"kind": pick.id, &"at": Vector2(x, Band.GROUND_LINE)})
        _next_summon = _rng.randf_range(4.0, 7.0)
    return out

func feed(amount: float) -> void:
    mass = maxf(0.0, mass - amount)

func retreat() -> void:
    active = false
    mass = 0.0

func _affordable() -> CreatureData:
    var pool: Array[CreatureData] = []
    for c in _table:
        if c.mass_cost <= mass:
            pool.append(c)
    if pool.is_empty():
        return null
    return pool[_rng.randi_range(0, pool.size() - 1)]

4 · src/actors/unit_system.gd — 300 unidades sem _process

## Um nó para todas as tropas. As unidades são linhas em arrays paralelos,
## não nós com script. É o que permite 300 unidades a 60 fps.
class_name UnitSystem extends Node2D

const SLICES := 6                          # 1/6 das unidades decide por tick

var ids: PackedInt32Array = []
var pos: PackedVector2Array = []
var hp: PackedInt32Array = []
var state: PackedByteArray = []            # 0 IDLE 1 GOTO 2 WORK 3 FIGHT 4 FLEE
var band: PackedByteArray = []             # 0 AERIAL 1 SURFACE 2 UNDERGROUND
var kind: Array[StringName] = []
var sprites: Array[Node2D] = []

var _slice: int = 0

func _physics_process(delta: float) -> void:
    _slice = (_slice + 1) % SLICES
    var n := ids.size()
    for i in n:
        # decisão fatiada: cada unidade repensa a cada 6 ticks (0,2 s a 30 Hz)
        if i % SLICES == _slice:
            _decide(i)
        _advance(i, delta)
        sprites[i].position = pos[i]

func _decide(i: int) -> void:
    pass   # consulta o JobBoard; ver §29, prompt 4

func _advance(i: int, delta: float) -> void:
    pass   # movimento 1.5D: sign(alvo.x - pos[i].x) + separação

Testes, CI e os testes de design

Sem testes automáticos não consegues rever o que a IA escreve, e vais deixar de tentar ao fim de duas semanas. Com testes, podes aceitar 400 linhas sem as ler linha a linha — porque sabes o que elas têm de fazer.

Três níveis

Os testes de design a escrever primeiro

# tests/design_targets_test.gd
extends GdUnitTestSuite

func test_dia_de_asfixia_no_intervalo() -> void:
    var eco := Economy.new(load("res://data/economy/curve.tres"))
    var d := eco.suffocation_day(EconomyProfile.BALANCED)
    assert_int(d).is_between(9, 14)

func test_noite_1_e_sempre_ganha() -> void:
    var r := SimHarness.run_night(1, {&"archers": 2, &"wall": 1})
    assert_bool(r.wall_survived).is_true()
    assert_int(r.deaths).is_less_equal(0)

func test_noite_8_sem_torre_e_sempre_perdida() -> void:
    var r := SimHarness.run_night(8, {&"archers": 6, &"wall": 2, &"towers": 0})
    assert_bool(r.wall_survived).is_false()

func test_arqueiros_nao_param_ariete() -> void:
    var ttk := Combat.ttk("archer_open", "slime_ram")
    assert_float(ttk).is_greater(105.0)   # mais do que uma noite inteira

func test_sim_nao_toca_em_nos() -> void:
    for f in FileScan.gd_files("res://src/sim/"):
        var src := FileAccess.get_file_as_string(f)
        assert_bool(src.contains("extends Node")).is_false()
        assert_bool(src.contains("get_tree()")).is_false()

Os cinco portões estão na §64

Estes três níveis são a estrutura. Os cinco portões de CI que a fazem cumprir — incluindo o teste de reprodutibilidade por seed, que apanha o que nenhum dos outros apanha — estão especificados na §64.

CI em GitHub Actions

# .github/workflows/test.yml
name: testes
on: [push, pull_request]
jobs:
  gdunit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with: { lfs: true }
      - uses: godot-gdunit-labs/gdUnit4-action@v1
        with:
          godot-version: '4.6'
          paths: 'res://tests'
          timeout: 8
          report-name: relatorio.xml

Oito minutos de limite. Se a suite passar disso, é porque estás a testar cenas onde devias testar lógica pura — o sinal de que a fronteira de src/sim/ foi violada.

Medir sem espiar

Vais ter dez playtesters, não dez mil. Isso significa que os números têm de responder a perguntas que a observação não responde — e que a observação continua a valer mais do que os números.

Agência na abertura — ADR 0065

O protótipo mede localmente movimento, marco inspecionado, escolha e ID de fundação, primeira tarefa, primeira moeda, percepção contextual da contaminação, tarefa ao crepúsculo, sobrevivência, perda, mudança de tarefa após a noite e descoberta do subsolo. A pausa exporta JSON; nada é enviado a terceiros.

foundation_reason_posttest e kingdom_similarity_timestamp são observações humanas, separadas dos eventos automáticos. A estratégia observada também inclui muro e luz; o campo automático registra somente a tarefa. Metas e limitações estão em docs/qa/ultima-carroca-playtest.md. Não se toma um teste de código como prova de compreensão ou identidade.

O protocolo de playtest que funciona com dez pessoas

Nove fases, 28 a 40 meses

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

Cada fase tem um critério de saída verificável. Não avanças por sentires que está pronto — avanças quando o critério passa. É a única defesa contra o problema do Thronefall: "não acabar é sempre a maior ameaça a qualquer projeto."

As primeiras trinta tarefas, ao nível do ticket

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

Isto é o que abres na segunda-feira. Cada linha é uma sessão de agente, no formato do §29. As Fases 0 e 1 estão completas; a partir daí escreves tu, no mesmo molde.

Fase 0 — Fundação · 1 mês

Fase 1 — Núcleo jogável · 3 meses

O formato de tarefa — copia para docs/backlog/F1-08.md

# F1-08 · RotSystem

Porque   A Podridao e a mecanica que distingue o jogo. Sem ela ha um clone.
Spec     docs/design/05-loop.md, seccao "A Podridao"
Depende  F0-06 (GameClock)
Contrato [colar do prompt 2 do dossie, §29]
Feito    Os 6 testes passam + a mancha e visivel no horizonte ao crepusculo
Fora     Arte da mancha (F1-17), som (F4-03), alimentar (F6-11)

O campo Fora é o mais importante: é o que impede o agente — e a ti — de fazer três tarefas numa e produzir um diff que não consegues rever.

Quanto custa, e quantas cópias paga

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

O custo mediano de um indie ronda os 30 000–60 000 $ quando se contabiliza o custo de oportunidade, contra ganhos medianos de 5 000–15 000 $. Tu estás numa posição melhor do que a mediana por três razões: fazes a arte, fazes o design, e a IA faz a maior parte do código. O que resta é isto.

Quantas cópias pagam isto

A 16,99 € com a comissão de 30% do Steam, recebes 11,89 € por cópia a preço cheio. Mas o preço efetivo é sempre mais baixo — preços regionais, saldos, e o mercado chinês a ~45% do preço americano. O Thronefall fez cerca de 5 $ por cópia num jogo mais barato. Assume 8,50 € líquidos por cópia e não te enganas muito.

Publisher ou não

Adiantamentos típicos vão de 20 000 $ (micro-publishers) a 500 000 $ e mais. A percentagem para o publisher fica geralmente nos 30–35% depois da comissão da plataforma, e o adiantamento é recuperável da tua parte. A conta é dura: com 150 000 $ de adiantamento a 30/70, um jogo que faça 300 000 $ brutos deixa-te 0 $ e o publisher com 63 000 $.

Wishlists, página, demo e trailer

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

Vinte mil jogos por ano e metade acaba com menos de dez análises. A diferença entre os que vendem e os que não vendem raramente é qualidade — é tempo de exposição acumulado. Isso começa no mês 11, não no mês 28.

O calendário

A página de Steam — o que converte

O nome

Empire é um nome de código, não um nome. É genérico demais para ser pesquisável e quase de certeza colide com marcas registadas. Antes da Fase 4, precisas de um nome que: seja pesquisável no Steam sem competir com trinta jogos; funcione fonicamente em inglês e português; esteja livre como domínio .com e em pesquisa de marcas na UE; e diga algo sobre povos ou a noite que avança — os dois ganchos reais do jogo. Trata isto como uma tarefa de design com um prazo, não como uma coisa que aparece.

Registo de risco

Ordenado por dano esperado, não por probabilidade. Relê isto no fim de cada fase — leva quatro minutos e é a coisa mais barata que podes fazer pelo projeto.

As dez coisas a fechar esta semana

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

Por ordem. Nenhuma demora mais de uma tarde, e todas desbloqueiam trabalho a jusante.

A especificação técnica começa aqui

As trinta e nove secções anteriores respondem a que jogo é este e se vale a pena fazê-lo. As vinte e nove que se seguem respondem a que ficheiros existem, que campos têm, por que ordem correm e como se sabe que estão certos. São públicos diferentes: a primeira metade é para ti; esta é para ti e para os agentes que escrevem o código.

Autoridade

O que ainda falta ao projeto, depois desta parte

Para não ficares com a ideia de que isto fecha tudo. O mapa honesto do que existe e do que não:

Contrato vivo: não existe prioridade automática de uma secção antiga por ter número menor. Atualiza-se a regra temática, a ADR, o registo da decisão, os dados quando autorizados e a documentação gerada. O catálogo técnico contém contratos históricos: nomes atuais e migrações seguem AGENTS.md e ADRs; a §90 identifica lacunas de implementação.

As oito regras que nunca se quebram

Cada uma existe porque violá-la custa uma reescrita, não uma correção. Cada uma tem um teste automático que a defende (§64). Se um agente propuser código que quebre qualquer uma delas, o CI trava o commit antes de tu leres uma linha.

Soberania: Solo mantém uma coroa durante controlo, queda, roubo e sucessão pendente. Coop tem um reino comum; PvP tem dois reinos segundo ADR 0067/0068. Persistência, autoridade e recompensas devem respeitar a topologia do modo (§89), sem enfraquecer as invariantes de simulação.

Módulos, e quem pode importar quem

Quatro camadas. As setas só apontam para baixo. Uma seta para cima é um erro de compilação conceptual, e o CI trata-a como tal.

A árvore completa

res://
├─ data/                  # .tres gerados a partir de data/source/*.csv (§44)
│  ├─ source/             # CSV — a FONTE ÚNICA dos números
│  ├─ units/ creatures/ buildings/ walls/ peoples/ classes/
│  ├─ crafts/ mounts/ biomes/ segments/ economy/ rot/
├─ src/
│  ├─ core/               # autoloads — ver §46 e §48
│  │  ├─ event_bus.gd     # o catálogo do §46, e nada mais
│  │  ├─ game_clock.gd    # fase do dia, tick fixo
│  │  ├─ rng_service.gd   # fluxos nomeados (§42)
│  │  ├─ registry.gd      # .tres carregados por StringName
│  │  └─ save_service.gd
│  ├─ sim/
│  │  ├─ state/           # GameState, KingdomState, UnitRec…
│  │  ├─ systems/         # economy, combat, rot, jobs, build, debt…
│  │  ├─ ai/              # unit_fsm.gd, enemy_king_ai.gd
│  │  └─ worldgen/
│  ├─ actors/             # UnitView, KingView, CreatureView, MountView
│  ├─ world/              # WorldRoot, ParallaxStack, BandLayers, CameraRig
│  ├─ ui/  net/
├─ scenes/
│  ├─ boot.tscn  game.tscn  segments/  tests/
├─ art/
│  ├─ source/             # .aseprite (Git LFS)
│  └─ export/             # .png + .json gerados (NÃO versionar)
├─ shaders/  audio/
├─ tools/                 # csv_to_tres.gd, lint_sim.gd, greybox_gen.gd
└─ tests/                 # gdUnit4

Aleatoriedade com disciplina

Uma seed reproduz tudo — o §21 promete isso e mostra-a ao jogador. Essa promessa custa uma regra: a aleatoriedade é dividida em fluxos independentes, e cada consumidor usa sempre o mesmo.

Os fluxos

# src/core/rng_service.gd
extends Node

var _streams: Dictionary = {}   # StringName -> RandomNumberGenerator
var _seed: int = 0

func configure(world_seed: int) -> void:
    _seed = world_seed
    _streams.clear()
    for s in [&"world", &"combat", &"rot", &"economy", &"ai"]:
        var r := RandomNumberGenerator.new()
        r.seed = hash(str(world_seed) + str(s))
        _streams[s] = r
    var v := RandomNumberGenerator.new()
    v.randomize()                # só o fluxo visual é livre
    _streams[&"visual"] = v

func stream(name: StringName) -> RandomNumberGenerator:
    assert(_streams.has(name), "fluxo RNG desconhecido: %s" % name)
    return _streams[name]

func snapshot() -> Dictionary:   # para o save: guarda o estado, não só a seed
    var out := {}
    for k in _streams:
        if k != &"visual":
            out[k] = _streams[k].state
    return out

Regras derivadas

O tick, e o que corre em que ordem

30 passos de simulação por segundo, metade do render (§19). Dentro de cada passo a ordem é fixa e escrita — porque uma ordem implícita é uma ordem que muda sozinha quando um agente reorganiza um ficheiro.

Os recursos, com todos os campos

Doze classes de Resource. Cada uma é gerada a partir de um CSV em data/source/ pela ferramenta tools/csv_to_tres.gd — o CSV é a fonte, o .tres é artefacto, e nenhum dos dois se edita à mão no outro lado.

As duas que mais interessam, por extenso

# src/sim/data/unit_data.gd
class_name UnitData extends Resource

@export var id: StringName                      # &"archer" — chave do Registry
@export var display_key: String                   # chave de tradução, não texto
@export var people: StringName = &"neutral"

@export_group("Combate")
@export var max_health: int = 10
@export var damage: int = 0
@export var attack_interval: float = 1.2          # segundos
@export var accuracy_open: float = 0.34            # 1.0 dentro de torre
@export var range_px: int = 28
@export var targets_bands: Array[int] = [1]         # que faixas consegue atingir

@export_group("Economia")
@export var recruit_cost: int = 1
@export var upkeep_per_day: float = 0.0
@export var drops_on_death: Array[StringName] = []

@export_group("Mundo")
@export var band: Band.Kind = Band.Kind.SURFACE
@export var move_speed: float = 26.0               # px/s
@export var scale_tier: int = 2                    # 1, 2 ou 3 — §22
@export var can_change_band: bool = false

@export_group("Arte")
@export var sprite_frames: SpriteFrames
@export var layer_slots: Array[StringName] = [&"body", &"face", &"weapon"]
@export var shadow_width: int = 18                 # largura da elipse de contacto

# src/sim/data/rot_profile.gd — A Podridão como dados, não como código
class_name RotProfile extends Resource

@export var speed_base: float = 14.0               # px/s
@export var speed_per_day: float = 0.9
@export var mass_base: float = 60.0
@export var mass_per_day: float = 26.0
@export var mass_per_fortress: float = 40.0
@export var summon_interval: Vector2 = Vector2(4.0, 7.0)
@export var consecrated_slowdown: float = 0.40      # -40% em terreno consagrado
@export var trail_move_penalty: float = 0.20
@export var two_sided_from_day: int = 12
@export var sacrifice_mass_per_coin: float = 0.5

O estado autoritativo, e o que não pertence lá

Uma regra simples: se está aqui, é guardado no save e é determinista. Se está num nó, é derivado e descartável. A fronteira entre os dois é o que torna o save trivial.

# src/sim/state/game_state.gd
class_name GameState extends RefCounted

var seed: int
var tick: int = 0                              # passos desde o início
var day: int = 1
var phase: GameClock.Phase = GameClock.Phase.DAWN
var phase_elapsed: float = 0.0

var player: KingdomState                        # o teu império
var kingdoms: Array[KingdomState] = []          # impérios inimigos, ordenados por id

var units: Array[UnitRec] = []                  # ordenado por id, sempre
var creatures: Array[CreatureRec] = []
var buildings: Array[BuildingRec] = []
var coins_on_ground: Array[CoinRec] = []
var corpses: Array[CorpseRec] = []              # ressuscitáveis até ao amanhecer

var rot: RotState                               # posição, largura, massa, ativo
var world: WorldState                            # segmentos, cavidades, passagens, terreno apodrecido
var debt: DebtState
var next_id: int = 1                             # contador único e monotónico

# src/sim/state/unit_rec.gd — uma tropa é uma linha de dados, não um nó
class_name UnitRec extends RefCounted

var id: int
var data_id: StringName          # chave para UnitData no Registry
var owner: int                   # 0 = jogador, 1..n = impérios
var x: float
var band: Band.Kind
var health: int
var state: UnitFsm.State         # IR_PARA, TRABALHAR, COMBATER, FUGIR, MORTO
var job_id: int = -1
var target_id: int = -1
var attack_cooldown: float = 0.0
var carried_coins: int = 0
var slots: Dictionary = {}       # body/head/face/weapon/overlay -> StringName
var loyalty: float = 1.0         # mercenários e encantados (§14)

O que fica de fora, e porquê

O catálogo completo

Sessenta e um sinais. É a lista fechada: um sistema que precise de comunicar uma coisa que não está aqui precisa primeiro de uma entrada nova na §46. É esta restrição que impede a IA de inventar meia dúzia de sinais quase iguais em ficheiros diferentes.

Enums e números que o código pode conhecer

A invariante I4 diz que balanceamento vive em .tres. Isto é o complemento: o que não é balanceamento e pode, por isso, ser constante de código. A distinção é simples — se afinares isto num playtest, está no sítio errado.

# src/sim/band.gd  — corrigido na v5.1, ver §70
class_name Band
enum Kind { AERIAL = 0, SURFACE = 1, UNDERGROUND = 2 }

# Planos de imagem — §11. Fixados na Fase 0 e nunca mexidos.
const SKY_TOP        := 0
const HORIZON        := 420    # onde as camadas distantes se encontram
const GROUND_LINE    := 517    # onde as tropas pisam
const SCREEN_BOTTOM  := 720
const AERIAL_BOTTOM  := 200
const SOIL_CUT       := SCREEN_BOTTOM - GROUND_LINE   # 203

# Camadas de física — uma por faixa, mais estáticos
# v5.2: uma constante por linha — o GDScript não aceita várias numa só (C-01, §72)
const L_AERIAL   := 1
const L_SURFACE  := 2
const L_UNDER    := 4
const L_TERRAIN  := 8
const L_BUILDING := 16
const L_COIN     := 32

GameClock — a fase do dia é um estado, não um temporizador

Seis fases, 360 segundos, durações do §05. Tudo o resto no jogo pergunta ao relógio; o relógio não pergunta a ninguém.

# src/core/game_clock.gd — o único sítio onde o tempo avança
enum Phase { DAWN, MORNING, NOON, AFTERNOON, DUSK, NIGHT }
const DURATIONS := [15.0, 85.0, 40.0, 85.0, 30.0, 105.0]
const STEP := 1.0 / 30.0

func advance(s: GameState) -> void:
    s.tick += 1
    s.phase_elapsed += STEP
    if s.phase_elapsed < DURATIONS[s.phase]:
        return
    var old := s.phase
    s.phase_elapsed = 0.0
    s.phase = (s.phase + 1) % 6
    if s.phase == Phase.DAWN:
        s.day += 1
        EventBus.queue(&"day_started", [s.day])
        EventBus.queue(&"night_survived", [s.day - 1, _deaths, _walls_lost])
    EventBus.queue(&"phase_changed", [old, s.phase])

EconomySystem — três circuitos, uma passagem por fase

O §06 define produção, conversão e comércio. Aqui está o contrato: quando corre, o que toca, e a regra que impede a matéria-prima de virar um inventário.

O algoritmo, por fase

func on_phase(s: GameState, phase: int) -> void:
    # 1 — produção: cada edifício acumula a sua matéria
    for b in s.buildings:                       # ordenado por id (I2/§42)
        if b.destroyed or b.on_rot_trail: continue
        var d := Registry.building(b.data_id)
        b.stock += d.yield_per_phase
    # 2 — conversão: ofícios consomem matéria e produzem moeda OU capacidade
    for c in s.player.active_crafts:
        var src := _find_building(s, c.source_id)
        if src == null or src.stock < c.cost: continue
        src.stock -= c.cost
        EventBus.queue(&"material_consumed", [src.id, c.kind, c.cost])
        if c.mode == CraftData.Mode.COIN:
            _drop_coins(s, src.x, c.coin_yield)
        else:
            _grant_capacity(s, c.capacity_kind, c.magnitude)
    # 3 — comércio: uma vez por dia, no DAWN
    if phase == GameClock.Phase.DAWN:
        for r in s.player.routes:
            _drop_coins(s, s.player.core_x, r.income)

CombatSystem — legível antes de emocionante

As quatro regras do §07 são de design. Estas são as de implementação, e a mais importante é a ordem de resolução: sem uma ordem fixa, a mesma noite dá resultados diferentes e a promessa da seed morre.

Ordem de resolução, por tick

Ocupação de linha

# Uma regra de dados, não de física. Sem colisão entre aliados.
func _assign_queue_positions(wall: WallRec, attackers: Array) -> void:
    var free := attackers.filter(func(a): return a.slot == -1)
    free.sort_custom(func(a, b): return a.id < b.id)
    for i in free.size():
        # posições estáveis: não vibram, não empurram
        free[i].queue_x = wall.x + sign(free[i].x - wall.x) * (30 + i * 18)

RotSystem — uma entidade, não um spawner

A §05 insiste que A Podridão é um sistema de primeira classe. Tecnicamente isso quer dizer: tem posição contínua, um orçamento de massa, e é a única fonte de criaturas no jogo.

# src/sim/state/rot_state.gd
class_name RotState extends RefCounted
var active: bool = false
var x: float                      # centro da mancha
var width: float
var mass: float                   # orçamento de invocação
var side: int                     # -1 esquerda, +1 direita, 0 = ambos (dia 12+)
var next_summon_at: float
var trail_from: float
var trail_to: float

As quatro interações do jogador

JobSystem e UnitSystem — previsível vence inteligente

Duas camadas, como o §20 define. A de cima corre uma vez por fase e é global; a de baixo é uma máquina de estados de cinco casos por unidade. Nada de behavior trees para tropas comuns.

Camada A — atribuição de trabalho

func assign(s: GameState) -> void:
    var openings := _collect_openings(s)      # postos publicam vagas com prioridade
    openings.sort_custom(func(a, b): return a.priority > b.priority)
    var free := s.units.filter(func(u): return u.job_id == -1 and u.state != UnitFsm.State.DEAD)
    for o in openings:
        var best := -1
        var best_score := -INF
        for i in free.size():
            var u: UnitRec = free[i]
            var score := _fit(u, o) * _proximity(u, o) * o.urgency
            if score > best_score:
                best_score = score; best = i
        if best >= 0:
            free[best].job_id = o.id
            free.remove_at(best)

Camada B — a máquina de estados

Fatiamento: só 1/6 das unidades reavalia por tick (u.id % 6 == s.tick % 6). Uma unidade decide cinco vezes por segundo, o que é impercetível e corta a IA para um sexto do custo. O movimento e o combate continuam a correr todos os ticks — é só a decisão que é fatiada.

O rei inimigo

Utilidade ponderada, cinco ações, uma vez por dia por império. O código está no §20 e não se repete aqui. A parte que interessa aqui é o contrato: KingAISystem lê um KingdomState e devolve um StringName. Não executa a ação — emite king_action_chosen e os sistemas respetivos reagem. É o que permite testá-la sem simular nada.

Faixas, colisão e a matriz que tem de existir no dia 1

A invariante I3. Uma câmara só, três faixas, camadas de física separadas. A matriz abaixo é a configuração exata do projeto.

WorldGen — determinista, e por camadas separadas

Atualização do gerador: a geração contínua existente mantém sementes e alterações persistentes. A sequência natural → fundação → primeira noite territorial → despertar social da §88 é o contrato adotado, ainda por completar em RG-24. A antiga distribuição de fortalezas e mercenários prontos não é o destino final.

O §21 resolve o conflito entre geração e composição com uma regra: o parallax nunca é por segmento. Aqui está a consequência técnica — a geração corre em duas passagens independentes.

func generate(seed: int, biome: BiomeData) -> WorldState:
    var rng := RngService.stream(&"world")
    var w := WorldState.new()
    w.width = _region_width(biome)             # derivado do tempo de travessia, §21
    w.parallax = _make_landscape(rng, biome, w.width)   # passagem 1
    w.segments = _pick_segments(rng, biome, w.width / 640)
    _apply_adjacency_rules(w.segments)          # fortalezas nunca adjacentes, etc.
    _place_core(w)                              # base_inicial ao centro
    _carve_cavities(rng, w)
    _scatter_decoration(rng, w)                 # passagem 3, ignora juntas
    return w

BuildSystem — moeda física, slots pré-definidos

Contrato territorial atual e extensão: RealmGrowth consulta a recusa de território derivada pelo RG-28 antes de autorizar a obra. A §92 define o avaliador comum e a §95 a revalidação por revisão do mundo; elegibilidade futura inclui acessos/direitos, além do alcance atual.

Os slots de construção são autorados na cena do segmento, não calculados. É a decisão do §21: forçar posições arriscadas em vez de deixar amontoar tudo no sítio seguro. O gerador escolhe segmentos; o segmento decide onde se pode construir.

Fundação e expansão atuais: confirmar a fundação válida é gratuito e idempotente; os estágios seguintes são pagos. Bancas nascem só após fundar, dentro do primeiro recinto. Obra disponível depende também de estágio, expansão, apoio e maturidade (Q-221/Q-227/Q-233). Ao reservar solo/subsolo, respeitar §87/§88 e o conflito da Q-237.

DiplomacySystem e DebtSystem

CrownSystem — ganância, impulsos, sucessão

Composição por slots

Seis Sprite2D empilhados por personagem, um AnimationPlayer partilhado. Custo de desenho desprezável em 2D; poupança de trabalho artístico enorme — e é o que torna viável ter seis povos (§22).

A pilha, de trás para a frente

Os deltas de saturação, valor e matiz estão no §22 e não se repetem aqui. Isto é a ordem, os nós e a regra do pixel inteiro.

# src/world/parallax_stack.gd — a invariante I8, num sítio só
func _process(_d: float) -> void:
    var cam := camera.global_position.x
    for l in layers:
        l.node.position.x = floor(cam * (1.0 - l.motion_scale))   # floor, sempre

Catálogo, com uniforms

Dois verbos, e como chegam à simulação

Limite dos exemplos: o encaminhamento antigo de ASSUME não autoriza assumir tropas nem trocar livremente entre imperadores. A ação contextual valida o contrato de herdeiro da §15; ataque, habilidade e corrida têm entradas separadas com paridade de toque (§24).

O mapa completo de comandos está no §24. Aqui só interessa o contrato: a entrada nunca muda estado diretamente.

# scenes/game.tscn → src/ui/input_router.gd
func _unhandled_input(e: InputEvent) -> void:
    if e.is_action_pressed(&"verb_drop"):
        # NÃO mexe no estado. Enfileira uma intenção.
        Sim.queue_intent(Intent.DROP_COIN, {&"x": _player_x(), &"band": _player_band()})
    elif e.is_action_pressed(&"verb_assume"):
        Sim.queue_intent(Intent.ASSUME, {&"target": _nearest_assumable()})

As intenções são consumidas no início do tick seguinte, na ordem em que chegaram. É o que faz o jogo determinista apesar de haver um humano: dada a mesma seed e a mesma sequência de intenções, a partida repete-se exatamente. E é isso que torna possível gravar uma repetição em 40 bytes por segundo.

Esquema, versões e a regra de segurança

Persistência territorial: RG-28 mantém save v12, assinatura v2 para novas fundações e perfis derivados. A §95 define o estado futuro de água/contratos/carga e as regras de migração. Q-248 confirma que limpeza da paisagem e construções persistem; reabrir não restitui árvores nem concede madeira.

Como a simulação é pura, o save é quase trivial: serializa GameState, mais o estado dos fluxos RNG. As regras à volta é que não são negociáveis.

# O que um ficheiro de save contém
{
  save_version: int          # desde a v1, com migrações explícitas
  worldgen_version: int      # §54 — se mudar, o mundo é regenerado ou recusado
  created_utc: int
  play_seconds: int
  seed: int
  rng_states: Dictionary     # §42 — o ESTADO, não a semente
  intents_since_tick: Array  # para repetição, opcional
  state: Dictionary          # GameState serializado, campo a campo
}

Persistência da revisão v7: esta atualização documental não muda o formato dos saves. Futuras alterações têm de versionar e migrar fundação, cobertura/árvores, sociedades, sucessão e propriedade por modo (§88/§89), sem duplicar coroas, recursos, recompensas ou perfis. Um cache de afinidade não substitui o estado persistido que o produz.

Orçamentos, e como se medem

O alvo é 60 fps no Steam Deck com 300 unidades no ecrã. Isso dá 16,6 ms por frame, dos quais a simulação usa metade dos ticks. Os números abaixo são orçamentos, não medições — o teste de desempenho falha quando são ultrapassados.

Três níveis e cinco portões

Sem testes automáticos não consegues rever o que a IA escreve, e vais deixar de tentar ao fim de duas semanas. Com testes, podes aceitar 400 linhas sem as ler linha a linha — porque sabes o que elas têm de fazer.

Os cinco portões de CI

Os testes de design propriamente ditos — dia de asfixia, noite 1 sempre ganha, noite 8 sem torre sempre perdida, arqueiros não param aríetes — estão escritos na §31 e não se repetem aqui. O que a §31 não tinha são os cinco portões acima e o teste que se segue.

# tests/determinism_test.gd — o que apanha o que os outros não apanham
func test_seed_reproduz() -> void:
    var a := SimHarness.run_days(10, 12345)
    var b := SimHarness.run_days(10, 12345)
    assert_str(a.checksum()).is_equal(b.checksum())

Fundação — seis semanas, 42 ficheiros, ≈ 63 h

Contexto histórico: estudos de mercado, previsões, horas, listas de arranque e estados de implementação desta versão descrevem a fase em que foram escritos. A baseline e a ordem de execução atuais estão na §90; decisões posteriores da §86 prevalecem. Exemplos antigos não são ficheiros para copiar sobre o projeto atual.

Revisto na v5.1: esta lista tratava só dos ficheiros de jogo. Os do repositório — que vêm antes — estão na §68, e o conteúdo de cada um na §69; os caminhos marcados §70 foram corrigidos. Critério de saída do §33: um sprite anda nas três faixas e o CI está verde. Nada mais. A tentação é fazer combate na Fase 0; resistir a essa tentação é o que faz a Fase 1 correr bem.