character-animation-creator-skill  by tachikomared

Generates game-ready character spritesheets and animations from prompts

Created 2 months ago
268 stars

Top 95.5% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a skill for Codex and GPT Web Agents to automatically generate game-ready pixel-art character spritesheets with 8-direction animations. It targets game developers seeking to streamline the creation of 64x64 assets from text prompts or reference images, significantly reducing manual effort in asset pipelines for RPGs, roguelikes, and similar genres.

How It Works

The skill processes input (text prompt or reference image) to establish character identity, including species, class, silhouette, and palette. It then generates a canonical 64x64 base sprite and produces animation strips for idle, walk, and attack actions across all 8 cardinal and intercardinal directions. Post-generation, it applies pixel cleanup, such as palette quantization and edge snapping, validates the resulting sprite atlas for frame integrity, and packages the final spritesheet along with a QA report. This automated workflow ensures consistent, game-ready assets.

Quick Start & Requirements

  • Installation: Requires Python 3.9+ and the Pillow library (pip install Pillow).
  • Dependencies: An external image generation backend is necessary (e.g., Codex/GPT $imagegen, DALL-E, Midjourney).
  • Documentation: Full workflow details are available in SKILL.md.

Highlighted Details

  • Generates 64x64 pixel-art spritesheets with 8-direction animations (south, south-east, east, north-east, north, north-west, west, south-west).
  • Supports default animation sets: idle (4 frames), walk (6 frames), and attack (6 frames), with rows padded to 6 cells.
  • Includes utility scripts for pixel cleanup (pixel_snap.py) and sprite sheet validation (validate_64_sheet.py).
  • Default atlas dimensions are 384x1536 pixels, with options for smaller scopes like walk-only or idle-walk.

Maintenance & Community

No specific information regarding maintainers, community channels (like Discord/Slack), or project roadmap was found in the provided text.

Licensing & Compatibility

The project is released under the MIT License, which generally permits broad use, including commercial applications, with minimal restrictions beyond attribution.

Limitations & Caveats

The skill's functionality is critically dependent on the quality and capabilities of the integrated external image generation backend. Output is specifically tailored for 64x64 pixel art and the defined 8-direction animation structure, potentially requiring adaptation for different art styles or animation requirements.

Health Check
Last Commit

2 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
74 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.