Communitygithub.com

2D 게임 맵 생성기

실전용 2D 게임 맵을 생성합니다: RPG/탑다운 맵, 사이드 스크롤러 배경, 타일맵, 레이어드 래스터 맵, 소품 팩, 충돌 영역, 이동 가능 영역. 브라우저 게임을 만들 때 실제 맵 아트가 필요하면 사용하세요.

2D 게임 맵 생성기란 무엇인가요?

이 스킬은 2D 게임 개발을 위해 'imagine_text_to_image'를 활용해 프로덕션에 바로 쓸 수 있는 게임 맵을 생성합니다. RPG 탑다운 맵, 사이드 스크롤러 파라랙스 스테이지, 타일맵, 레이어드 래스터 맵, 소품 팩, 충돌 지대 등 다양한 포맷을 지원하며, 플레이 가능한 맵을 만들기 위한 전체 파이프라인을 제공합니다. 주요 기능으로는 타일 기반 편집(tile_mode), 개별 소품 배치(scene_mode), 파라랙스 사이드 스크롤(side_scroll_mode) 등 6가지 맵 모드를 지원하며, 사용자 요청에 적합한 모드를 자동으로 추천합니다. 이 스킬은 이미지 생성 프롬프트를 직접 작성하고, 생성된 아트를 슬라이스/크로마키/크롭하여 JSON 또는 엔진 파일로 내보냅니다. 맵은 단일 이미지가 아니라 여러 레이어와 충돌 정보, 메타데이터로 구성된 플레이 가능한 번들로 제공됩니다. Phaser, Godot, Unity, Tiled 등 여러 엔진을 지원하지만 기본값은 raw_canvas 또는 Phaser입니다. 문자, 적, NPC 등은 'generate2dsprite' 스킬로 처리하고, 맵에는 스폰 마커나 트리거 같은 메타데이터만 포함시킵니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/evalix098/tiktoklive/tree/HEAD/.grok/skills/generate2dmap

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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_targetraw_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; 맵 완료를 선언하기 전에 두 가지를 모두 실행하세요.

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

evalix098/tiktoklive

Add user accounts and sign-in to this TanStack Start app. Use when the app needs authentication, sign-in, user accounts, protected routes, or per-user data. Triggers on "auth", "login", "log in", "sign in", "sign up", "account", "users", "authentication", "protected", "who is logged in", "current user", "per-user".

evalix098/tiktoklive

Build browser games and interactive/canvas/3D experiences in this TanStack Start + React app. Use for any game, simulation, or WebGL/Canvas experience — 2D or 3D, single-player. Covers the game loop & timing, 3D orientation/camera conventions, collision, performance, assets, audio, save, game feel, and per-genre playbooks. For WASD / vehicle / flight **input signs and inverted A/D**, open the **`controls`** skill — do not rely on this file or racing-kart alone. Triggers on "game", "minecraft", "fps", "platformer", "racing", "tetris", "snake", "shooter", "3d", "three.js", "canvas", "voxel", "physics".

evalix098/tiktoklive

Player-facing input signs for browser games: WASD, vehicles, flight, FPS mouse-look, and the #1 failure mode (inverted A/D). Mandatory control self-tests and a tiny test interface so you can verify A turns left before shipping. Load for ANY game with movement, steering, flying, driving, tanks, boats, mechs, drones, planes, karts, third-person follow cams — not only racing. Triggers on "controls", "WASD", "inverted", "steer", "flight", "airplane", "kart", "vehicle", "yaw", "roll", "pitch", "mouse look", "A/D".

evalix098/tiktoklive

Design and build polished, non-generic UI for this TanStack Start + React + Tailwind v4 + shadcn/Radix app. Use whenever you create or restyle any interface surface — pages, landing pages, dashboards, forms, modals, nav, and game overlays (start screens, HUD, menus). Covers design tokens, layout, typography, color, spacing, motion, and the anti-"AI-slop" rules that keep output from looking generic. Triggers on "design", "UI", "make it look good", "polish", "landing page", "theme", "style", "redesign", "ugly", "clean up".

evalix098/tiktoklive

Deep guide for game ANIMATION assets: motion cycles, action keyframes, effect sequences, and animation sprite sheets — built around a video-first pipeline. In this app-builder sandbox, execute via the video2dsprite / generate2dsprite skills (magenta + scripts), not ad-hoc ffmpeg. Use whenever generating anything that moves: walk/run cycles, attacks, idles, FX, flags, fire, animation sheets. Complements game-asset-core.

evalix098/tiktoklive

Core discipline for ANY game-asset generation with Imagine tools: the engine-ready defaults users don't state, spec checklists, style anchoring, read-back verification, honest defect flagging. Use whenever generating any game art (sprites, sheets, animations, tiles, UI, FX) — then ALSO load the matching specialist skill: game-animation-frames for anything that moves, game-tilesets for tiles/terrain, game-character-consistency for recurring characters, game-ui-icons for UI and icons.

evalix098/tiktoklive

Deep guide for CHARACTER IDENTITY across images: turnarounds (front/side/ back), state and damage variants, palette swaps, equipment changes, and same-character-in-context sets. Use whenever generating character turnarounds, character sheets, variants of an existing sprite, or any same-subject multi-image set. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game TILE assets: seamless tileable textures, terrain transition tilesets, autotiles, and ground/platform tiles. Use whenever generating tileable textures, tilesets, terrain transitions, or seamless patterns. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game UI assets: buttons with interaction states, panels, bars, wordmark logos, and icon sets. Use whenever generating game UI elements, HUD assets, inventory icons, icon sets, buttons, or title logos. Complements game-asset-core.

evalix098/tiktoklive

Generate and postprocess 2D game sprites and animation sheets: pixel-art characters, NPCs, creatures, spells, projectiles, impacts, props, summons, and transparent PNG/GIF exports. Use when building browser games that need real sprite sheets (not code-drawn placeholders), matching a map art style, or producing magenta-background sheets for chroma-key cleanup. Triggers on "sprite", "sprite sheet", "animation sheet", "pixel art character", "walk cycle", "attack animation", "projectile sprite", "2D game asset".

evalix098/tiktoklive

How to use the Imagine tools in Grok Build: imagine_text_to_image, imagine_image_to_image, imagine_reference_to_image, imagine_text_to_video, imagine_image_to_video, imagine_reference_to_video, and render_file for chat previews. When to build a visual with code instead of generating it, prompt-craft, reference-first handling of real people, factual grounding, and asset-consistency. Load this whenever generating or editing an image or video is on the table. Tool-usage-driven, not triggered by a user merely mentioning images.

evalix098/tiktoklive

Peer-to-peer realtime multiplayer over WebRTC data channels: every user of the deployed app connects directly to every other user (full mesh), the server only brokers the handshake at /api/rtc. Lowest possible latency, zero per-message server cost. Use for 2-8 player co-op/casual realtime: shared cursors, drawing, party games, casual action. Triggers: p2p, peer to peer, webrtc, low latency multiplayer, direct connection.

evalix098/tiktoklive

Use Neon Postgres (the database) in this TanStack Start app. Use when the app needs to store or query data, persist state, or keep per-user data. Triggers on "database", "Postgres", "Neon", "save data", "store data", "persist", "tables", "SQL", "query", "migrations".

evalix098/tiktoklive

Share-link previews and app identity for apps on *.grok.me: the injector-owned og:image card, the SVG favicon, and PWA icons for installable apps. Use when scaffolding, renaming, or restyling the app — and for share / unfurl / OG / Twitter card questions. A custom 1200×630 card from the app's own art is the default — games of every kind (DOM board/word games included), whimsical apps, creative tools, and brand-forward pages; only plain utilities keep the placeholder. Always run the brand-asset pass as a `task` subagent and never wait for it. Triggers on "share", "rename", "app name", "OG", "Open Graph", "twitter card", "unfurl", "og:image", "og:type", "x:game:image", "x-banner", "link preview", "social card", "thumbnail", "preview image", "favicon", "app icon", "PWA", "manifest", "installable", "home screen", "SEO", "meta description".

evalix098/tiktoklive

Official Three.js API and TSL (Three.js Shading Language) reference for LLM code generation. Load when writing or debugging three.js / WebGL / WebGPU / custom materials / shaders / GLTF / advanced three APIs beyond basic game loop/controls. Prefer building-games for game correctness (loop, WASD, camera, orientation); use this skill for full API/TSL depth. Triggers on "three.js", "threejs", "WebGPU", "TSL", "NodeMaterial", "shader", "GLTF", "MeshStandard", "OrbitControls", "WebGLRenderer".

evalix098/tiktoklive

Grok Build only. Turn a 2D character still into denser animation sprites via imagine_text_to_image base → imagine_image_to_video (6s/10s run-in-place) → ffmpeg frames → magenta chroma-key → dense sampled strips/grids/GIFs. Use when the user wants video-to-sprite, smoother run/walk cycles, or denser intermediate poses. Prefer generate2dsprite for crisp production pixel sheets. Triggers on "video to sprite", "imagine_image_to_video sprite", "dense walk cycle", "smooth run animation from video".

evalix098/tiktoklive

Call the xAI API (Grok) from this app's server code using the injected XAI_API_KEY: chat/LLM features, image and video generation (Imagine), and voice (text-to-speech). Use when the app needs any "AI" / "assistant" / "chatbot" / "Grok" functionality, runtime image/video generation, or speech. Triggers on "AI", "LLM", "chatbot", "assistant", "Grok", "xAI", "generate text", "summarize", "generate image", "AI video", "voice", "text to speech", "TTS", "OpenAI" (use xAI instead).

관련 스킬