Skip to content
SkillScript-led2,970 tokens in use

generate2dmap

Plan and build 2D game maps and scenes with generated art, collision and reachability checks, environment motion, a playable HTML preview and export to Tiled, Godot or LDtk.

5,887 stars on the repository MIT License0x0funky/agent-sprite-forge · skills/generate2dmap
claude plugin marketplace add 0x0funky/agent-sprite-forge --sparse .claude-plugin skills && claude plugin install agent-sprite-forge@agent-sprite-forge
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing generate2dmap costs

210tokens idle
2,970tokens in use
81,105tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Script-led

Script-ledMixedModel-led

Most of this skill is scripts, so it behaves much the same whichever model runs it.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: references/runtime/map-runtime.mjs, scripts/build_motion_mask.py, scripts/build_scene_preview.py, scripts/compose_layered_preview.py, scripts/conform_background.py, scripts/edit_locality_check.py, scripts/export_godot.py, scripts/export_ldtk.py, scripts/export_tiled.py, scripts/extract_platform_strip.py, scripts/extract_prop_pack.py, scripts/extract_scene_lights.py, scripts/extract_terrain_tiles.py, scripts/forge_av.py, scripts/forge_core.py, scripts/forge_hibit.py, scripts/forge_index.py, scripts/forge_matte.py, scripts/forge_nav.py, scripts/forge_schema.py, scripts/hibit_plate.py, scripts/map_bundle.py, scripts/map_nav.py, scripts/scene_layout_guide.py, scripts/scene_motion.py, scripts/validate_chunks.py, scripts/validate_layout.py, scripts/validate_parallax.py, scripts/validate_stage.py.

Touches

shelldetectednetworkdetectedwrites filesdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter8/15
  • Structure19/25
  • Examples0/15
  • Output15/15
  • Size8/15
  • Resources11/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Fair
  • Reaches the network−10

    does this on the machine, and the frontmatter does not say so

    scripts/build_scene_preview.py, line 782
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    scripts/build_scene_preview.py, line 1646
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    scripts/build_scene_preview.py, line 1831
  • Hidden characters−20

    characters that render as nothing or reorder the text

    scripts/forge_core.py, line 478

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity96
  • Maintenance84
  • Community44
  • Maturity28
  • Momentum40

Generate2DMap builds the smallest scene bundle a game needs: top-down or side-scrolling levels, tilemaps, prop kits, parallax backgrounds and HD-2D battle or story plates. Map art such as terrain, tiles, props and plates comes from image generation, while layout, collision, exits and spawns are written as validated data.

The agent records viewport, world size, camera, actor scale and routes before any art is made, then checks navigation and reachability and previews the result in a playable HTML page.

What You Get

  • A scene bundle with map art, layout, collision, exits and spawn data
  • Reachability and navigation checks on the map geometry
  • A playable HTML preview and optional environment motion such as water or mist on a plate
  • Exports for Tiled, Godot 4 or LDtk

Common Use Cases

  • Build a top-down town or dungeon with collision and exits
  • Create a parallax side-scrolling stage with movement geometry
  • Generate a battle or title backdrop with lights and ambient motion
  • Convert a generated map into Tiled, Godot or LDtk files

What Makes It Unique

It treats a painting and a playable map as different things: a background needs no game system, while a playable map needs explicit geometry. Every asset records its art source and route, and the agent is told never to claim a generation that did not happen. It also indexes everything the Forge skills made in a folder.

Under The Hood

The agent runs a capability check and Python scripts from the skill folder through the shell, and a media route command that sends prompts and reference images to an image or video provider (OpenAI, Google Gemini, xAI, BytePlus or fal.ai) when you have set a key in the environment or a user config file, or to your signed-in Codex or Grok command line tool. Paid calls are logged in a ledger file in the project. It needs Python with numpy and Pillow, ffmpeg for scene motion and node for the browser runtime, and it writes new output folders in your project. Read the scripts before running them on a sensitive machine; the automated scan findings are shown on the page.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers