Repolode
제출하기
aldegad

aldegad/sprite-gen

기본 이미지 하나를 게임용 2D 스프라이트 아틀라스나 투명 애니메이션 루프로 변환하는 Codex/Claude 스킬 및 Python CLI입니다.

GitHub에서 보기
스타
3,843
포크
400
열린 이슈
2
마지막 커밋
14시간 전

어떤 프로젝트인가요?

sprite-gen은 AI 이미지 모델에서 흔히 겪는 문제를 해결합니다. 스프라이트 시트를 요청하면 프레임마다 캐릭터의 외형이 달라지고, 배경이 깔끔하게 제거되지 않으며, PNG를 게임 엔진에서 바로 사용할 수 없는 경우가 많습니다. 이 도구는 기본 이미지 하나에서 시작해 캐릭터의 일관성을 유지하면서 애니메이션 상태별 행을 생성하고, 크로마 키 배경을 실제 알파 채널로 변환한 다음 각 포즈를 투명 프레임으로 추출합니다.

출력물은 런타임 아틀라스(sprite-sheet-alpha.png)와 함께 제공되며, manifest.json에는 프레임의 절대 좌표와 크기, 상태별 fps, 루프 플래그가 포함됩니다. 또는 동일한 정지 이미지를 비디오 모델에 전달해 동작 상태별로 매끄럽게 반복되는 투명 루프를 만들 수도 있습니다. 큐레이션 웹뷰에서 사용자는 최종 에셋을 만들기 전에 루프를 비교하고, 제외하거나, 조정하고, 미리 볼 수 있습니다.

프로젝트는 여러 파이프라인과 유틸리티로 구성됩니다. 아틀라스 행 생성 파이프라인, 비디오를 루프로 변환하는 파이프라인, 시트를 분할하고 자르는 유틸리티, 색상 변경 및 엔진용 내보내기(Aseprite, Phaser, Flame)를 위한 후처리 기능, 타일링과 그림자 투영 같은 독립 에셋 도구, 그리고 선택적으로 사용할 수 있는 장면 구성 워크플로가 포함됩니다.

핵심 기능

  • 01기본 이미지 하나에서 캐릭터의 일관성을 유지하며 스프라이트 상태별 행을 생성합니다.
  • 02크로마 키 배경을 실제 알파 채널로 변환하고 깔끔한 투명 프레임을 추출합니다.
  • 03프레임 좌표와 크기, fps, 루프 플래그를 기록한 manifest.json과 런타임 아틀라스를 출력합니다.
  • 04비디오 모델로 동작 상태별 투명 애니메이션 루프를 생성합니다.
  • 05최종 에셋을 만들기 전에 프레임을 검토하고 미세 조정하며 미리 볼 수 있는 큐레이션 웹뷰를 제공합니다.
  • 06색상 변경 기능과 Phaser, Flame 같은 엔진용 Aseprite JSON 내보내기를 지원합니다.

활용 사례

  • 캐릭터 일러스트 하나를 2D 게임용 대기, 걷기, 공격, 점프 스프라이트 전체 세트로 변환합니다.
  • 정지 이미지 하나로 비디오 모델을 사용해 반복 재생되는 투명 애니메이션을 생성합니다.
  • 기존 스프라이트 시트의 색상을 변경해 여러 팔레트 버전을 만듭니다.
  • Aseprite JSON을 통해 스프라이트 아틀라스를 Phaser 또는 Flame용으로 내보냅니다.

빠른 시작

  1. 1

    Python 가상 환경을 만들고 활성화합니다

    python3 -m venv .venv && source .venv/bin/activate
  2. 2

    sprite-gen을 editable 모드로 설치합니다

    pip install -e .
  3. 3

    CLI가 실행되는지 확인합니다

    sprite-gen --help

사용 전 알아둘 점

  • 이미지와 동영상을 생성하려면 Codex 또는 Grok 구독 계정으로 로그인하거나 XAI_API_KEY와 같은 API 키가 필요합니다.
  • 동영상 루프를 만들려면 ffmpeg와 img2webp도 별도로 설치해야 합니다.
  • 모션 QA를 통과하지 않으면 걷기 및 달리기 루프는 실험적 기능입니다. 방향 보정은 선택 사항이며 잘못 적용될 수 있습니다.

포함된 컬렉션

Claude Code 도구·스킬·플러그인AI 코딩 어시스턴트와 에이전트AI 이미지 생성기 & Stable Diffusion 도구게임 개발 도구와 엔진

토픽

#game-dev#sprite-generation#2d-game#pixel-art#sprite-sheet#ai-tools#image-generation#claude-code#codex#gamedev

자주 묻는 질문

sprite-gen은(는) 무엇인가요?
기본 이미지 하나를 게임용 2D 스프라이트 아틀라스나 투명 애니메이션 루프로 변환하는 Codex/Claude 스킬 및 Python CLI입니다. sprite-gen은 AI 이미지 모델에서 흔히 겪는 문제를 해결합니다. 스프라이트 시트를 요청하면 프레임마다 캐릭터의 외형이 달라지고, 배경이 깔끔하게 제거되지 않으며, PNG를 게임 엔진에서 바로 사용할 수 없는 경우가 많습니다. 이 도구는 기본 이미지 하나에서 시작해 캐릭터의 일관성을 유지하면서 애니메이션 상태별 행을 생성하고, 크로마 키 배경을 실제 알파 채널로 변환한 다음 각 포즈를 투명 프레임으로 추출합니다.
sprite-gen은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
sprite-gen은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
sprite-gen은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. sprite-gen의 마지막 커밋은 2026년 11월 6일입니다.
sprite-gen은(는) 어디에 사용할 수 있나요?
캐릭터 일러스트 하나를 2D 게임용 대기, 걷기, 공격, 점프 스프라이트 전체 세트로 변환합니다. 정지 이미지 하나로 비디오 모델을 사용해 반복 재생되는 투명 애니메이션을 생성합니다. 기존 스프라이트 시트의 색상을 변경해 여러 팔레트 버전을 만듭니다. Aseprite JSON을 통해 스프라이트 아틀라스를 Phaser 또는 Flame용으로 내보냅니다.
sprite-gen는 어떻게 설치하나요?
Python 가상 환경을 만들고 활성화합니다: python3 -m venv .venv && source .venv/bin/activate sprite-gen을 editable 모드로 설치합니다: pip install -e . CLI가 실행되는지 확인합니다: sprite-gen --help
sprite-gen은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/aldegad/sprite-gen

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트