Generate2dmap
App-builder / Grok 환경
| 항목 | 값 |
|---|---|
| 스킬 디렉토리 / 스크립트 | .grok/skills/generate2dmap/, python3 .grok/skills/generate2dmap/scripts/<script>.py … 로 실행 |
| 이미지 도구 | imagine_text_to_image / imagine_image_to_image (경로 기반; imagine 참조); 출력물은 PNG 경로를 read_file로 검사 (Codex view_image 아님) |
| 생성된 이미지 경로 | imagine_text_to_image → 샌드박스 file_path → assets/map/에 복사; Pillow 사전 설치됨 |
기본 engine_target | raw_canvas 또는 Phaser (이 TanStack 브라우저 샌드박스용); 사용자가 명시적으로 원하는 경우에만 Godot/Unity/Tiled 사용 |
| 관련 스킬 | generate2dsprite (캐릭터/FX 스프라이트; 소품 팩은 여전히 이 스킬의 추출 스크립트 사용), building-games, imagine |
먼저 파이프라인 결정
게임에 적합한 가장 작은 플레이 가능 맵 번들을 만듭니다: 제품 수준의 map_mode를 선택한 후, 하위 축(visual_model, runtime_object_model, collision_model, engine_target)을 결정합니다.
tile_mode— 편집 가능한 타일/그리드 맵: 포켓몬스터 스타일 경로, 탑다운 RPG 마을, 플랫포머 타일맵, 또는 Tiled/LDtk/Godot/Unity/Phaser 타일맵을 사용하는 프로젝트.scene_mode— 기반 바탕 + 개별 소품: 타워 디펜스, 서바이버스 스타일 아레나, 아늑한 탑다운 전시 맵.side_scroll_mode— 파라랙스 사이드 스크롤러 스테이지: 메가맨 스타일, 액션 플랫포머, 메트로이드배니아 방, 러너, 격투 게임.grid_mode— 규칙 중심 그리드: 전술 RPG, 공장/자동화, 보드/카드 배틀러, 건설 그리드.room_chunk_mode— 모듈식 방/청크: 로그라이크 던전, 메트로이드배니아 네트워크, 절차적 조립.baked_scene_mode— 명시적으로 평면적이고 플레이 불가능한 장면만: 타이틀/메뉴 화면, 전투 배경, 비주얼 노벨 장면, 컨셉 아트.
사용자가 지정한 파라미터가 있으면 사용하고, 없으면 기존 게임, 카메라, 충돌 요구사항, 맵 스케일, 편집 요구사항에서 가장 가벼운 플레이 가능 파이프라인을 추론합니다. 모드와 축이 충돌할 경우 모드의 플레이 가능/편집 가능 계약이 우선합니다. 장르 라우팅, 모드별 축 기본값, 프리셋, 에스컬레이션 휴리스틱은 references/map-strategies.md에서 확인하세요. 선택이 명확하지 않을 때마다 읽으십시오.
플레이 가능한 맵은 절대 단일 이미지가 아닙니다. 플레이 가능한 맵, 레벨, 스테이지, 방, 프로토타입, 또는 엔진 장면을 요청하는 모든 경우, 결과물은 게임플레이 지오메트리와 오브젝트를 별도의 레이어, 소품, 타일/오브젝트 데이터, 충돌, 영역, 또는 엔진 네이티브 장면 노드로 노출해야 합니다. 단일 이미지는 배경, 참조, 또는 미리보기 아티팩트일 수 있으며 — 런타임 맵이 아닙니다 — 사용자가 명시적으로 평면 배경만 요청한 경우는 예외입니다.
장면과 맵만 생성합니다. 캐릭터, 적, 보스, NPC, 플레이어, 발사체, 애니메이션 스프라이트는 여기서 생성하지 마십시오. 해당 작업은 $generate2dsprite에 속합니다. 맵은 장면 훅(스폰 마커, 순찰/조우 영역, 아레나 입구, 게이트, 출구, 카메라 트리거)을 메타데이터로만 담으며, 그려진 아트로는 포함하지 않습니다.
아트는 이미지 생성에서 비롯되며, 직접 프롬프트를 작성합니다
imagine_text_to_image는 기본 맵, 파라랙스 판, 참조 이미지, 소품 시트, 타일셋 아트의 기본 아트 소스입니다. 기본art_style은clean_hd(손으로 그린 HD, 선명하고 읽기 쉬운 형태, 낮은 텍스처 노이즈, 두툼한 픽셀 없음); 요청 시에만pixel_inspired또는retro_pixel을 사용하세요.- 창의적인 프롬프트는 직접 작성해야 합니다. 스크립트는 조합, 슬라이스, 크로마키, 크롭, 검증, 미리보기 구성, JSON/엔진 파일 출력을 수행할 수 있습니다 — 창의적인 프롬프트를 작성하거나 최종 아트를 그리지 마십시오. 사용자가 명시적으로 플레이스홀더, 고정물, 디버그 맵, 또는 스캐폴딩을 요청한 경우에만 절차적/플레이스홀더 아트를 사용하십시오. 타일 엔진을 대상으로 할 경우 먼저 타일셋 아트를 생성한 다음, 스크립트는 레이어, 충돌, 영역, 장면 연결만 처리합니다.
- 실행 시 새로운 시각적 자산을 생성할 때마다 각 프롬프트를 해당 자산 옆에
<asset>.prompt.txt로 저장합니다 (또는 명시적 매니페스트 필드). - 참조 전달은 파일 경로이며, 문장이 아닙니다. 이전 이미지를 기반으로 작업하려면 샌드박스
file_path를imagine_image_to_image에 전달하고 (read_file로 확인), 보존할 구체적인 특징을 명명하세요: 카메라 프레이밍, 수평선, 도로/물 형태, 지형 경계, 입구/출구, 랜드마크. 파일 이름, "맵 기준", 또는 이미지가 대화에 보이는 것만으로는 전달이 아닙니다 — 중단하고 경로를 전달하세요.
런타임 오브젝트는 기본 레이어에서 제외
처음 생성된 기본/배경/기반 이미지는 안정적이고 상호작용이 없는 기반 아트만 담아야 합니다 — 지면 재질, 경로, 도로, 물, 절벽, 바닥 패턴, 차선 표시 및 건설 패드; 측면 보기의 경우 하늘, 먼/중간 풍경, 실루엣, 분위기; 타일맵의 경우 타일셋 아트를 편집 가능한 레이어로. 다음을 포함해서는 안 됩니다: 높은 소품, 건물, 나무, 바위, 상자, 표지판, 문, 게이트, 픽업, 상자, 체크포인트, 위험 요소, 함정, 포탑, 사다리, 전경 차폐물, 파괴 가능한 물체, 액터, 적, NPC, UI, 라벨, 또는 충돌, 상호작용, 재사용, y-정렬, 애니메이션, 자체 렌더 순서가 필요한 모든 것 — 기반 전용 이미지를 다시 생성하거나 해당 이미지를 참조 아티팩트로 강등하세요.
참조 목업은 체크포인트이지 최종 결과물이 아닙니다
드레스드 참조(탑다운) 및 스테이지 참조(사이드 뷰)는 게임 세계 내 배치를 계획합니다: 자연스러운 게임 월드 오브젝트 또는 미묘한 블록아웃 지오메트리, 최대 9개의 뚜렷한 시각적 오브젝트 후보 (반복은 한 번으로 계산한 후 배치 메타데이터에서 재발생), 주석 그래픽 없음 (원, 화살표, 외곽선, 라벨, 텍스트, 콜아웃, 범례, 측정선), 그리고 비시각적 메타데이터 없음 — 스폰, 트리거, 순찰 힌트, 카메라 경계는 이후에 장면 훅으로 작성됩니다.
생성했다고 거기서 멈추지 마세요. 계속해서 references/object-production-gate.md를 따르세요: 두 이미지를 read_file로 다시 읽고, 오브젝트 목록을 작성하고, 최종 개별 오브젝트를 생성하고, 배치/충돌/장면 훅 메타데이터를 작성하고, QA 미리보기를 구성하세요. 사용자가 명시적으로 컨셉 이미지를 요청하지 않는 한, 참조 전용 출력은 불완전한 실행입니다.
선택한 파이프라인의 심층 정보 — 자산 생산 전에 열어보십시오
- 레이어드 래스터 맵 →
references/layered-map-contract.md(레이어 유형, 기본 및 소품 프롬프트 패턴, 소품 메타데이터, 렌더 순서, 충돌, QA 체크리스트). side_scroll_mode→references/side-scroll-stages.md:stage_canvas결정, 명명된 풍경 전용 파라랙스 레이어, 플랫폼/오브젝트 작업 전에 반드시 필요한 게임 내 스테이지 참조.- 소품 또는 장면 오브젝트 생성 → 먼저 각 오브젝트를 분류하고
references/prop-pack-contract.md를 따르세요: 컴팩트 소품만 정사각형 소품 팩을 공유할 수 있습니다; 플랫폼, 바닥, 다리, 게이트, 건물 및 충돌 정렬이 필요한 모든 것은 하나씩, 플랫폼 스트립, 맞춤형 와이드 팩, 또는 타일/오브젝트 레이어로 처리합니다. - 파라미터, 단계별 워크플로우,
extract_prop_pack.py/compose_layered_preview.py명령어 →references/pipeline.md. - 파이프라인별 결과물 목록 및 검증 체크리스트 →
references/deliverables.md; 맵 완료를 선언하기 전에 두 가지를 모두 실행하세요.