spawnpoint-studio 0.3.0__tar.gz → 0.3.2__tar.gz

{spawnpoint_studio-0.3.0/compiler/spawnpoint_studio.egg-info → spawnpoint_studio-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawnpoint-studio
-Version: 0.3.0
+Version: 0.3.2
 Summary: Turn a sentence into a juicy, playable Godot 4 game — locally, on a consumer GPU.
 Author: smoky1496
 License: MIT
@@ -156,7 +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). v5 adds **side-scrolling shooters** (flight patterns, power-ups, a boss), reads **Vietnamese prompts directly** and writes a small per-genre format instead of one big form. The downloadable AWQ build gets 75% of a sealed set of 16 human-written prompts for shooters and the v4 fixes fully right, and 77% of 30 human-written game ideas in English and Vietnamese (v4 scored a bit higher on its older sets; the model card lists every number and where v5 is behind). The GGUF Q4_K_M build scores 73% 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"). 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`.
 
@@ -204,8 +204,13 @@ 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 cartoon -o gallery.png          # every kind on one sheet, for review
 ```
 
+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.0 → spawnpoint_studio-0.3.2}/README.md

@@ -132,7 +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). v5 adds **side-scrolling shooters** (flight patterns, power-ups, a boss), reads **Vietnamese prompts directly** and writes a small per-genre format instead of one big form. The downloadable AWQ build gets 75% of a sealed set of 16 human-written prompts for shooters and the v4 fixes fully right, and 77% of 30 human-written game ideas in English and Vietnamese (v4 scored a bit higher on its older sets; the model card lists every number and where v5 is behind). The GGUF Q4_K_M build scores 73% 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"). 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`.
 
@@ -180,8 +180,13 @@ 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 cartoon -o gallery.png          # every kind on one sheet, for review
 ```
 
+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.0 → spawnpoint_studio-0.3.2}/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.0 → spawnpoint_studio-0.3.2}/compiler/spawnpoint/cli.py

@@ -121,6 +121,9 @@ 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"))
 
     ds = sub.add_parser("dataset", help="recorded fine-tuning data")
     ds.add_argument("action", choices=["stats", "path"])
@@ -272,6 +275,11 @@ 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 == "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.0 → spawnpoint_studio-0.3.2}/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.0 → spawnpoint_studio-0.3.2}/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-release" if MODEL == DEFAULT_MODEL else "")
+REVISION = os.environ.get("SPAWNPOINT_MODEL_REVISION") or ("v5.1-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.0 → spawnpoint_studio-0.3.2}/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",
 }