Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
docs(readme): a Steam wishlist line for Dungeon Sookuma and one sentence on walk cycles, in all six languages
Soohong Kim48eb0cb34275
diff --git a/README.es.md b/README.es.mdindex 58d4116..e0a96e0 100644--- a/README.es.md+++ b/README.es.md@@ -8,6 +8,8 @@</p>+<p align="center"><sub>Añade a tu lista de deseados de Steam <a href="https://store.steampowered.com/app/5045950/">Dungeon Sookuma</a>, un juego en desarrollo por el creador de sprite-gen con parte de su arte hecho con esta herramienta.</sub></p>+<p align="center"><a href="https://youtu.be/zVu9YlbPtog"><img src="docs/assets/hero-v2-party.gif" width="960" alt="Muestra animada de sprite-gen v2: paladín, lobo y slime" /></a></p>@@ -80,7 +82,7 @@ flowchart LR- **Un manifiesto de runtime** (`manifest.json.frame_layout`) — rectángulos de fotograma absolutos, fps por estado y banderas de bucle. Tu motor muestrea rectángulos; nunca adivina una cuadrícula.- **Breathe** — un reposo estático se convierte en un bucle vivo, con squash & stretch determinista horneado sobre tus fotogramas curados a partir de un solo campo sidecar, consciente de la anatomía y fiel al píxel ([detalles](docs/breathing.md)).- **Pixel-art que no se sale de la cuadrícula** — la Backbone Lattice mide una única cuadrícula para todo el sujeto y ajusta cada recorte a ella ([detalles](docs/pixel-unfake.md)).-- **Bucles de movimiento a partir de vídeo** — los saltos reciben un lienzo alto, los ataques uno ancho, el punto de bucle es el propio periodo del clip, y una acción de un solo disparo se corta reposo → acción → reposo ([detalles](docs/video-pipeline.md)).+- **Bucles de movimiento a partir de vídeo** — los saltos reciben un lienzo alto, los ataques uno ancho, el punto de bucle es el propio periodo del clip, y una acción de un solo disparo se corta reposo → acción → reposo. Los bucles de caminata cuentan los cruces de pies para cortar dos pasos completos y suavizar los saltos en la unión ([detalles](docs/video-pipeline.md)).- **Combinaciones de color deterministas** — `recolor` hornea N hojas variantes a partir de un mapa de paleta; misma entrada, mismos bytes de salida ([detalles](docs/recolor.md)).- **QA que puedes mirar** — GIF por estado y hojas de contacto, para que el movimiento se juzgue como movimiento antes de publicar nada. La locomoción cíclica (caminar/correr) sigue siendo experimental salvo que el QA de movimiento realmente pase.- **Herramientas de recursos independientes** — construye fondos repetibles, proyecta sombras desde un ancla de pie e inspecciona el tiempo, las poses duplicadas y la evidencia de contacto. Los pies ambiguos producen una medición no verificada ([detalles](docs/asset-tools.md)).diff --git a/README.fr.md b/README.fr.mdindex 3182c87..838dd58 100644--- a/README.fr.md+++ b/README.fr.md@@ -8,6 +8,8 @@</p>+<p align="center"><sub>Ajoutez à votre liste de souhaits Steam <a href="https://store.steampowered.com/app/5045950/">Dungeon Sookuma</a>, un jeu en cours de développement par le créateur de sprite-gen avec une partie de ses graphismes conçue avec cet outil.</sub></p>+<p align="center"><a href="https://youtu.be/zVu9YlbPtog"><img src="docs/assets/hero-v2-party.gif" width="960" alt="Démonstration animée de sprite-gen v2 : paladin, loup et slime" /></a></p>@@ -80,7 +82,7 @@ Index complet : [`docs/README.md`](docs/README.md). Architecture avec diagrammes- **Un manifeste d'exécution** (`manifest.json.frame_layout`) — rectangles de frames absolus, fps et drapeaux de boucle par état. Votre moteur échantillonne des rectangles ; il ne devine jamais une grille.- **Breathe** — une pose idle statique devient une boucle vivante, un squash & stretch déterministe cuit sur vos frames curées à partir d'un seul champ sidecar, respectueux de l'anatomie et fidèle au pixel ([détails](docs/breathing.md)).- **Du pixel-art qui reste sur la grille** — le Backbone Lattice mesure une seule grille pour l'ensemble du sujet et y maintient chaque découpe ([détails](docs/pixel-unfake.md)).-- **Des boucles d'animation issues de la vidéo** — les sauts reçoivent un canvas haut, les attaques un canvas large, le point de boucle est la période propre du clip, et une action one-shot est coupée repos → action → repos ([détails](docs/video-pipeline.md)).+- **Des boucles d'animation issues de la vidéo** — les sauts reçoivent un canvas haut, les attaques un canvas large, le point de boucle est la période propre du clip, et une action one-shot est coupée repos → action → repos. Les boucles de marche comptent les croisements de pieds pour caler un cycle de deux pas et lisser les raccords ([détails](docs/video-pipeline.md)).- **Des variantes de couleurs déterministes** — `recolor` cuit N feuilles variantes à partir d'une palette de correspondance ; même entrée, mêmes octets en sortie ([détails](docs/recolor.md)).- **Un QA que vous pouvez regarder** — des GIF et planches contact par état, pour que le mouvement soit jugé en tant que mouvement avant toute livraison. La locomotion cyclique (marche/course) reste expérimentale tant que le QA d'animation n'est pas réellement validé.- **Des outils d'assets indépendants** — construisez des fonds répétables, projetez des ombres depuis un point d'ancrage au pied, et inspectez le timing, les poses dupliquées et les preuves de contact. Des pieds ambigus produisent une mesure non vérifiée ([détails](docs/asset-tools.md)).diff --git a/README.ja.md b/README.ja.mdindex fb7cf44..abd8d6e 100644--- a/README.ja.md+++ b/README.ja.md@@ -8,6 +8,8 @@</p>+<p align="center"><sub>sprite-genの制作者がゲームアートの一部を本ツールで制作しながら開発している<a href="https://store.steampowered.com/app/5045950/">Dungeon Sookuma</a>を、Steamのウィッシュリストに追加してください。</sub></p>+<p align="center"><a href="https://youtu.be/zVu9YlbPtog"><img src="docs/assets/hero-v2-party.gif" width="960" alt="Animated sprite-gen v2 showcase: paladin, wolf and slime" /></a></p>@@ -80,7 +82,7 @@ flowchart LR- **ランタイムマニフェスト** (`manifest.json.frame_layout`) — 絶対座標のフレーム矩形、ステートごとの fps とループフラグ。エンジンは矩形をサンプリングするだけで、グリッドを推測しません。- **Breathe** — 静止したアイドルが生きたループになります。一つのサイドカーフィールドから、キュレーション済みのフレームに決定論的なスカッシュ&ストレッチを焼き込み、解剖学に沿ってピクセル忠実に仕上げます([詳細](docs/breathing.md))。- **グリッドから外れないピクセルアート** — Backbone Lattice が被写体全体に対して一つのグリッドを計測し、すべてのカットをそれに従わせます([詳細](docs/pixel-unfake.md))。-- **動画からのモーションループ** — ジャンプには縦長のキャンバス、攻撃には横長のキャンバス、ループ点はクリップ自身の周期、ワンショットのアクションは静止 → アクション → 静止でカットされます([詳細](docs/video-pipeline.md))。+- **動画からのモーションループ** — ジャンプには縦長のキャンバス、攻撃には横長のキャンバス、ループ点はクリップ自身の周期、ワンショットのアクションは静止 → アクション → 静止でカットされます。歩行ループは足が交差する瞬間を数えて2歩1周でカットし、乱れたフレームを滑らかに補正します([詳細](docs/video-pipeline.md))。- **決定論的カラーウェイ** — `recolor` はパレットマップから N 枚のバリアントシートを焼きます。同じ入力なら同じ出力バイト列([詳細](docs/recolor.md))。- **目で見られる QA** — ステートごとの GIF とコンタクトシートにより、何かを出荷する前にモーションはモーションとして判断されます。周期的な移動(walk/run)は、モーション QA に実際に通らない限り実験的なままです。- **独立したアセットツール** — 繰り返す背景を作り、足のアンカーから影を投影し、タイミング・重複ポーズ・接地の根拠を検査します。足が曖昧な場合は未検証の計測として出力されます([詳細](docs/asset-tools.md))。diff --git a/README.ko.md b/README.ko.mdindex d8d4e86..c838ceb 100644--- a/README.ko.md+++ b/README.ko.md@@ -10,6 +10,8 @@<p align="center"><sub>개발에 필요한 모델 API 비용을 <a href="https://github.com/sponsors/aldegad">GitHub 후원</a>으로 보탤 수 있어요. 원하시는 금액으로 일회성 또는 월간 후원을 선택할 수 있어요.</sub></p>+<p align="center"><sub>sprite-gen 제작자가 게임 아트 일부를 이 도구로 만들며 개발 중인 <a href="https://store.steampowered.com/app/5045950/">Dungeon Sookuma</a>를 Steam에서 찜해 주세요.</sub></p>+<p align="center"><a href="https://youtu.be/zVu9YlbPtog"><img src="docs/assets/hero-v2-party.gif" width="960" alt="움직이는 sprite-gen v2 쇼케이스: 팔라딘, 늑대, 슬라임" /></a></p>@@ -86,7 +88,7 @@ flowchart LR- **런타임 매니페스트** (`manifest.json.frame_layout`) — 절대 프레임 사각형, 상태별 fps 와 루프 플래그. 엔진은 사각형을 샘플링할 뿐, 그리드를 추측하지 않는다.- **Breathe** — 정지된 아이들이 살아 있는 루프가 된다. 사이드카 필드 하나로 큐레이션한 프레임 위에 결정론적 스쿼시 & 스트레치를 굽고, 해부학을 인지하며 픽셀 단위로 정확하다 ([자세히](docs/breathing.md)).- **그리드를 벗어나지 않는 픽셀 아트** — 백본 래티스(Backbone Lattice)가 피사체 전체에 대해 하나의 그리드를 측정하고 모든 컷을 거기에 고정한다 ([자세히](docs/pixel-unfake.md)).-- **비디오에서 나온 모션 루프** — 점프에는 세로로 긴 캔버스, 공격에는 가로로 넓은 캔버스가 주어지고, 루프 지점은 클립 자체의 주기이며, 일회성 동작은 대기 → 동작 → 대기로 잘린다 ([자세히](docs/video-pipeline.md)).+- **비디오에서 나온 모션 루프** — 점프에는 세로로 긴 캔버스, 공격에는 가로로 넓은 캔버스가 주어지고, 루프 지점은 클립 자체의 주기이며, 일회성 동작은 대기 → 동작 → 대기로 잘린다. 걷기 루프는 발이 엇갈리는 순간을 세어 두 걸음 한 바퀴로 자르고 튄 프레임을 매끄럽게 다듬는다 ([자세히](docs/video-pipeline.md)).- **결정론적 컬러웨이** — `recolor` 가 팔레트 맵으로 N 개의 변형 시트를 굽는다. 같은 입력이면 같은 출력 바이트 ([자세히](docs/recolor.md)).- **눈으로 확인하는 QA** — 상태별 GIF 와 컨택트 시트로, 무엇이든 출고되기 전에 모션을 모션으로서 판단한다. 주기적 이동(걷기/달리기)은 모션 QA 를 실제로 통과하기 전까지 실험적 상태로 남는다.- **독립적인 에셋 도구** — 반복 배경을 만들고, 발 앵커에서 그림자를 투영하고, 타이밍·중복 포즈·접지 증거를 검사한다. 발이 모호하면 미검증 측정값이 나온다 ([자세히](docs/asset-tools.md)).diff --git a/README.md b/README.mdindex fdd9916..bfbca08 100644--- a/README.md+++ b/README.md@@ -10,6 +10,8 @@<p align="center"><sub>Help cover the model API costs of developing sprite-gen with an optional <a href="https://github.com/sponsors/aldegad">GitHub sponsorship</a>. Choose your amount and a one-time or monthly contribution.</sub></p>+<p align="center"><sub>Please wishlist <a href="https://store.steampowered.com/app/5045950/">Dungeon Sookuma on Steam</a>, a game in development by the creator of sprite-gen with part of the game art made using this tool.</sub></p>+<p align="center"><a href="https://youtu.be/zVu9YlbPtog"><img src="docs/assets/hero-v2-party.gif" width="960" alt="Animated sprite-gen v2 showcase: paladin, wolf and slime" /></a></p>@@ -93,7 +95,7 @@ Full index: [`docs/README.md`](docs/README.md). Architecture with domain and pip- **A runtime manifest** (`manifest.json.frame_layout`) — absolute frame rectangles, per-state fps and loop flags. Your engine samples rectangles; it never guesses a grid.- **Breathe** — a still idle becomes a living loop, deterministic squash & stretch baked on your curated frames from one sidecar field, anatomy-aware and pixel-true ([details](docs/breathing.md)).- **Pixel-art that stays on grid** — the Backbone Lattice measures one grid for the whole subject and holds every cut to it ([details](docs/pixel-unfake.md)).-- **Motion loops from video** — jumps get a tall canvas, attacks a wide one, the loop point is the clip's own period, and a one-shot action is cut rest → action → rest ([details](docs/video-pipeline.md)).+- **Motion loops from video** — jumps get a tall canvas, attacks a wide one, the loop point is the clip's own period, and a one-shot action is cut rest → action → rest. Walk cycles count foot crossovers into a clean two-step loop with smoothed seams ([details](docs/video-pipeline.md)).- **Deterministic colourways** — `recolor` bakes N variant sheets from a palette map; same input, same output bytes ([details](docs/recolor.md)).- **QA you can watch** — per-state GIFs and contact sheets, so motion is judged as motion before anything ships. Cyclic locomotion (walk/run) stays experimental unless motion QA actually passes.- **Independent asset tools** — build repeating backgrounds, project shadows from a foot anchor, and inspect timing, duplicate poses and contact evidence. Ambiguous feet produce an unverified measurement ([details](docs/asset-tools.md)).diff --git a/README.zh-Hans.md b/README.zh-Hans.mdindex 934f207..e25c796 100644--- a/README.zh-Hans.md+++ b/README.zh-Hans.md@@ -8,6 +8,8 @@</p>+<p align="center"><sub>请将 <a href="https://store.steampowered.com/app/5045950/">Dungeon Sookuma</a> 添加至 Steam 愿望单,这是 sprite-gen 开发者正在开发的游戏,部分游戏美术由本工具制作。</sub></p>+<p align="center"><a href="https://youtu.be/zVu9YlbPtog"><img src="docs/assets/hero-v2-party.gif" width="960" alt="sprite-gen v2 动画展示:圣骑士、狼与史莱姆" /></a></p>@@ -80,7 +82,7 @@ flowchart LR- **一份运行时清单**(`manifest.json.frame_layout`)—— 绝对帧矩形、每状态 fps 与循环标志。你的引擎按矩形取样,绝不去猜网格。- **Breathe** —— 静止的待机变成有生命的循环,基于一个 sidecar 字段在你策展过的帧上烘焙确定性的挤压与拉伸,尊重解剖结构且像素精准([详情](docs/breathing.md))。- **始终贴合网格的像素画** —— Backbone Lattice 为整个主体测量出一套网格,并让每一次切割都严格遵守它([详情](docs/pixel-unfake.md))。-- **来自视频的运动循环** —— 跳跃使用高画布,攻击使用宽画布,循环点取自片段自身的周期,而一次性动作按 静止 → 动作 → 静止 裁切([详情](docs/video-pipeline.md))。+- **来自视频的运动循环** —— 跳跃使用高画布,攻击使用宽画布,循环点取自片段自身的周期,而一次性动作按 静止 → 动作 → 静止 裁切。行走循环通过计算双脚交错裁切为完整的两步一轮,并平滑修复跳帧([详情](docs/video-pipeline.md))。- **确定性配色方案** —— `recolor` 依据调色板映射烘焙出 N 份变体表;相同输入,相同输出字节。([详情](docs/recolor.md))。- **可以亲眼检验的 QA** —— 每状态 GIF 与contact sheet,让运动在交付前先以运动的方式被评判。除非运动 QA 真正通过,循环式位移(走/跑)始终视为实验性。- **独立的素材工具** —— 构建可重复的背景、从脚部锚点投射阴影,并检查时序、重复姿势与接地证据。脚部含糊不清时将产出一份未经验证的测量结果([详情](docs/asset-tools.md))。