转载 开源 工具 迅速收割 v1.1.0

[MD]
# 迅速收割（SwiftHarvest）

一款现代轻量的 PaperMC 服务端插件，将连锁挖矿与伐木功能整合为一体，并针对性能进行了优化。

---

/HR]

## 功能特性

- **⛏ 连锁挖矿（VeinMiner）**——手持镐子、潜行并破坏矿石，即可一次性挖掉整条矿脉
- ** 连锁伐木（Timber）**——手持斧头、潜行并破坏原木，整棵树瞬间砍倒
- ** 预览粒子**——启用后，瞄准方块并潜行，绿色粒子将提前标示出所有受影响的方块
- **智能耐久损耗**——工具耐久按实际破坏的方块数量等比例扣除
- **掉落物合并**——物品直接进入背包，彻底消除大量掉落物造成的卡顿
- **经验球合并**——多个经验掉落合并为单个经验球
- **WorldGuard 兼容**——完整遵守领地保护旗标
- **⚙ 高度可配置**——工具类型、目标方块、数量上限均可自定义

---

/HR]

## 使用方法

### ⛏ 连锁挖矿

1. 手持任意**镐子**
2. 按住 **Shift** 进入潜行状态
3. **破坏**一个矿石方块
4. 所有相连的同类矿石将一并挖出

### 连锁伐木

1. 手持任意**斧头**
2. 按住 **Shift** 进入潜行状态
3. **破坏**一个原木方块
4. 整棵树将被一次性砍倒

### 预览粒子

在配置中启用后，潜行状态下瞄准方块，绿色粒子将显示本次操作将影响的方块数量与范围。

---

/HR]

## 命令

| 命令 | 说明 |
|------|------|
| /swifthavert reload | 重新加载配置（需管理员权限） |

别名：/sh

---

/HR]

## 权限节点

| 权限节点 | 说明 | 默认 |
|----------|------|------|
| `swifthavert.use` | 使用 SwiftHarvest 全部功能 | 所有人 |
| `swifthavert.veinminer` | 使用连锁挖矿功能 | 所有人 |
| `swifthavert.timber` | 使用连锁伐木功能 | 所有人 |
| `swifthavert.bypass` | 绕过世界黑名单限制 | OP |
| `swifthavert.admin` | 使用管理员命令 | OP |

---

/HR]

## ⚙ 配置文件

```yaml
settings:
require-sneak: true # 是否需要潜行才能触发
max-blocks: 64 # 单次最多破坏方块数
cooldown: 10 # 冷却时间（毫秒）
preview-particles: true # 是否启用预览粒子

veinminer:
enabled: true
allowed-tools:
- WOODEN_PICKAXE
- STONE_PICKAXE
- IRON_PICKAXE
- GOLDEN_PICKAXE
- DIAMOND_PICKAXE
- NETHERITE_PICKAXE
valid-blocks:
- COAL_ORE
- IRON_ORE
- GOLD_ORE
- DIAMOND_ORE
- REDSTONE_ORE
- LAPIS_ORE
- EMERALD_ORE

timber:
enabled: true
allowed-tools:
- WOODEN_AXE
- STONE_AXE
- IRON_AXE
- GOLDEN_AXE
- DIAMOND_AXE
- NETHERITE_AXE
break-leaves: false # 是否同时破坏树叶

worlds:
blacklist:
- world_nether
- world_the_end
```

---

/HR]

## 技术说明

- **搜索算法**：采用广度优先搜索（BFS），无递归调用，从根本上规避堆栈溢出风险
- **方块上限**：可配置的最大破坏数量（默认 64），防止单次操作引发卡顿
- **线程安全**：方块范围计算在异步线程中完成，实际破坏操作回归主线程执行
- **掉落物处理**：合并所有掉落物后优先送入背包，再处理地面掉落

---

/HR]

## 支持与反馈

遇到 Bug 或有功能建议？请在 [GitHub Issues](https://github.com/Syaaddd/SwiftHarvest/issues) 提交 Issue。

---

/HR]

版本 1.0.0 · MIT 许可证
[/MD]