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

Gorest 2D 애니메이션 스프라이트시트 생성기

무엇인가요 – 2D 게임 장면을 구성하고 애니메이션 준비된 스프라이트시트를 생성하는 오픈소스 웹 기반 에디터입니다. 전통적인 그래픽 UI는 없으며, 원하는 내용을 설명하거나 자산을 드래그하여 작업하고, 로컬에 있는 Codex 기반 에이전트가 프로젝트 파일을 자동으로 업데이트합니다. 스프라이트시트 생성, 가져오기, 편집이 가능하며, 메타데이터(액션 이름, 방향, 루프 모드, 트리거 등)를 첨부하고 브라우저에서 바로 결과를 미리 볼 수 있습니다. 필요 시 Codex 기반 프롬프트를 활용할 수 있습니다.

왜 중요한가요 – 2D 게임 자산을 만드는 일반적인 과정은 수작업 파이프라인(프레임 그리기 → 시트 조합 → 메타데이터 추가 → 게임 엔진에 가져오기)을 거칩니다. Gorest는 이 과정을 자동화합니다. Codex에 프롬프트를 입력하면 완전한 투명 PNG 스프라이트시트가 생성되며, 앱은 즉시 재생 미리보기를 표시합니다. 브라우저를 벗어나지 않고도 레이어 순서, 장면 구성, 상호작용 데이터를 조정할 수 있습니다. 또한 사전 렌더링된 스프라이트시트를 회전시켜 3D 오브젝트처럼 보이게 하는 '가짜 3D' 뷰어도 지원합니다.

주요 기능

• 장면 컴포저 – 배경, 캐릭터, 소품, UI 요소, 애니메이션 스프라이트를 개별 레이어로 자유롭게 배치할 수 있는 캔버스.
• 스프라이트시트 페이지 – 현재 장면에서 사용된 모든 시트 목록을 표시하며, 미리보기, 다운로드, 클립별 메타데이터 편집이 가능합니다.
• Codex 지원 워크플로우 – 자연어 프롬프트(예: "16프레임의 금붕어 사육장 스프라이트시트 생성")를 입력하면 로컬 에이전트가 자동으로 자산을 생성하거나 업데이트합니다.
• 메타데이터 풍부한 자산 – 각 클립은 역할, 클립 이름, 트리거 유형/값, 게임 상태, 방향, 루프 모드, 태그, 그리고 가짜 3D 회전용 옵션의 viewMode를 저장합니다.
• 가짜 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에서 직접 인용되었으며, 추가 기능은 추측되지 않았습니다.