place_object
Place multi-tile objects such as houses or trees on a map, stamping them onto the upper tile layer and reporting passability, with warnings for collisions or impassable terrain.
Instructions
Place a multi-tile B/C object (a house, tree, fountain, …) on a map and report its passability. tiles is the object's block of flat tile ids as rows (top to bottom), each row left to right; a 0 leaves that cell untouched so L-shaped/irregular objects work. Stamped onto the upper tile layer (2) by default so it draws over the ground. Unlike paint_tiles this does NOT autotile (objects are flat sheet tiles) — instead it uses the tileset flags to warn when a footprint cell sits on impassable terrain or overwrites an existing tile, and returns the resulting per-cell passability plus the collision cells the object turns into a solid obstacle. Warn-by-default: never refuses a placement. Get tile ids from find_tile/get_tile_catalog.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Left (top-left) tile x of where the object is placed | |
| y | Yes | Top (top-left) tile y of where the object is placed | |
| layer | No | Z-layer 0-3 to stamp onto (default 2 = upper tile layer, drawn over the ground) | |
| mapId | Yes | The ID of the map | |
| tiles | Yes | The object as a rectangular grid of tile ids: rows top→bottom, each row left→right. 0 = a transparent cell (left untouched). | |
| dryRun | No | Preview only: return a diff of what would change without writing to disk. |