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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawnpoint-studio
-Version: 0.3.1
+Version: 0.3.3
 Summary: Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU.
 Author: smoky1496
 License: MIT
@@ -33,7 +33,7 @@ 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/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/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">
@@ -42,10 +42,10 @@ Dynamic: license-file
   <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>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.
+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"><b><a href="https://leluong141996-dev.github.io/Spawn-Point/">▶ Play the demos in your browser</a></b>: a Mario-style platformer, a cartoon
+<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
 they work on phones too (touch controls).</p>
@@ -169,10 +169,12 @@ use `--no-web` to skip and play natively with `spawnpoint run`.
 
 ## Sprites: generated or your own
 
-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
+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>
+
+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, a sword-wielder holds a sword).
 Every sprite has idle / run / jump / fall / hurt animations driven automatically by an `Animator` component, plus
@@ -204,8 +206,14 @@ spawnpoint sprites import hero.png --grid 32x32 --anim idle=0-3 --anim run=4-9
 spawnpoint sprites import sheet.png --rows idle,run,jump           # auto-sliced by transparent gutters
 spawnpoint sprites import kenney_frames/                           # idle_0.png, walk_1.png, ...
 spawnpoint sprites preview assets/sprites/Knight.sprite.json       # contact sheet + collision outline
+spawnpoint sprites gallery --style fine -o gallery.png             # every kind on one sheet, for review
+spawnpoint sprites parade --set monsters -o monsters.gif           # an animated sheet of characters, monsters or items
 ```
 
+Names pick the art: `Knight` gets a helmet and shield, `SkeletonArcher` a skull and a bow (and shoots
+arrows), `HealthPotion` is a potion, `GoldKey` a key. Layer 2 scatters trees, bushes and rocks that
+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_studio-0.3.1 → spawnpoint_studio-0.3.3}/README.md

@@ -9,7 +9,7 @@
 [![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/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/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">
@@ -18,10 +18,10 @@
   <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>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.
+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"><b><a href="https://leluong141996-dev.github.io/Spawn-Point/">▶ Play the demos in your browser</a></b>: a Mario-style platformer, a cartoon
+<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
 they work on phones too (touch controls).</p>
@@ -145,10 +145,12 @@ use `--no-web` to skip and play natively with `spawnpoint run`.
 
 ## Sprites: generated or your own
 
-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
+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>
+
+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, a sword-wielder holds a sword).
 Every sprite has idle / run / jump / fall / hurt animations driven automatically by an `Animator` component, plus
@@ -180,8 +182,14 @@ spawnpoint sprites import hero.png --grid 32x32 --anim idle=0-3 --anim run=4-9
 spawnpoint sprites import sheet.png --rows idle,run,jump           # auto-sliced by transparent gutters
 spawnpoint sprites import kenney_frames/                           # idle_0.png, walk_1.png, ...
 spawnpoint sprites preview assets/sprites/Knight.sprite.json       # contact sheet + collision outline
+spawnpoint sprites gallery --style fine -o gallery.png             # every kind on one sheet, for review
+spawnpoint sprites parade --set monsters -o monsters.gif           # an animated sheet of characters, monsters or items
 ```
 
+Names pick the art: `Knight` gets a helmet and shield, `SkeletonArcher` a skull and a bow (and shoots
+arrows), `HealthPotion` is a potion, `GoldKey` a key. Layer 2 scatters trees, bushes and rocks that
+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_studio-0.3.1 → spawnpoint_studio-0.3.3}/compiler/spawnpoint/analyze.py

@@ -347,6 +347,7 @@ class _Analyzer:
                 "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,
+                "z": -1 if ent.decor else 0,
             })
             entities[-1]["components"] = comps
 
@@ -413,6 +414,8 @@ class _Analyzer:
         }
 
     def _layer(self, ent: Entity, team: str) -> int:
+        if ent.decor:
+            return 0
         if ent.body == "character":
             return {"player": L_PLAYER, "enemy": L_ENEMY}.get(team, 0)
         if ent.body == "static":
@@ -420,6 +423,8 @@ class _Analyzer:
         return 0 if "Projectile" in ent.components else L_PICKUP
 
     def _mask(self, ent: Entity) -> int:
+        if ent.decor:
+            return 0
         if ent.body == "character":
             return L_WORLD
         if ent.body == "static":

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

@@ -121,6 +121,12 @@ def main(argv: list[str] | None = None) -> int:
     sv2.add_argument("sprite", type=Path)
     sv2.add_argument("-o", "--out", type=Path)
     sps.add_parser("kinds", help="list the procedural sprite kinds")
+    sga = sps.add_parser("gallery", help="render one contact sheet of every procedural kind, for review")
+    sga.add_argument("--style", choices=["pixel", "fine", "cartoon"], default="fine")
+    sga.add_argument("-o", "--out", type=Path, default=Path("sprite-gallery.png"))
+    spa = sps.add_parser("parade", help="render an animated sheet (GIF) of characters, monsters or items")
+    spa.add_argument("--set", dest="which", choices=["heroes", "monsters", "items"], default="heroes")
+    spa.add_argument("-o", "--out", type=Path, default=Path("sprite-parade.gif"))
 
     ds = sub.add_parser("dataset", help="recorded fine-tuning data")
     ds.add_argument("action", choices=["stats", "path"])
@@ -272,6 +278,17 @@ def _sprites(args) -> int:
             for k, spec in gen.KINDS.items():
                 print(f"{k:<8} {spec.size[0]}x{spec.size[1]} px  animations: {', '.join(spec.anims)}")
             return 0
+        if args.sprites_cmd == "parade":
+            from .sprites.gallery import parade
+            frames = parade(args.which)
+            frames[0].save(args.out, save_all=True, append_images=frames[1:], duration=100, loop=0, optimize=True)
+            print(f"Wrote {args.out}")
+            return 0
+        if args.sprites_cmd == "gallery":
+            from .sprites.gallery import gallery
+            gallery(args.style).save(args.out)
+            print(f"Wrote {args.out}")
+            return 0
         if args.sprites_cmd == "preview":
             s = load(args.sprite)
             out = args.out or args.sprite.with_suffix("").with_suffix(".preview.png")

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

@@ -75,6 +75,7 @@ class Entity(_Model):
     sprite: Union[str, SpriteRef, None] = None
     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")
 
 
 class Level(_Model):

{spawnpoint_studio-0.3.1 → spawnpoint_studio-0.3.3}/compiler/spawnpoint/sprites/ai.py

@@ -42,6 +42,12 @@ KIND_HINT = {
     "heart": "a single heart pickup", "orb": "a single glowing orb", "door": "a tall wooden door",
     "exit": "a glowing exit doorway", "portal": "a swirling magic portal", "spikes": "a row of metal spikes",
     "bullet": "a small glowing projectile",
+    "beast": "a small four-legged animal, side view", "spider": "a small spider, side view",
+    "dragon": "a small winged dragon, side view", "ghost": "a small floating ghost", "snake": "a small snake, side view",
+    "key": "a single golden key", "potion": "a single potion bottle with a cork", "scroll": "a single rolled paper scroll",
+    "bomb": "a single round black bomb with a lit fuse", "chest": "a single wooden treasure chest",
+    "arrow": "a single arrow pointing right", "tree": "a single tree", "bush": "a single round bush",
+    "rock": "a single boulder",
 }