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

Gorest 2D 動畫精靈圖集生成器

是什麼 – 一個開源、基於網頁的編輯器，用於構建 2D 遊戲場景並產生動畫就緒的精靈圖集。此工具沒有傳統意義上的圖形使用者介面；您透過描述所需內容（或拖曳資源）來工作，本地的 Codex 驅動代理會自動更新專案檔案。它能生成、匯入與編輯精靈圖集，附加元資料（動作名稱、方向、循環模式、觸發器等），並直接在瀏覽器中預覽結果。

為何重要 – 建立 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；未推測任何額外功能。