@kpanks/game-assets

@kpanks/game-assets

One spec → runnable Godot 4.4 project. Sprites, textures, music, SFX, scene tree, controller stub.

Charter-driven game-asset pipeline for Praetor. Same adapter contract as @kpanks/ugc — every stage has a paid backend (best quality) and a zero-cost fallback so a charter can keep running when API credits are exhausted.

Install

npm i @kpanks/game-assets

Quick start

import { defaultRenderer, specFromGoal } from "@kpanks/game-assets";

const r = defaultRenderer({ outDir: "out" });
const result = await r.render(
  specFromGoal({ id: "fox-run", goal: "A 2D platformer about a fox who collects stars" })
);

// result.outputDir is a folder Godot 4.4 can open directly
console.log(result.outputDir);
console.log(result.costUsd); // 0 on the default zero-cost path

Backends (April 2026 list prices)

Stage	Backend	Per-clip cost (default counts)	Env key
Concept	openai-image	$0.04	OPENAI_API_KEY
Concept	fal-flux	$0.025	FAL_KEY
Concept	reuse (default)	$0	—
Sprite	nano-banana-bg-removed	$0.04 × frames (default 4)	FAL_KEY
Sprite	openai-image	$0.04 × frames	OPENAI_API_KEY
Sprite	aseprite-template (default)	$0	—
Texture	fal-flux-tileable	$0.025 × tiles (default 6)	FAL_KEY
Texture	noise-procedural (default)	$0	—
Music	suno-api	$0.30 / 60s loop	SUNO_API_KEY
Music	elevenlabs-music	$0.25 / 60s loop	ELEVENLABS_API_KEY
Music	silent (default)	$0	—
SFX	elevenlabs-sfx	$0.018 × cues (default 6)	ELEVENLABS_API_KEY
SFX	sfxr-presets	$0	—
SFX	silent (default)	$0	—
Code	anthropic-claude	~$0.45 / controller	ANTHROPIC_API_KEY
Code	static-template (default)	$0	—

Default total: $0. Maxed-out paid path with 4 sprite frames + 6 tiles + 6 SFX cues: ~$1.21.

Output

The renderer writes a folder Godot 4.4 can open directly:

out/games/<spec.id>/
├── project.godot          # Godot project manifest
├── Main.tscn              # Root scene
├── controller.gd          # 4-direction Sprite2D controller
├── concept.png            # Concept art
├── sprites/
│   └── sheet_4f.png       # 4-direction character sheet
├── textures/
│   ├── tile_0.png         # Seamless environment tiles
│   └── …
├── music.mp3              # (optional) loop
└── sfx/
    ├── jump.wav
    ├── hit.wav
    └── …

Open the folder in Godot 4.4 → press F5 → playable.

Custom adapters

import { GameAssetsRendererImpl } from "@kpanks/game-assets";

const r = new GameAssetsRendererImpl({
  concept: { "openai-image": myOpenAIAdapter },
  sprite: { "nano-banana-bg-removed": myFalAdapter },
  texture: {},
  music: { "suno-api": mySunoAdapter },
  sfx: { "elevenlabs-sfx": myElevenLabsSfxAdapter },
  code: { "anthropic-claude": myClaudeAdapter },
  outDir: "out",
});

const result = await r.render(spec, {
  concept: "openai-image",
  sprite: "nano-banana-bg-removed",
  music: "suno-api",
  sfx: "elevenlabs-sfx",
  code: "anthropic-claude",
});

Any stage without a wired backend falls back to its free-tier built-in (transparent PNG + silent audio + static template controller).

Canonical SFX cues

Six cues are defined by default — jump, hit, pickup, ui_confirm, ui_cancel, music_sting. Override with spec.sfxNames for genre-specific cues.

License

MIT