Agent Sprite Forge: 자연어 요청으로 2D 게임 스프라이트와 맵을 만드는 Codex 에이전트 스킬

9bow · 6월 12, 2026, 3:30오전

Agent Sprite Forge 소개

Agent Sprite Forge는 Codex를 위한 2D 게임 에셋 제작 스킬로, 게임에서 바로 쓸 수 있는 스프라이트와 레이어드 맵, 엔진 연동형 프로토타입 에셋을 자연어 요청으로 만들어 냅니다. 사용자가 원하는 것을 말로 설명하면 Codex가 에셋 파이프라인을 계획하고, 내장 이미지 생성으로 원본 비주얼을 만든 뒤, 로컬 프로세서가 배경 제거와 프레임 분할, 정렬, 검증, 내보내기를 수행합니다. 결과물은 Godot, Unity, 또는 일반 2D 게임 워크플로에서 그대로 사용할 수 있습니다.

이 프로젝트가 단순한 프롬프트 모음과 다른 점은 역할 분담에 있습니다. 무엇을 만들지와 어떤 제작 흐름을 따를지는 에이전트가 판단하고, 이미지 생성이 원본 비주얼을 그리며, 결정론적(deterministic) 로컬 스크립트가 이를 재사용 가능한 게임 에셋으로 정리합니다. 저자는 "스크립트는 창작의 중심이 아니며, 시각적 판단과 파이프라인 결정은 에이전트가 하고 Python 도구는 반복 가능한 픽셀과 내보내기 처리만 담당한다"고 설명합니다.

만들 수 있는 에셋의 범위는 넓습니다. 캐릭터와 몬스터, props, 공격과 마법, projectile과 impact 같은 스프라이트 시트부터, ground 베이스와 prop 팩, y-sort 배치, collision과 zone을 가진 레이어드 맵, 그리고 편집 가능한 Godot TileMapLayer 와 collision body까지 포함합니다. 로컬 정리 단계에서는 마젠타 배경 제거, 프레임 추출, 정렬, 투명 PNG와 GIF 내보내기, prop 팩 슬라이싱, QA 메타데이터 생성이 이루어집니다.

Agent Sprite Forge의 동작 방식

제작 흐름은 다섯 단계로 이어집니다. 먼저 사용자가 Codex에 스프라이트나 prop 팩, 맵, 엔진용 프로토타입을 요청합니다. 그러면 에이전트가 에셋 종류, 동작, 번들 형태, 시트 레이아웃, 프레임 수, 스타일, 정렬 전략을 결정합니다. 다음으로 내장 이미지 생성이 원본 비주얼을 만들고, 로컬 스크립트가 배경 제거(chroma-key cleanup)와 despill, 프레임 추출, 정렬, prop 팩 슬라이싱, GIF/PNG 내보내기, 검증 메타데이터 생성 같은 결정론적 후처리를 수행합니다.

맵이나 프로토타입의 경우 에이전트가 배치 메타데이터, collision, trigger zone, Godot 씬, Unity 프로젝트 연결까지 조립할 수 있습니다. 일반적인 스프라이트 시트 출력에는 raw-sheet.png, 정리된 투명 시트 sheet-transparent.png, 개별 프레임 PNG, animation.gif, 사용된 프롬프트 기록 prompt-used.txt, 그리고 pipeline-meta.json 이 포함됩니다.

Agent Sprite Forge의 두 가지 스킬

Agent Sprite Forge는 두 개의 스킬로 구성됩니다.

스킬	용도	출력
`generate2dsprite`	스프라이트, 애니메이션 시트, props, 스펠 번들, FX, 레퍼런스 기반 변형, 고정 프레임 시트	raw 시트, 정리된 투명 시트, 프레임, GIF, 메타데이터
`generate2dmap`	baked 맵, 레이어드 raster 맵, HD RPG 맵, prop 팩, collision과 zone, Godot 편집 가능 씬, 횡스크롤 씬	base 맵, dressed 레퍼런스, prop 팩, 추출된 props, 프리뷰, 씬 메타데이터

$generate2dmap 은 선택한 맵 파이프라인이 재사용 가능한 투명 props를 필요로 할 때만 $generate2dsprite 를 함께 사용합니다. 작은 환경 props는 2x2, 3x3, 4x4 prop 팩으로 묶을 수 있고, platform이나 floor, bridge처럼 collision이 중요한 오브젝트는 개별 생성하거나 tile 및 object 레이어로 표현하는 것이 안전합니다.

Agent Sprite Forge로 만든 예시 결과물

저장소의 Showcase 섹션에는 이 스킬만으로 조립한, 실제 플레이 가능한 프로토타입과 맵 결과물이 정리되어 있습니다. 모두 내장 이미지 생성이 만든 원본 에셋을 로컬 스크립트가 정리하고, 에이전트가 엔진 씬으로 연결한 결과입니다.

먼저 엔진에 연결한 플레이 가능한 프로토타입들입니다.

Unity WebGL로 배포된 서바이버형 게임 Summon Survivors 입니다. 맵 아트와 방향별 영웅 시트, 소환수와 진화 시트, 적과 보스, 획득물, HUD, FX를 모두 생성해 레벨업 선택과 소환수 훈련, WebGL 배포까지 하나의 흐름으로 연결했습니다. (플레이 빌드)

Godot 4로 만든 타워 디펜스 프로토타입 Forest Pass Defense 입니다. 맵과 분리된 props, 타워 슬롯, 6종 타워 패밀리, 지상과 공중, 보스 적의 애니메이션 시트, 웨이브와 HUD, 건설과 업그레이드, 판매 흐름, projectile과 타겟팅 규칙까지 갖췄습니다.

생성된 캐릭터와 공격, 맵, 게임플레이 에셋으로 조립한 사이버펑크 횡스크롤 프로토타입 Neon Breach 입니다.

센고쿠 시대를 배경으로 한 브라우저 기반 Pokemon 류 RPG Sengoku Era 입니다. 생성된 캐릭터와 스타터 몬스터 선택, 맵 흐름, 전투 UI로 하나의 씬을 구성했습니다. (플레이 빌드)

맵 파이프라인이 만들어 내는 결과물도 살펴볼 수 있습니다.

$generate2dmap 의 레이어드 raster 파이프라인으로 만든 사이버펑크 운하 맵 프리뷰입니다. ground-only 베이스, dressed 레퍼런스, prop 팩, 투명 prop 추출, 레이어 합성 프리뷰 순으로 진행해, 캐릭터가 키 큰 props의 앞뒤로 걸어다니는 y-sort 배치까지 표현합니다.

$generate2dmap 은 단일 이미지 대신 편집 가능한 Godot 맵 프로젝트로도 내보낼 수 있습니다. 내장 이미지 생성으로 만든 타일셋과 3x3 prop 시트를 편집 가능한 TileMapLayer, 개별 Sprite2D props, encounter grass Area2D 존, StaticBody2D collision 블로커, exit 존, 디버그 플레이어 씬으로 연결한 결과입니다.

Agent Sprite Forge 설치 및 사용법

저장소를 클론하고 의존성을 설치한 뒤, 스킬 디렉토리를 Codex 스킬 경로(~/.codex/skills/)로 복사합니다. 아래는 macOS와 Linux 기준입니다.

git clone https://github.com/0x0funky/agent-sprite-forge.git
cd ./agent-sprite-forge
python3 -m pip install -r ./requirements.txt
mkdir -p ~/.codex/skills
cp -R ./skills/* ~/.codex/skills/

설치 후에는 새 Codex 세션을 시작해 스킬을 다시 로드합니다. 이후 자연어로 스킬을 호출하면 됩니다.

Use $generate2dsprite to create a 3x3 idle for an ultimate earth titan.

Use $generate2dmap to create a Godot-editable RPG map with separated props,
encounter grass Area2D zones, collision StaticBody2D blockers, exit zones,
and a debug player scene.

Windows의 PowerShell 설치 절차는 저장소의 한국어 README 에 함께 정리되어 있습니다.

Agent Sprite Forge의 라이선스

Agent Sprite Forge는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

Agent Sprite Forge 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~