generate2dmap

by 0x0funky4.5k

Install

Use withClaudeCursorCodex

The file stays in the publisher's repository. PlugMCP does not host or rewrite it.

Download skill skills/generate2dmap/SKILL.md on GitHub

Related skills

View all

C
codeart2dExplicit-only last resort. Draws game art from code, with no image model - pixel sprites from a PixelSpec, flat vector props, UI and icons from portable SVG, rigged characters with planted feet, FX wi
G
generate2dmediaThe art-route layer of the Forge skills. route_media.py is the one command that generates an image or an image-to-video clip - through the paid API of any provider whose key is configured (OpenAI, Goo
G
generate2dspriteMake game-ready 2D characters, creatures, props, icons and FX as master stills, sprite sheets or animation clips. Plan size, motion and finish; generate the art (image generation is the default, throu

Plan and build 2D game maps and scenes - top-down and side-scrolling levels, tilemaps, prop packs, parallax backgrounds and HD-2D battle or story plates - with collision, navigation and reachability checks, environment motion, a playable HTML preview and export to Tiled, Godot 4 or LDtk. Map art (terrain, tiles, props, plates, parallax layers) is image generation by default, through generate2dmedia route_media.py (the API when a key is configured, else the local Codex or Grok CLI); map data (layout, collision, exits, spawns) is written as data. Use for any map, level, room, scene, background, terrain or prop-kit request. Not for characters, creatures, items or FX (generate2dsprite), character animation (video2dsprite), code-drawn tiles or maps (codeart2d, only on request) or calling an image or video API by itself (generate2dmedia).

Need

Route

Props from a sheet

extract_prop_pack.py --input <sheet> --rows R --cols C --labels a,b --output-dir <new> (--grid-rounding nearest, --auto-boxes, --boxes-file <json> --keep-canvas, --world-scale 3/8, --suggest-footprint ellipse); place by anchor_px (prop-pack-contract.md)

Terrain fills, overlays, iso or hex, Wang rows

extract_terrain_tiles.py --strict-qc (--layer overlay, --shape iso-diamond, --wang NAME=A/B:MASKS; --edge-policy seamless only for art meant to tile)

Platform caps and middles

extract_platform_strip.py --strict-qc (side-scroll-scenes.md)

Code-drawn autotiles, only on request

codeart2d autotile_build.py (seam-proven tileset manifest), then the exporters

A code-drawn playable map, only on request

codeart2d layout_build.py (writes map_bundle.v2), then map_nav.py check and the exporters

Draw order, contact anchors, placement audit

compose_layered_preview.py --base <png> --placements <json> --output <png> --report <json>; with --bundle <map_bundle.json> --debug-overlay --audit-out <json> look at both

Validate a playable map

map_bundle.py validate --bundle  (map_bundle.py hash fills sha256), then map_nav.py check --bundle --output-dir <new> (--link each neighbour); review nav-debug.png; map_nav.py query tests one spot or move

Walk the map, check every route

build_scene_preview.py --bundle --output-dir <new> --verify; attach scene-snapshot.json (scene-preview.md)

Export

export_tiled.py export --bundle --output-dir <new> (--embedded-variant for Phaser); export_godot.py --bundle --output-dir <new>; export_ldtk.py --bundle --output-dir <new> (engine-maps.md)

Room chunks; side-scroll grammar

validate_chunks.py --chunks <json> --output-dir <new>; validate_layout.py --layout <json> --output-dir <new>

Parallax

validate_parallax.py --spec <plan> --report <qa.json> (declare camera.pivot and the aspects you ship); code-drawn layers on request: codeart2d parallax_build.py (parallax-backgrounds.md)

Fit a painting to the game size or floor

conform_background.py conform --mode cover or --mode ground-fit; subjects on every screen aspect: conform_background.py validate-crops

HD-2D plate

hd2d-plates.md: plan stage.json, scene_layout_guide.py, generate with guide.png attached, then validate_stage.py --stage <json> --output-dir <new>; look at every layout-*.png

Lights, shadows, atmosphere

hd2d-presentation.md: extract_scene_lights.py extract --stage <json>, curate lights.json

Night, lit or damaged variant of a plate

edit_locality_check.py --before <master> --after <variant> --stage <json> --edit-box <box>; regenerate on failure

Water, fire, mist or cloth on a still plate

background-scenes.md: build_motion_mask.py --envelope-from <clip>, scene_motion.py build, then scene_motion.py qa on the decoded file; code-drawn ripples or glow on request: codeart2d ambient_bake.py

Full-frame scene loop

generate2dsprite assemble_frames.py (--static-regions, --loop-overlap K --ambient)

Collision and paths in a web game

references/runtime/map-runtime.mjs (same rules as map_nav.py)

generate2dmap

Install

Related skills

Generate 2D Map

Use when

Do not use when

Capability check (once per session)

Art source

Host notes

Commands

Plan before art

Pipeline

Acceptance

References