放置工具

放置工具

Stardew Valley 批量放置模组，支持按行/列快速放置树苗、果树、茶苗、机器等物品。

## 功能

- **[b]批量放置[/b]**：按快捷键进入放置会话，左键拖动摆放一列物品
- **[b]物品分类[/b]**：自动识别普通树、果树、茶苗、机器、其他可放置大物件（BigCraftable），按类别设置间隔
- **[b]实时预览[/b]**：拖动时显示半透明预览，绿色=可放置，红色=不可放置
- **[b]间隔配置[/b]**：可按物品类别独立配置放置间隔（紧挨、间隔1格、间隔2格等）
- **[b]库存统计[/b]**：侧边面板实时显示背包中各类物品的数量
- **[b]右键删除[/b]**：右键点击已放置的预览可移除
- **[b]确认落地[/b]**：关闭时弹出确认对话框，显示有效/无效数量

## 操作方式

| 操作 | 功能 |
|------|------|
| 按 `P` 键 | 进入/退出放置会话 |
| 左键拖动 | 沿鼠标拖动方向排列物品预览 |
| 左键松手 | 固化当前拖动预览 |
| 右键点击 | 删除该位置的预览 |
| 再按 `P` 或 Esc | 弹出确认对话框 |

## 支持的物品类型

| 类型 | 说明 | 默认间隔 |
|------|------|----------|
| 普通树 | 橡果、枫种、松果、桃花心木种子 | 1格 |
| 果树 | 各类果树树苗 | 2格 |
| 茶苗 | 茶叶树苗 | 2格 |
| 机器 | 小桶、罐头机、酒桶等可产出机器 | 紧挨 |
| 其他 | 洒水器、稻草人等可放置大物件（BigCraftable） | 紧挨 |

## 配置

通过 GMCM（Generic Mod Config Menu）可配置：

- **OpenMenuKey**：进入放置会话的快捷键（默认 `P`）
- **TreeSpacing**：普通树放置间隔
- **FruitTreeSpacing**：果树放置间隔
- **TeaBushSpacing**：茶苗放置间隔
- **MachineSpacing**：机器放置间隔
- **OtherSpacing**：其他可放置大物件（BigCraftable）放置间隔

## 依赖

| Mod | 必需 | 说明 |
|-----|------|------|
| StardewUI | 是 | UI 框架，用于渲染侧边面板和预览覆盖层 |
| Generic Mod Config Menu | 否 | 提供游戏内配置界面 |

## 安装

1. 安装 [SMAPI](https://smapi.io/) 4.0.0+
2. 安装 [StardewUI](https://www.nexusmods.com/stardewvalley/mods/22072)
3. 将 `PlacementTool/` 文件夹复制到游戏的 `Mods/` 目录
4. 启动游戏，SMAPI 会自动加载模组