155 lines
4.1 KiB
Markdown
155 lines
4.1 KiB
Markdown
# 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
|