arrow_back Docs
grid_view

Map Editing

Paint maps with layers and objects

The map editor is the main workspace for building tile maps, arranging layer data, placing object metadata, and preparing engine-ready layouts.

Step 1

Choose the right tool

The toolbar keeps the core map tools close to the canvas. Use paint for normal tile placement, erase for cleanup, fill for broad regions, select for editing regions, and autotile when a configured terrain rule should choose tile variants for you.

  • S selects the Select tool.
  • B selects the Paint tool.
  • A selects the Autotile tool.
  • E selects the Erase tool.
  • G selects the Fill tool.
  • Number keys 1 through 5 set brush size.

Step 2

Build with layer intent

Keep visual art, background images, gameplay objects, and organizational groups separated. Tile layers are best for grid painting, image layers are useful for backgrounds or parallax-like art, object layers hold gameplay markers, and layer groups help keep larger maps readable.

  1. Create a tile layer for each major visual or gameplay tile pass.
  2. Use image layers for larger non-grid artwork such as backgrounds.
  3. Use object layers for spawn points, collision zones, triggers, and text markers.
  4. Group related layers when a map becomes large enough to need structure.

Step 3

Move quickly while editing

The editor includes shortcuts for iteration-heavy work: undo and redo, tile copy and paste, deletion, tile orientation, map zoom, find and replace, and quick export. These are useful when you are trying variations rather than placing every tile one at a time.

  • Ctrl+Z or Cmd+Z undoes; Ctrl+Shift+Z, Cmd+Shift+Z, or Ctrl+Y redoes.
  • Ctrl+C, Ctrl+X, and Ctrl+V copy, cut, and paste tile selections.
  • H and V flip a hovered tile horizontally or vertically.
  • + and - zoom the map canvas.
  • Ctrl+H or Cmd+H opens find and replace.

Next guides

auto_awesome

Import tilesets and paint terrain

Prepare grid-aligned tilesets, assign terrain rules, use autotile painting, and fill regions with weighted tile sets.

keyboard

Keyboard shortcuts

Keep editing fast with tool, brush, save, export, zoom, orientation, clipboard, and find-and-replace shortcuts.

output

Move projects into game engines

Import and export native files, raster images, Phaser bundles, Tiled maps, Godot scenes, Unity bundles, GameMaker rooms, Defold resources, tIDE maps, and Mappy FMP maps.