Community이미지github.com

sprite-forge

로컬에서 무료로 2D 게임 아트를 생성합니다. 스프라이트, 소품, 아이템, 아이콘, UI 요소, 투명 배경, 진정한 픽셀 아트(실제 그리드, 제한된 팔레트), 4/8방향 턴어라운드 및 애니메이션 스프라이트 시트(걷기, 달리기, 대기, 공격...), 기존 픽셀 스프라이트 설명 기반 애니메이션, 2D 조명용 법선 맵, 매끄러운 타일, 초상화 및 VFX 프레임을 게임 준비 완료된 PNG, GIF 및 TexturePacker/Phaser JSON 아틀라스로 제공합니다.

sprite-forge란 무엇인가요?

Sprite Forge는 사용자의 GPU에서 로컬로 실행되는 (ComfyUI 기반) 2D 게임 에셋 생성 도구입니다. 외부 유료 서비스에 데이터를 전송하지 않으며, 모든 결과물은 깔끔하게 배경이 제거되고, 크롭, 크기 조정, 품질 검사 후 매니페스트와 함께 저장됩니다. 스프라이트, 소품, 아이템, 아이콘, UI 요소, 픽셀 아트, 캐릭터 턴어라운드(4/8방향), 애니메이션 시트(걷기, 달리기, 대기, 공격 등), 기존 픽셀 스프라이트의 설명 기반 애니메이션, 2D 조명용 법선 맵, 매끄러운 타일, 초상화, VFX 프레임 등 다양한 프로필을 지원하며, 결과물은 PNG, GIF, TexturePacker/Phaser JSON 아틀라스 형태로 제공됩니다. MCP 도구 세트(list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map 등)와 CLI를 통해 사용할 수 있으며, 비동기 작업을 지원하고 프리뷰 이미지를 제공합니다. 픽셀 아트의 경우 실제 픽셀 그리드, 하드 알파, 제한된 팔레트를 적용하여 진정한 픽셀 아트를 생성합니다. 각 게임 프로젝트는 spriteforge.json 설정 파일을 통해 일관된 스타일과 출력 설정을 유지합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-sprite-mcp/tree/main/skills/sprite-forge

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Sprite Forge

Sprite Forge는 텍스트를 이 기기의 GPU(내부적으로 ComfyUI를 사용하며 자동으로 시작됨)에서 게임 준비 완료된 2D 에셋으로 변환합니다. 유료 서비스로 전송되는 데이터는 없습니다. 모든 결과물은 깔끔한 가장자리로 잘리고, 크롭되고, 크기가 조정되며, 확인을 거친 후 매니페스트와 함께 저장됩니다. 여러 번의 시도 중 최상의 결과가 유지됩니다.

호출 방법

사용 가능한 경우 sprite-forge MCP 도구를 선호하세요: list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status.

그렇지 않으면 Sprite Forge 폴더에서 명령줄을 사용하세요. 모든 명령은 하나의 JSON 객체를 출력합니다:

python forge.py profiles
python forge.py sprite  <name> "<prompt>" -p sprite --project <game folder>
python forge.py sprite  <name> "<prompt>" -p pixel_sprite --set grid=32 --set palette=project --project <game folder>
python forge.py character <id> "<who, outfit, colours, props>" --project <game folder>
python forge.py sprite  <name> -p turnaround --character <id> --set directions=8 --project <game folder>
python forge.py sprite  <name> -p animation  --character <id> --set action=walk --set facing=right --project <game folder>
python forge.py animate <name> <sprite.png> "<the motion>" --pose "<frame 1>" --pose "<frame 2>" ...
python forge.py normal  <sprite.png>
python forge.py check   <file.png> --kind sprite

종료 코드 0 = 정상, 2 = 완료되었지만 결과가 검사에 실패함, 1 = 오류.

프로필 선택

프로필용도출력
sprite소품, 아이템, 픽업, 무기, 가구, UI 조각투명 PNG, 크롭, 정사각형 캔버스 중앙 정렬
icon스킬/아이템 아이콘, 배지, 버튼정사각형 PNG + 256/128/64 px 버전
pixel_sprite진정한 픽셀 아트: 캐릭터, 아이템, 적실제 픽셀 그리드(예: 32px), 하드 알파, 제한된 또는 명명된 팔레트, x8 프리뷰 포함
character재사용 가능한 캐릭터 참조전신 투명 PNG, 발이 지면 선에 위치
pixel_character픽셀 아트 스타일로 그려진 동일한 캐릭터픽셀 아트 시트용 참조
turnaround캐릭터가 4 또는 8 방향으로 보임프레임 + <name>_sheet.png + <name>.atlas.json
animation걷기, 달리기, 대기, 공격, 점프, 피격, 사망, 시전프레임 + 시트 + 애니메이션 태그가 있는 아틀라스
tile지면, 벽, 바닥, 물, 식물매끄러운 정사각형 텍스처 + 3x3 타일 프리뷰(선택적 픽셀 버전)
portrait대화 초상화, 카드, 주요 아트풀 해상도 이미지
vfx폭발, 연기, 마법 버스트, 타격 스파크프레임 + 시트 + 아틀라스; 밝기가 투명도
animate_pixel (도구)설명을 바탕으로 기존 픽셀 스프라이트에 애니메이션 적용스프라이트 자체 그리드 및 팔레트의 프레임 + 시트 + 아틀라스 + GIF

모든 시트에는 <name>.gif(반복)도 함께 제공되어 사용자가 볼 수 있습니다.

각각 세 가지 프리셋이 있습니다: fast(빠른 한 번), standard(기본값), max(더 큰 모델 또는 더 많은 시도; 턴어라운드/애니메이션용 Qwen-Image-Edit). 사용한 프리셋을 명시하세요.

워크플로우

  1. 항상 게임 프로젝트 폴더를 전달하세요 (project_dir / --project). 프로젝트의 spriteforge.json은 스타일, 출력 폴더, 캐릭터 폴더 및 프로필별 설정을 제공하므로 게임 아트의 일관성이 유지됩니다. 설정이 없으면 생성(forge.py init <dir>)을 제안하세요.
  2. 프로필의 prompt_guide에 따라 프롬프트를 작성하세요 (list_profiles가 반환함). 그림이 아닌 대상을 설명하세요: "~의 스프라이트" 없음, 배경 없음, 프롬프트에 카메라 관련 단어 없음 - 각도는 params.view로 설정합니다(front view, side view, top-down view, isometric view).
  3. 여러 번 등장하는 캐릭터는 먼저 생성하세요. create_character (또는 character 설정과 함께 character 프로필)는 참조를 저장합니다. 턴어라운드와 애니메이션은 이를 편집하여 캐릭터가 하나의 모습을 유지합니다. 픽셀 아트 시트의 경우 profile: "pixel_character"을 사용하고 params.pixel_grid(예: 32)를 시트에 전달하세요.
  4. 시간이 오래 걸리는 작업은 비동기입니다. 도구가 작업 ID를 반환하면 wait_seconds: 50으로 get_job을 호출하여 상태가 queued 또는 running이 아닐 때까지 기다리세요. 한 번에 하나의 작업만 처리하세요.
  5. 프리뷰를 확인하세요. 모든 결과에는 프리뷰 이미지(체커보드 위의 스프라이트)가 함께 제공됩니다. 에셋이 완료되었다고 판단하기 전에 확인하세요: 잘못된 대상, 잘린 부분, 두 번째 객체, 후광, 동일한 캐릭터가 아닌 프레임. 파일, 크기, problems를 보고하고 .spriteforge/<name>/의 다른 시도들을 언급하세요.

픽셀 아트

  • 이미지 모델은 픽셀 아트 스타일만 그립니다. Sprite Forge는 실제로 만듭니다: 모델의 픽셀 그리드를 찾거나(grid 강제), 각 셀의 지배적인 색상을 취하고, 떠도는 픽셀을 제거하고, 알파를 완전히 켜기/끄기로 만들고 팔레트를 제한합니다. 이 단계 없이 스프라이트가 픽셀 아트라고 주장하지 마세요.
  • grid: 스프라이트의 가장 긴 쪽(픽셀 단위, 16, 24, 32, 48, 64). "auto"는 모델이 그린 픽셀 크기를 유지합니다.
  • palette: pico8, gameboy, nes, endesga32, sweetie16, 16진수 색상 목록, 또는 "project" - 전체 게임에 대해 고정된 하나의 팔레트(첫 번째 픽셀 에셋에 의해 프로젝트에 palette.hex로 저장되고 이후 모든 에셋에 재사용됨). 게임의 경우 "project"를 사용하세요.
  • outline: true는 1픽셀 어두운 외곽선을 추가합니다. canvas: 32는 스프라이트를 32x32 그리드에 배치합니다.
  • 디더링은 적용되지 않습니다(애니메이션에서 깜박임).

기존 픽셀 스프라이트 애니메이션

사용자에게 이미 픽셀 스프라이트(자신의 것 또는 pixel_sprite로 만든 것)가 있고 동작을 설명할 때 animate_pixel을 사용하세요: "슬라임이 튀게 만들기", "기사가 검을 휘두르는 애니메이션". 모든 프레임에서 스프라이트의 정확한 픽셀 크기와 팔레트를 유지합니다.

  • image: PNG(기본 크기 최대 256px, 또는 하드 픽셀로 확대된 복사본).
  • description: 동작. walk / run / idle / attack / jump / hurt / death / cast는 내장된 키 포즈를 사용합니다.
  • 그 외의 경우에는 poses를 직접 작성하세요: 프레임당 한 줄씩 변경 사항을 설명합니다. 예: 검 휘두르기의 경우 ["raising the sword high above his head", "the sword at the top, body leaning back", "swinging the sword down in front of him", "the sword low after the strike"]. 3-6 프레임이 가장 좋습니다. 이것들은 키 포즈이며 중간 프레임이 아닙니다.
  • params.include_original: true는 프레임 0으로 수정되지 않은 스프라이트를 포함합니다. params.fps.
  • GIF/프리뷰를 확인하세요: 프레임이 스프라이트의 일부를 잃거나 변경한 경우 새 seed 또는 preset: "max"(프레임당 더 많은 시도)로 다시 실행하세요.

법선 맵 (2D 조명)

2D 조명이 있는 게임(Godot CanvasTexture + Light2D, Unity 2D 조명, Phaser light2d)의 경우 sprite, icon, pixel_sprite, character, turnaround, animation 또는 animate_pixel에 params.normal_map: true를 전달하거나 기존 PNG에서 make_normal_map을 호출하세요.

  • <name>_normal.png(또는 <name>_sheet_normal.png, 시트와 동일한 레이아웃)와 <name>_lit_preview.png(왼쪽, 위, 오른쪽, 아래에서 조명이 비춰진 스프라이트)를 작성합니다 - 사용자에게 프리뷰를 보여주세요.
  • 픽셀 아트는 선명하고 스냅된 법선으로 픽셀 그리드를 유지합니다.
  • 기본 규칙은 OpenGL(녹색 = 위)이며 Godot와 Unity가 이를 예상합니다. DirectX의 경우 normal_y: "down" / y: "down". normal_strength 0.5 미묘함 - 2 강함.
  • 윤곽은 그림(외곽선, 색상 영역, 하이라이트)에서 추론되며 모델링된 것이 아닙니다: 움직이는 조명 아래에서 잘 읽히지만 실제 깊이 스캔은 아닙니다.

결과가 failed_check를 표시할 때

파일은 작성되었지만 있는 그대로 사용해서는 안 됩니다. problems가 이유를 설명합니다.

문제해결책
cut off새 seed로 재실행; "작고, 중앙에, 주변에 공간 있게" 추가하거나 params.padding을 높입니다.
several objects하나의 객체만 지정하고 새 seed로 재실행합니다.
background not removed / empty단단한 객체를 설명하고 background를 평범하게 유지한 후 재실행합니다.
may not look like the character (시트)해당 시트를 새 seed 또는 preset: "max"로 재실행하고 캐릭터 프롬프트를 간단하게 유지합니다.
may not have turned (턴어라운드)preset: "max"(Qwen-Image-Edit가 뷰 변경을 더 잘 따름)로 재실행합니다.
no clear pixel grid found그림이 픽셀 아트로 그려지지 않았습니다. grid를 숫자로 설정하거나 재실행합니다.
visible seam (타일)유기적인 표면을 사용하거나 params.blend를 높인 후 재실행합니다.
much smaller than the original (animate_pixel)해당 프레임이 스프라이트의 일부를 잃었습니다. 새 seed로 재실행하거나 더 명확한 포즈를 제공하세요.
flat: almost a single colour모델이 실루엣을 그렸습니다. 새 seed로 재실행하고 "풀 컬러로"라고 말합니다.

동일한 name + 동일한 설정은 기존 파일을 반환합니다. 설정, seed를 변경하거나 force: true를 전달하면 새 파일을 만듭니다.

사용자 정의

  • 프로젝트별: spriteforge.json (style, style_preset, output_dir, characters_dir, profiles.<id>.params, 예: {"pixel_sprite": {"params": {"grid": 32, "palette": "project"}}}).
  • 호출별: params, 예: {"size": 256, "candidates": 6, "view": "side view", "directions": 4, "action": "attack", "facing": "down"}. list_profiles는 각 매개변수를 설명과 함께 나열합니다.
  • 새 프로필: 프로젝트의 spriteforge_profiles/ 폴더에 있는 작은 JSON 파일로, 하나를 extends합니다.
  • 모델 및 하드웨어: models 도구는 각 프로필과 프리셋에 필요한 것과 누락된 것을 보고합니다. 다운로드는 큽니다 - 설치 전에 사용자에게 물어보세요.
  • 라이선스: Sprite Forge가 설치하는 모든 모델은 사용자가 만든 것의 상업적 사용을 허용합니다(FLUX.2 Klein 4B, Z-Image Turbo, Qwen-Image-Edit 2511 및 픽셀 LoRA: Apache 2.0; BiRefNet 및 CLIP: MIT). 일부 스토어(예: Steam, itch.io)는 AI 제작 에셋 공개를 요구할 수 있습니다.

관련 스킬