Fazenda do Vovô — Documentação técnica

Visão geral

Fazenda do Vovô (Grandpa's Farm / La Granja del Abuelo) é um incremental de ação inspirado em Nodebuster. A história: o vovô deixou a fazenda tomada pelo mato, e você limpa um campo de cada vez. Um círculo segue o dedo/mouse e golpeia sozinho tudo o que estiver dentro dele; o clique/toque dá uma pisada forte. As plantas soltam moedas, que precisam ser puxadas antes do fôlego acabar. Entre um dia e outro, as moedas viram melhorias no galpão.

Dados gerados automaticamente do código em 2026-10-21T08:08:48. Para atualizar: godot --headless --path . -- --doc e depois python tools/make_docs.py.

Arquitetura

Projeto Godot 4.7 em D:\dev\fazenda-vovo. Tudo é desenhado em código (sem cenas .tscn além da principal): cada tela é um Node2D com _draw(), e a arte vem de funções estáticas em Art.

Fluxo de telas (main.gd)

Sobreposições: Pausa (Status / Como jogar / Configurações em abas), Carta do vovô, Compartilhar.

Autoloads

Arquivos

Save e configurações

Arquivo JSON em user://save.json (no Windows: %APPDATA%\Godot\app_userdata\Grandpa's Farm). Campos principais:

O placar do Diário fica em user://scores.json (melhor pontuação e tentativas por data).

Sistemas e fórmulas

Golpe

Dano = (1 + 0,25 × Enxada Afiada) × 1,15^Aço × 1,2^Ouro × 1,1^Calo × 1,25^{Raiz Forte}. Cada golpe automático (a cada 0,5 × 0,9^Ritmo × 0,94^Relógio s) atinge as plantas dentro do raio (40 + 7 × Largura + 7 × Ancinho). O dano varia com a distância ao centro: 1,3× no centro até 0,8× na borda. Golpe Certeiro: chance 4%/nível de ×3. Pisada: raio ×1,35, dano × (2 + Pisada + Botina), recarga 0,35 × 0,92^Botina s (clique, toque, Espaço ou X; segurar repete). Ficar parado enfraquece o golpe automático até 50% depois de ~2 s (o círculo apaga e avisa "Mexa-se!"), e o que ela destrói solta +50% de moedas.

Moedas

Moedas da planta × (1 + 0,15 × Cesta) × (1 + 0,12 × Carroça) × 1,05^{Terra Fértil} × 1,5^campo × 1,5^safra. As moedas caem no chão e o ímã (50 + 18 × Bolso + 12 × Ímã) puxa quando o cursor passa perto; os Corvos Ajudantes buscam moedas sozinhos, e as formigas dos formigueiros carregam as moedas que ficam no chão.

Spawn

Plantas nascem em "manchas": de 4 canteiros sorteados, vence o de maior valor de ruído simplex. Taxa 1,5 × (1 + 0,35 × Adubo)/s, máximo 30 + 4 × Adubo plantas (grade 7x7 = 49).

Campo grande

O tabuleiro tem tamanho fixo; em momentos especiais a grade cresce e os canteiros/plantas encolhem: 8x8 em metade das infestações do 3º campo em diante (chefe ×1,4 de vida e o dobro de sementes), 9x9 no chefe final, nas fases de chefe do Arcade (a cada 10, +4s) e no Desafio diário de sábado e domingo (+10s). Plantas iniciais, máximo no tabuleiro e enxurrada crescem na proporção de canteiros. O tipo sai da mistura do bioma; dourado tem chance 2%/nível de Dourado.

Infestação

O chefe nasce no centro com vida (40 + vida do tipo × 6) × dificuldade (×2 no final), e o tabuleiro recebe 14 plantas do mesmo tipo mais 5/s por 6s. Cada planta da praga morta tira (50% da vida do chefe × mortas / nascidas), então limpar todas = 50%.

Galinhas

Só ervas e carrapichos, 100% do dano a cada 0,9s; cada uma reserva um alvo diferente e só troca quando ele morre. O lado da planta é fixado ao escolher o alvo (corrigiu a galinha que ficava indo e voltando).

Fôlego

10 + 3 × Marmita + 2 × Caprichada + 2 × Fôlego de Família (s). Café: +0,1 s × nível por planta arrancada pelo jogador, com teto diário.

Loop do dia e controles

1. Dia de capina: tabuleiro 7x7 de canteiros. O mato nasce em manchas (ruído procedural). O círculo golpeia sozinho no ritmo do Ritmo de Roça, e o centro do círculo bate 30% mais forte que a borda (que bate 20% menos), marcado por um anel dourado interno; a pisada (clique/toque) bate com o multiplicador da Pisada numa área 35% maior, com recarga curta, e as plantas destruídas por ela soltam +50% de moedas.
2. Moedas caem no chão e são puxadas pelo ímã (raio do Bolso Fundo) quando o cursor passa perto. Moeda que fica no chão quando o dia acaba é perdida.
3. Fôlego: quando acaba, o dia termina. Depois, o resumo do dia.
4. Galpão: compra de melhorias, metas de colheita e banco de sementes. No PC, passar o mouse sobre um nó já o seleciona e mostra no painel (clique compra); no celular, toque para ver e toque de novo para comprar. Depois, "Novo dia".

Controles

• PC: o círculo segue o mouse; clique = pisada. Duas teclas de ataque configuráveis (padrão Espaço e X; aceita também botões do mouse) também pisam, e segurar repete a pisada a cada recarga. Esc/P = pausa; Espaço/Enter no galpão = novo dia.
• Celular: arrastar em qualquer lugar move o círculo de forma relativa (como um touchpad), para o dedo não cobrir a área. Toque rápido ou segundo dedo = pisada. O menu de pausa mostra os painéis de informação (no celular a interface é compacta).

Plantas

Vida e moedas na base (campo 1, safra 1). A vida é multiplicada pela dificuldade do campo; as moedas pelo bônus do campo e da Cesta.

As galinhas só bicam ervas e carrapichos, com 100% do dano, uma bicada a cada 0,9s, andando a 95 px/s. Cogumelos, tocos e chefes são sempre com o jogador. Cada galinha escolhe uma planta diferente, para elas se espalharem pelo tabuleiro.

Campos e biomas (procedural)

Cada campo pede um número de plantas arrancadas para ser limpo. A dificuldade (vida das plantas) cresce de campo para campo e também dentro do campo (+80% até o fim). Do 6º campo em diante os biomas se repetem com nome, pesos e cores sorteados pela semente do mundo (infinito). A história termina no 5º campo, contra o Cogumelo Rei.

Fórmulas: meta = 300 × 1,55^campo; vida = 1,45^campo × (1 + 0,8 × progresso) × 1,6^safra; moedas = 1,5^campo × 1,5^safra.

Árvore de melhorias

A árvore do galpão. Cada nó depende do nó pai (ter pelo menos 1 nível nele) e alguns só liberam depois de limpar campos. O custo do próximo nível = custo base × crescimento^nível. Os nós de segunda geração (Enxada de Aço, Golpe Certeiro, Ancinho Largo e Calo) e os de terceira geração (Marmita Caprichada, Ímã de Ferradura, Botina de Bico de Aço, Relógio do Vovô, Carroça da Feira, Enxada de Ouro e Terra Fértil, infinita) liberam do 2º ao 4º campo, para sempre haver o que comprar. A árvore fica numa área própria com pan e zoom (arrastar, roda do mouse, pinça, botões − + e enquadrar).

Níveis, custos e efeito de cada melhoria

Tiers (cor da borda) e animações de compra

Toda compra faz o nó pular, solta partículas e um anel. Cada nó troca a cor da borda a cada terço do nível máximo: Bronze (1/3), Prata (2/3) e Ouro (máximo, com brilho girando). Os infinitos sobem um tier a cada 5 níveis. Ao subir de tier, a animação é maior: anéis na cor do tier, tremor, som de estrela e o aviso "Nome: Bronze!". Um halo dourado pulsando indica que dá para comprar.

Outros efeitos

• Golpe Certeiro: cada golpe tem a chance de causar x3 de dano, com "x3!" na tela.
• Café do Vovô: cada planta que VOCÊ arranca devolve 0,1s × nível de fôlego, com teto diário (tabela acima).
• Adubo: também aumenta o máximo de plantas no tabuleiro (30 + 4 × nível, a grade tem 49 canteiros).

Metas de colheita (História)

Aba Metas do galpão. Cada planta arrancada no modo História conta para a meta daquele tipo. Ao bater a meta, aparece o botão "Resgatar +X" (a aba mostra um selo vermelho com quantas estão prontas). As metas seguem 20, 40, 80, 100, 150, 200, 300, 400, 500, 750, 1000 e depois +500 cada, divididas pela raridade da planta (cogumelos ×0,5, toco ×0,25, dourado ×0,1). O prêmio = plantas pedidas na meta × moedas da planta × 0,3 × bônus do campo atual (cresce junto com o jogo). O progresso sobrevive ao replantio. Uma planta só aparece nas metas depois que você arranca a primeira.

Na tabela: quantidade pedida e, embaixo, o prêmio no campo 1.

Infestações, chefes e prestígio

Infestações (chefes)

Em algum momento do dia o tabuleiro é tomado por um tipo só de planta durante 6s, comandado por um chefe de coroa no centro. A primeira infestação é garantida entre o 3º e o 6º dia (para o jogador saber que existe). Depois, a chance é 30% + 4% por campo + 12% por nível de Faro (máx. 85%). Vida do chefe = (40 + vida do tipo × 6) × dificuldade (× 2 no chefe final). Cada planta que veio com a infestação tira um pedaço da vida do chefe quando é arrancada: limpar todas tira 50%. Derrotar dá moedas (25× a planta) e Sementes Raras.

Replantar (prestígio)

A partir do 3º campo dá para replantar: zera moedas, melhorias e campos, ganha Sementes Raras e começa uma nova safra, mais difícil (vida ×1,6) e mais rica (moedas ×1,5). Sementes ganhas na safra 1: campo 3: 3, campo 4: 5, campo 5: 9, campo 6: 13, campo 7: 17, campo 8: 22. Quando o replantio libera, o vovô manda uma carta explicando, a aba Banco de sementes ganha um selo "!" e o painel mostra separado o que você perde (moedas, melhorias, campos), mantém (sementes, banco, metas, história, Arcade e Diário) e ganha. Ao terminar a história (Cogumelo Rei derrotado), aparece a tela de fim com as opções replantar ou continuar.

Banco de sementes (melhorias permanentes)

Modo Arcade

Fases numeradas, infinitas e determinísticas (iguais em qualquer aparelho), num caminho estilo Candy Crush. O Arcade NÃO usa as melhorias do galpão: cada fase tem um equipamento fixo, o mesmo para todo mundo, então só a habilidade conta e as estrelas são justas. O jogador melhora devagar (dano +0,12 por fase) e o mato endurece mais rápido (vida ×1,045 por fase). Metas: arrancar N plantas, arrancar N de um tipo, juntar N moedas; a cada 10 fases, um chefe.

Estrelas pelo fôlego que sobrar ao cumprir a meta: 1 estrela = meta cumprida, 2 = sobrou 20%, 3 = sobrou 45%. Durante a fase, o cartão da missão (sempre visível, também no celular) mostra a meta com ícone, uma barra grande de progresso, as estrelas que você leva se cumprir agora e em quantos segundos perde a próxima. A pausa mostra a missão e o equipamento da fase.

Desafio diário

Uma partida por dia, o mesmo tabuleiro para todo mundo (semente = data). 40s de fôlego, infestação garantida aos 15s, equipamento fixo (o da fase 20 do Arcade, com mais sorte de dourado). Pontuação = moedas. Jogar em dias seguidos aumenta a sequência.

• O cartão da missão mostra a data no formato do idioma, os pontos atuais, o recorde do dia e a contagem para a infestação.
• Tocar no cartão do Desafio diário abre a tela do desafio: o que é, como é o de hoje (campo, chefe e quando ele chega), seus números (recorde de hoje, melhor de todos, sequência, dias jogados, tentativas hoje), o histórico de todos os dias jogados (data, melhor pontuação, tentativas, coroa no melhor) com gráfico dos últimos 14 dias, e o botão de jogar.
• Compartilhar: WhatsApp e X por link; "Copiar" copia o texto e salva a imagem do tabuleiro.
• Ranking: hoje local; preparado para Google Play Games (ver docs/RANKING.md).

Layout, entrada e desempenho

• Tela: base 1280x720, stretch canvas_items + expand. main.gd centraliza a área via viewport.canvas_transform; Art.full() devolve o retângulo visível para os fundos preencherem as bordas.
• HUD adaptável: Hud.column_xf() cria a transformação de cada coluna (presa à borda, escala = Tamanho da interface limitada ao espaço livre). Art.begin_region() aplica a transformação também ao Art.at(); cliques são convertidos com Hud.to_local().
• Árvore: Control com clip_contents + Node2D com posição/escala (pan/zoom), desenhado atrás da tela (show_behind_parent). Clique só ao soltar sem arrastar (8 px); roda, pinça (2 toques), gestos de touchpad e botões.
• Texto: Hud.text_block() quebra linhas, reduz a fonte até 80% e, se preciso, rola com barrinha (sem cortar linhas).
• Toque: no dia de capina o arrasto move o círculo de forma relativa; toque rápido ou 2º dedo = pisada. PC: duas teclas de ataque (k:keycode ou m:botão), segurar repete a pisada.
• Desempenho: sprites das plantas pré-renderizados (2,5x), fundo e tabuleiro em camadas estáticas (o tremor só move a camada), teto de 140 partículas. Infestação no PC: 25 → 58 fps.
• Áudio: 13 efeitos e uma música de 19,2 s sintetizados em AudioStreamWAV (thread), volumes por bus com sliders.
• Idiomas: Loc.T com chave → [en, pt, es]; o teste automático confere que toda chave tem os 3. Nome do app localizado (config/name_localized).

Testes, builds e publicação

GODOT="C:/Program Files (x86)/Steam/steamapps/common/Godot Engine/godot.windows.opt.tools.64.exe"
"$GODOT" --headless --path . -- --smoke            # teste automático de todos os sistemas
"$GODOT" --path . -- --shots [--pt|--es] [--resolution 1800x810]   # prints de todas as telas (user://shots/<idioma>)
"$GODOT" --headless --path . -- --balance --mult=3.5 --days=34  # simulador da economia
"$GODOT" --headless --path . -- --doc              # exporta docs/game_data.json
"$GODOT" --path . -- --docimg                      # ícones, plantas, chefes, biomas e prints (3 idiomas) em docs/img
python tools/make_docs.py                          # gera as duas documentações em EN, PT e ES
"$GODOT" --headless --path . --export-debug "Android" build/android/GrandpasFarm-debug.apk
"$GODOT" --headless --path . --export-release "Windows Slim" build/windows-slim/FazendaDoVovo.exe

• Windows Slim: template compilado de D:\dev\godot-src (4.7.2-stable, custom.py sem 3D/física/Vulkan…), ~23 MB. Sem APIs depreciadas (ex.: Image.create_empty). Ícone aplicado pelo rcedit.
• Android: arm64, ícones adaptativos.
• Publicação: scp para [email protected]:/var/www/grandpasfarm = https://grandpasfarm.nxs.dev.br (chave SSH deste PC).