aldegad/sprite-gen

これは何？

主な機能

• 011枚の元画像から、キャラクターの一貫性を保ちながらスプライトの各状態を行ごとに生成します。
• 02クロマキー背景を実際のアルファに変換し、きれいな透過フレームを抽出します。
• 03フレーム矩形、fps、ループフラグを記載したmanifest.json付きのランタイムアトラスを出力します。
• 04動画モデルを使い、動作状態ごとに透過アニメーションループを生成します。
• 05書き出し前にフレームの確認、微調整、プレビューができるキュレーション用Webビューを備えています。
• 06再着色に対応し、PhaserやFlameなどのエンジン向けにAseprite JSON形式でエクスポートできます。

ユースケース

• 1枚のキャラクターイラストから、2Dゲーム用の待機、歩行、攻撃、ジャンプのスプライト一式を作成する。
• 動画モデルを使い、1枚の静止画から透過ループアニメーションを生成する。
• 既存のスプライトシートを再着色し、複数のパレットバリエーションを作成する。
• Aseprite JSONを介してスプライトアトラスをPhaserまたはFlame向けにエクスポートする。

クイックスタート

1. 1

   Python仮想環境を作成して有効化する

   python3 -m venv .venv && source .venv/bin/activate
2. 2

   sprite-genを編集可能モードでインストールする

   pip install -e .
3. 3

   CLIが実行できることを確認する

   sprite-gen --help

使う前に知っておきたいこと

• !画像と動画の生成には、CodexまたはGrokのサブスクリプションへのログイン、あるいはXAI_API_KEYなどのAPIキーが必要です。
• !動画ループの作成には、ffmpegとimg2webpも別途インストールする必要があります。
• !モーションQAに合格しない限り、歩行・走行ループは実験的な機能です。また、方向補正はオプトイン方式で、誤ることがあります。

収録されている特集

トピック

よくある質問

sprite-gen とは？

Codex/Claude向けスキルとPython CLI。1枚の元画像から、ゲーム用の2Dスプライトアトラスや透過アニメーションループを生成します。 sprite-genは、AI画像モデルによくある問題に対応します。スプライトシートを生成するよう指示すると、フレームごとにキャラクターの見た目が変わったり、背景をきれいに抜けなかったり、ゲームエンジンでそのまま使えないPNGが出力されたりします。このツールは1枚の元画像から始め、キャラクターの一貫性を保ちながらアニメーションの各状態を行ごとに生成し、クロマキー背景を実際のアルファに変換して、各ポーズを透過フレームとして抽出します。

sprite-gen は無料で使えますか？ライセンスは？

sprite-gen は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

sprite-gen は今もメンテナンスされていますか？

活発にメンテナンス中。sprite-gen の最終コミットは 2026年11月6日 です。

sprite-gen は何に使えますか？

1枚のキャラクターイラストから、2Dゲーム用の待機、歩行、攻撃、ジャンプのスプライト一式を作成する。 動画モデルを使い、1枚の静止画から透過ループアニメーションを生成する。 既存のスプライトシートを再着色し、複数のパレットバリエーションを作成する。 Aseprite JSONを介してスプライトアトラスをPhaserまたはFlame向けにエクスポートする。

sprite-gen のインストール方法は？

Python仮想環境を作成して有効化する: python3 -m venv .venv && source .venv/bin/activate sprite-genを編集可能モードでインストールする: pip install -e . CLIが実行できることを確認する: sprite-gen --help

sprite-gen はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/aldegad/sprite-gen