# Plugins for Tiled

Two custom tool plugins for [Tiled Map Editor](https://www.mapeditor.org/).

> **Disclaimer:** These plugins are provided as-is. I take no responsibility for what they do, how they work, any data loss, or any other consequences of using them. Use at your own risk.

---

## Installation

Copy the `.js` files into your Tiled plugins directory:

- **Linux/macOS:** `~/.config/tiled/plugins/`
- **Windows:** `%APPDATA%\Tiled\plugins\`

Restart Tiled. The tools will appear in the toolbar.

---

## random-tile-placer.js

Paints a randomly selected tile from your current tileset selection onto a tile layer with each click.

**Usage:**

1. Select a tile layer in the Layers panel.
2. In the Tilesets panel, select one or more tiles (hold Ctrl or Shift to select multiple).
3. Activate the **Random Tile Placer** tool from the toolbar.
4. Click on the map to place a random tile from your selection at that position.

---

## random-object-placer.js

Places a randomly selected tile as a map object onto an object layer with each click. Has a 50% chance to flip the object horizontally, useful for adding natural variation to decorations.

**Shortcut:** `R`

**Usage:**

1. Select an object layer in the Layers panel.
2. In the Tilesets panel, select one or more tiles (hold Ctrl or Shift to select multiple).
3. Activate the **Random Object Placer** tool from the toolbar (or press `R`).
4. Click on the map to place a randomly chosen tile object, centered on your cursor. It will be randomly flipped horizontally about half the time.