Grandpa's Farm — Technical documentation

Overview

Grandpa's Farm (Fazenda do Vovô / La Granja del Abuelo) is an action incremental inspired by Nodebuster. The story: grandpa left the farm overgrown with weeds, and you clear one field at a time. A circle follows your finger/mouse and automatically hits everything inside it; a click/tap does a strong stomp. Plants drop coins, which must be pulled in before your stamina runs out. Between days, coins become upgrades in the shed.

Data generated automatically from the code on 2026-10-21T08:08:48. To update: godot --headless --path . -- --doc and then python tools/make_docs.py.

Architecture

Godot 4.7 project in D:\dev\fazenda-vovo. Everything is drawn in code (no .tscn scenes besides the main one): each screen is a Node2D with _draw(), and the art comes from static functions in Art.

Screen flow (main.gd)

Overlays: Pause (Status / How to play / Settings in tabs), Grandpa's letter, Share.

Autoloads

Files

Save and settings

JSON file at user://save.json (on Windows: %APPDATA%\Godot\app_userdata\Grandpa's Farm). Main fields:

The Daily leaderboard lives in user://scores.json (best score and attempts per date).

Systems and formulas

Hit

Damage = (1 + 0.25 × Sharp Hoe) × 1.15^Steel × 1.2^Gold × 1.1^Callus × 1.25^{Deep Roots}. Each automatic hit (every 0.5 × 0.9^Rhythm × 0.94^Clock s) strikes the plants within the radius (40 + 7 × Width + 7 × Rake). Damage varies with distance from the center: 1.3× at the center down to 0.8× at the edge. Sure Strike: 4%/level chance of ×3. Stomp: radius ×1.35, damage × (2 + Stomp + Boot), cooldown 0.35 × 0.92^Boot s (click, tap, Space or X; holding repeats). Standing still weakens automatic hits down to 50% after ~2 s (the circle fades and says "Keep moving!"), and whatever it destroys drops +50% coins.

Coins

Plant coins × (1 + 0.15 × Basket) × (1 + 0.12 × Cart) × 1.05^{Rich Soil} × 1.5^field × 1.5^harvest. Coins fall on the ground and the magnet (50 + 18 × Pocket + 12 × Magnet) pulls them when the cursor passes nearby; Helper Crows fetch coins on their own, and ants from anthills carry off coins left on the ground.

Spawn

Plants sprout in "patches": out of 4 random plots, the one with the highest simplex noise value wins. Rate 1.5 × (1 + 0.35 × Rebel Soil)/s, max 30 + 4 × Rebel Soil plants (7x7 grid = 49).

Big field

The board has a fixed size; at special moments the grid grows and plots/plants shrink: 8x8 in half of the infestations from field 3 on (boss ×1.4 health and double seeds), 9x9 on the final boss, on Arcade boss levels (every 10, +4s) and on the Saturday and Sunday Daily challenge (+10s). Starting plants, board max and flood grow in proportion to the plots. The type comes from the biome mix; golden has a 2%/level chance from Golden Mushroom.

Infestation

The boss spawns in the center with health (40 + type health × 6) × difficulty (×2 on the final), and the board gets 14 plants of the same type plus 5/s for 6s. Each plague plant killed takes (50% of the boss's health × killed / spawned), so clearing all = 50%.

Chickens

Only weeds and burrs, 100% of the damage every 0.9s; each one reserves a different target and only switches when it dies. The plant's side is fixed when the target is picked (fixed the chicken that kept going back and forth).

Stamina

10 + 3 × Lunchbox + 2 × Hearty + 2 × Family Stamina (s). Coffee: +0.1 s × level per plant pulled by the player, with a daily cap.

Day loop and controls

1. Weeding day: a 7x7 board of plots. Weeds sprout in patches (procedural noise). The circle hits on its own at the pace of Farm Rhythm, and the center of the circle hits 30% harder than the edge (which hits 20% less), marked by an inner gold ring; the stomp (click/tap) hits with the Stomp multiplier over a 35% larger area, with a short cooldown, and plants destroyed by it drop +50% coins.
2. Coins fall on the ground and are pulled by the magnet (Deep Pockets radius) when the cursor passes nearby. Coins left on the ground when the day ends are lost.
3. Stamina: when it runs out, the day ends. Then the day summary.
4. Shed: buy upgrades, harvest goals and the seed bank. On PC, hovering a node selects it and shows it in the panel (click buys); on mobile, tap to view and tap again to buy. Then, "New day".

Controls

• PC: the circle follows the mouse; click = stomp. Two configurable attack keys (default Space and X; mouse buttons also work) stomp too, and holding repeats the stomp on every cooldown. Esc/P = pause; Space/Enter in the shed = new day.
• Mobile: dragging anywhere moves the circle relatively (like a touchpad), so your finger doesn't cover the area. Quick tap or second finger = stomp. The pause menu shows the info panels (on mobile the interface is compact).

Plants

Base health and coins (field 1, harvest 1). Health is multiplied by the field difficulty; coins by the field bonus and the Basket.

Chickens only peck weeds and burrs, with 100% of the damage, one peck every 0.9s, walking at 95 px/s. Mushrooms, stumps and bosses are always up to the player. Each chicken picks a different plant, so they spread across the board.

Fields and biomes (procedural)

Each field asks for a number of pulled plants to be cleared. Difficulty (plant health) grows from field to field and also within a field (+80% by the end). From the 6th field on, biomes repeat with names, weights and colors drawn from the world seed (endless). The story ends on field 5, against the Mushroom King.

Formulas: goal = 300 × 1.55^field; health = 1.45^field × (1 + 0.8 × progress) × 1.6^harvest; coins = 1.5^field × 1.5^harvest.

Upgrade tree

The shed tree. Each node depends on its parent node (having at least 1 level in it) and some only unlock after clearing fields. Cost of the next level = base cost × growth^level. The second-generation nodes (Steel Hoe, Sure Strike, Big Rake and Calloused Hands) and the third-generation ones (Hearty Lunchbox, Horseshoe Magnet, Steel-Toe Boots, Grandpa's Pocket Watch, Market Cart, Golden Hoe and Rich Soil, endless) unlock from the 2nd to the 4th field, so there is always something to buy. The tree lives in its own area with pan and zoom (drag, mouse wheel, pinch, − + buttons and fit).

Levels, costs and effect of each upgrade

Tiers (border color) and purchase animations

Every purchase makes the node bounce, emits particles and a ring. Each node changes its border color every third of its max level: Bronze (1/3), Silver (2/3) and Gold (max, with a spinning shine). Endless ones go up a tier every 5 levels. When a tier goes up, the animation is bigger: rings in the tier color, shake, a star sound and the notice "Name: Bronze!". A pulsing golden halo shows it can be bought.

Other effects

• Sure Strike: each hit has a chance to deal x3 damage, with "x3!" on screen.
• Grandpa's Coffee: each plant that YOU pull gives back 0.1s × level of stamina, with a daily cap (table above).
• Rebel Soil: also raises the maximum number of plants on the board (30 + 4 × level; the grid has 49 plots).

Harvest goals (Story)

The shed's Goals tab. Every plant pulled in Story mode counts toward the goal for its type. When the goal is reached, a "Claim +X" button appears (the tab shows a red badge with how many are ready). Goals go 20, 40, 80, 100, 150, 200, 300, 400, 500, 750, 1000 and then +500 each, divided by the plant's rarity (mushrooms ×0.5, stump ×0.25, golden ×0.1). Reward = plants required × plant coins × 0.3 × current field bonus (it grows with the game). Progress survives replanting. A plant only shows up in the goals after you pull the first one.

In the table: amount required and, below it, the reward on field 1.

Infestations, bosses and prestige

Infestations (bosses)

At some point in the day the board is taken over by a single plant type for 6s, led by a crowned boss in the middle. The first infestation is guaranteed between day 3 and day 6 (so the player learns it exists). After that, the chance is 30% + 4% per field + 12% per Pest Hunter level (max 85%). Boss health = (40 + type health × 6) × difficulty (× 2 on the final boss). Each plant that came with the infestation takes a chunk of the boss's health when pulled: clearing all of them takes 50%. Defeating it gives coins (25× the plant) and Rare Seeds.

Replant (prestige)

From field 3 on you can replant: resets coins, upgrades and fields, earns Rare Seeds and starts a new harvest, harder (health ×1.6) and richer (coins ×1.5). Seeds earned on harvest 1: field 3: 3, field 4: 5, field 5: 9, field 6: 13, field 7: 17, field 8: 22. When replanting unlocks, grandpa sends a letter explaining it, the Seed bank tab gets a "!" badge and the panel shows separately what you lose (coins, upgrades, fields), keep (seeds, bank, goals, story, Arcade and Daily) and gain. When the story is finished (Mushroom King defeated), the ending screen appears with the options replant or continue.

Seed bank (permanent upgrades)

Arcade mode

Numbered, endless and deterministic levels (the same on any device), on a Candy Crush-style path. Arcade does NOT use the shed upgrades: each level has fixed gear, the same for everyone, so only skill counts and the stars are fair. The player improves slowly (damage +0.12 per level) and weeds toughen faster (health ×1.045 per level). Goals: pull N plants, pull N of one type, collect N coins; every 10 levels, a boss.

Stars for the stamina left when the goal is met: 1 star = goal met, 2 = 20% left, 3 = 45% left. During the level, the mission card (always visible, on mobile too) shows the goal with an icon, a big progress bar, the stars you'd get if you finished now and how many seconds until you lose the next one. The pause screen shows the mission and the level's gear.

Daily challenge

One match per day, the same board for everyone (seed = date). 40s of stamina, infestation guaranteed at 15s, fixed gear (that of Arcade level 20, with more golden luck). Score = coins. Playing on consecutive days builds a streak.

• The mission card shows the date in the language's format, current points, the day's record and the countdown to the infestation.
• Tapping the Daily challenge card opens the challenge screen: what it is, what today's is like (field, boss and when it arrives), your numbers (today's record, all-time best, streak, days played, attempts today), the history of every day played (date, best score, attempts, a crown on the best) with a chart of the last 14 days, and the play button.
• Share: WhatsApp and X via link; "Copy" copies the text and saves the board image.
• Leaderboard: local for now; prepared for Google Play Games (see docs/RANKING.md).

Layout, input and performance

• Screen: base 1280x720, stretch canvas_items + expand. main.gd centers the area via viewport.canvas_transform; Art.full() returns the visible rectangle so backgrounds fill the edges.
• Adaptive HUD: Hud.column_xf() builds each column's transform (pinned to the edge, scale = Interface size limited to the free space). Art.begin_region() also applies the transform to Art.at(); clicks are converted with Hud.to_local().
• Tree: a Control with clip_contents + a Node2D with position/scale (pan/zoom), drawn behind the screen (show_behind_parent). Click only on release without dragging (8 px); wheel, pinch (2 touches), touchpad gestures and buttons.
• Text: Hud.text_block() wraps lines, shrinks the font down to 80% and, if needed, scrolls with a small bar (no lines cut off).
• Touch: on the weeding day dragging moves the circle relatively; quick tap or 2nd finger = stomp. PC: two attack keys (k:keycode or m:button), holding repeats the stomp.
• Performance: pre-rendered plant sprites (2.5x), background and board in static layers (the shake only moves the layer), cap of 140 particles. Infestation on PC: 25 → 58 fps.
• Audio: 13 effects and a 19.2 s song synthesized into AudioStreamWAV (thread), per-bus volumes with sliders.
• Languages: Loc.T with key → [en, pt, es]; the automated test checks every key has all 3. Localized app name (config/name_localized).

Tests, builds and publishing

GODOT="C:/Program Files (x86)/Steam/steamapps/common/Godot Engine/godot.windows.opt.tools.64.exe"
"$GODOT" --headless --path . -- --smoke            # automated test of every system
"$GODOT" --path . -- --shots [--pt|--es] [--resolution 1800x810]   # screenshots of every screen (user://shots/<lang>)
"$GODOT" --headless --path . -- --balance --mult=3.5 --days=34  # economy simulator
"$GODOT" --headless --path . -- --doc              # exports docs/game_data.json
"$GODOT" --path . -- --docimg                      # icons, plants, bosses, biomes and screenshots (3 languages) in docs/img
python tools/make_docs.py                          # builds both docs in EN, PT and 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 compiled from D:\dev\godot-src (4.7.2-stable, custom.py without 3D/physics/Vulkan…), ~23 MB. No deprecated APIs (e.g. Image.create_empty). Icon applied with rcedit.
• Android: arm64, adaptive icons.
• Publishing: scp to [email protected]:/var/www/grandpasfarm = https://grandpasfarm.nxs.dev.br (this PC's SSH key).