spawnpoint-studio 0.3.3__tar.gz → 0.3.4__tar.gz

{spawnpoint_studio-0.3.3/compiler/spawnpoint_studio.egg-info → spawnpoint_studio-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawnpoint-studio
-Version: 0.3.3
+Version: 0.3.4
 Summary: Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU.
 Author: smoky1496
 License: MIT
@@ -31,23 +31,22 @@ Dynamic: license-file
 [![Model](https://img.shields.io/badge/%F0%9F%A4%97%20model-SpawnPoint--Coder--7B-yellow)](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ)
 [![Play the demos](https://img.shields.io/badge/%E2%96%B6%20play-demos%20in%20your%20browser-ff004d)](https://leluong141996-dev.github.io/Spawn-Point/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/leluong141996-dev/Spawn-Point?style=social)](https://github.com/leluong141996-dev/Spawn-Point/stargazers)
+
+⭐ **If Spawn Point drew something fun or useful, a star helps other people find it. If it drew something wrong, [open an issue](https://github.com/leluong141996-dev/Spawn-Point/issues/new) with your prompt: the model's tests grow from prompts that broke.**
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/knight-quest.gif" width="48%" alt="Knight's Quest: a sword platformer">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/castle-defense.gif" width="48%" alt="Castle Defense: a tower defense game">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/ninja-rescue.gif" width="48%" alt="Ninja Rescue: a platformer where a ninja frees his mother">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/dino-eggs.gif" width="48%" alt="Dino Eggs: a bubble shooter with dinosaur eggs">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/night-survivor.gif" width="48%" alt="Night Survivor: auto-fire, gems, level-ups">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper: a Mario-style platformer">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/star-run.gif" width="48%" alt="Star Run: a side-scrolling shooter with power-ups and a boss">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-field.gif" width="48%" alt="Tilling, planting, watering and harvesting in the fenced field">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-animals.gif" width="48%" alt="Collecting eggs and milk from the chickens and the cow in the pen">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-fishing.gif" width="48%" alt="Fishing from the pond's shore: cast, wait for the bite, reel in">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-house.gif" width="48%" alt="Walking into the farmhouse: bed, fireplace, table and rug">
 </p>
-<p align="center"><sub>Seven of the demo games, each one a small JSON graph in <code>examples/</code> built from the
-same component library: generated pixel art, collision traced from the sprites, juice on by default.
-Recorded with <code>spawnpoint gif</code> (autopilot).</sub></p>
+<p align="center"><sub>A cozy farm made from one sentence: the field, the animals, fishing and the farmhouse inside.
+Every tile, building, animal and crop is drawn by plain Python. Recorded with <code>spawnpoint gif --focus field|animals|fish|house</code> (autopilot).</sub></p>
 
 <p align="center"><b><a href="https://leluong141996-dev.github.io/Spawn-Point/">▶ Play the demos in your browser</a></b>: a Mario-style platformer, a
-knight with a sword, tower defense, a ninja rescue, a dinosaur-egg bubble shooter, a survivor with level-ups, a farming
-game, an arena shooter and a side-scrolling space shooter. No install needed, and
+knight with a sword, tower defense, a ninja rescue, a dinosaur-egg bubble shooter, a survivor with level-ups, a cozy
+island farm, an arena shooter and a side-scrolling space shooter. No install needed, and
 they work on phones too (touch controls).</p>
 
 Spawn Point is an open-source, autonomous game studio that runs on your own machine. Instead of asking an LLM to type
@@ -156,7 +155,7 @@ Only what you asked for changes, and the level layout is kept. Prompts can be in
 **The model.** [SpawnPoint-Coder-7B](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ) is a 7B model
 fine-tuned to generate Godot 4 games through this pipeline: it writes the game design, tweaks and entity
 edits as strict JSON, and the compiler turns that into Godot scenes and GDScript. It runs on a single 12 GB
-GPU (AWQ 4-bit). v5 added **side-scrolling shooters** (flight patterns, power-ups, a boss), **Vietnamese prompts read directly** and a small per-genre format instead of one big form; v5.1 fixes prompts that name the hero only indirectly ("a tank shooting monsters"). The downloadable AWQ build gets 88% of a sealed set of 16 human-written prompts for shooters and the v4 fixes fully right, and 80% of 30 human-written game ideas in English and Vietnamese (v4: 87% on those 30; the model card lists every number and where v5.1 is behind). The GGUF Q4_K_M build scores 83% on those 30. Older models still work with `SPAWNPOINT_BRIEF_FORMAT=v4`. It is tuned for the 2D game kinds Spawn Point builds; other genres are no better than a general 7B coder. `spawnpoint llm up` downloads and serves it: the AWQ build on vLLM when
+GPU (AWQ 4-bit). v5 added **side-scrolling shooters** (flight patterns, power-ups, a boss), **Vietnamese prompts read directly** and a small per-genre format instead of one big form; v5.1 fixes prompts that name the hero only indirectly ("a tank shooting monsters"); v5.2 catches farm pests mentioned only in passing ("có cáo", "with a fox around") and leaves peaceful farms without any. The downloadable AWQ build gets 94% of a sealed set of 16 human-written prompts for shooters and the v4 fixes fully right, 100% of a sealed set of 16 farm prompts with pests named in passing, and 83% of 30 human-written game ideas in English and Vietnamese (v4: 87% on those 30; the model card lists every number and where v5.2 is behind). The GGUF Q4_K_M build scores 87% on those 30. Older models still work with `SPAWNPOINT_BRIEF_FORMAT=v4`. It is tuned for the 2D game kinds Spawn Point builds; other genres are no better than a general 7B coder. `spawnpoint llm up` downloads and serves it: the AWQ build on vLLM when
 Docker and an NVIDIA GPU are present, otherwise the [GGUF build](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-GGUF)
 (Q4_K_M, ~4.7 GB) in Ollama. Force one with `--backend vllm|ollama`.
 
@@ -167,12 +166,51 @@ Web builds need the Godot **web export templates** (Editor → Manage Export Tem
 `web_*.zip` from the official `.tpz` into `~/.local/share/godot/export_templates/<version>/`);
 use `--no-web` to skip and play natively with `spawnpoint run`.
 
+## A cozy farm from one sentence
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-overview.png" width="92%" alt="A generated island farm: farmhouse, fenced crop field, animal pen with a coop, pond and woods"><br><sub>One generated farm, the whole map: everything here is drawn by plain Python, no image files.</sub></p>
+
+Ask for a farming game (`spawnpoint create "a cozy farming game with strawberries and pumpkins"`) and
+Spawn Point lays out a whole farm: a farmhouse with a dirt path to its door, a fenced crop field, an animal pen with a
+coop, a pond, a shipping bin, and woods around the edge, on an island (water all round, cliffs to the south; an
+ocean-themed farm always is one) or in a meadow in the woods. The art is a 16-pixel tile set drawn from code: grass with tufts, flowers and mushrooms, paths with soft edges,
+water with lily pads and reeds, buildings, fences, four kinds of tree, chickens and cows, a farmer who walks in four
+directions, and crops with five growth stages (strawberries, carrots, potatoes, pumpkins, corn, wheat, cabbages...,
+picked from the crop's name).
+
+A farm is a season of a few days, each running from 6:00 to 22:00 with the light turning gold in the evening and dark
+at night; sleep in the farmhouse bed (or drop off in the fields at midnight) and watered crops grow overnight. Earn the
+target before the season ends. What you do there: buy seeds (they cost money), till the grass with the hoe, plant,
+water and harvest; feed the hens and the cow, then collect eggs and milk (chicks grow into hens); fish from the pond's
+shore (cast, wait for the bite, reel in on the "!"); chop trees and break rocks for wood and stone; carry it all to the
+shipping bin, while crows, foxes, rabbits or mice go for your crops. Step through the farmhouse door for a cozy room
+inside (bed, fireplace, table, rug). Maps vary: the house on either side, the field and the pen swapping places, the
+pond moving around. The workbench by the house sells tool upgrades (a watering can and a hoe that work a
+3x3 patch, a bigger basket, a sharper axe, a better rod), and the farm saves itself: close the game and it carries on
+where you left it (a won or lost season, or R, starts a fresh one). On a phone, ACT does all of it and a tap on a seed in
+the bar picks it. The
+hotbar shows your seeds and basket. You walk behind trees and the house (the scene is depth-sorted), and only an
+object's footprint blocks you. `spawnpoint overview <project>` saves a picture of the whole map after a short autopilot
+run, like the one above.
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/sunny-farm.gif" width="52%" alt="Sunny Farm: the farmer harvests, sells at the shipping bin and works the field"> <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-night.gif" width="40%" alt="Evening turns to night on the farm; the farmer milks the cow before bed"></p>
+
+The theme sets the season, and the model picks it from the prompt ("a winter farm", "nông trại trên sa mạc"): a snowy
+farm is winter (snow, a frozen pond, snowy pines and bare trees, and crops grow slower), a desert farm has sand, palms
+and cacti (and the soil dries faster), an autumn farm is orange with maples, the rest is spring.
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-seasons.png" width="92%" alt="The same kind of farm in spring, autumn, winter and the desert"></p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-winter.gif" width="32%" alt="A winter farm: snow, snowy pines, bare trees">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-autumn.gif" width="32%" alt="An autumn farm: orange ground, maples">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-desert.gif" width="32%" alt="A desert farm: sand, palms and cacti">
+</p>
+
 ## Sprites: generated or your own
 
 Layer 2 replaces placeholder shapes with **procedural pixel art** — no assets, no GPU: chibi people with big heads, monsters with faces (a biting plant, a mushroom, a snail, a flame spirit, a reaper, an alien, a dragon, a ghost...), items, props, themed tiles and a parallax sky. Spawn Point makes pixel art games only. (A graph can still ask for the smooth `"art_style": "cartoon"` look by hand, but games made from a prompt are always pixel art.)
 
-<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/parade-heroes.gif" width="48%" alt="Animated heroes: knight, wizard, ranger, viking, king, princess, ninja..."> <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/parade-monsters.gif" width="48%" alt="Animated monsters: slime, frog, biting plant, mushroom, snail, flame..."></p>
-<p align="center"><sub>Every character and monster is drawn by plain Python from its name (<code>spawnpoint sprites parade --set heroes|monsters|items</code>).</sub></p>
+Every character and monster is drawn by plain Python from its name; `spawnpoint sprites parade --set heroes|monsters|items` renders them as an animated sheet.
 
 The
 kind follows the entity (`Goblin` → humanoid, `FireBat` → flyer, `LaserBot` → robot, `Crystal` → gem…)
@@ -217,7 +255,7 @@ match the palette, drawn behind everything and without collision.
 Record a clip of any built game to share it (a window opens for a few seconds; autopilot plays):
 
 ```bash
-spawnpoint gif out/pixel-hopper -o demo.gif --seconds 8 --fps 20 --width 640
+spawnpoint gif out/sunny-farm -o demo.gif --seconds 10 --fps 10 --focus fish
 ```
 
 **AI art (optional plug-in).** Point Spawn Point at an image model and layer 2 asks it for the look of
@@ -369,7 +407,7 @@ headless smoke test (spawn, scripted input, crash detection) and report `E_RUNTI
 | Game modes | `BubbleBoard` (a complete bubble shooter: bank shots, colour pops, falling clusters, a descending ceiling) |
 | Shooters | `FlightPath` (straight, wave, dive and hover patterns across the screen), `ShmupShip` (auto-fire, power-ups that add shots and spread), `HealthBar` (boss bars), and `WaveSpawner` gates (`autostart`, `endless`, random spread) |
 | Tower defense | `PathFollower` (walks the road to the base), `Base` (loses a life per invader that gets in), `WaveSpawner` ("8 x Goblin every 1.2; ..."), `TowerSlot`, `TowerBuilder` (click a pad, pay in gold), `TowerBrain` (targets the invader furthest along), `GroundPatch` (roads and paths) |
-| Farming | `FarmPlot` (soil that grows a crop only while watered), `Farmer` (plant / water / harvest, a basket, crop choice), `Market` (sell the basket), `CropPest` (crows that eat crops) |
+| Farming | `FarmPlot` (soil that grows a crop only while watered, drawn from its growth stages), `Farmer` (till / plant / water / harvest, buy seeds, feed, collect, fish, chop, sleep, a basket and a tappable hotbar), `FarmAnimal` (wanders, needs feeding, gives eggs or milk, chicks grow up), `FarmDays` (a season of days with day and night), `SleepSpot` (a bed), `ToolBench` (tool upgrades), `FarmSave` (keeps the farm between plays), `Gatherable` (trees and rocks that break into wood and stone), `FishingSpot` (cast, bite, reel in), `Warp` (doorways, e.g. into the farmhouse), `Market` (a stall or a shipping bin that buys the basket), `CropPest` (crows that eat crops) |
 | Feel | `Juice` — attached to every entity unless `"juice": "none"` |
 
 Runtime autoloads: `GameState` (score, lives, variables, win/lose), `World` (spawning, rule

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/README.md

@@ -7,23 +7,22 @@
 [![Model](https://img.shields.io/badge/%F0%9F%A4%97%20model-SpawnPoint--Coder--7B-yellow)](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ)
 [![Play the demos](https://img.shields.io/badge/%E2%96%B6%20play-demos%20in%20your%20browser-ff004d)](https://leluong141996-dev.github.io/Spawn-Point/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/leluong141996-dev/Spawn-Point?style=social)](https://github.com/leluong141996-dev/Spawn-Point/stargazers)
+
+⭐ **If Spawn Point drew something fun or useful, a star helps other people find it. If it drew something wrong, [open an issue](https://github.com/leluong141996-dev/Spawn-Point/issues/new) with your prompt: the model's tests grow from prompts that broke.**
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/knight-quest.gif" width="48%" alt="Knight's Quest: a sword platformer">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/castle-defense.gif" width="48%" alt="Castle Defense: a tower defense game">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/ninja-rescue.gif" width="48%" alt="Ninja Rescue: a platformer where a ninja frees his mother">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/dino-eggs.gif" width="48%" alt="Dino Eggs: a bubble shooter with dinosaur eggs">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/night-survivor.gif" width="48%" alt="Night Survivor: auto-fire, gems, level-ups">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper: a Mario-style platformer">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/star-run.gif" width="48%" alt="Star Run: a side-scrolling shooter with power-ups and a boss">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-field.gif" width="48%" alt="Tilling, planting, watering and harvesting in the fenced field">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-animals.gif" width="48%" alt="Collecting eggs and milk from the chickens and the cow in the pen">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-fishing.gif" width="48%" alt="Fishing from the pond's shore: cast, wait for the bite, reel in">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-house.gif" width="48%" alt="Walking into the farmhouse: bed, fireplace, table and rug">
 </p>
-<p align="center"><sub>Seven of the demo games, each one a small JSON graph in <code>examples/</code> built from the
-same component library: generated pixel art, collision traced from the sprites, juice on by default.
-Recorded with <code>spawnpoint gif</code> (autopilot).</sub></p>
+<p align="center"><sub>A cozy farm made from one sentence: the field, the animals, fishing and the farmhouse inside.
+Every tile, building, animal and crop is drawn by plain Python. Recorded with <code>spawnpoint gif --focus field|animals|fish|house</code> (autopilot).</sub></p>
 
 <p align="center"><b><a href="https://leluong141996-dev.github.io/Spawn-Point/">▶ Play the demos in your browser</a></b>: a Mario-style platformer, a
-knight with a sword, tower defense, a ninja rescue, a dinosaur-egg bubble shooter, a survivor with level-ups, a farming
-game, an arena shooter and a side-scrolling space shooter. No install needed, and
+knight with a sword, tower defense, a ninja rescue, a dinosaur-egg bubble shooter, a survivor with level-ups, a cozy
+island farm, an arena shooter and a side-scrolling space shooter. No install needed, and
 they work on phones too (touch controls).</p>
 
 Spawn Point is an open-source, autonomous game studio that runs on your own machine. Instead of asking an LLM to type
@@ -132,7 +131,7 @@ Only what you asked for changes, and the level layout is kept. Prompts can be in
 **The model.** [SpawnPoint-Coder-7B](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ) is a 7B model
 fine-tuned to generate Godot 4 games through this pipeline: it writes the game design, tweaks and entity
 edits as strict JSON, and the compiler turns that into Godot scenes and GDScript. It runs on a single 12 GB
-GPU (AWQ 4-bit). v5 added **side-scrolling shooters** (flight patterns, power-ups, a boss), **Vietnamese prompts read directly** and a small per-genre format instead of one big form; v5.1 fixes prompts that name the hero only indirectly ("a tank shooting monsters"). The downloadable AWQ build gets 88% of a sealed set of 16 human-written prompts for shooters and the v4 fixes fully right, and 80% of 30 human-written game ideas in English and Vietnamese (v4: 87% on those 30; the model card lists every number and where v5.1 is behind). The GGUF Q4_K_M build scores 83% on those 30. Older models still work with `SPAWNPOINT_BRIEF_FORMAT=v4`. It is tuned for the 2D game kinds Spawn Point builds; other genres are no better than a general 7B coder. `spawnpoint llm up` downloads and serves it: the AWQ build on vLLM when
+GPU (AWQ 4-bit). v5 added **side-scrolling shooters** (flight patterns, power-ups, a boss), **Vietnamese prompts read directly** and a small per-genre format instead of one big form; v5.1 fixes prompts that name the hero only indirectly ("a tank shooting monsters"); v5.2 catches farm pests mentioned only in passing ("có cáo", "with a fox around") and leaves peaceful farms without any. The downloadable AWQ build gets 94% of a sealed set of 16 human-written prompts for shooters and the v4 fixes fully right, 100% of a sealed set of 16 farm prompts with pests named in passing, and 83% of 30 human-written game ideas in English and Vietnamese (v4: 87% on those 30; the model card lists every number and where v5.2 is behind). The GGUF Q4_K_M build scores 87% on those 30. Older models still work with `SPAWNPOINT_BRIEF_FORMAT=v4`. It is tuned for the 2D game kinds Spawn Point builds; other genres are no better than a general 7B coder. `spawnpoint llm up` downloads and serves it: the AWQ build on vLLM when
 Docker and an NVIDIA GPU are present, otherwise the [GGUF build](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-GGUF)
 (Q4_K_M, ~4.7 GB) in Ollama. Force one with `--backend vllm|ollama`.
 
@@ -143,12 +142,51 @@ Web builds need the Godot **web export templates** (Editor → Manage Export Tem
 `web_*.zip` from the official `.tpz` into `~/.local/share/godot/export_templates/<version>/`);
 use `--no-web` to skip and play natively with `spawnpoint run`.
 
+## A cozy farm from one sentence
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-overview.png" width="92%" alt="A generated island farm: farmhouse, fenced crop field, animal pen with a coop, pond and woods"><br><sub>One generated farm, the whole map: everything here is drawn by plain Python, no image files.</sub></p>
+
+Ask for a farming game (`spawnpoint create "a cozy farming game with strawberries and pumpkins"`) and
+Spawn Point lays out a whole farm: a farmhouse with a dirt path to its door, a fenced crop field, an animal pen with a
+coop, a pond, a shipping bin, and woods around the edge, on an island (water all round, cliffs to the south; an
+ocean-themed farm always is one) or in a meadow in the woods. The art is a 16-pixel tile set drawn from code: grass with tufts, flowers and mushrooms, paths with soft edges,
+water with lily pads and reeds, buildings, fences, four kinds of tree, chickens and cows, a farmer who walks in four
+directions, and crops with five growth stages (strawberries, carrots, potatoes, pumpkins, corn, wheat, cabbages...,
+picked from the crop's name).
+
+A farm is a season of a few days, each running from 6:00 to 22:00 with the light turning gold in the evening and dark
+at night; sleep in the farmhouse bed (or drop off in the fields at midnight) and watered crops grow overnight. Earn the
+target before the season ends. What you do there: buy seeds (they cost money), till the grass with the hoe, plant,
+water and harvest; feed the hens and the cow, then collect eggs and milk (chicks grow into hens); fish from the pond's
+shore (cast, wait for the bite, reel in on the "!"); chop trees and break rocks for wood and stone; carry it all to the
+shipping bin, while crows, foxes, rabbits or mice go for your crops. Step through the farmhouse door for a cozy room
+inside (bed, fireplace, table, rug). Maps vary: the house on either side, the field and the pen swapping places, the
+pond moving around. The workbench by the house sells tool upgrades (a watering can and a hoe that work a
+3x3 patch, a bigger basket, a sharper axe, a better rod), and the farm saves itself: close the game and it carries on
+where you left it (a won or lost season, or R, starts a fresh one). On a phone, ACT does all of it and a tap on a seed in
+the bar picks it. The
+hotbar shows your seeds and basket. You walk behind trees and the house (the scene is depth-sorted), and only an
+object's footprint blocks you. `spawnpoint overview <project>` saves a picture of the whole map after a short autopilot
+run, like the one above.
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/sunny-farm.gif" width="52%" alt="Sunny Farm: the farmer harvests, sells at the shipping bin and works the field"> <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-night.gif" width="40%" alt="Evening turns to night on the farm; the farmer milks the cow before bed"></p>
+
+The theme sets the season, and the model picks it from the prompt ("a winter farm", "nông trại trên sa mạc"): a snowy
+farm is winter (snow, a frozen pond, snowy pines and bare trees, and crops grow slower), a desert farm has sand, palms
+and cacti (and the soil dries faster), an autumn farm is orange with maples, the rest is spring.
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-seasons.png" width="92%" alt="The same kind of farm in spring, autumn, winter and the desert"></p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-winter.gif" width="32%" alt="A winter farm: snow, snowy pines, bare trees">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-autumn.gif" width="32%" alt="An autumn farm: orange ground, maples">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/farm-desert.gif" width="32%" alt="A desert farm: sand, palms and cacti">
+</p>
+
 ## Sprites: generated or your own
 
 Layer 2 replaces placeholder shapes with **procedural pixel art** — no assets, no GPU: chibi people with big heads, monsters with faces (a biting plant, a mushroom, a snail, a flame spirit, a reaper, an alien, a dragon, a ghost...), items, props, themed tiles and a parallax sky. Spawn Point makes pixel art games only. (A graph can still ask for the smooth `"art_style": "cartoon"` look by hand, but games made from a prompt are always pixel art.)
 
-<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/parade-heroes.gif" width="48%" alt="Animated heroes: knight, wizard, ranger, viking, king, princess, ninja..."> <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/parade-monsters.gif" width="48%" alt="Animated monsters: slime, frog, biting plant, mushroom, snail, flame..."></p>
-<p align="center"><sub>Every character and monster is drawn by plain Python from its name (<code>spawnpoint sprites parade --set heroes|monsters|items</code>).</sub></p>
+Every character and monster is drawn by plain Python from its name; `spawnpoint sprites parade --set heroes|monsters|items` renders them as an animated sheet.
 
 The
 kind follows the entity (`Goblin` → humanoid, `FireBat` → flyer, `LaserBot` → robot, `Crystal` → gem…)
@@ -193,7 +231,7 @@ match the palette, drawn behind everything and without collision.
 Record a clip of any built game to share it (a window opens for a few seconds; autopilot plays):
 
 ```bash
-spawnpoint gif out/pixel-hopper -o demo.gif --seconds 8 --fps 20 --width 640
+spawnpoint gif out/sunny-farm -o demo.gif --seconds 10 --fps 10 --focus fish
 ```
 
 **AI art (optional plug-in).** Point Spawn Point at an image model and layer 2 asks it for the look of
@@ -345,7 +383,7 @@ headless smoke test (spawn, scripted input, crash detection) and report `E_RUNTI
 | Game modes | `BubbleBoard` (a complete bubble shooter: bank shots, colour pops, falling clusters, a descending ceiling) |
 | Shooters | `FlightPath` (straight, wave, dive and hover patterns across the screen), `ShmupShip` (auto-fire, power-ups that add shots and spread), `HealthBar` (boss bars), and `WaveSpawner` gates (`autostart`, `endless`, random spread) |
 | Tower defense | `PathFollower` (walks the road to the base), `Base` (loses a life per invader that gets in), `WaveSpawner` ("8 x Goblin every 1.2; ..."), `TowerSlot`, `TowerBuilder` (click a pad, pay in gold), `TowerBrain` (targets the invader furthest along), `GroundPatch` (roads and paths) |
-| Farming | `FarmPlot` (soil that grows a crop only while watered), `Farmer` (plant / water / harvest, a basket, crop choice), `Market` (sell the basket), `CropPest` (crows that eat crops) |
+| Farming | `FarmPlot` (soil that grows a crop only while watered, drawn from its growth stages), `Farmer` (till / plant / water / harvest, buy seeds, feed, collect, fish, chop, sleep, a basket and a tappable hotbar), `FarmAnimal` (wanders, needs feeding, gives eggs or milk, chicks grow up), `FarmDays` (a season of days with day and night), `SleepSpot` (a bed), `ToolBench` (tool upgrades), `FarmSave` (keeps the farm between plays), `Gatherable` (trees and rocks that break into wood and stone), `FishingSpot` (cast, bite, reel in), `Warp` (doorways, e.g. into the farmhouse), `Market` (a stall or a shipping bin that buys the basket), `CropPest` (crows that eat crops) |
 | Feel | `Juice` — attached to every entity unless `"juice": "none"` |
 
 Runtime autoloads: `GameState` (score, lives, variables, win/lose), `World` (spawning, rule

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/analyze.py

@@ -9,7 +9,7 @@ from typing import Any
 
 from . import level as lvl
 from .diagnostics import Diagnostics, did_you_mean, join_path
-from .graph import Entity, Graph, parse
+from .graph import Entity, Graph, Shape, parse
 from .manifest import BODY_CLASSES, Component, Manifest, Param
 from .rules import compile_rules
 from .sprites import resolve as sprite_resolve
@@ -121,7 +121,11 @@ class _Analyzer:
                              "Generator kinds: " + ", ".join(sorted(sprite_resolve.KINDS)) if "kind" in str(e) else None)
                 continue
             self.sprites[name] = sprite
-            if "shape" not in ent.model_fields_set:
+            if ent.base is not None and "shape" not in ent.model_fields_set:
+                # Standing on its base: only the footprint collides (walk behind the crown or the roof).
+                ent.shape = Shape(type="circle" if ent.body == "character" else "rect", size=tuple(ent.base),
+                                  color=ent.shape.color)
+            elif "shape" not in ent.model_fields_set:
                 # No explicit shape: the body collision comes from the drawing.
                 ent.shape = sprite_resolve.derived_shape(ent, sprite, self.g.genre)
 
@@ -130,6 +134,12 @@ class _Analyzer:
         s = self.g.settings
         from .sprites import scenery as sc
 
+        for name, req in s.art.items():
+            self.scenery_images[f"art_{name}"] = sc.to_image(_draw_art(req))
+        if s.terrain:  # a drawn ground for the whole map (farms)
+            from .sprites import farm
+            self.scenery_images["scenery_ground"] = sc.to_image(farm.terrain_image(s.terrain, s.seed, s.season))
+            return {"ground": "res://sprites/scenery_ground.png", "pixel": 2}
         if s.scenery == "space":  # scrolling stars for shooters, in any art style
             sky, stars = sc.space(background, s.pixel_palette if s.art_style == "pixel" else None, s.seed)
             self.scenery_images["scenery_sky"] = sc.to_image(sky)
@@ -346,9 +356,11 @@ class _Analyzer:
                           "color": ent.shape.color or self._color(ent, team)},
                 "eye": ent.body == "character" and sprite is None,
                 "pivot": "bottom" if g.genre == "platformer" and ent.body == "character" else "center",
-                "sprite": sprite_resolve.plan_entry(name, sprite) if sprite is not None else None,
+                "sprite": sprite_resolve.plan_entry(name, sprite, on_base=ent.base is not None) if sprite is not None else None,
                 "z": -1 if ent.decor else 0,
             })
+            if ent.base is not None:  # the collision box sits at the feet, the origin
+                entities[-1]["shape_offset"] = [0, round(-ent.shape.size[1] / 2, 2)]
             entities[-1]["components"] = comps
 
         placements = []
@@ -356,7 +368,9 @@ class _Analyzer:
             ent = g.entities[p.entity]
             x = (p.x + 0.5) * ts
             floating = any(c in ent.components for c in ("Collectible", "Projectile", "Spawner"))
-            if g.genre == "platformer" and not floating:
+            if ent.base is not None:  # standing on the bottom of its cell
+                y = (p.y + 1) * ts - 4
+            elif g.genre == "platformer" and not floating:
                 y = (p.y + 1) * ts - ent.shape.size[1] / 2
             else:
                 y = (p.y + 0.5) * ts
@@ -410,6 +424,7 @@ class _Analyzer:
             "walls": self.genre["walls"],
             "entities": entities,
             "placements": placements,
+            "y_sort": s.y_sort,
             "rules_script": RULES_SCRIPT,
         }
 
@@ -446,3 +461,15 @@ class _Analyzer:
         if team == "enemy":
             return COLORS["enemy"]
         return COLORS["other"]
+
+
+def _draw_art(req):
+    """The picture an ArtRequest asks for, as an RGBA array."""
+    from .sprites import farm
+    if req.kind == "crop":
+        return farm.crop_sheet(req.of, req.color or "#e83a4a")
+    if req.kind == "crop_icon":
+        return farm.crop_icon(req.of, req.color or "#e83a4a")
+    if req.kind == "item_icon":
+        return farm.item_icon(req.of)
+    return farm.soil_tile(req.kind == "soil_wet")

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/cli.py

@@ -94,6 +94,13 @@ def main(argv: list[str] | None = None) -> int:
     gf.add_argument("--fps", type=int, default=20)
     gf.add_argument("--width", type=int, default=640)
     gf.add_argument("--skip", type=float, default=0.0, help="seconds of play before the clip starts")
+    gf.add_argument("--focus", default="", choices=["", "field", "animals", "fish", "house"],
+                    help="farms: show one activity")
+
+    ov = sub.add_parser("overview", help="save one picture of a built project's whole map (needs a display)")
+    ov.add_argument("project", type=Path)
+    ov.add_argument("-o", "--out", type=Path, help="output file (default: <project>/overview.png)")
+    ov.add_argument("--seconds", type=float, default=20.0, help="seconds of autopilot play first")
 
     sp = sub.add_parser("sprites", help="import, generate or preview sprites")
     sps = sp.add_subparsers(dest="sprites_cmd", required=True)
@@ -143,7 +150,7 @@ def main(argv: list[str] | None = None) -> int:
         return {"validate": _validate, "build": _build, "run": _run, "components": _components,
                 "manifest": _manifest, "create": studio_cli.create, "tweak": studio_cli.tweak,
                 "serve": studio_cli.serve, "dataset": studio_cli.dataset, "playtest": studio_cli.playtest, "studio": studio_cli.studio,
-                "sprites": _sprites, "gif": _gif, "llm": _llm, "examples": _examples,
+                "sprites": _sprites, "gif": _gif, "overview": _overview, "llm": _llm, "examples": _examples,
                 "demo": _demo}[args.cmd](args)
     except godot.GodotError as e:
         print(f"error: {e}", file=sys.stderr)
@@ -252,11 +259,20 @@ def _gif(args) -> int:
     from .gif import record_gif
 
     out = args.out or args.project / "demo.gif"
-    path = record_gif(args.project.resolve(), out.resolve(), args.seconds, args.fps, args.width, args.skip)
+    path = record_gif(args.project.resolve(), out.resolve(), args.seconds, args.fps, args.width, args.skip, args.focus)
     print(f"Wrote {out} ({path.stat().st_size / 1e6:.1f} MB)")
     return 0
 
 
+def _overview(args) -> int:
+    from .gif import overview
+
+    out = args.out or args.project / "overview.png"
+    overview(args.project.resolve(), out.resolve(), args.seconds)
+    print(f"Wrote {out}")
+    return 0
+
+
 def _demo(args) -> int:
     from .demo import build_site
 

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/demo.py

@@ -55,10 +55,10 @@ SHOWCASE = [
      "Move: arrows / WASD | Dash: Shift | Pick an upgrade: 1 / 2 / 3 or click | Restart: R",
      {"pad": "dpad", "buttons": [["DASH", "ShiftLeft"]], "tap": "Move with the stick - you shoot on your own"}),
     ("sunny_farm.json", "farming",
-     "Plant, water and harvest carrots, tomatoes and pumpkins, sell them at the market, and shoo the crows before sunset.",
-     "Move: arrows / WASD | Plant, water, harvest: Space / E | Crop: 1 / 2 / 3 | Shoo crows: X | Restart: R",
-     {"pad": "dpad", "buttons": [["ACT", "Space"], ["SHOO", "KeyX"], ["3", "Digit3"], ["2", "Digit2"], ["1", "Digit1"]],
-      "tap": "Stand next to a plot and press ACT"}),
+     "A cozy island farm over three days: buy seeds, till and grow strawberries, carrots and pumpkins, feed the hens and the cow, fish in the pond, chop wood, sleep in the farmhouse, upgrade your tools, and sell it all at the shipping bin. Your farm is saved as you play.",
+     "Move: arrows / WASD | Till, plant, water, harvest, feed, fish, chop, go in, sleep: Space / E | Seed: 1 / 2 / 3 or click it | Shoo crows: X | Restart: R",
+     {"pad": "dpad", "buttons": [["ACT", "Space"], ["SHOO", "KeyX"]],
+      "tap": "ACT works the field, feeds, fishes and opens doors; tap a seed in the bar to choose it"}),
     ("pixel_arena.json", "arena shooter",
      "A top-down arena: blast through robots and turrets, then reach the portal.",
      "Move: WASD | Aim: mouse | Shoot: click / X | Dash: Shift | Restart: R",

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/gif.py

@@ -18,7 +18,7 @@ from .manifest import ADDON_DIR
 RECORD_SCENE = "res://addons/spawn_point/tools/record.tscn"
 
 
-def record_frames(project: Path, out_dir: Path, seconds: float, fps: int, skip: float = 0.0) -> list[Path]:
+def record_frames(project: Path, out_dir: Path, seconds: float, fps: int, skip: float = 0.0, focus: str = "") -> list[Path]:
     # Projects built before the recorder existed get the current tool copied in.
     tools = project / "addons" / "spawn_point" / "tools"
     for name in ("record.gd", "record.tscn"):
@@ -26,7 +26,7 @@ def record_frames(project: Path, out_dir: Path, seconds: float, fps: int, skip:
     step = max(1, round(60 / fps))
     total = int(seconds * 60)
     cmd = [godot.find_binary(), "--path", str(project), "--fixed-fps", "60", RECORD_SCENE,
-           "--", str(out_dir), str(total), str(step), str(int(skip * 60))]
+           "--", str(out_dir), str(total), str(step), str(int(skip * 60)), focus]
     proc = subprocess.run(cmd, capture_output=True, text=True, timeout=(seconds + skip) * 20 + 60)
     frames = sorted(out_dir.glob("frame_*.png"))
     if not frames:
@@ -54,8 +54,27 @@ def make_gif(frames: list[Path], out: Path, fps: int, width: int, colors: int =
 
 
 def record_gif(project: Path, out: Path, seconds: float = 8.0, fps: int = 20, width: int = 640,
-               skip: float = 0.0) -> Path:
-    """`skip`: seconds of autopilot play before the clip starts (survivor games get busy later)."""
+               skip: float = 0.0, focus: str = "") -> Path:
+    """`skip`: seconds of autopilot play before the clip starts (survivor games get busy later). `focus` (farms):
+    what the autopilot does: "field", "animals", "fish" or "house"; empty for a bit of everything."""
     with tempfile.TemporaryDirectory() as tmp:
-        frames = record_frames(project, Path(tmp), seconds, fps, skip)
+        frames = record_frames(project, Path(tmp), seconds, fps, skip, focus)
         return make_gif(frames, out, fps, width)
+
+
+OVERVIEW_SCENE = "res://addons/spawn_point/tools/overview.tscn"
+
+
+def overview(project: Path, out: Path, seconds: float = 20.0) -> Path:
+    """One picture of the whole map after `seconds` of autopilot play (crops grow, animals wander)."""
+    tools = project / "addons" / "spawn_point" / "tools"
+    for name in ("record.gd", "record.tscn", "overview.gd", "overview.tscn"):
+        shutil.copy2(ADDON_DIR / "tools" / name, tools / name)
+    out.parent.mkdir(parents=True, exist_ok=True)
+    out.unlink(missing_ok=True)  # an old picture must not pass for a new one
+    cmd = [godot.find_binary(), "--path", str(project), "--fixed-fps", "60", OVERVIEW_SCENE, "--", str(out),
+           str(int(seconds * 60))]
+    proc = subprocess.run(cmd, capture_output=True, text=True, timeout=seconds * 20 + 60)
+    if not out.exists():
+        raise godot.GodotError("the overview produced no picture (is a display available?)", proc.stdout + proc.stderr)
+    return out

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/graph.py

@@ -76,6 +76,9 @@ class Entity(_Model):
     components: dict[str, dict[str, Any]] = Field(default_factory=dict)
     juice: Union[Literal["none"], dict[str, Any], None] = None
     decor: bool = Field(default=False, description="scenery (trees, bushes, rocks): drawn behind everything, no collision")
+    # Footprint [width, height] in px: the entity stands on the bottom of its drawing (origin at its feet) and only
+    # this box at its base collides, so a tree's crown or a house's roof can be walked behind (with y_sort).
+    base: tuple[float, float] | None = None
 
 
 class Level(_Model):
@@ -99,6 +102,15 @@ class TileStyle(_Model):
     _color = field_validator("color", "top")(_check_color)
 
 
+class ArtRequest(_Model):
+    """An extra picture drawn by the compiler for a component to use (res://sprites/art_<name>.png)."""
+    kind: Literal["crop", "crop_icon", "item_icon", "soil", "soil_wet"]
+    of: str = ""  # the crop name ("Strawberry") or item ("egg", "milk", "wood", "stone", "fish", "hay")
+    color: str | None = None
+
+    _color = field_validator("color")(_check_color)
+
+
 class Settings(_Model):
     tile_size: int = Field(default=32, ge=8, le=128)
     viewport: tuple[int, int] = (960, 540)
@@ -117,6 +129,14 @@ class Settings(_Model):
     # colour, a theme name forces one, "flat" keeps the plain hills and checkered floor.
     scenery: Literal["auto", "flat", "night", "forest", "desert", "neon", "candy", "ocean", "lava", "snow", "space"] = "auto"
     zoom: float = Field(default=1.0, ge=0.5, le=4.0)
+    # A drawn ground for the whole map, one character per cell like the level map: "." grass, ":" dirt path,
+    # "~" water, "," tidy grass (fields), "_" sand. Used by farms; replaces the floor and scenery.
+    terrain: list[str] | None = None
+    season: Literal["spring", "autumn", "winter", "desert"] = "spring"  # the terrain's colours
+    # Draw entities lower on screen in front of the ones above them (top-down games with tall trees and houses).
+    y_sort: bool = False
+    # Extra pictures for components (crop growth stages, item icons, soil): name -> what to draw.
+    art: dict[str, ArtRequest] = Field(default_factory=dict)
 
     _bg = field_validator("background")(_check_color)
 

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/llm_server.py

@@ -19,7 +19,7 @@ IMAGE = os.environ.get("VLLM_IMAGE", "vllm/vllm-openai:v0.10.2")  # CUDA 12.8: N
 DEFAULT_MODEL = "smoky1496/SpawnPoint-Coder-7B-AWQ"
 MODEL = os.environ.get("SPAWNPOINT_MODEL", DEFAULT_MODEL)
 # This Spawn Point version speaks the v5 per-genre format: pin the weights that do, whatever the repo's main becomes.
-REVISION = os.environ.get("SPAWNPOINT_MODEL_REVISION") or ("v5.1-release" if MODEL == DEFAULT_MODEL else "")
+REVISION = os.environ.get("SPAWNPOINT_MODEL_REVISION") or ("v5.2-release" if MODEL == DEFAULT_MODEL else "")
 SERVED = "SpawnPoint-Coder-7B"
 OLLAMA_MODEL = os.environ.get("SPAWNPOINT_OLLAMA_MODEL", "hf.co/smoky1496/SpawnPoint-Coder-7B-GGUF:Q4_K_M")
 OLLAMA_PORT = 11434

{spawnpoint_studio-0.3.3 → spawnpoint_studio-0.3.4}/compiler/spawnpoint/sprites/cartoon.py

@@ -982,6 +982,10 @@ OUTLINE = {"bullet": 0.8, "slash": 0.8, "coin": 1.0, "gem": 1.0, "star": 1.1, "h
 def generate_cartoon(name: str, kind: str, color: str, features: list[str] | None = None, seed: int = 0) -> SpriteSet:
     if kind not in KINDS:
         raise ValueError(f"unknown sprite kind '{kind}'")
+    from . import farm
+    if kind in farm.SPRITES:  # the farm set is pixel art only
+        from .generate import generate
+        return generate(name, kind, color, features, seed)
     spec = KINDS[kind]
     feats = list(features) if features is not None else features_for(name)
     rng_seed = zlib.crc32(f"{name}:{kind}:{seed}".encode())