BS-BanHammer

插件

· 作者 boondocksulfur

适用于 Paper 和 Folia 的功能最全面的封禁工具。在保持完整的处罚数据库、Discord 集成和预设系统的同时,使用闪电效果制裁玩家。

0 本站下载 0 关注 更新于 1 周前

最新 4.2.1 · 26.3 · Folia / Paper

一键开服(送7天)

⚡ BanHammer 4.0.0 - Enhanced Edition

适用于 Paper & Folia 26.1.x 服务器的功能最丰富的封禁模组插件

通过带有闪电、粒子效果和音效的戏剧性封禁锤,彻底改变你的管理流程——同时保持完整的处罚数据库和 Discord 集成。


? 资源包

BanHammer 纹理包可单独下载:

➡️ BS-BanHammer Resource Pack

成员在加入时会在屏幕上看到可点击的下载提示(可在 config.yml 中配置)。


? BS-BanHammer 的独特之处

? 双动作预设系统

封禁预设(Shift + 右键):

  • 即时切换无限数量的预定义封禁类型
  • 每个预设都有自定义时长、理由、IP 封禁选项和音效
  • 动作栏反馈显示当前激活的预设
  • 无需输入命令——只需 Shift+右键即可封禁!

踢出/监禁预设(Shift + 左键):

  • 在一个预设列表中混合即时踢出和限时监禁
  • 左键点击玩家以执行当前预设的操作
  • 非常适合快速管理而无需输入命令
  • 与封禁预设分开跟踪

示例工作流程:

1. Shift + 右键 → 切换到“7 天封禁”预设
2. 右键点击破坏者 → 立即因闪电被封禁 7 天!
3. Shift + 左键 → 切换到“30 分钟监禁”预设
4. 左键点击刷屏者 → 监禁 30 分钟

⚡ 戏剧性的视觉效果

每次处罚都伴随着壮观的效果:

  • 闪电击中玩家所在位置
  • 雷声与爆炸音效带来最大冲击力
  • 粒子效果(暴击烟雾与烟尘)
  • 可选击退效果增加戏剧性
  • 每个预设均可完全配置

? 完整的数据库系统

SQLite 或 MySQL —— 由你选择:

  • SQLite 用于单服务器设置(零配置)
  • MySQL 用于多服务器网络(共享封禁数据库)
  • 完整的处罚历史记录追踪
  • 工作人员统计数据和排行榜
  • 自动清理过期的处罚
  • 符合 GDPR 的 IP 匿名化

? 自动解封调度器

设置好即可忘记:

  • 临时处罚到期时自动解封
  • 适用于临时封禁、临时静音和监禁刑期
  • 可配置的检查间隔(默认:60 秒)
  • 自动解封时的 Discord 通知
  • 供外部插件使用的事件系统

? 扩展的处罚类型

超越封禁:

  • 静音系统 - 阻止聊天和命令(永久或临时)
  • 监禁系统 - 将玩家锁定在原位,支持 Essentials 集成
  • 警告系统 - 达到 X 次警告后自动封禁(可配置)
  • IP 封禁 - 全网络范围的封禁,支持匿名化选项
  • 申诉系统 - 允许玩家提交解封请求

? Essentials 监禁集成

智能集成:

  • 软依赖——无硬性要求
  • 如果可用则自动使用 Essentials 监禁
  • 回退到内置监禁系统
  • 与现有的 Essentials 监禁配置配合工作
  • 基于反射机制——无版本冲突

? Discord Webhook 集成

实时管理日志:

  • 不同操作的颜色编码嵌入消息
  • 丰富信息:玩家、工作人员、理由、时长
  • 独立于数据库运行
  • 每种事件类型可配置(封禁、踢出、静音、解封、申诉)
  • 处罚到期时自动通知

? 多语言支持

完全翻译:

  • ?? 德语 - Vollständig übersetzt
  • ?? 英语 - Fully translated
  • 所有消息可在 YAML 文件中配置
  • 易于添加自定义语言

? 开发者友好 API

自定义事件:

PlayerPunishEvent      // 可取消,在处罚前触发
PlayerPunishedEvent    // 在成功处罚后触发
PlayerUnpunishedEvent  // 在处罚移除时触发

PunishmentManager API:

pm.banPlayer(staff, victim, reason, duration, ipBan)
pm.mutePlayer(staff, victim, reason, duration)
pm.jailPlayer(staff, victim, reason, duration)
pm.getHistory(playerUuid, limit)

? 统计数据与申诉

追踪一切:

  • 工作人员排行榜(最多封禁、踢出等)
  • 玩家处罚历史
  • 当前活跃处罚数量

申诉系统:

  • 玩家可以通过 /appeal <text> 提交申诉
  • 冷却系统防止刷屏
  • 工作人员通过 /bh approve/deny 进行审核
  • 新申诉的 Discord 通知

? 快速开始

  1. 安装 插件到你的 plugins/ 文件夹
  2. 启动 你的服务器(自动生成配置)
  3. 给予 你自己这把锤子:/bh give <player>
  4. 下载 Resource Pack 以获取自定义纹理
  5. 配置 config.yml 中的预设(可选)
  6. 使用 锤子:
    • Shift + 右键 切换封禁预设
    • 右键点击玩家 以当前预设进行封禁
    • Shift + 左键 切换踢出/监禁预设
    • 左键点击玩家 以当前预设进行踢出/监禁

? 命令概览

命令 描述
/bh give <player> 给予封禁锤物品
/bh reload 重载配置(重新初始化 Discord 和数据库)
/bh history <player> 查看处罚历史
/bh unban <player> 手动解封玩家
/bh stats [player] 查看管理统计数据
/bh appeals 查看待处理的申诉
/mute <player> <duration> 静音玩家
/jail <player> <duration> 监禁玩家
/warn <player> [reason] 警告玩家

完整命令列表见 README.md


⚙️ 配置亮点

封禁预设示例:

presets:
  warning:
    displayName: "Warning Ban"
    reason: "First offense"
    duration: "1h"
    ipBan: false
    sound: "BLOCK_NOTE_BLOCK_PLING"

  serious:
    displayName: "7 Day Ban"
    reason: "Serious rule violation"
    duration: "7d"
    ipBan: false
    sound: "BLOCK_NOTE_BLOCK_BASS"

permanent:
    displayName: "永久封禁"
    reason: "已被永久封禁"
    duration: "permanent"
    ipBan: true
    sound: "BLOCK_ANVIL_LAND"

踢出/监禁预设示例:

kickJailPresets:
  quick_kick:
    displayName: "快速踢出"
    reason: "已从服务器踢出"
    # 无持续时间 = 立即踢出

  jail_30m:
    displayName: "30分钟监禁"
    reason: "因违规被监禁30分钟"
    duration: "30m"  # 有持续时间 = 监禁

? 安全与隐私

  • 符合 GDPR 标准 - 支持4级 IP 匿名化
  • 基于权限控制 - 细粒度的权限系统
  • 防 SQL 注入 - 全面使用预编译语句
  • 绕过保护 - 免疫玩家无法被封禁
  • 自我保护 - 禁止自我封禁
  • 冷却系统 - 防止滥用刷屏

? 4.0.0 更新内容

支持 Paper 26.1.x(破坏性更新):

  • ✨ 针对采用新版 Minecraft 版本号的 Paper 26.1.2+
  • ✨ 需要 Java 25
  • ✨ 所有已弃用 API 现代化(Adventure Components,不再使用旧版颜色代码)
  • ✨ 智能更新检查器按游戏版本过滤(1.21.x 用户不会看到 4.x 更新)
  • ✨ 资源包移至 单独下载

之前的主要功能:

  • ✨ Folia 支持(兼容 Paper/Folia 双模式)
  • ✨ 封禁预设系统,支持预设循环
  • ✨ 踢出/监禁预设系统(独立于封禁预设)
  • ✨ Essentials 监禁集成
  • ✨ Modrinth 更新检查器,支持游戏版本过滤
  • ✨ 完整翻译系统(DE/EN)
  • ✨ Discord 通知无需数据库即可工作

? 要求

  • 服务端: Paper 或 Folia 26.1.x 或更高版本
  • Java: 25 或更高版本
  • 可选: MySQL Server(用于 MySQL 模式)
  • 可选: Essentials 插件(用于增强监禁系统)

寻找 1.21.x 支持? 请使用 BanHammer v3.1.1。


? 许可证

MIT 许可证 - 免费供所有类型的服务器使用(商业与非商业)


? 致谢


⭐ 如果你喜欢 BanHammer,请留下评分! ⭐

为 Minecraft 社区 ❤️ 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源