转载 工具 洞穴矿工 1.1.0-RELEASE

[MD]
# 洞穴矿工（CaveMiner）

*挖掘整条矿脉，而不只是一个方块。*

一款轻量级的连锁采矿插件，风格类似 VeinMiner。所有功能均可在 config.yml 中配置，无臃肿内容，也无需安装前置依赖。

## 功能特性

- **连锁采矿**：一次挖掘即可破坏相连的同类矿石方块。
- **时运支持**：矿脉中的每个方块都会应用原版时运附魔逻辑。
- **智能工具检测**：每种矿石均可单独设置允许使用的工具白名单。
- **耐久消耗**：挖掘时会消耗工具耐久，并正确兼容耐久附魔。
- **掉落物聚合**：所有掉落物都会集中到第一个被破坏方块的位置。
- **触发音效**：可自由配置连锁采矿触发时播放的音效。
- **创造模式保护**：可配置是否允许在创造模式下使用。
- **潜行开关**：可选功能，可通过按住潜行键启用或禁用连锁采矿。
- **PlaceholderAPI 支持**：提供玩家个人统计占位符。

## PlaceholderAPI 占位符

| 占位符 | 说明 |
| --- | --- |
| `%caveminer_blocks_mined%` | 玩家通过连锁采矿破坏的方块总数。 |
| `%caveminer_veins_triggered%` | 玩家触发连锁采矿的次数。 |

## 命令与权限

| 命令 | 权限 |
| --- | --- |
| `/caveminer reload` | `caveminer.reload`（OP） |

## 工作原理

1. 玩家使用符合等级要求的镐子挖掘矿石。
2. 插件会通过 **BFS 广度优先搜索**，检测所有相邻且同类型的方块。
3. 每个方块都会被逐一破坏，并正确计算时运与耐久附魔效果。
4. 所有掉落物会传送至第一个被破坏方块的位置。

---

/HR]

**作者：LucasTHCR**
Discord：[dc.gg/paperstream](https://dc.gg/paperstream)
[/MD]