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