NO6KIKO/gorest-2d-animation-spritesheet-generator

Gorest 2Dアニメーションスプライトシートジェネレーター

何であるか – 2Dゲームシーンの構築とアニメーション対応スプライトシートの生成に特化したオープンソース・ウェブベースのエディタ。従来のグラフィカルUIは一切なく、希望する内容を記述する（またはアセットをドラッグする）ことで、ローカルのCodex駆動エージェントがプロジェクトファイルを自動更新します。スプライトシートの生成・インポート・編集が可能で、メタデータ（アクション名、方向、ループモード、トリガーなど）を付与し、ブラウザ上で直接プレビューできます。AIプロンプトによる自動生成もオプションで利用可能です。

なぜ重要か – 2Dゲームアセットの作成は通常、手作業のプロセス（フレームを描画 → シートに組み立てる → メタデータを追加 → ゲームエンジンにインポート）を経ます。Gorestはこのプロセスを自動化します。Codexにプロンプトを送信するだけで、完全な透明PNGスプライトシートが生成され、アプリは即座に再生プレビューを表示。ブラウザから離れることなく、レイヤー順序、シーン構成、インタラクションデータの調整が可能です。また、「フェイク3D」ビューアーも搭載しており、事前にレンダリングされたスプライトシートを回転させることで3Dオブジェクトのような錯覚を演出します。

主な機能

• シーンコンポーザー – 背景、キャラクター、小物、UI要素、アニメーションスプライトを個別レイヤーとして自由に配置できるキャンバス。
• スプライトシートページ – 現在のシーンで使用されているすべてのシートを一覧表示。プレビュー、ダウンロード、クリップごとのメタデータ編集が可能。
• Codex支援ワークフロー – 自然言語プロンプト（例：「16フレームの金魚鉢のスプライトシートを生成」）を入力すると、ローカルエージェントが自動的にアセットを生成または更新。
• メタデータ豊富なアセット – 各クリップには役割、クリップ名、トリガータイプ/値、ゲーム状態、方向、ループモード、タグ、およびオプションのviewMode（フェイク3D回転用）が保存。
• フェイク3Dオブジェクト回転 – スプライトシートを回転テーブルのように表示でき、方位角/仰角のフレーム、感度、自動回転をカスタマイズ可能。
• ローカル優先ストレージ – 生成されたPNGファイルとgame_asset_library.jsonはpublic/generated/に保存され、プロトタイプが完全に自己完結するようになっています。
• キーボードショートカット – 標準的なコピー/ペースト、元に戻す/やり直し、複製、削除など、迅速なシーン編集に対応。
• デプロイ可能 – 開発用はnpm run dev、本番用はnpm run build + npm startで実行可能。

一般的な利用シーン

1. 迅速なプロトタイピング – デザイナーはサイドスクロールレベルをスケッチし、アニメーション小物を配置して、別途エンジンにエクスポートせずにゲームの見た目を確認可能。
2. AI補助アセット作成 – アーティストはキャラクターや小物を自然言語で記述し、Codexが完全なスプライトシートを生成。その後、アプリ内で微調整可能。
3. 再利用可能なアセットライブラリ – 一度保存されたスプライトや小物は、将来の任意のシーンにドラッグアンドドロップ可能。ゲームプレイロジックに必要なメタデータも保持。
4. 教育用デモ – 教師は2DアニメーションのパイプラインやLLM駆動エージェントが反復作業を自動化する仕組みを紹介可能。

導入方法

# 1. Node.js 20+ をインストール
# 2. リポジトリをクローン
git clone https://github.com/NO6KIKO/gorest-2d-animation-spritesheet-generator.git
cd gorest-2d-animation-spritesheet-generator

# 3. 依存関係をインストール
npm install

# 4. ローカルで実行
npm run dev   # http://localhost:3000 が開く（PORT環境変数で変更可能）

アプリは完全にローカルで動作。クラウド画像生成サービスを有効化しない限り、APIキーは不要です。

ライセンス – コードはMITライセンスで公開。メディアアセット（スプライトシート、背景、デモ画像）はプレビュー用に提供されており、MITライセンスではありません。詳細はpublic/ASSET_LICENSE.mdを参照してください。

---

上記のすべての情報はリポジトリのREADMEから直接引用しており、追加機能は一切推測されていません。