PlacementPlugin

🌻 PlacementPlugin 🌻

> An intuitive building tool for Paper/Spigot 1.20+ that lets you place blocks creatively through a configurable GUI and a special “Placeler” wand – no WorldEdit required.

---

✨ Features

- Color‑coded Items & Flexible Config — `/farmplace` opens an inventory GUI with configurable blocks, plants, and water‑/lava‑source items. - Color‑coded Items & Flexible Config - Color‑coded Items & Flexible Config: places blocks with `physics=false`; water/lava stay static. - Color‑coded Items & Flexible Config: re‑opens the GUI. - Color‑coded Items & Flexible Config — `/pradius <1‑20>` - *1* = single block - *>1* = square area of `(2r + 1) × (2r + 1)` blocks. - Color‑coded Items & Flexible Config — `/plundo` & `/plredo` roll back or restore multiple steps (stack‑based). - Color‑coded Items & Flexible Config — GUI titles and item labels accept Minecraft color codes (`&aGrass`). All materials, GUI size, defaults, and permissions live in `config.yml`.

---

🛠 Installation

1. Drop the JAR into your `plugins` folder. 2. Restart the server *or* run: ```bash /reload confirm ``` 3. Adjust `plugins/PlacementPlugin/config.yml` as needed and restart again.

---

💻 Commands

| Command | Description | |---------|-------------| | `/farmplace` | Open the build GUI | | `/pc` | Clear the current Placeler wand | | `/pradius <n>` | Set placement radius (1 – 20) | | `/plundo` | Undo last placement | | `/plredo` | Redo last undo |

---

🔐 Permissions

| Node | Purpose | |------|---------| | `farmplace.use` | Open GUI | | `farmplace.clear` | Clear wand | | `farmplace.radius` | Change radius | | `farmplace.undo` | Run undo | | `farmplace.redo` | Run redo |

---

⚙ Configuration Snippet

```yaml

plugins/PlacementPlugin/config.yml

farm-items: TALL_GRASS: "&2Tall Grass" FERN: "&2Ferns" LARGE_FERN: "&2Large Ferns" RED_MUSHROOM: "&cRed &4Mushrooms" BROWN_MUSHROOM: "&6Brown &cMushrooms" OXEYE_DAISY: "&fOxeye Daisy" DANDELION: "&eDandelion" POPPY: "&cPoppy" SUNFLOWER: "&eSunflower" LILAC: "&dLilac" PEONY: "&dPeony" ROSE_BUSH: "&cRose Bush" LILY_PAD: "&2Lily Pad" VINE: "&2Vines" SUGAR_CANE: "&aSugar Cane" CACTUS: "&2Cactus" BAMBOO: "&aBamboo" MOSS_CARPET: "&2Moss Carpet" WATER: "&bWater" LAVA: "&cLava"

Add more items by increasing gui-size. Maximum: 54  Minimum: 9

gui-size: 27 gui-title: "&a&lItems"

default-radius: 1 max-radius: 20

```

---

Need help? • Open an issue • Join our Discord (https://discord.gg/XBZfsANgCP)