# DisableCreeperBoom - 苦力怕爆炸控制插件

## 插件简介

DisableCreeperBoom 是一个基于 Bukkit API 的 Minecraft 插件，适用于 Minecraft 1.21.8 版本。该插件允许服务器管理员控制苦力怕的爆炸行为，包括阻止爆炸破坏方块和阻止爆炸对玩家/实体造成伤害。

## 功能特性

- ✅ **阻止方块破坏**: 可以配置苦力怕爆炸时不破坏任何方块
- ✅ **阻止伤害**: 可以配置苦力怕爆炸不对玩家和实体造成伤害
- ✅ **灵活配置**: 通过配置文件轻松开关各项功能
- ✅ **命令管理**: 支持在游戏中重新加载配置和查看状态
- ✅ **调试模式**: 提供详细的调试日志输出

## 安装方法

1. 将编译好的 `DisableCreeperBoom.jar` 文件放入服务器的 `plugins` 文件夹
2. 启动或重启 Minecraft 服务器
3. 插件会自动生成配置文件 `config.yml`
4. 根据需要编辑配置文件
5. 使用 `/creeperboom reload` 命令重新加载配置

## 配置说明

配置文件位于 `plugins/DisableCreeperBoom/config.yml`：

```yaml
config:
  # 插件总开关 - 是否启用此插件功能
  # true = 启用插件功能
  # false = 禁用插件功能（苦力怕正常爆炸）
  Enable: true

  # 苦力怕爆炸破坏方块控制
  # true = 阻止苦力怕爆炸破坏方块
  # false = 允许苦力怕爆炸破坏方块
  CreeperExplode: true

  # 苦力怕爆炸伤害控制
  # true = 阻止苦力怕爆炸对玩家和实体造成伤害
  # false = 允许苦力怕爆炸对玩家和实体造成伤害
  CreeperDamage: true

  # 调试模式
  # true = 在控制台输出详细的调试信息
  # false = 关闭调试信息输出
  debug: false
```

## 命令列表

| 命令 | 权限 | 描述 |
|------|------|------|
| `/creeperboom` | disablecreeperboom.admin | 显示帮助信息 |
| `/creeperboom reload` | disablecreeperboom.admin | 重新加载配置文件 |
| `/creeperboom status` | disablecreeperboom.admin | 查看当前配置状态 |
| `/creeperboom help` | disablecreeperboom.admin | 显示帮助信息 |

**命令别名**: `/cboom`, `/creeper`

## 权限节点

- `disablecreeperboom.admin` - 允许使用插件管理命令（默认 OP）

## 使用示例

### 场景 1: 完全禁止苦力怕爆炸破坏

```yaml
config:
  Enable: true
  CreeperExplode: true
  CreeperDamage: true
  debug: false
```

### 场景 2: 只阻止方块破坏，但保留伤害

```yaml
config:
  Enable: true
  CreeperExplode: true
  CreeperDamage: false
  debug: false
```

### 场景 3: 只阻止伤害，但允许破坏方块

```yaml
config:
  Enable: true
  CreeperExplode: false
  CreeperDamage: true
  debug: false
```

### 场景 4: 临时禁用插件功能

```yaml
config:
  Enable: false
  CreeperExplode: true
  CreeperDamage: true
  debug: false
```

## 技术细节

- **API 版本**: 1.21
- **Java 版本**: Java 21
- **依赖**: Spigot API 1.21.8-R0.1-SNAPSHOT
- **构建工具**: Maven

## 开发构建

如果你想要自己编译这个插件：

```bash
mvn clean package
```

编译后的 JAR 文件将位于 `target/` 目录中。

## 注意事项

1. 修改配置文件后，需要使用 `/creeperboom reload` 命令或重启服务器才能使更改生效
2. 当 `Enable` 设置为 `false` 时，所有功能都将被禁用，苦力怕会正常爆炸
3. 调试模式会在控制台输出详细的事件日志，建议在生产环境中关闭
4. 插件只影响苦力怕的爆炸行为，不会影响其他爆炸源（如 TNT、末影水晶等）

## 常见问题

**Q: 为什么苦力怕还是会破坏方块？**  
A: 请检查配置文件中 `CreeperExplode` 是否设置为 `true`，并确保插件已启用（`Enable: true`）

**Q: 如何确认插件正在运行？**  
A: 使用 `/creeperboom status` 命令查看当前配置状态

**Q: 修改配置后为什么不生效？**  
A: 请使用 `/creeperboom reload` 命令重新加载配置文件

## 支持与反馈

如果你遇到问题或有建议，请提交 Issue 或联系开发者。

## 许可证

本项目遵循开源协议，可自由使用和修改。

---

**Minecraft 版本**: 1.21.8  
**插件版本**: 1.1-SNAPSHOT  
**开发者**: gtb520