dsh-sprite-gen

Sprite Sheet Generator with AI Image Generation for DeepSeek Harness.

Features

• ?? AI Image Generation - Generate sprites directly with AI
• ?? 4 Providers - Gemini Flash, Stable Diffusion, Agnes AI, ComfyUI (local)
• ?? Auto-crop - Automatically remove transparent edges
• ?? Grid Arrangement - Configurable sprite sheet layouts
• ?? Cutout + Validation - Distance-threshold background removal with bbox crop, scale, and quality checks
• ?? Animation Sequences - Multi-frame walk/jump/attack/idle with reference consistency
• ??? Parallax Backgrounds - 3-layer side-scroller backgrounds (sky/mid/foreground)
• ?? Effects Generation - Bullets, fire, explosions, smoke, sparks
• ?? Weapon/Equipment Sprites - Guns, swords, armor, helmets
• ?? Batch Generation - Generate multiple assets in one call
• ?? GIF Export - Export sprite sheets to animated GIF for preview

Supported Providers

Installation

# From GitHub
dsh plugin --profile web add github:randomix777/dsh-sprite-gen

# Manual
cd ~/.dsh/profiles/web
pnpm add file:/path/to/dsh-sprite-gen

Available Tools

Core Tools

Animation & Effects

Advanced

Character Consistency

Props & Scene Objects

Terrain & Platforms

Preview

Usage Examples

Generate Character with Animation

// 1. Generate base character
sprite_generate_image({
  prompt: "female survivor pixel art character, idle pose, detailed 32-bit pixel art",
  provider: "agnes",
  width: 1024, height: 1536,
  output_path: "./sprites/player_base.png"
})

// 2. Cutout and validate
sprite_cutout({
  image_path: "./sprites/player_base.png",
  output_path: "./sprites/player_clean.png",
  target_width: 512, target_height: 768
})

// 3. Generate walk cycle
sprite_animation_sequence({
  sequence: "player_run",
  reference_image_path: "./sprites/player_clean.png",
  output_path: "./sprites/player_run.png"
})

// 4. Generate jump animation
sprite_animation_sequence({
  sequence: "player_jump",
  reference_image_path: "./sprites/player_clean.png",
  output_path: "./sprites/player_jump.png"
})

// 5. Generate attack animation
sprite_animation_sequence({
  sequence: "player_shoot",
  reference_image_path: "./sprites/player_clean.png",
  output_path: "./sprites/player_shoot.png"
})

Generate Effects

// List available effects
sprite_effect_list()

// Generate bullet effects
sprite_generate_effect({ effect: "bullet_trail", output_path: "./effects/bullet.png" })
sprite_generate_effect({ effect: "bullet_impact", output_path: "./effects/impact.png" })
sprite_generate_effect({ effect: "fire_explosion", output_path: "./effects/explosion.png" })

Generate Weapons

// List weapons
sprite_weapon_list()

// Generate weapon sprites
sprite_generate_weapon({ weapon: "assault_rifle", output_path: "./weapons/rifle.png" })
sprite_generate_weapon({ weapon: "pistol_9mm", output_path: "./weapons/pistol.png" })

Batch Generation

// Generate multiple characters at once
sprite_batch_generate({
  provider: "agnes",
  items: [
    { prompt: "female survivor pixel art", output_path: "./sprites/female.png" },
    { prompt: "male raider pixel art", output_path: "./sprites/raider.png" },
    { prompt: "zombie enemy pixel art", output_path: "./sprites/zombie.png" },
  ]
})

Parallax Background

sprite_generate_background({
  character_prompt: "post-apocalyptic survivor in wasteland",
  character_image_url: "https://example.com/character.png",
  provider: "agnes"
})

Export to GIF

// Convert a sprite sheet PNG to animated GIF
sprite_gif_export({
  image_path: "./sprites/player_walk.png",
  output_path: "./sprites/player_walk.gif",
  fps: 12,
  grid_cols: 4,
  grid_rows: 1
})

ComfyUI (Local SD)

// Ensure ComfyUI is running on http://127.0.0.1:8188
sprite_generate_image({
  prompt: "pixel art character sprite",
  provider: "comfy",
  width: 512, height: 512
})

Configuration

// Set Agnes API key
sprite_sprite_config({
  action: "set_key",
  provider: "agnes",
  api_key: "your_key_here"
})

// Switch default provider
sprite_sprite_config({ action: "set_provider", provider: "agnes" })

// List providers
sprite_sprite_config({ action: "list" })

Godot Integration

1. Import the generated PNG into your Godot project
2. Add a SpriteFrames node
3. Create a new resource, import the PNG
4. Enable Region in the inspector
5. Set Region Rect to single cell size
6. Set H Frames and V Frames to grid dimensions

Requirements

• Node.js >= 18
• Python 3.8+
• Pillow + NumPy

pip install Pillow numpy

Development

# Install dependencies
npm install

# Build client bundle
npm run build-client

# Test
node scripts/validate.mjs

# Pack for publishing
npm pack

License

MIT