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：

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: 完全禁止苦力怕爆炸破坏

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

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

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

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

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

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

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

技术细节

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

开发构建

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

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