Command · tilemap

tilemap.paint

Paint tile cells as one undoable stroke, optionally auto-tiling terrain.

scope edit:scenenot idempotentnon-destructive

Params

Typed as TilePaintParams. Fields marked * are required.

entity*

entity

Tilemap entity, including prefab addresses.

required

layer*

string

Stable layer ID.

required

cells*

list<PaintCell>

Stroke samples in input order; later duplicates win.

required

autotile

option<bool>

Re-run terrain rules on the stroke and its neighbors in the same transaction (default false).

default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "tilemap.paint",
  "args": {
    "entity": "e_map1",
    "layer": "l_ground",
    "cells": [
      {
        "x": 0,
        "y": 0,
        "tile": 1
      },
      {
        "x": 1,
        "y": 0,
        "tile": 1
      }
    ],
    "autotile": true
  }
}

CLI

ara do tilemap.paint --args '{"entity":"e_map1","layer":"l_ground","cells":[{"x":0,"y":0,"tile":1},{"x":1,"y":0,"tile":1}],"autotile":true}' --why "…"