DisableCreeperBoom

README.md

@@ -0,0 +1,154 @@
+# 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 | 显示帮助信息 |
+
+**命令别名**: `/cb`, `/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.0-SNAPSHOT  
+**开发者**: gtb520