godot-asset-generator

Godot Asset Generator

Generate game assets using AI image generation APIs and prepare them for use in Godot 4.x. This skill covers the complete art pipeline from concept to Godot-ready sprites.

When to Use This Skill

Use this skill when:

Generating game sprites, characters, or objects using AI
Creating tilesets for platformers or top-down games
Generating UI elements, icons, or menu assets
Batch-generating animation frames
Preparing AI-generated assets for Godot import
Creating consistent asset sets with style guides

Do NOT use this skill when:

Creating 3D models or textures (2D assets only)
Manual pixel art or illustration (use art software)
Complex frame-by-frame animation (use animation tools)
Working with existing assets (use Godot directly)

Prerequisites

Required:

Deno runtime installed
At least one API key:
- OPENAI_API_KEY for DALL-E 3
- REPLICATE_API_TOKEN for Replicate (SDXL, Flux)
- FAL_KEY for fal.ai

Optional:

ImageMagick for advanced image processing
Godot 4.x project for import file generation

Quick Start

Generate a Single Image

deno run --allow-env --allow-net --allow-write scripts/generate-image.ts \
  --provider dalle \
  --prompt "pixel art knight character, front view, 16-bit style, transparent background" \

Batch Generate Animation Frames

Create Sprite Sheet

Core Workflow

Phase 1: Style Definition

Define your art style before generating assets:

Choose Art Style: Pixel art, hand-drawn, painterly, or vector
Create Style Guide: Document colors, modifiers, and constraints
Test Prompts: Generate samples to validate style consistency

Phase 2: Asset Generation

Generate assets using the appropriate provider:

Single Assets: Use generate-image.ts for individual images
Batch Assets: Use batch-generate.ts for multiple related assets
Iterate: Refine prompts based on results

Phase 3: Post-Processing

Prepare raw AI output for game use:

Background Removal: Extract sprites from backgrounds
Color Correction: Normalize palette if needed
Resize: Scale to exact game resolution
Trim/Pad: Remove whitespace, add sprite padding

Phase 4: Godot Integration

Prepare assets for Godot import:

Pack Sprite Sheets: Combine frames into optimized sheets
Generate Import Files: Create .import with optimal settings
Configure Animations: Set up SpriteFrames resources

API Provider Selection

Provider	Best For	Quality	Cost	Speed
DALL-E 3	Consistency, high detail	Excellent	$$$	Medium
Replicate	Style control, variations	Very Good	$$	Medium
fal.ai	Fast iteration, testing	Good	$	Fast

DALL-E 3 (OpenAI)

Best for high-quality, consistent results. Excellent prompt following.

Sizes: 1024x1024, 1792x1024, 1024x1792
Quality: standard, hd
Style: vivid, natural

Replicate (SDXL/Flux)

Best for style control and cheaper batch generation.

More model options (SDXL, Flux, specialized)
Negative prompts supported
ControlNet and img2img available

fal.ai

Best for rapid iteration and testing prompts.

Fastest inference
Good for prototyping
Lower cost per image

Prompting by Art Style

Pixel Art

Key modifiers: 16-bit, 8-bit, pixel art, retro, clean pixels, no anti-aliasing

Avoid: realistic, detailed, smooth, gradient

Hand-Drawn / Illustrated

Key modifiers: hand-drawn, illustration, ink lines, sketch, watercolor

Painterly / Concept Art

Key modifiers: digital painting, concept art, painterly, brush strokes

Vector / Flat Design

Key modifiers: flat design, vector, clean edges, solid colors, minimal

Script Reference

generate-image.ts

Generate a single image from any supported provider.

batch-generate.ts

Generate multiple images from a specification file.

Batch Spec Format:

process-sprite.ts

Post-process generated images for game use.

pack-spritesheet.ts

Pack multiple sprites into a sprite sheet.

Output Metadata:

generate-import-files.ts

Generate Godot .import files with optimal settings.

Godot Import Settings

Pixel Art Sprites

HD Sprites

UI Elements

Examples

Example 1: Pixel Art Character with Walk Animation

Example 2: Tileset Generation

Example 3: UI Icons

Common Issues

API Key Not Found

Solution: Export the API key before running:

Inconsistent Style Across Batch

Problem: Generated images have different styles despite same prompt.

Solutions:

Use more specific style modifiers
Use Replicate with seed parameter for reproducibility
Generate more images and select best matches
Use img2img with reference image (Replicate)

Background Removal Fails

Problem: --remove-bg doesn't cleanly separate sprite.

Solutions:

Add "transparent background" or "white background" to prompt
Use --color-key with a specific background color
Use more explicit prompts: "isolated on transparent background"
Manual cleanup may be needed for complex images

Pixel Art Has Anti-Aliasing

Problem: Generated pixel art has smoothed edges.

Solutions:

Add "no anti-aliasing", "clean pixels" to prompt
Generate at larger size, then downscale with nearest neighbor
Use --filter nearest in process-sprite.ts
Post-process with palette reduction

Rate Limiting

Problem: API returns 429 rate limit errors.

Solutions:

Increase --delay in batch-generate.ts
Reduce --concurrency
Wait and retry
Use different provider for large batches

Additional Resources

Prompting Guides

references/prompting/pixel-art.md - Detailed pixel art techniques
references/prompting/hand-drawn.md - Illustrated style guide
references/prompting/consistent-characters.md - Character consistency

API Guides

references/api-guides/openai-dalle.md - DALL-E 3 API reference
references/api-guides/replicate-sdxl.md - Replicate integration
references/api-guides/fal-ai.md - fal.ai guide

Godot Integration

references/godot-integration/import-settings.md - Import configuration
references/godot-integration/animation-setup.md - AnimatedSprite2D setup

Templates

assets/prompts/pixel-art-templates.json - Pixel art prompt templates
assets/prompts/character-templates.json - Character prompts
assets/style-guides/style-guide-template.json - Style guide schema

Limitations

API-based only: Requires internet and API keys (no local models)
Style consistency: AI may produce variations despite same prompt
Resolution constraints: Each provider has size limits
2D assets only: Not for 3D models, textures, or complex animations
Background removal: May require manual cleanup for complex images
Cost: API calls incur charges, especially for large batches