spawnpoint-studio 0.2.0__tar.gz → 0.3.1__tar.gz

{spawnpoint_studio-0.2.0/compiler/spawnpoint_studio.egg-info → spawnpoint_studio-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawnpoint-studio
-Version: 0.2.0
+Version: 0.3.1
 Summary: Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU.
 Author: smoky1496
 License: MIT
@@ -33,15 +33,22 @@ Dynamic: license-file
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper — generated platformer">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-arena.gif" width="48%" alt="Pixel Arena — generated top-down shooter">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/knight-quest.gif" width="48%" alt="Knight's Quest: a cartoon-style 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">
 </p>
-<p align="center"><sub>Both games are built from <code>examples/pixel_hopper.json</code> and
-<code>examples/pixel_arena.json</code>: generated sprites, collision traced from pixels, juice on by
-default. Recorded with <code>spawnpoint gif</code> (autopilot).</sub></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 cartoon or pixel art, collision traced from the sprites, juice on by default.
+Recorded with <code>spawnpoint gif</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 ninja
-rescue, a dinosaur-egg bubble shooter, a survivor with level-ups and an arena shooter. No install needed.</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 cartoon
+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
+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
 hundreds of lines of GDScript (slow, expensive, and easy to break with Godot 3/4 mix-ups), the LLM
@@ -149,10 +156,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). v2 on 30 human-written game ideas (English and Vietnamese): 87% fully right (v1: 73%),
-97% of checks passed; on held-out tasks: briefs 88% exact (v1: 36%), Vietnamese → English 97% (v1: 52%),
-tweaks 98%, entity edits 91%. It is tuned for 2D platformers and 2D top-down games only; 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"). 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
 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`.
 
@@ -165,10 +169,29 @@ use `--no-web` to skip and play natively with `spawnpoint run`.
 
 ## Sprites: generated or your own
 
-Layer 2 replaces placeholder shapes with **procedural pixel-art sprites** — no assets, no GPU. The
+Layer 2 replaces placeholder shapes with **procedural sprites** — no assets, no GPU — in one of two art styles:
+**pixel art** (the default) or **cartoon** (`"art_style": "cartoon"` in the graph settings, or "cartoon style" in
+the prompt): smooth shaded sprites with a sticker outline, rounded tiles, and a parallax sky with hills, clouds and
+trees. The
 kind follows the entity (`Goblin` → humanoid, `FireBat` → flyer, `LaserBot` → robot, `Crystal` → gem…)
-and details follow the name (`Ninja` → mask, `Fox` → ears and tail, `Spider` → legs). Every sprite has
-idle / run / jump / fall / hurt animations driven automatically by an `Animator` component.
+and details follow the name (`Ninja` → mask, `Fox` → ears and tail, `Spider` → legs, a sword-wielder holds a sword).
+Every sprite has idle / run / jump / fall / hurt animations driven automatically by an `Animator` component, plus
+`attack` (played each time its weapon fires) and `die` (a death sequence that plays on after the entity is gone) for
+anything that fights or can be hurt; heroes breathe and blink while they stand.
+
+**Pixel-art settings** (`settings` in the graph; the assembler sets the first two from the game's theme):
+
+| Setting | Values | What it does |
+|---|---|---|
+| `pixel_palette` | `none`, `pico8`, `sweetie16`, `endesga32` | Limits every sprite, tile and backdrop colour to a classic palette, so the whole game shares one set of colours. |
+| `scenery` | `auto`, `flat`, or a theme (`night`, `forest`, `desert`, `neon`, `candy`, `ocean`, `lava`, `snow`) | A banded sky with sun or moon and stars, parallax clouds, mountains, hills and themed trees, cacti, skylines or kelp (a themed floor for top-down games). `auto` picks one that fits the background colour, `flat` keeps the plain hills. |
+| `pixel_size` | `2` (default), `1` | `2` is chunky (NES-like); `1` draws the same art at twice the resolution (SNES-like) at the same on-screen size. |
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-size.png" width="92%" alt="The same game with pixel_size 2 (chunky) and pixel_size 1 (fine)"><br><sub>The same game, same moment: <code>pixel_size: 2</code> (left) and <code>pixel_size: 1</code> (right).</sub></p>
+
+Ground tiles are drawn for their neighbours (grass on top, outlined exposed edges, rounded and notched corners,
+varied interiors, capped one-way planks), and pixel-art levels get pixel effects: skidding dust, hit sparks and a
+screen shake in whole pixels.
 
 **Collision comes from the pixels.** Hitboxes, hurtboxes, pickups, hazards and static bodies use the
 sprite's traced outline (`CollisionPolygon2D`); moving bodies keep a smooth capsule/circle fitted to
@@ -332,10 +355,13 @@ headless smoke test (spawn, scripted input, crash detection) and report `E_RUNTI
 |---|---|
 | Movement | `PlatformerMovement` (coyote time, jump buffer, variable jump, apex hang, dash, double jump), `TopDownMovement` (accel/friction, dash) |
 | Controllers | `PlayerInput`, `PatrolAI`, `ChaseAI`, `Aim` |
-| Combat | `Health`, `Hitbox`, `Hurtbox`, `Stomp`, `Weapon`, `Projectile` |
+| Combat | `Health`, `Hitbox`, `Hurtbox`, `Stomp`, `Weapon`, `Projectile` (a sword is a `Weapon` whose projectile is a short, piercing slash) |
 | World | `Collectible`, `TriggerZone`, `Spawner` (ramping waves, spawns around the player), `Gate` |
 | Progression | `Experience` (XP and levels), `XpOrb` (gems that fly to the player), `LevelUpMenu` (pause and pick one of three upgrades) |
 | 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) |
 | Feel | `Juice` — attached to every entity unless `"juice": "none"` |
 
 Runtime autoloads: `GameState` (score, lives, variables, win/lose), `World` (spawning, rule

{spawnpoint_studio-0.2.0 → spawnpoint_studio-0.3.1}/README.md

@@ -9,15 +9,22 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-hopper.gif" width="48%" alt="Pixel Hopper — generated platformer">
-  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-arena.gif" width="48%" alt="Pixel Arena — generated top-down shooter">
+  <img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/knight-quest.gif" width="48%" alt="Knight's Quest: a cartoon-style 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">
 </p>
-<p align="center"><sub>Both games are built from <code>examples/pixel_hopper.json</code> and
-<code>examples/pixel_arena.json</code>: generated sprites, collision traced from pixels, juice on by
-default. Recorded with <code>spawnpoint gif</code> (autopilot).</sub></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 cartoon or pixel art, collision traced from the sprites, juice on by default.
+Recorded with <code>spawnpoint gif</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 ninja
-rescue, a dinosaur-egg bubble shooter, a survivor with level-ups and an arena shooter. No install needed.</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 cartoon
+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
+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
 hundreds of lines of GDScript (slow, expensive, and easy to break with Godot 3/4 mix-ups), the LLM
@@ -125,10 +132,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). v2 on 30 human-written game ideas (English and Vietnamese): 87% fully right (v1: 73%),
-97% of checks passed; on held-out tasks: briefs 88% exact (v1: 36%), Vietnamese → English 97% (v1: 52%),
-tweaks 98%, entity edits 91%. It is tuned for 2D platformers and 2D top-down games only; 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"). 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
 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`.
 
@@ -141,10 +145,29 @@ use `--no-web` to skip and play natively with `spawnpoint run`.
 
 ## Sprites: generated or your own
 
-Layer 2 replaces placeholder shapes with **procedural pixel-art sprites** — no assets, no GPU. The
+Layer 2 replaces placeholder shapes with **procedural sprites** — no assets, no GPU — in one of two art styles:
+**pixel art** (the default) or **cartoon** (`"art_style": "cartoon"` in the graph settings, or "cartoon style" in
+the prompt): smooth shaded sprites with a sticker outline, rounded tiles, and a parallax sky with hills, clouds and
+trees. The
 kind follows the entity (`Goblin` → humanoid, `FireBat` → flyer, `LaserBot` → robot, `Crystal` → gem…)
-and details follow the name (`Ninja` → mask, `Fox` → ears and tail, `Spider` → legs). Every sprite has
-idle / run / jump / fall / hurt animations driven automatically by an `Animator` component.
+and details follow the name (`Ninja` → mask, `Fox` → ears and tail, `Spider` → legs, a sword-wielder holds a sword).
+Every sprite has idle / run / jump / fall / hurt animations driven automatically by an `Animator` component, plus
+`attack` (played each time its weapon fires) and `die` (a death sequence that plays on after the entity is gone) for
+anything that fights or can be hurt; heroes breathe and blink while they stand.
+
+**Pixel-art settings** (`settings` in the graph; the assembler sets the first two from the game's theme):
+
+| Setting | Values | What it does |
+|---|---|---|
+| `pixel_palette` | `none`, `pico8`, `sweetie16`, `endesga32` | Limits every sprite, tile and backdrop colour to a classic palette, so the whole game shares one set of colours. |
+| `scenery` | `auto`, `flat`, or a theme (`night`, `forest`, `desert`, `neon`, `candy`, `ocean`, `lava`, `snow`) | A banded sky with sun or moon and stars, parallax clouds, mountains, hills and themed trees, cacti, skylines or kelp (a themed floor for top-down games). `auto` picks one that fits the background colour, `flat` keeps the plain hills. |
+| `pixel_size` | `2` (default), `1` | `2` is chunky (NES-like); `1` draws the same art at twice the resolution (SNES-like) at the same on-screen size. |
+
+<p align="center"><img src="https://raw.githubusercontent.com/leluong141996-dev/Spawn-Point/main/docs/media/pixel-size.png" width="92%" alt="The same game with pixel_size 2 (chunky) and pixel_size 1 (fine)"><br><sub>The same game, same moment: <code>pixel_size: 2</code> (left) and <code>pixel_size: 1</code> (right).</sub></p>
+
+Ground tiles are drawn for their neighbours (grass on top, outlined exposed edges, rounded and notched corners,
+varied interiors, capped one-way planks), and pixel-art levels get pixel effects: skidding dust, hit sparks and a
+screen shake in whole pixels.
 
 **Collision comes from the pixels.** Hitboxes, hurtboxes, pickups, hazards and static bodies use the
 sprite's traced outline (`CollisionPolygon2D`); moving bodies keep a smooth capsule/circle fitted to
@@ -308,10 +331,13 @@ headless smoke test (spawn, scripted input, crash detection) and report `E_RUNTI
 |---|---|
 | Movement | `PlatformerMovement` (coyote time, jump buffer, variable jump, apex hang, dash, double jump), `TopDownMovement` (accel/friction, dash) |
 | Controllers | `PlayerInput`, `PatrolAI`, `ChaseAI`, `Aim` |
-| Combat | `Health`, `Hitbox`, `Hurtbox`, `Stomp`, `Weapon`, `Projectile` |
+| Combat | `Health`, `Hitbox`, `Hurtbox`, `Stomp`, `Weapon`, `Projectile` (a sword is a `Weapon` whose projectile is a short, piercing slash) |
 | World | `Collectible`, `TriggerZone`, `Spawner` (ramping waves, spawns around the player), `Gate` |
 | Progression | `Experience` (XP and levels), `XpOrb` (gems that fly to the player), `LevelUpMenu` (pause and pick one of three upgrades) |
 | 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) |
 | Feel | `Juice` — attached to every entity unless `"juice": "none"` |
 
 Runtime autoloads: `GameState` (score, lives, variables, win/lose), `World` (spawning, rule

{spawnpoint_studio-0.2.0 → spawnpoint_studio-0.3.1}/compiler/spawnpoint/analyze.py

@@ -46,6 +46,7 @@ class Analysis:
     rules_source: str | None = None
     sprites: dict[str, SpriteSet] = field(default_factory=dict)  # entity -> resolved sprite sheet
     tiles_image: Any = None  # pixel-art tile atlas (PIL image), written to res://sprites/tiles.png
+    scenery_images: dict[str, Any] = field(default_factory=dict)  # name -> PIL image, written to res://sprites/<name>.png
 
     @property
     def ok(self) -> bool:
@@ -69,6 +70,7 @@ class _Analyzer:
         self.genre = GENRE_DEFAULTS[graph.genre]
         self.sprites: dict[str, SpriteSet] = {}
         self.tiles_image = None
+        self.scenery_images: dict[str, Any] = {}
 
     # -- entry -----------------------------------------------------------------------------
     def run(self) -> Analysis:
@@ -99,7 +101,7 @@ class _Analyzer:
         if not self.d.ok or data is None:
             return Analysis(g, self.d)
         plan = self._plan(data, teams, params_by_entity, players[0])
-        return Analysis(g, self.d, plan, rules.source, self.sprites, self.tiles_image)
+        return Analysis(g, self.d, plan, rules.source, self.sprites, self.tiles_image, self.scenery_images)
 
     # -- sprites ---------------------------------------------------------------------------
     def _resolve_sprites(self, teams: dict[str, str]) -> None:
@@ -110,7 +112,10 @@ class _Analyzer:
             try:
                 path = join_path("entities", name, "sprite")
                 sprite = sprite_resolve.resolve(name, ent, self.base_dir, color,
-                                                warn=lambda m, p=path: self.d.warning("W_AI_SPRITE", p, m))
+                                                warn=lambda m, p=path: self.d.warning("W_AI_SPRITE", p, m),
+                                                style=self.g.settings.art_style,
+                                                palette=self.g.settings.pixel_palette,
+                                                fine=self.g.settings.pixel_size == 1)
             except SpriteError as e:
                 self.d.error("E_SPRITE", join_path("entities", name, "sprite"), str(e),
                              "Generator kinds: " + ", ".join(sorted(sprite_resolve.KINDS)) if "kind" in str(e) else None)
@@ -120,6 +125,37 @@ class _Analyzer:
                 # No explicit shape: the body collision comes from the drawing.
                 ent.shape = sprite_resolve.derived_shape(ent, sprite, self.g.genre)
 
+    def _scenery(self, background: str) -> dict | None:
+        """Pixel-art backdrop images (written next to the sprites) and how the level should lay them out."""
+        s = self.g.settings
+        from .sprites import scenery as sc
+
+        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)
+            layers = []
+            for name, image, speed in stars:
+                self.scenery_images[f"scenery_stars_{name}"] = sc.to_image(image)
+                layers.append({"name": name, "texture": f"res://sprites/scenery_stars_{name}.png", "speed": speed,
+                               "height": int(image.shape[0])})
+            return {"sky": "res://sprites/scenery_sky.png", "stars": layers, "pixel": 2, "width": sc.WIDTH}
+        if s.art_style != "pixel" or s.scenery == "flat" or s.tile_style != "pixel":
+            return None
+
+        theme = s.scenery if s.scenery in sc.THEMES else "auto"
+        if self.g.genre == "topdown":
+            self.scenery_images["scenery_floor"] = sc.to_image(sc.floor_tile(theme, background, s.pixel_palette, s.seed))
+            return {"floor": "res://sprites/scenery_floor.png", "pixel": 2}
+        sky, layers = sc.build(theme, background, s.pixel_palette, s.seed)
+        self.scenery_images["scenery_sky"] = sc.to_image(sky)
+        out = []
+        for layer in layers:
+            name = f"scenery_{layer.name}"
+            self.scenery_images[name] = sc.to_image(layer.image)
+            out.append({"name": layer.name, "texture": f"res://sprites/{name}.png", "scroll": layer.scroll,
+                        "anchor": layer.anchor, "lift": layer.lift, "height": int(layer.image.shape[0])})
+        return {"sky": "res://sprites/scenery_sky.png", "layers": out, "pixel": 2, "width": sc.WIDTH}
+
     # -- entities --------------------------------------------------------------------------
     def _team(self, e: Entity) -> str:
         if e.team:
@@ -331,11 +367,26 @@ class _Analyzer:
                       "top": (solid and solid.top) or self.genre["solid_top"]},
             "oneway": {"color": (oneway and oneway.color) or self.genre["oneway"]},
         }
+        variant_of: dict[tuple[int, int], int] = {}
         if s.tile_style == "pixel":
-            from .sprites.tiles import tileset
-            self.tiles_image = tileset(g.genre, tiles_style["solid"]["color"], tiles_style["solid"]["top"],
-                                       tiles_style["oneway"]["color"], ts, s.seed)
+            from .sprites.tiles import tileset_cartoon
+            if s.art_style == "pixel":
+                from .sprites.tiles import tileset_auto
+                # Pixel ground is drawn for each cell's real neighbours (grass on top, outlines, rounded corners).
+                self.tiles_image, kinds, variant_of = tileset_auto(
+                    g.genre, tiles_style["solid"]["color"], tiles_style["solid"]["top"], tiles_style["oneway"]["color"],
+                    ts, s.seed, s.pixel_palette, data.tiles, data.width, data.height, s.pixel_size)
+                tiles_style["variants"] = kinds
+            else:
+                self.tiles_image = tileset_cartoon(g.genre, tiles_style["solid"]["color"], tiles_style["solid"]["top"],
+                                                   tiles_style["oneway"]["color"], ts, s.seed)
             tiles_style["texture"] = "res://sprites/tiles.png"
+            tiles_style["smooth"] = s.art_style == "cartoon"
+            if s.art_style == "cartoon":
+                from .sprites.tiles import CARTOON_GAP
+                tiles_style["separation"] = CARTOON_GAP
+        background = s.background or self.genre["background"]
+        scenery_plan = self._scenery(background)
         return {
             "format": PLAN_FORMAT,
             "name": g.name,
@@ -344,11 +395,16 @@ class _Analyzer:
             "lives": s.lives,
             "viewport": list(s.viewport),
             "zoom": s.zoom,
-            "background": s.background or self.genre["background"],
+            "art_style": s.art_style,
+            "background": background,
+            **({"scenery": scenery_plan} if scenery_plan else {}),
             "gravity": s.gravity if s.gravity is not None else self.genre["gravity"],
             "tiles": tiles_style,
             "map": {"width": data.width, "height": data.height,
-                    "cells": [[x, y, k] for (x, y), k in sorted(data.tiles.items(), key=lambda kv: (kv[0][1], kv[0][0]))]},
+                    "cells": [[x, y, k] for (x, y), k in sorted(data.tiles.items(), key=lambda kv: (kv[0][1], kv[0][0]))],
+                    # parallel to cells: the atlas variant drawn for each one (neighbour-aware pixel tiles)
+                    **({"cell_variants": [variant_of[c] for c, _ in sorted(data.tiles.items(), key=lambda kv: (kv[0][1], kv[0][0]))]}
+                       if variant_of else {})},
             "bounds": [0, 0, data.width * ts, data.height * ts],
             "walls": self.genre["walls"],
             "entities": entities,

{spawnpoint_studio-0.2.0 → spawnpoint_studio-0.3.1}/compiler/spawnpoint/build.py

@@ -65,7 +65,8 @@ def build(data: Any, out_dir: Path, *, manifest: Manifest | None = None, smoke:
 
     t = time.perf_counter()
     feature = _godot_feature()
-    project.write(out_dir, data, plan, analysis.rules_source, feature, analysis.sprites, analysis.tiles_image)
+    project.write(out_dir, data, plan, analysis.rules_source, feature, analysis.sprites, analysis.tiles_image,
+                  analysis.scenery_images)
     sfx.write_all(out_dir / "sfx", seed=analysis.graph.settings.seed)
     timings["write"] = time.perf_counter() - t
 

{spawnpoint_studio-0.2.0 → spawnpoint_studio-0.3.1}/compiler/spawnpoint/cli.py

@@ -93,6 +93,7 @@ def main(argv: list[str] | None = None) -> int:
     gf.add_argument("--seconds", type=float, default=8.0)
     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")
 
     sp = sub.add_parser("sprites", help="import, generate or preview sprites")
     sps = sp.add_subparsers(dest="sprites_cmd", required=True)
@@ -245,7 +246,7 @@ 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)
+    path = record_gif(args.project.resolve(), out.resolve(), args.seconds, args.fps, args.width, args.skip)
     print(f"Wrote {out} ({path.stat().st_size / 1e6:.1f} MB)")
     return 0
 

{spawnpoint_studio-0.2.0 → spawnpoint_studio-0.3.1}/compiler/spawnpoint/demo.py

@@ -28,26 +28,50 @@ MODEL = "https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ"
 SHOWCASE = [
     ("pixel_hopper.json", "platformer",
      "A Mario-style romp: stomp slimes, double-jump, dash, and collect every coin to open the door.",
-     "Move: arrows / WASD | Jump: Space (twice to double-jump) | Dash: Shift | Restart: R"),
+     "Move: arrows / WASD | Jump: Space (twice to double-jump) | Dash: Shift | Restart: R",
+     {"pad": "lr", "buttons": [["JUMP", "Space"], ["DASH", "ShiftLeft"]]}),
     ("ninja_rescue.json", "platformer",
      "Mom has been caged! Throw shurikens, dodge the masked throwers, grab the key up high and set her free.",
-     "Move: arrows / WASD | Jump: Space | Shuriken: X / J | Dash: Shift | Restart: R"),
+     "Move: arrows / WASD | Jump: Space | Shuriken: X / J | Dash: Shift | Restart: R",
+     {"pad": "lr", "buttons": [["JUMP", "Space"], ["STAR", "KeyX"], ["DASH", "ShiftLeft"]]}),
+    ("knight_quest.json", "sword platformer",
+     "A cartoon knight's run: slash slimes, bats and goblins with your sword, double-jump the spikes and reach the gate.",
+     "Move: arrows / WASD | Jump: Space (twice to double-jump) | Sword: X / J | Restart: R",
+     {"pad": "lr", "buttons": [["JUMP", "Space"], ["SWORD", "KeyX"]]}),
+    ("castle_defense.json", "tower defense",
+     "Goblins, orcs and wolves march on the castle: build archer and cannon towers beside the road and hold all seven waves.",
+     "Build: click a pad | Tower: 1 archer / 2 cannon | Restart: R",
+     {"pad": None, "buttons": [["2", "Digit2"], ["1", "Digit1"]], "tap": "Tap a pad to build; 1 / 2 picks the tower"}),
+    ("star_run.json", "side-scrolling shooter",
+     "Fly the Falcon through drones, saucers and hunters, grab power-ups for more guns, and bring down the Warship.",
+     "Move: arrows / WASD | Fire: automatic | Restart: R",
+     {"pad": "dpad", "buttons": [], "tap": "Move with the stick - the ship fires on its own"}),
     ("dino_eggs.json", "bubble shooter",
      "The classic egg shooter: bank shots off the walls, pop three dinosaur eggs of a colour, drop whole clusters.",
-     "Aim: mouse or Left / Right | Shoot: click / Space / X | Restart: R"),
+     "Aim: mouse or Left / Right | Shoot: click / Space / X | Restart: R",
+     {"pad": None, "buttons": [], "tap": "Tap where you want the egg to go"}),
     ("night_survivor.json", "survivor",
      "Survive three minutes of the night: auto-fire, collect gems, level up and pick a new power each time.",
-     "Move: arrows / WASD | Dash: Shift | Pick an upgrade: 1 / 2 / 3 or click | Restart: R"),
+     "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"}),
     ("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"),
+     "Move: WASD | Aim: mouse | Shoot: click / X | Dash: Shift | Restart: R",
+     {"pad": "dpad", "buttons": [["DASH", "ShiftLeft"]], "tap": "Move with the stick, tap to shoot"}),
 ]
+TOUCH_JS = Path(__file__).with_name("demo_touch.js")
 
 
-def game_overlay(controls: str) -> str:
+def game_overlay(controls: str, touch: dict | None = None) -> str:
     """Injected into every game page: a way back to the gallery and the controls (bottom-left, clear of
-    the HUD). Hidden for screenshots (?shot)."""
+    the HUD), plus the touch controls on phones (../touch.js). Hidden for screenshots (?shot)."""
     return (
+        "<script>window.SP_TOUCH=" + json.dumps(touch or {}) + ";</script><script src=\"../touch.js\"></script>"
         "<style>#sp-bar{position:fixed;bottom:30px;left:8px;z-index:10;display:flex;gap:10px;align-items:center;"
         "font:12px/1.4 ui-monospace,Menlo,monospace;color:#fff;background:rgba(0,0,0,.55);padding:5px 10px;"
         "border-radius:6px;pointer-events:none}#sp-bar a{color:#ffec27;text-decoration:none;pointer-events:auto}"
@@ -67,17 +91,19 @@ class Game:
     tag: str = ""
     blurb: str = ""
     controls: str = ""
+    touch: dict = field(default_factory=dict)
     errors: list[str] = field(default_factory=list)
 
 
 def discover(examples: Path | None = None) -> list[Game]:
     examples = examples or manifest_mod.EXAMPLES_DIR
     games: list[Game] = []
-    for name, tag, blurb, controls in SHOWCASE:
+    for name, tag, blurb, controls, touch in SHOWCASE:
         path = examples / name
         if path.exists():
             data = load_graph(path)
-            games.append(Game(path.stem.replace("_", "-"), path, data.get("name", path.stem), tag, blurb, controls))
+            games.append(Game(path.stem.replace("_", "-"), path, data.get("name", path.stem), tag, blurb, controls,
+                              touch))
     return games
 
 
@@ -93,13 +119,14 @@ def build_site(out: Path, games: list[Game] | None = None, screenshots: bool = T
                 g.errors = [str(d) for d in result.diagnostics.errors] or ["build failed"]
                 log(f"  {g.slug}: build failed: {g.errors[0]}")
                 continue
-            seconds = web.export(project, head_include=game_overlay(g.controls))
+            seconds = web.export(project, head_include=game_overlay(g.controls, g.touch))
             target = out / g.slug
             shutil.rmtree(target, ignore_errors=True)
             shutil.copytree(project / web.WEB_DIR, target,
                             ignore=shutil.ignore_patterns(".gdignore", web.VERSION_FILE))
             share_engine(out, target)
             log(f"  {g.slug}: built (web export {seconds:.1f}s)")
+    shutil.copy2(TOUCH_JS, out / "touch.js")  # every game page loads it (before the browser check)
     built = [g for g in games if (out / g.slug / "index.html").exists()]
     if screenshots:
         if webcheck.find_chrome() is None:
@@ -178,7 +205,7 @@ def index_html(games: list[Game]) -> str:
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Spawn Point demos</title>
-<meta name="description" content="Five Godot 4 games built with Spawn Point: platformers, a bubble shooter, a survivor. Play in your browser.">
+<meta name="description" content="Nine Godot 4 games built with Spawn Point: platformers, a sword fighter, tower defense, a space shooter, a bubble shooter, a survivor, a farm. Play in your browser.">
 <meta property="og:title" content="Spawn Point demos: play Godot games in your browser">
 <meta property="og:description" content="A Mario-style platformer, a ninja rescue, a dinosaur-egg shooter, a survivor and an arena, all built from Spawn Point components.">
 <style>
@@ -217,8 +244,8 @@ footer {{ color:var(--muted); font-size:13px; padding-bottom:40px }}
 <body>
 <header>
   <h1>Spawn<span>Point</span> demos</h1>
-  <p class="lede">Five games, five ways to play, all built by Spawn Point from small JSON game graphs and a
-  library of tested Godot 4 components: game feel, pixel art and collisions come for free. Click a card to play in
+  <p class="lede">Nine games, nine ways to play, all built by Spawn Point from small JSON game graphs and a
+  library of tested Godot 4 components: game feel, cartoon or pixel art and collisions come for free. Click a card to play in
   your browser, no install needed.</p>
   <div class="links">
     <a href="{REPO}">⭐ GitHub repo</a>

spawnpoint_studio-0.3.1/compiler/spawnpoint/demo_touch.js

@@ -0,0 +1,118 @@
+// Touch controls for the Spawn Point demo games (phones and tablets).
+// Each game page sets window.SP_TOUCH = {pad: "lr" | "dpad" | null, buttons: [[label, code], ...], tap: "hint"}.
+// Buttons send the same keyboard events a keyboard would, straight to Godot's canvas, so the games need no
+// changes; taps on the canvas itself reach Godot as mouse clicks (aiming, upgrade cards).
+(function () {
+  var cfg = window.SP_TOUCH || {};
+  var coarse = window.matchMedia && matchMedia("(pointer: coarse)").matches;
+  var forced = location.search.indexOf("touch") >= 0;  // ?touch shows the controls on a desktop (testing)
+  if (!(coarse || forced || "ontouchstart" in window) || location.search.indexOf("shot") >= 0) return;
+
+  var KEYS = {Space: " ", ShiftLeft: "Shift", KeyX: "x", KeyR: "r", KeyE: "e", Digit1: "1", Digit2: "2", Digit3: "3",
+              ArrowLeft: "ArrowLeft",
+              ArrowRight: "ArrowRight", ArrowUp: "ArrowUp", ArrowDown: "ArrowDown"};
+  var held = {};
+  function send(code, on) {
+    if (!!held[code] === on) return;
+    held[code] = on;
+    var canvas = document.getElementById("canvas");
+    if (!canvas) return;
+    canvas.dispatchEvent(new KeyboardEvent(on ? "keydown" : "keyup",
+      {code: code, key: KEYS[code] || code, bubbles: true, cancelable: true}));
+  }
+
+  var css = document.createElement("style");
+  css.textContent =
+    ".sp-touch{position:fixed;z-index:20;display:flex;gap:12px;user-select:none;-webkit-user-select:none;touch-action:none}" +
+    ".sp-btn{width:64px;height:64px;border-radius:50%;background:rgba(255,255,255,.16);border:2px solid rgba(255,255,255,.45);" +
+    "color:#fff;font:700 14px/60px ui-monospace,Menlo,monospace;text-align:center;touch-action:none}" +
+    ".sp-btn.big{width:84px;height:84px;line-height:80px;font-size:16px}.sp-btn.on{background:rgba(255,236,39,.45)}" +
+    ".sp-pad{width:136px;height:136px;border-radius:50%;background:rgba(255,255,255,.12);border:2px solid rgba(255,255,255,.4);" +
+    "position:relative;touch-action:none}.sp-knob{position:absolute;left:43px;top:43px;width:46px;height:46px;border-radius:50%;" +
+    "background:rgba(255,255,255,.5)}#sp-rotate{position:fixed;inset:0;z-index:30;display:none;align-items:center;" +
+    "justify-content:center;background:#14121c;color:#fff;font:600 18px system-ui;text-align:center;padding:24px}" +
+    "@media (orientation:portrait){#sp-rotate{display:flex}}#sp-hint{position:fixed;left:50%;top:40%;z-index:20;" +
+    "transform:translateX(-50%);color:#fff;background:rgba(0,0,0,.55);padding:8px 14px;border-radius:8px;" +
+    "font:600 14px system-ui;pointer-events:none;transition:opacity 1s}#sp-bar span{display:none}";  // keyboard help hides
+  document.head.appendChild(css);
+
+  function button(label, code, big) {
+    var b = document.createElement("div");
+    b.className = "sp-btn" + (big ? " big" : "");
+    b.textContent = label;
+    b.addEventListener("pointerdown", function (e) {
+      e.preventDefault();
+      b.setPointerCapture(e.pointerId);
+      b.classList.add("on");
+      send(code, true);
+    });
+    ["pointerup", "pointercancel", "lostpointercapture"].forEach(function (t) {
+      b.addEventListener(t, function () { b.classList.remove("on"); send(code, false); });
+    });
+    return b;
+  }
+
+  function dpad() {
+    var pad = document.createElement("div"), knob = document.createElement("div");
+    pad.className = "sp-pad";
+    knob.className = "sp-knob";
+    pad.appendChild(knob);
+    function update(e) {
+      var r = pad.getBoundingClientRect();
+      var dx = (e.clientX - r.left - r.width / 2) / (r.width / 2);
+      var dy = (e.clientY - r.top - r.height / 2) / (r.height / 2);
+      var len = Math.sqrt(dx * dx + dy * dy) || 1, k = Math.min(1, len) / len;
+      knob.style.transform = "translate(" + dx * k * 45 + "px," + dy * k * 45 + "px)";
+      send("ArrowLeft", dx < -0.35); send("ArrowRight", dx > 0.35);
+      send("ArrowUp", dy < -0.35); send("ArrowDown", dy > 0.35);
+    }
+    function release() {
+      knob.style.transform = "";
+      ["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown"].forEach(function (c) { send(c, false); });
+    }
+    pad.addEventListener("pointerdown", function (e) { e.preventDefault(); pad.setPointerCapture(e.pointerId); update(e); });
+    pad.addEventListener("pointermove", function (e) { if (pad.hasPointerCapture(e.pointerId)) update(e); });
+    ["pointerup", "pointercancel", "lostpointercapture"].forEach(function (t) { pad.addEventListener(t, release); });
+    return pad;
+  }
+
+  addEventListener("DOMContentLoaded", function () {
+    var rotate = document.createElement("div");
+    rotate.id = "sp-rotate";
+    rotate.textContent = "Turn your phone sideways to play ↻";
+    document.body.appendChild(rotate);
+
+    var left = document.createElement("div");
+    left.className = "sp-touch";
+    left.style.cssText = "left:18px;bottom:64px";
+    if (cfg.pad === "lr") {
+      left.appendChild(button("◀", "ArrowLeft", true));
+      left.appendChild(button("▶", "ArrowRight", true));
+    } else if (cfg.pad === "dpad") {
+      left.appendChild(dpad());
+    }
+    document.body.appendChild(left);
+
+    var right = document.createElement("div");
+    right.className = "sp-touch";
+    right.style.cssText = "right:18px;bottom:64px;flex-direction:row-reverse;align-items:flex-end";
+    (cfg.buttons || []).forEach(function (b, i) { right.appendChild(button(b[0], b[1], i === 0)); });
+    document.body.appendChild(right);
+
+    var restart = document.createElement("div");
+    restart.className = "sp-touch";
+    restart.style.cssText = "right:14px;top:48px";
+    var r = button("↻", "KeyR");
+    r.style.cssText = "width:44px;height:44px;line-height:40px;font-size:20px";
+    restart.appendChild(r);
+    document.body.appendChild(restart);
+
+    if (cfg.tap) {
+      var hint = document.createElement("div");
+      hint.id = "sp-hint";
+      hint.textContent = cfg.tap;
+      document.body.appendChild(hint);
+      setTimeout(function () { hint.style.opacity = "0"; }, 3500);
+    }
+  });
+})();