⚡ BanHammer 4.0.0 - Enhanced Edition
适用于 Paper & Folia 26.1.x 服务器的功能最丰富的封禁模组插件
通过带有闪电、粒子效果和音效的戏剧性封禁锤,彻底改变你的管理流程——同时保持完整的处罚数据库和 Discord 集成。
? 资源包
BanHammer 纹理包可单独下载:
成员在加入时会在屏幕上看到可点击的下载提示(可在 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 通知
? 快速开始
- 安装 插件到你的
plugins/文件夹 - 启动 你的服务器(自动生成配置)
- 给予 你自己这把锤子:
/bh give <player> - 下载 Resource Pack 以获取自定义纹理
- 配置
config.yml中的预设(可选) - 使用 锤子:
- 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 许可证 - 免费供所有类型的服务器使用(商业与非商业)
? 致谢
- 插件开发: BoondockSulfur
- 资源包: BS-BanHammer Resource Pack
- 依赖库: HikariCP、discord-webhooks、Adventure
⭐ 如果你喜欢 BanHammer,请留下评分! ⭐
为 Minecraft 社区 ❤️ 制作
⚡ BanHammer 4.0.0 - Enhanced Edition
The most feature-rich ban hammer plugin for Paper & Folia 26.1.x servers
Transform your moderation workflow with a dramatic ban hammer that strikes players with lightning, particles, and sound effects - all while maintaining a complete punishment database and Discord integration.
🎨 Resource Pack
The BanHammer texture pack is available as a separate download:
Staff members will see a clickable download hint on join (configurable in config.yml).
🎯 What Makes BS-BanHammer Special?
🔨 Dual-Action Preset System
Ban Presets (Shift + Right-Click):
- Cycle through unlimited predefined ban types on-the-fly
- Each preset has custom duration, reason, IP-ban option, and sound
- Actionbar feedback shows active preset
- No commands needed - just shift-click and ban!
Kick/Jail Presets (Shift + Left-Click):
- Mix instant kicks and timed jails in one preset list
- Left-click players to execute with active preset
- Perfect for quick moderation without typing commands
- Separate preset tracking from ban presets
Example Workflow:
1. Shift + Right-Click → Switch to "7 Day Ban" preset
2. Right-Click on griefer → Instantly banned for 7 days with lightning!
3. Shift + Left-Click → Switch to "30 Min Jail" preset
4. Left-Click on spammer → Jailed for 30 minutes
⚡ Dramatic Visual Effects
Every punishment comes with spectacular effects:
- Lightning strikes at player location
- Thunder & explosion sounds for maximum impact
- Particle effects (critical hits & smoke)
- Optional knockback for extra drama
- Fully configurable per preset
📊 Complete Database System
SQLite or MySQL - Your Choice:
- SQLite for single-server setups (zero configuration)
- MySQL for multi-server networks (shared ban database)
- Complete punishment history tracking
- Staff statistics and leaderboards
- Automatic cleanup of expired punishments
- GDPR-compliant IP anonymization
🔄 Auto-Unban Scheduler
Set it and forget it:
- Automatic unbanning when temporary punishments expire
- Works for temp-bans, temp-mutes, and jail sentences
- Configurable check intervals (default: 60 seconds)
- Discord notifications on auto-unbans
- Event system for external plugins
🎭 Extended Punishment Types
Beyond Bans:
- Mute System - Blocks chat and commands (permanent or temporary)
- Jail System - Locks players in place with Essentials integration
- Warning System - Auto-ban after X warnings (configurable)
- IP Bans - Network-wide bans with anonymization options
- Appeals - Let players submit unban requests
🌐 Essentials Jail Integration
Smart Integration:
- Soft dependency - no hard requirement
- Automatically uses Essentials jails if available
- Falls back to built-in jail system
- Works with existing Essentials jail configurations
- Reflection-based - no version conflicts
💬 Discord Webhook Integration
Real-Time Moderation Logs:
- Color-coded embeds for different actions
- Rich information: player, staff, reason, duration
- Works independently of database
- Configurable per event type (bans, kicks, mutes, unbans, appeals)
- Automatic notifications on punishment expiry
🌍 Multi-Language Support
Fully translated:
- 🇩🇪 German - Vollständig übersetzt
- 🇬🇧 English - Fully translated
- All messages configurable in YAML files
- Easy to add custom languages
🔌 Developer-Friendly API
Custom Events:
PlayerPunishEvent // Cancellable, fired before punishment
PlayerPunishedEvent // Fired after successful punishment
PlayerUnpunishedEvent // Fired when punishment removed
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)
📈 Statistics & Appeals
Track Everything:
- Staff leaderboards (most bans, kicks, etc.)
- Player punishment history
- Active punishment counts
Appeal System:
- Players can submit appeals via
/appeal <text> - Cooldown system prevents spam
- Staff review with
/bh approve/deny - Discord notifications for new appeals
🚀 Quick Start
- Install the plugin in your
plugins/folder - Start your server (auto-generates config)
- Give yourself the hammer:
/bh give <player> - Download the Resource Pack for the custom texture
- Configure presets in
config.yml(optional) - Use the hammer:
- Shift + Right-Click to switch ban presets
- Right-Click player to ban with active preset
- Shift + Left-Click to switch kick/jail presets
- Left-Click player to kick/jail with active preset
📝 Commands Overview
| Command | Description |
|---|---|
/bh give <player> |
Give the Ban Hammer item |
/bh reload |
Reload config (reinitializes Discord & DB) |
/bh history <player> |
View punishment history |
/bh unban <player> |
Manually unban a player |
/bh stats [player] |
View moderation statistics |
/bh appeals |
View pending appeals |
/mute <player> <duration> |
Mute a player |
/jail <player> <duration> |
Jail a player |
/warn <player> [reason] |
Warn a player |
Full command list in README.md
⚙️ Configuration Highlights
Ban Presets Example:
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: "Permanent Ban"
reason: "Permanently banned"
duration: "permanent"
ipBan: true
sound: "BLOCK_ANVIL_LAND"
Kick/Jail Presets Example:
kickJailPresets:
quick_kick:
displayName: "Quick Kick"
reason: "Kicked from server"
# No duration = instant kick
jail_30m:
displayName: "30 Min Jail"
reason: "Jailed for 30 minutes"
duration: "30m" # Has duration = jail
🔒 Security & Privacy
- GDPR Compliant - IP anonymization with 4 levels
- Permission-based - Granular permission system
- SQL Injection Protected - Prepared statements everywhere
- Bypass Protection - Immune players can't be banned
- Self-Protection - Can't ban yourself
- Cooldown System - Prevents spam abuse
🌟 What's New in 4.0.0?
Paper 26.1.x Support (BREAKING):
- ✨ Targets Paper 26.1.2+ with the new Minecraft versioning
- ✨ Requires Java 25
- ✨ All deprecated APIs modernized (Adventure Components, no more legacy color codes)
- ✨ Smart update checker filters by game version (1.21.x users won't see 4.x updates)
- ✨ Resource pack moved to separate download
Previous Major Features:
- ✨ Folia Support (dual Paper/Folia compatibility)
- ✨ Ban Presets System with preset cycling
- ✨ Kick/Jail Presets System (separate from ban presets)
- ✨ Essentials Jail Integration
- ✨ Modrinth Update Checker with game version filtering
- ✨ Complete translation system (DE/EN)
- ✨ Discord works without database requirement
📦 Requirements
- Server: Paper or Folia 26.1.x or higher
- Java: 25 or higher
- Optional: MySQL Server (for MySQL mode)
- Optional: Essentials Plugin (for enhanced jail system)
Looking for 1.21.x support? Use BanHammer v3.1.1 instead.
📜 License
MIT License - Free for all server types (commercial & non-commercial)
🙏 Credits
- Plugin Development: BoondockSulfur
- Resource Pack: BS-BanHammer Resource Pack
- Libraries: HikariCP, discord-webhooks, Adventure
⭐ If you enjoy BanHammer, please leave a rating! ⭐
Made with ❤️ for the Minecraft community
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BS-BanHammer
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[4.2.1] - 2026-11-09
🐛 Bug 修复
/appeal命令现在指向最新的封禁、静音或监禁记录;警告不再支持申诉。/bh ban在检测到持续时间输入错误时会拒绝执行,而不是直接给予永久封禁。- Essentials 监狱:在此处在线时才会计算监禁时间;玩家重新加入服务器时不会再出现被释放后又立即重新关押的情况。
- 其他插件的传送功能不再能将处于监禁状态的玩家送出(
preventTeleport)。 - 过期的封禁和静音记录会遵循
discord.notifications.unbans配置项的设置。 - 当同时触发多个警告并达到阈值时,只会生成一次自动封禁。
- 使用
/unjail命令且未连接数据库时,如果玩家未被关押,则会报告相关信息。 - 在启动期间,如果由 Essentials 提供监狱功能,则不会显示内置的监狱警告信息。
🔧 更改
/bh reload命令现在会应用数据库仍在启动过程中时所做的useEssentials设置及数据库变更。- 更新和资源包提示现已支持翻译(
update.*、resourcePack.hint、linkHover)。
[4.2.0] - 2026-09-28
适用于 1.21.x 和 26.x 的单个 JAR 文件
Added
/bh ban <player> [duration] [reason](权限banhammer.ban)。- 惩罚离线玩家,这些玩家之前曾在服务器上出现过(
/bh ban、/mute、/jail、/warn)。离线监禁将在玩家下次登录时生效。 - 监禁时间仅在玩家在线时倒计时。
Bug fixes
-
过期的临时封禁不再移除同一玩家的其他封禁。
-
批准申诉现在会解除被申诉的处罚(包括静音和监禁)。
-
监禁状态已持久化到
jails.yml:返回位置在重启后保留,离线状态下使用 Essentials 执行unjail命令也能正常工作。 -
Folia:定时任务再次被取消;ban 列表和物品栏访问现在在正确的线程上运行。
-
锤子功能现可在无数据库的情况下完全工作(包括事件、审计日志、Discord 集成和 IP 封禁)。
-
静音功能还涵盖了命令别名和旧版聊天监听器。
-
对 IP 解封、申诉、词库过滤、数据库层以及翻译内容进行了多项小修复。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧