La Granja del Abuelo — Documentación técnica

Visión general

La Granja del Abuelo (Grandpa's Farm / Fazenda do Vovô) es un incremental de acción inspirado en Nodebuster. La historia: el abuelo dejó la granja invadida por la maleza, y tú limpias un campo a la vez. Un círculo sigue al dedo/ratón y golpea solo todo lo que esté dentro; el clic/toque da un pisotón fuerte. Las plantas sueltan monedas, que hay que atraer antes de que se acabe el aliento. Entre un día y otro, las monedas se convierten en mejoras en el granero.

Datos generados automáticamente del código el 2026-10-21T08:08:48. Para actualizar: godot --headless --path . -- --doc y luego python tools/make_docs.py.

Arquitectura

Proyecto Godot 4.7 en D:\dev\fazenda-vovo. Todo se dibuja en código (sin escenas .tscn además de la principal): cada pantalla es un Node2D con _draw(), y el arte sale de funciones estáticas en Art.

Flujo de pantallas (main.gd)

Superposiciones: Pausa (Estado / Cómo jugar / Ajustes en pestañas), Carta del abuelo, Compartir.

Autoloads

Archivos

Guardado y ajustes

Archivo JSON en user://save.json (en Windows: %APPDATA%\Godot\app_userdata\Grandpa's Farm). Campos principales:

El marcador del Diario está en user://scores.json (mejor puntuación e intentos por fecha).

Sistemas y fórmulas

Golpe

Daño = (1 + 0,25 × Azada Afilada) × 1,15^Acero × 1,2^Oro × 1,1^Callo × 1,25^{Raíz Fuerte}. Cada golpe automático (cada 0,5 × 0,9^Ritmo × 0,94^Reloj s) alcanza las plantas dentro del radio (40 + 7 × Anchura + 7 × Rastrillo). El daño varía con la distancia al centro: 1,3× en el centro hasta 0,8× en el borde. Golpe Certero: probabilidad 4%/nivel de ×3. Pisotón: radio ×1,35, daño × (2 + Pisotón + Bota), recarga 0,35 × 0,92^Bota s (clic, toque, Espacio o X; mantener repite). Quedarse quieto debilita el golpe automático hasta el 50% tras ~2 s (el círculo se apaga y avisa "¡Muévete!"), y lo que destruye suelta +50% de monedas.

Monedas

Monedas de la planta × (1 + 0,15 × Cesta) × (1 + 0,12 × Carreta) × 1,05^{Tierra Fértil} × 1,5^campo × 1,5^cosecha. Las monedas caen al suelo y el imán (50 + 18 × Bolsillo + 12 × Imán) las atrae cuando el cursor pasa cerca; los Cuervos Ayudantes recogen monedas solos, y las hormigas de los hormigueros se llevan las monedas del suelo.

Aparición

Las plantas brotan en "manchas": de 4 parcelas sorteadas, gana la de mayor valor de ruido simplex. Ritmo 1,5 × (1 + 0,35 × Tierra Rebelde)/s, máximo 30 + 4 × Tierra Rebelde plantas (cuadrícula 7x7 = 49).

Campo grande

El tablero tiene tamaño fijo; en momentos especiales la cuadrícula crece y las parcelas/plantas se encogen: 8x8 en la mitad de las infestaciones del 3.er campo en adelante (jefe ×1,4 de vida y el doble de semillas), 9x9 en el jefe final, en los niveles de jefe del Arcade (cada 10, +4s) y en el Desafío diario del sábado y el domingo (+10s). Las plantas iniciales, el máximo en el tablero y la oleada crecen en proporción a las parcelas. El tipo sale de la mezcla del bioma; el dorado tiene una probabilidad de 2%/nivel de Hongo Dorado.

Infestación

El jefe aparece en el centro con vida (40 + vida del tipo × 6) × dificultad (×2 en el final), y el tablero recibe 14 plantas del mismo tipo más 5/s durante 6s. Cada planta de la plaga muerta quita (50% de la vida del jefe × muertas / nacidas), así que limpiarlas todas = 50%.

Gallinas

Solo malezas y abrojos, 100% del daño cada 0,9s; cada una reserva un objetivo distinto y solo cambia cuando muere. El lado de la planta se fija al elegir el objetivo (arregló la gallina que iba y venía).

Aliento

10 + 3 × Fiambrera + 2 × Abundante + 2 × Aliento de Familia (s). Café: +0,1 s × nivel por planta arrancada por el jugador, con tope diario.

Ciclo del día y controles

1. Día de desmalezado: tablero de 7x7 parcelas. La maleza brota en manchas (ruido procedural). El círculo golpea solo al ritmo de Ritmo de Campo, y el centro del círculo golpea un 30% más fuerte que el borde (que golpea un 20% menos), marcado por un anillo dorado interior; el pisotón (clic/toque) golpea con el multiplicador del Pisotón en un área un 35% mayor, con recarga corta, y las plantas destruidas por él sueltan +50% de monedas.
2. Monedas: caen al suelo y el imán (radio del Bolsillos Hondos) las atrae cuando el cursor pasa cerca. Las monedas que quedan en el suelo al terminar el día se pierden.
3. Aliento: cuando se acaba, el día termina. Después, el resumen del día.
4. Granero: compra de mejoras, metas de cosecha y banco de semillas. En PC, pasar el ratón sobre un nodo ya lo selecciona y lo muestra en el panel (clic compra); en el móvil, toca para ver y toca de nuevo para comprar. Después, "Nuevo día".

Controles

• PC: el círculo sigue al ratón; clic = pisotón. Dos teclas de ataque configurables (por defecto Espacio y X; también acepta botones del ratón) también pisan, y mantenerlas repite el pisotón en cada recarga. Esc/P = pausa; Espacio/Enter en el granero = nuevo día.
• Móvil: arrastrar en cualquier lugar mueve el círculo de forma relativa (como un touchpad), para que el dedo no tape el área. Toque rápido o segundo dedo = pisotón. El menú de pausa muestra los paneles de información (en el móvil la interfaz es compacta).

Plantas

Vida y monedas base (campo 1, cosecha 1). La vida se multiplica por la dificultad del campo; las monedas por el bono del campo y de la Cesta.

Las gallinas solo picotean malezas y abrojos, con el 100% del daño, un picotazo cada 0,9s, caminando a 95 px/s. Hongos, tocones y jefes siempre le tocan al jugador. Cada gallina elige una planta distinta, para que se repartan por el tablero.

Campos y biomas (procedural)

Cada campo pide una cantidad de plantas arrancadas para quedar limpio. La dificultad (vida de las plantas) crece de campo en campo y también dentro del campo (+80% hasta el final). Del 6.º campo en adelante los biomas se repiten con nombre, pesos y colores sorteados por la semilla del mundo (infinito). La historia termina en el campo 5, contra el Rey Hongo.

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

Árbol de mejoras

El árbol del granero. Cada nodo depende de su nodo padre (tener al menos 1 nivel en él) y algunos solo se desbloquean después de limpiar campos. El costo del siguiente nivel = costo base × crecimiento^nivel. Los nodos de segunda generación (Azada de Acero, Golpe Certero, Rastrillo Grande y Manos Curtidas) y los de tercera generación (Fiambrera Abundante, Imán de Herradura, Botas con Puntera de Acero, Reloj del Abuelo, Carreta del Mercado, Azada de Oro y Tierra Fértil, infinita) se desbloquean del 2.º al 4.º campo, para que siempre haya algo que comprar. El árbol tiene su propia área con desplazamiento y zoom (arrastrar, rueda del ratón, pellizco, botones − + y encuadrar).

Niveles, costos y efecto de cada mejora

Tiers (color del borde) y animaciones de compra

Cada compra hace saltar el nodo, suelta partículas y un anillo. Cada nodo cambia el color del borde a cada tercio del nivel máximo: Bronce (1/3), Plata (2/3) y Oro (máximo, con brillo giratorio). Los infinitos suben un tier cada 5 niveles. Al subir de tier, la animación es mayor: anillos del color del tier, temblor, sonido de estrella y el aviso "Nombre: ¡Bronce!". Un halo dorado palpitante indica que se puede comprar.

Otros efectos

• Golpe Certero: cada golpe tiene la probabilidad de causar x3 de daño, con "x3!" en pantalla.
• Café del Abuelo: cada planta que arrancas TÚ devuelve 0,1s × nivel de aliento, con tope diario (tabla de arriba).
• Tierra Rebelde: también aumenta el máximo de plantas en el tablero (30 + 4 × nivel; la cuadrícula tiene 49 parcelas).

Metas de cosecha (Historia)

Pestaña Metas del granero. Cada planta arrancada en el modo Historia cuenta para la meta de su tipo. Al cumplir la meta aparece el botón "Reclamar +X" (la pestaña muestra un sello rojo con cuántas están listas). Las metas siguen 20, 40, 80, 100, 150, 200, 300, 400, 500, 750, 1000 y después +500 cada una, divididas por la rareza de la planta (hongos ×0,5, tocón ×0,25, dorado ×0,1). El premio = plantas pedidas × monedas de la planta × 0,3 × bono del campo actual (crece junto con el juego). El progreso sobrevive a la replantación. Una planta solo aparece en las metas después de arrancar la primera.

En la tabla: cantidad pedida y, debajo, el premio en el campo 1.

Infestaciones, jefes y prestigio

Infestaciones (jefes)

En algún momento del día el tablero es tomado por un solo tipo de planta durante 6s, comandado por un jefe con corona en el centro. La primera infestación está garantizada entre el 3.er y el 6.º día (para que el jugador sepa que existe). Después, la probabilidad es 30% + 4% por campo + 12% por nivel de Olfato de Plaga (máx. 85%). Vida del jefe = (40 + vida del tipo × 6) × dificultad (× 2 en el jefe final). Cada planta que llegó con la infestación le quita un pedazo de vida al jefe al ser arrancada: limpiarlas todas quita el 50%. Derrotarlo da monedas (25× la planta) y Semillas Raras.

Replantar (prestigio)

A partir del campo 3 se puede replantar: reinicia monedas, mejoras y campos, gana Semillas Raras y empieza una nueva cosecha, más difícil (vida ×1,6) y más rica (monedas ×1,5). Semillas ganadas en la cosecha 1: campo 3: 3, campo 4: 5, campo 5: 9, campo 6: 13, campo 7: 17, campo 8: 22. Cuando se desbloquea la replantación, el abuelo manda una carta explicándola, la pestaña Banco de semillas recibe un sello "!" y el panel muestra por separado lo que pierdes (monedas, mejoras, campos), conservas (semillas, banco, metas, historia, Arcade y Diario) y ganas. Al terminar la historia (Rey Hongo derrotado), aparece la pantalla final con las opciones replantar o continuar.

Banco de semillas (mejoras permanentes)

Modo Arcade

Niveles numerados, infinitos y deterministas (iguales en cualquier dispositivo), en un camino estilo Candy Crush. El Arcade NO usa las mejoras del granero: cada nivel tiene un equipo fijo, el mismo para todos, así que solo cuenta la habilidad y las estrellas son justas. El jugador mejora despacio (daño +0,12 por nivel) y la maleza se endurece más rápido (vida ×1,045 por nivel). Metas: arrancar N plantas, arrancar N de un tipo, juntar N monedas; cada 10 niveles, un jefe.

Estrellas según el aliento que sobre al cumplir la meta: 1 estrella = meta cumplida, 2 = sobró el 20%, 3 = sobró el 45%. Durante el nivel, la tarjeta de misión (siempre visible, también en el móvil) muestra la meta con icono, una barra grande de progreso, las estrellas que te llevas si la cumples ahora y en cuántos segundos pierdes la siguiente. La pausa muestra la misión y el equipo del nivel.

Desafío diario

Una partida por día, el mismo tablero para todos (semilla = fecha). 40s de aliento, infestación garantizada a los 15s, equipo fijo (el del nivel 20 del Arcade, con más suerte de dorado). Puntuación = monedas. Jugar en días seguidos aumenta la racha.

• La tarjeta de misión muestra la fecha en el formato del idioma, los puntos actuales, el récord del día y la cuenta atrás para la infestación.
• Tocar la tarjeta del Desafío diario abre la pantalla del desafío: qué es, cómo es el de hoy (campo, jefe y cuándo llega), tus números (récord de hoy, mejor de todos, racha, días jugados, intentos hoy), el historial de todos los días jugados (fecha, mejor puntuación, intentos, corona en el mejor) con gráfico de los últimos 14 días, y el botón de jugar.
• Compartir: WhatsApp y X por enlace; "Copiar" copia el texto y guarda la imagen del tablero.
• Clasificación: por ahora local; preparada para Google Play Games (ver docs/RANKING.md).

Diseño, entrada y rendimiento

• Pantalla: base 1280x720, stretch canvas_items + expand. main.gd centra el área mediante viewport.canvas_transform; Art.full() devuelve el rectángulo visible para que los fondos rellenen los bordes.
• HUD adaptable: Hud.column_xf() crea la transformación de cada columna (fijada al borde, escala = Tamaño de la interfaz limitada al espacio libre). Art.begin_region() aplica la transformación también a Art.at(); los clics se convierten con Hud.to_local().
• Árbol: Control con clip_contents + Node2D con posición/escala (desplazamiento/zoom), dibujado detrás de la pantalla (show_behind_parent). Clic solo al soltar sin arrastrar (8 px); rueda, pellizco (2 toques), gestos de touchpad y botones.
• Texto: Hud.text_block() parte las líneas, reduce la fuente hasta el 80% y, si hace falta, se desplaza con una barrita (sin cortar líneas).
• Toque: en el día de desmalezado el arrastre mueve el círculo de forma relativa; toque rápido o 2.º dedo = pisotón. PC: dos teclas de ataque (k:keycode o m:botón), mantener repite el pisotón.
• Rendimiento: sprites de las plantas prerrenderizados (2,5x), fondo y tablero en capas estáticas (el temblor solo mueve la capa), tope de 140 partículas. Infestación en PC: 25 → 58 fps.
• Audio: 13 efectos y una música de 19,2 s sintetizados en AudioStreamWAV (hilo), volúmenes por bus con sliders.
• Idiomas: Loc.T con clave → [en, pt, es]; la prueba automática comprueba que toda clave tenga los 3. Nombre de la app localizado (config/name_localized).

Pruebas, builds y publicación

GODOT="C:/Program Files (x86)/Steam/steamapps/common/Godot Engine/godot.windows.opt.tools.64.exe"
"$GODOT" --headless --path . -- --smoke            # prueba automática de todos los sistemas
"$GODOT" --path . -- --shots [--pt|--es] [--resolution 1800x810]   # capturas de todas las pantallas (user://shots/<idioma>)
"$GODOT" --headless --path . -- --balance --mult=3.5 --days=34  # simulador de la economía
"$GODOT" --headless --path . -- --doc              # exporta docs/game_data.json
"$GODOT" --path . -- --docimg                      # iconos, plantas, jefes, biomas y capturas (3 idiomas) en docs/img
python tools/make_docs.py                          # genera las dos documentaciones en EN, PT y 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: plantilla compilada desde D:\dev\godot-src (4.7.2-stable, custom.py sin 3D/física/Vulkan…), ~23 MB. Sin APIs obsoletas (p. ej. Image.create_empty). Icono aplicado con rcedit.
• Android: arm64, iconos adaptativos.
• Publicación: scp a [email protected]:/var/www/grandpasfarm = https://grandpasfarm.nxs.dev.br (clave SSH de este PC).