Adding plugins

README.md

@@ -1 +1,44 @@
-# tiled-plugins
+# 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.