studioigor/ref2game

어떤 프로젝트인가요?

핵심 기능

• 01참조 이미지 스타일에 맞춰 아트를 조금씩 생성하고, 움직임과 효과는 엔진에서 처리합니다.
• 02두 개의 뼈가 있는 팔다리와 관절 단위 측정 기능을 갖춘 분리형 리그로 캐릭터를 구성합니다.
• 03발 미끄러짐과 보폭 같은 움직임을 자동으로 검사합니다.
• 04플레이 상태를 유지하면서 변경 사항이 있을 때마다 브라우저 페이지를 새로고침합니다.
• 05텍스처, manifest, 소스가 포함된 정적 플레이 가능 빌드를 제공합니다.

활용 사례

• 게임 컨셉 스크린샷을 발표나 플레이테스트용 클릭 가능한 프로토타입으로 만듭니다.
• 이미지 한 장을 바탕으로 플랫포머나 탑다운 슈터 같은 2D 게임 장르를 실험합니다.
• 리그를 직접 만들지 않고 컨셉 아트로 애니메이션 스프라이트를 프로토타이핑합니다.
• 에이전트 세션에서 작은 브라우저 게임 빌드를 내보냅니다.

빠른 시작

1. 1

   설치 프롬프트를 에이전트(Claude Code 또는 Codex)에 보냅니다

2. 2

   Claude Code에서는 claude/ 폴더를, Codex에서는 codex/ 폴더를 사용합니다

3. 3

   참고 이미지를 첨부한 뒤 Claude Code에서는 /ref2game을, Codex에서는 $ref2game을 보냅니다

사용 전 알아둘 점

• !Claude Code 또는 Codex가 필요하며 macOS 또는 Linux에서만 실행됩니다.
• !Python 3.9 이상과 Node.js 18 이상이 필요합니다. 첫 실행 시 Playwright와 Chromium이 설치됩니다.
• !동영상 참조 자료를 사용하거나 동영상을 렌더링하려면 ffmpeg가 필요합니다.
• !Claude Code 에디션의 이미지 생성에는 선택한 이미지 API 또는 도구가 필요하며, 사용 비용은 직접 부담해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ref2game은(는) 무엇인가요?

Claude Code와 Codex용 에이전트 스킬로, 참조 이미지 한 장을 플레이 가능한 2D 브라우저 게임 프로토타입으로 만듭니다. ref2game은 스크린샷, 키 아트 또는 컨셉 이미지를 받아 브라우저에서 플레이할 수 있는 2D 게임 프로토타입을 만듭니다. AI 이미지 생성으로 참조 이미지의 스타일에 맞춰 아트를 조금씩 그려 내고, 움직임·조명·파티클·카메라·HUD는 작은 WebGL2 엔진의 코드로 구현합니다. 에이전트가 작업하는 동안 페이지가 실시간으로 업데이트됩니다.

ref2game은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ref2game은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ref2game은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ref2game의 마지막 커밋은 2026년 10월 15일입니다.

ref2game은(는) 어디에 사용할 수 있나요?

게임 컨셉 스크린샷을 발표나 플레이테스트용 클릭 가능한 프로토타입으로 만듭니다. 이미지 한 장을 바탕으로 플랫포머나 탑다운 슈터 같은 2D 게임 장르를 실험합니다. 리그를 직접 만들지 않고 컨셉 아트로 애니메이션 스프라이트를 프로토타이핑합니다. 에이전트 세션에서 작은 브라우저 게임 빌드를 내보냅니다.

ref2game는 어떻게 설치하나요?

설치 프롬프트를 에이전트(Claude Code 또는 Codex)에 보냅니다 Claude Code에서는 claude/ 폴더를, Codex에서는 codex/ 폴더를 사용합니다 참고 이미지를 첨부한 뒤 Claude Code에서는 /ref2game을, Codex에서는 $ref2game을 보냅니다

ref2game은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/studioigor/ref2game