Generate2dsprite
이 스킬은 앱 빌더 샌드박스(TanStack Start + 브라우저 게임)에서 사용할 2D 스프라이트 또는 애니메이션 에셋을 제작할 때 사용합니다.
더 큰 게임이나 플레이 가능한 프로토타입에 스프라이트가 필요한 경우, 이 스킬을 사용하여 가시적인 스프라이트 에셋을 생성하고 런타임/게임 조립은 별도로 처리(Phaser/Canvas/DOM에 와이어링)합니다. 요청된 스프라이트 에셋을 코드로 그린 자리 표시자로 대체하지 마세요.
앱 빌더 / Grok 환경
| 항목 | 값 |
|---|---|
| 스킬 디렉토리 | .grok/skills/generate2dsprite/ |
| 스크립트 | python3 .grok/skills/generate2dsprite/scripts/<script>.py … |
| 이미지 도구 | imagine_text_to_image / imagine_image_to_image (경로 기반; 프롬프트 작성은 imagine 스킬 참조) |
| 이미지 검사 | read_file로 PNG 경로 확인(Codex view_image 사용 안 함) |
| 생성된 이미지 경로 | imagine_text_to_image가 샌드박스 file_path 반환; 처리 전에 해당 경로를 작업 디렉토리로 복사 |
| Python 종속성 | Pillow + numpy(이미지에 사전 설치됨) |
| 출력 홈 | 앱에서 임포트할 수 있도록 /workspace 아래 assets/sprites/<name>/ 권장 |
| 엔진 대상 | 브라우저: Canvas 2D, Phaser, 또는 DOM/<img> — 사용자가 요청하지 않는 한 Godot/Unity 사용 안 함 |
관련 스킬: imagine (이미지 도구 사용법), game-asset-core (+ game-animation-frames / game-character-consistency 품질 관리 및 엔진 기본값), generate2dmap (맵/소품), video2dsprite (imagine_image_to_video로 밀도 높은 모션), building-games (게임 루프 / 통합).
매개변수
다음 매개변수는 사용자 요청에서 추론합니다:
asset_type:player|npc|creature|character|spell|projectile|impact|prop|summon|fxaction:single|idle|cast|attack|shoot|jump|hurt|combat|walk|run|hover|charge|projectile|impact|explode|deathview:topdown|side|3/4sheet:auto|2x2|2x3|2x4|3x3|3x4|4x4|5x5|custom_grid|strip_1x3|strip_1x4frames:auto또는 명시적 개수bundle:single_asset|unit_bundle|spell_bundle|combat_bundle|line_bundle|hero_action_bundle|engine_atlaseffect_policy:all|largestanchor:center|bottom|feetmargin:tight|normal|safeart_style: pixel_art | clean_hd | pixel_inspired | retro_pixel | map_style | project-nativereference:none|attached_image|generated_image|local_filelayout_guide:none|optional|recommendedprompt: 사용자의 테마 또는 시각적 방향role: 에셋이 명확히 NPC 역할인 경우에만name: 선택적 출력 슬러그
요청이 모호한 경우 references/modes.md를 참조하세요.
에이전트 규칙
- 에셋 계획을 스스로 결정합니다. 사용자가 시트 크기, 프레임 수 또는 번들 구조를 구체적으로 말하도록 강요하지 마세요. 요청에 이미 암시되어 있다면 말입니다.
- 단순히
4x4,5x5또는 사용자 정의 엔진 아틀라스를 맞추기 위해 관련 없는 액션을 하나의 원시 생성 시트에 채우지 마세요. 원시 생성 시트는 하나의 액션 계열, 하나의 연속 시퀀스, 하나의 표준 방향성 이동 시트 또는 하나의 소품/에셋 팩을 나타내야 합니다. - 조작 가능한 영웅, 주인공 및 여러 액션을 가진 고가치 플레이어 에셋의 경우, 먼저 액션별 그리드 시트를 별도로 생성하고 각 액션의 품질을 확인한 다음, 그리드가 시각적 검토를 통과한 후에만 엔진에서 요구하는 아틀라스를 결정적으로 조립합니다.
- 조작 가능한 영웅, 주인공 및 고가치 플레이어 바디 액션의 경우, 기본 공격/슛/시전 바디 시트는 바디 전용으로 설정합니다. 큰 베기 호, 머즐 플래시, 발사체, 충격 폭발, 분리된 먼지, 긴 흔적 또는 넓은 분리된 FX를 바디 시트에 포함하지 마세요. 이러한 것들은 별도의
fx,projectile또는impact시트로 생성하여 게임에서 레이어링합니다. - 대상 런타임이 더 넓은 액션별 셀과 액션별 원점/앵커 메타데이터를 명시적으로 지원하는 경우에만 넓은 공격 FX를 동일한 원시 바디 시트에 포함하세요. 그렇지 않으면 넓은 FX 경계 상자가 바디가 고정 셀 내에서 축소되도록 강제합니다.
- 아트 프롬프트를 직접 작성합니다. 프롬프트 빌더 스크립트를 기본값으로 사용하지 마세요.
- 모든 원시 이미지에 내장된
imagine_text_to_image를 사용합니다. - Three.js, Canvas, SVG, HTML/CSS 그리기, PIL 모양 그리기, 절차적 지오메트리, 자리 표시자 프리미티브 또는 코드 렌더링 스크린샷으로 원시 스프라이트 아트를 만들지 마세요. 런타임 코드는 완성된 생성 에셋을 표시할 수 있고, 스크립트는 레이아웃 가이드를 만들거나 생성된 이미지를 후처리할 수 있지만, 요청된 스프라이트 아트는 내장된
imagine_text_to_image에서 비롯되어야 합니다. - 사용자가 시각적 참조를 제공하거나 암시하는 경우, 해당 참조의 샌드박스
file_path를imagine_image_to_image에 전달합니다(도구가 파일을 읽음). 또한 로컬 참조를 볼 수 있도록read_file로 읽습니다. 프롬프트 내에서만 언급된 경로는 시각적 입력이 아닙니다. - 에셋이
$generate2dmap의 맵 소품이거나 사용자/프로젝트가 다른 스타일을 요청하는 경우 픽셀 아트를 강요하지 마세요. 먼저 맵 또는 참조 스타일과 일치시킵니다. - 스크립트는 결정적 프로세서로만 사용합니다: 마젠타 정리, 프레임 분할, 컴포넌트 필터링, 스케일링, 정렬, 품질 관리 메타데이터, 투명 시트 내보내기 및 GIF 내보내기.
- 스크립트를 사용하여 창의적인 이미지 프롬프트를 생성하지 마세요. 레거시 프롬프트 빌더 명령이 있는 경우, 일반적인 스킬 워크플로가 아닌 역사적 호환성 용도로만 취급하세요.
- 레이아웃 가이드는 이미지 생성을 위한 결정적 지오메트리 참조로만 허용됩니다. 슬롯 개수, 간격, 중앙 정렬 및 안전 패딩을 표시할 수 있지만 창의적인 아트 방향을 정의해서는 안 됩니다.
- 스크립트 플래그는 사용자 대면 하드코딩된 워크플로가 아닌 에이전트가 선택하는 실행 프리미티브로 취급합니다.
- 생성된 시트가 셀 가장자리에 닿거나, 스케일이 흔들리거나, 발사체/충격 루프를 깨는 경우, 더 나은 프리미티브 설정으로 다시 처리하거나 원시 시트를 다시 생성합니다.
- 캐릭터, 플레이어, 조작 가능한 영웅, 생물, NPC, 적, 소환수, 애니메이션 소품 또는 바디/주체가 중앙에 유지되어야 하는 모든 에셋에
1x4,1x6,1x8또는1xN과 같은 원시 단일 행 시트를 사용하지 마세요. 단일 행 원시 생성은 수평으로 이동하고 불일치하게 자를 가능성이 너무 높습니다. - 애니메이션 바디 에셋의 경우 기본적으로 다중 행 그리드를 사용합니다: 4프레임 ->
2x2, 6프레임 ->2x3, 8프레임 ->2x4, 9프레임 ->3x3, 12프레임 ->3x4또는4x3, 16프레임 ->4x4. - 게임 엔진에 최종 단일 행 스트립 또는 혼합 아틀라스가 필요한 경우, 먼저 액션을 다중 행 그리드로 생성 및 품질 확인한 다음, 배달 스트립/아틀라스를 결정적으로 조립합니다.
- 모든 애니메이션 바디 그리드 프롬프트에서 주체 바디가 각 셀 중앙에 유지되고, 전체 바디가 중앙 60% ~ 70% 안전 영역 내에 있으며, 셀 전체에서 일관된 스케일, 해당되는 경우 안정적인 발/바닥 앵커 라인, 그리고 팔다리, 무기, 머리카락, 망토, 먼지, 머즐 플래시 또는 분리된 FX가 셀 가장자리를 넘지 않도록 명시적으로 요구합니다.
- 히어로 공격 바디 프롬프트의 경우, 바디 높이와 바디 스케일이 승인된 idle/run 시트와 일치하고, 안정적인 발/바닥 앵커, 무기가 바디 bbox를 넓히지 않을 만큼 충분히 가깝게 유지되며, 분리된 베기 호 또는 화면 공간 공격 효과가 없도록 명시적으로 요구합니다.
- 맵 소품 팩의 경우, 그리드를 선택하기 전에 소품을 분류합니다. 정사각형
2x2,3x3및4x4팩은 컴팩트한 소품에만 사용합니다. 플랫폼, 바닥, 다리, 벽, 사다리, 게이트, 문, 긴 위험물, 넓은/높은 소품, 충돌 부여 객체 또는 타일셋/스트립 조각을 정사각형 소품 팩에 넣지 마세요. 대신 하나씩,1x3/1x4스트립, 사용자 정의 넓은 셀 또는 타일셋 같은 아틀라스를 사용합니다. - 사용자가 명시적으로 다른 처리 워크플로를 원하지 않는 한 단색
#FF00FF배경 규칙을 유지합니다.
워크플로
1. 에셋 계획 추론
가장 작은 유용한 출력을 선택합니다.
예시:
- 4방향 조작 가능한 영웅 ->
player+player_sheet - 사이드뷰 조작 가능한 영웅 (idle/run/shoot/jump) ->
player+hero_action_bundle- idle 그리드 시트, 일반적으로 4프레임
2x2 - run 그리드 시트, 필요한 프레임 수에 따라 일반적으로
2x2또는2x3 - shoot 그리드 시트(바디/무기만), 일반적으로
2x2 - jump 그리드 시트, 일반적으로
2x2 - 필요할 때 발사체 / 머즐 플래시는 별도 에셋
- 액션별 품질 확인 후 선택적 조립 엔진 아틀라스
- idle 그리드 시트, 일반적으로 4프레임
- 사이드뷰 조작 가능한 영웅 (근접 공격) ->
player+hero_action_bundle- 공격 바디 그리드 시트, 일반적으로
2x2또는2x3, 바디 전용 - 베기 호 / 무기 흔적은 공격에 넓은 시각 효과가 필요할 때 별도의
fx시트 - 충격 스파크는 히트 피드백이 필요할 때 별도의
impact시트
- 공격 바디 그리드 시트, 일반적으로
- 힐러 오버월드 NPC ->
npc+single_asset또는unit_bundle - 큰 보스 idle 루프 ->
creature+idle+3x3 - 마법사가 마법 구체 던지기 ->
spell_bundle- 시전자 시전 시트
- 발사체 루프
- 충격 폭발
- 몬스터 라인 요청 ->
line_bundle- 1-3가지 형태 계획
- 각 형태에 대해 요청이 실제로 필요한 시트 생성
2. 수동으로 프롬프트 작성
references/prompt-rules.md를 사용합니다.
프롬프트를 작성하기 전에 art_style을 선택합니다:
- 클래식 스프라이트, 16비트 RPG 액터, 픽셀 아트를 명시적으로 요청하는 요청에는
pixel_art또는retro_pixel을 사용합니다. - 깔끔한 손으로 그린 HD 맵과 일치시키기 위한 맵 소품 또는 에셋에는
clean_hd를 사용합니다. - 사용자가 레트로 덩어리짐 없이 픽셀에 인접한 모양을 원할 때만
pixel_inspired를 사용합니다. - 기존 맵, 게임 또는 참조가 스타일을 정의해야 할 때
map_style또는project-native를 사용합니다.
참조가 관련된 경우:
- 참조를 호출에 연결합니다: 해당 샌드박스
file_path를imagine_image_to_image에 전달하거나, 2개 이상의 참조인 경우 경로 목록을imagine_reference_to_image에 전달합니다(생성된 이미지에는 이미file_path가 있고 로컬 파일은 샌드박스 경로를 사용). 또한 로컬 참조를 볼 수 있도록read_file로 읽습니다. - 참조 역할을 명시적으로 명시합니다: 정체성/스타일 유지, 동일한 대상에 대한 애니메이션 시트 생성, 진화/변형 생성, 일치하는 소품/FX 파생.
- 참조에서 안정적인 정체성 마커를 유지합니다: 실루엣, 팔레트, 얼굴/눈 특징, 의상 마크, 주요 액세서리 및 재료 언어.
- 요청된 액션 또는 진화만 변경되도록 합니다. 사용자가 요청하지 않는 한 대상을 재설계하지 마세요.
- 여전히 정확한 시트 모양, 단색 마젠타 배경, 프레임 포함 및 모든 프레임에서 동일한 스케일을 요구합니다.
엄격한 부분 유지:
- 단색
#FF00FF배경 - 정확한 시트 모양
- 모든 프레임에서 동일한 캐릭터 또는 에셋 정체성
- 모든 프레임에서 동일한 경계 상자 및 픽셀 스케일
- 명시적 포함: 어떤 것도 셀 가장자리를 넘을 수 없음
혼합 액션 아틀라스 안전 장치:
imagine_text_to_image에 조작 가능한 영웅 또는 주인공에 대해행 1 idle, 행 2 run, 행 3 shoot, 행 4 jump와 같이 관련 없는 액션 행을 하나의 원시 시트로 생성하도록 요청하지 마세요.imagine_text_to_image에 조작 가능한 영웅, 캐릭터, 생물, NPC, 적, 소환수 또는 애니메이션 소품에 대해1x4 idle,1x4 run,1x4 shoot또는1x4 jump와 같은 원시 단일 행 액션 스트립을 생성하도록 요청하지 마세요.- 엔진에 결합된
4x4,5x5, 사용자 정의 아틀라스 또는 행 스트립 전달 형식이 필요한 경우, 액션 그리드를 별도로 생성하고, 별도로 처리 및 품질 확인한 다음, 전달 아틀라스를 결정적으로 조립합니다. - 예외는 표준 방향성 이동 시트, 하나의 연속적인 긴 액션 시퀀스, 소품 팩, 타일셋 같은 아틀라스 및 위험이 낮은 컴팩트한 적 전투 시트입니다. 이러한 경우에도 하나의 일관된 프롬프트와 시각적 품질 확인이 필요합니다.
- 발사체, 머즐 플래시, 충격, 먼지 흔적 및 분리된 FX는 동일한 액션 실루엣의 일부로 의도되고 단단히 부착된 상태로 유지되지 않는 한 별도의 시트에 보관합니다.
- 조작 가능한 영웅과 주인공의 경우, 효과로 인해 액션 bbox가 idle/run보다 훨씬 넓거나 높아지면