# 🌻 PlacementPlugin 🌻
> **一个为 Paper/Spigot 1.20+ 设计的直观建筑工具，通过可配置的 GUI 和一个特殊的“Placeler”魔杖，让您可以创造性地放置方块——无需 WorldEdit。**
---
### ✨ 特性
- **GUI 选择** — `/farmplace` 打开一个带有可配置方块、植物和水/熔岩源物品的物品栏 GUI。
- **Placeler 魔杖**
- **右键点击**: 放置带有 `physics=false` 的方块；水/熔岩保持静止。
- **左键点击**: 重新打开 GUI。
- **半径模式** — `/pradius <1‑20>`
- *1* = 单个方块
- *>1* = `(2r + 1) × (2r + 1)` 个方块的正方形区域。
- **撤销 & 重做** — `/plundo` & `/plredo` 回滚或恢复多个步骤（基于堆栈）。
- **彩色物品 & 灵活配置** — GUI 标题和物品标签接受 Minecraft 颜色代码 (`&aGrass`)。 所有材料、GUI 大小、默认设置和权限都存储在 `config.yml` 中。
---
### 🛠 安装
1. 将 **JAR** 文件放入您的 `plugins` 文件夹。
2. 重启服务器 *或* 运行：
```bash
/reload confirm
```
3. 根据需要调整 `plugins/PlacementPlugin/config.yml` 并重新启动。
---
### 💻 命令
| 命令 | 描述 |
|---------|-------------|
| `/farmplace` | 打开建筑 GUI |
| `/pc` | 清空当前 Placeler 魔杖 |
| `/pradius ` | 设置放置半径 (1 – 20) |
| `/plundo` | 撤销上次放置 |
| `/plredo` | 重做上次撤销 |
---
### 🔐 权限
| 节点 | 目的 |
|------|---------|
| `farmplace.use` | 打开 GUI |
| `farmplace.clear` | 清空魔杖 |
| `farmplace.radius` | 更改半径 |
| `farmplace.undo` | 运行撤销 |
| `farmplace.redo` | 运行重做 |
---
### ⚙ 配置片段
```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"
# 通过增加 gui-size 添加更多物品。最大值：54 最小值：9
gui-size: 27
gui-title: "&a&lItems"
default-radius: 1
max-radius: 20
```
---
需要帮助？ • 打开问题 • 加入我们的 Discord ([https://discord.gg/XBZfsANgCP](https://discord.gg/XBZfsANgCP))