# 💥 BoomControl
**BoomControl** 是一个轻量级且专注于设计的插件，专门为希望**限制或削弱水晶 PvP 的 SMP 服务器**设计。它提供对末影水晶和重生锚爆炸的精细控制，以防止不公平的优势或破坏行为，同时保持游戏乐趣和平衡。
- - -
## 🎯 为什么选择 BoomControl？
在许多 SMP 服务器中，末影水晶和重生锚被用于 PvP，造成巨大的爆发伤害。BoomControl 让您对这些物品的行为拥有**完全控制权**：
* 禁用或削弱水晶 PvP
* 防止通过爆炸方块伤害造成破坏
* 使爆炸仅对攻击者造成伤害
* 在完全禁止水晶的情况下，保持 SMP 的乐趣和公平性
- - -
## 🔧 功能
* ✅ 全局启用/禁用插件
* 🔄 使用 `/boomcontrol reload` 动态重新加载设置
* 🧨 对**末影水晶**行为进行全面控制
* 🌋 对**重生锚**进行全面控制
* ❌ 阻止爆炸破坏（方块破坏和火焰）
* 📢 阻止操作的自定义拒绝消息
- - -
## 🧨 水晶设置
```
crystal:
enabled: true # 需要服务器重启才能更改
mode: "self" # 选项： "disabled", "self", "vanilla"
break-blocks: false # 防止方块受损
start-fire: false # 停止爆炸时的火焰
show-deny-message: true # 当操作被阻止时告知玩家
```
### 模式：
* `"disabled"` – 水晶根本不会爆炸。
* `"self"` – 只有触发爆炸的玩家会受到伤害。
* `"vanilla"` – 默认的 Minecraft 行为。
- - -
## 🌋 重生锚设置
```
anchor:
enabled: true
mode: "self" # 与水晶相同的选项
break-blocks: true
start-fire: true
show-deny-message: true
```
非常适合控制基于地狱的 PvP 或使用锚的创造性机制。
- - -
## 🔄 命令
```
/boomcontrol reload
```
在**不重启服务器**的情况下重新加载插件配置.
⚠️ 注意：`enabled` 切换和 `crystal.enabled` **需要重启**。
- - -
## 🗨️ 自定义消息
```
messages:
crystal-denied: "&c此服务器已禁用水晶 PvP。"
anchor-denied: "&c不允许重生锚伤害。"
```
使用颜色代码 (`&c`, `&7` 等) 格式化您的消息。
- - -
## 🛑 世界黑名单
BoomControl 现在支持通过在 `settings.yml` 中配置黑名单，在**特定世界中完全禁用插件**。如果要在某些世界（如地狱、末地或大厅世界）中完全禁用 BoomControl，非常有用，无论区域标志或其他设置如何。
### 示例配置：
```yaml
blacklisted_worlds:
- world_nether
- world_the_end
```
### 工作原理：
- 如果世界在 `blacklisted_worlds` 中列出，BoomControl 将在该世界中**完全禁用**。
- 这意味着该世界中的任何基于区域的控制或 WorldGuard 标志都会被忽略。
- 在这些世界中，将应用 Minecraft 默认的爆炸行为。
### 使用技巧：
- 将列表留空以在*所有*世界中启用 BoomControl。
- 添加您希望 BoomControl 禁用的世界，例如大厅或活动世界。
- 将此黑名单与 WorldGuard 区域标志结合使用，以在其他地方实现细粒度的控制。
---
## 🏳️ WorldGuard 集成 (可选)
BoomControl 与 [WorldGuard](https://enginehub.org/worldguard/) 集成，以支持使用自定义标志进行**基于区域的控制**。
### 🔖 `boomcontrol` 标志
如果安装了 WorldGuard，BoomControl 会注册一个自定义区域标志：
```
boomcontrol
```
此标志允许您在**特定区域中禁用 BoomControl**，即使该插件已全局启用。
### 🧰 工作原理
- 如果在区域中将标志设置为 `DENY`，**BoomControl 将完全在该区域中禁用**。
该区域中的爆炸行为将遵循正常的 Minecraft 机制。
- 如果标志**未设置**或明确设置为 `ALLOW`，BoomControl 将按照 `settings.yml` 中配置的方式应用。
### 🧪 示例
要禁用区域内的 BoomControl：
```bash
/rg flag spawn boomcontrol deny
```
要再次启用它：
```bash
/rg flag spawn boomcontrol allow
```
要完全删除该标志：
```bash
/rg flag spawn -r boomcontrol
```
### ❗ 默认行为
- 如果标志**未设置**，BoomControl 假设为 `ALLOW`。
- 这意味着 BoomControl 在**所有地方都已激活**，除非通过区域标志明确拒绝。
---
## 🧠 非常适合
* 🏰 SMP 服务器
* 🔒 反破坏设置
* ⚔️ PvP 练习世界，采用受限的机制
* 🛡️ 具有平衡战斗的生存服务器
- - -
## ✅ 轻量级且可靠
没有膨胀。没有复杂的依赖项。 简单有效的爆炸控制。
使用 **BoomControl** 让您的 SMP 更安全、更平衡。