README.md

---
license: apache-2.0
language: [en, vi]
library_name: transformers
tags: [gamedev, godot, json, spawn-point, awq]
---

# SpawnPoint-Coder-7B

> **Status:** Spawn Point is finished and no longer actively developed ([what I built and why I stopped](https://github.com/leluong141996-dev/Spawn-Point/blob/main/docs/retrospective.md)); the model and the tool stay available. **Want a genre or a feature? [Open a Discussion](https://huggingface.co/smoky1496/SpawnPoint-Coder-7B-AWQ/discussions).** If real requests come in, I'll pick it back up.

**A 7B model that generates Godot 4 games.** Fine-tuned for [Spawn Point](https://github.com/leluong141996-dev/Spawn-Point),
an open-source autonomous game studio: you describe a game in plain English or Vietnamese, the model writes
the game design as strict JSON, and Spawn Point compiles it into a playable Godot 4 project (scenes, GDScript
components, levels, sprites) that runs on desktop or in the browser.

What it does inside the pipeline:

- **Design**: game idea → the game's design (one small schema per genre: character, abilities, enemies, goal, art style, feel).
- **Tweak**: "jump 20% higher, add a sword, make it cartoon" → a precise patch of the game.
- **Edit an entity**: "double its health and make it shoot fireballs" → component and parameter changes.

4-bit AWQ, runs on a single 12 GB GPU.

**What's new in v6, v5.2, v5.1 and v5**
- **v6** designs **card games** (Slay the Spire style deckbuilders): "a deckbuilder where a wizard climbs a frozen
  tower full of ice spirits", "game thẻ bài kiểu Slay the Spire, hiệp sĩ đánh lũ xương khô, trùm cuối là Lich". It picks
  the hero and its class (warrior, mage, rogue), the game's own cards and what each does (big hits, sweeps, poison,
  shields, healing...), the foes and how they fight (brutes, guards, casters, swarms) and the boss. "Upgrade cards" in
  a survivor or "key cards" in a shooter stay what they were.
- **v5.2** catches farm pests mentioned only in passing ("game nông trại mùa đông, có cáo", "a farm with a fox around"),
  keeps a named farmer ("a cat farmer"), and leaves a peaceful farm without pests.
- **v5.1** fixes prompts that name the player only indirectly ("a tank shooting monsters": the tank is now the hero,
  not the default "Hero").
- **Side-scrolling shooters** ("a falcon ship fights drones and saucers, the boss is a mothership"): enemies that
  fly straight, in waves, dive at you or stop and shoot; power-ups; a boss.
- **Vietnamese is read directly**: no separate translation step, so names come out right ("chú vịt" is a Duck).
- **One small schema per genre**: shorter answers and prompts (a third of the v4 prompt) and no cross-genre
  mistakes such as a rescue target in a farm.
- Fixes from v4: "a wizard shooting skeletons" keeps the shoot ability, "collect coins" is a collect goal, an unnamed
  pickup is a Coin.

**Needs Spawn Point 0.4 or later for card games** (0.3 or later for the rest): v5 and later answer in the per-genre
format. Older Spawn Point versions expect the v4 format; use release `v4-release` of this repo with them.

## Run it

```bash
docker run --gpus all -p 8000:8000 --ipc=host vllm/vllm-openai:v0.10.2 \
  --model smoky1496/SpawnPoint-Coder-7B-AWQ --served-model-name SpawnPoint-Coder-7B --max-model-len 16384 --gpu-memory-utilization 0.85
```

Then Spawn Point finds it automatically at `http://localhost:8000/v1`.

## Evaluation

Hand-written prompts in English and Vietnamese through the whole pipeline, same server and sampling for both versions.
Sealed sets were written before training and not looked at until the release decision. The first two rows include
prompts about the genre v4 did not know, so v4 cannot be expected to answer them.

| benchmark (prompts fully right) | v4 | v5.2 | v6 (this release) |
|---|---|---|---|
| **sealed set: card games** (16 prompts) | - | 56% | 94% |
| sealed set: farm pests named in passing (16 prompts) | - | 100% | 100% |
| sealed set: shooters and the v4 fixes (16 prompts) | 56% | 88% | 88% |
| dev set: shooters and the v4 fixes (24 prompts) | 54% | 79% | 88% |
| sealed set: farms, tower defense, cartoon (12 prompts) | 67% | 92% | 83% |
| 16 prompts: farms, tower defense, melee, cartoon | 75% | 81% | 94% |
| sealed set: the first nine genres (12 prompts) | 67% | 75% | 83% |
| 30 human-written prompts | 87% | 87% | 90% |
| 12 prompts: bubble, rescue, survivor | 92% | 92% | 75% |

**Where v6 is a little behind v5.2**: the 12-prompt bubble / rescue / survivor set (two prompts, both names in a bubble
shooter: the shooter or the egg) and the 12-prompt sealed farms / tower defense set (one prompt), and exact synthetic
briefs (70% against 77%). Results vary by one to three prompts per set from run to run, so read differences of one or
two prompts as noise.

Held-out synthetic examples with one exact answer (v5 format only): briefs 70%, tweaks 98%, entity edits 96%.

The 4-bit AWQ files you download, measured the same way:

| benchmark (prompts fully right) | AWQ build |
|---|---|
| **sealed set: card games** (16 prompts) | 94% |
| 30 human-written prompts | 87% |
| sealed set: farm pests named in passing (16 prompts) | 100% |
| sealed set: shooters and the v4 fixes (16 prompts) | 81% |

## Limitations

- Fine-tuned only for the 2D game kinds Spawn Point builds: **platformers (including rescue missions and sword
  fighting), top-down arenas and survivors, bubble shooters, farming games, tower defense, side-scrolling
  shooters and card games**. Other genres (3D, RPG systems, racing…) and free-form Godot coding were not part of the
  training data, so expect results no better than a general 7B coder model there.
- Prompts that do not say the genre can be read either way ("a space shooter" may come out as a side-scrolling
  shooter, "a farm game" as a farming game).
- It writes Spawn Point's JSON formats; the GDScript itself comes from Spawn Point's tested component
  library, not from the model. Outside Spawn Point it is a general coding model with a narrow specialty.
- Occasionally one detail of a request is missed (an enemy's name, a palette); Spawn Point's validator and
  normalizer catch most of these.

## License

Apache 2.0, see `LICENSE` and `NOTICE`.