?️ BadBans
⚡ 适用于 Paper 服务器的现代零延迟处罚系统
BadBans 是一款轻量、强大且现代化的处罚插件,专为 Minecraft Paper 服务器打造。
通过简洁高效的系统,管理处罚记录、IP 追踪、重复 IP 检测、管理员工具、网页历史记录以及多服同步功能。
作者: Bad_0320
平台: Paper
Minecraft: 26.1.2
Java: 25+
存储: MariaDB / SQLite
同步: Redis
✨ 概述
BadBans 是一款受 LiteBans 启发的完整处罚系统,旨在为需要整洁的管理工具、快速的数据库处理以及可靠的管理员控制的现代 Minecraft 服务器提供服务。
它包含 封禁、IP 封禁、静音、IP 静音、警告、踢出、重复 IP 检测、历史查询、静默处罚、回滚工具、网页历史记录支持以及可选的玩家数据清除系统。
专为处罚玩家而设计,不影响你的 TPS。
? 功能亮点
? 处罚系统
以整洁可靠的方式管理玩家处罚所需的一切功能。
- 账号封禁
- 临时封禁
- IP 封禁
- 临时 IP 封禁
- 静音
- 临时静音
- IP 静音
- 警告
- 临时警告
- 踢出
- 全员踢出
|
? 管理员调查工具
强大的工具用于追踪玩家、IP、处罚记录及关联账号。
- 完整处罚历史
- 当前活跃处罚检查
- IP 历史记录
- 重复 IP 扫描器
- UUID 追踪
- IP 追踪
- 状态着色的小号账号
- 美观的处罚 ID
- 管理员回滚系统
|
? 网络就绪
专为单服和多服网络设计。
- MariaDB 支持
- Redis 同步
- SQLite 备用方案
- 多服处罚同步
- 安全降级行为
- 运行时库加载
- 轻量级最终 jar 包
|
? 高级体验
整洁的视觉效果、精致的消息提示和流畅的管理员反馈。
- 小型大写字体处罚界面
- 样式化封禁消息
- 样式化静音消息
- 整洁的公开广播
- 静默管理员通知
- XP 球成功音效
- Tab 补全
- 网页历史记录支持
|
⚡ 零延迟设计
BadBans 的设计旨在保持服务器流畅,即使在积极管理期间也是如此。
尽可能异步处理数据库操作、处罚检查和同步动作,减少主线程工作并帮助保护服务器 TPS。
| 设计目标 |
结果 |
| 异步处罚处理 |
减轻主线程压力 |
| 离线数据库工作 |
提升服务器性能 |
| Redis 同步 |
快速全网更新 |
| 轻量级 jar 包 |
部署更快 |
| 使用 Paper API |
更好的兼容性 |
| 无 NMS 依赖 |
更容易更新 |
? 多服支持
BadBans 已准备好用于服务器网络和共享处罚数据。
| 组件 |
用途 |
| MariaDB |
处罚数据的主要真相来源(主数据库) |
| Redis |
服务器间的实时同步 |
| SQLite |
MariaDB 不可用时的本地备用方案 |
如果 MariaDB 或 Redis 不可用,BadBans 可以安全地降级到 SQLite,并自动禁用多服同步。
? 静默处罚
所有处罚命令均支持使用 -s 参数进行静默模式。
| 示例 |
可见性 |
/ban Player 7d Cheating |
对所有人在线可见 |
/ban Player 7d Cheating -s |
仅对拥有静默通知权限的管理员可见 |
静默通知仅显示给控制台和拥有以下权限的玩家:
badbans.notify.silent
⚠️ 警告自动封禁
BadBans 包含一个自动警告处罚系统。
| 设置 |
默认值 |
| 激活所需的警告次数 |
3 |
| 自动执行的操作 |
Ban(封禁) |
| 持续时间 |
1 day(1 天) |
| 原因 |
Too many warnings reached(达到过多警告限制) |
当玩家达到配置的警告上限时,BadBans 会自动应用处罚。
? 清除系统
BadBans 包含一个强大的玩家重置系统。
/wipe <player> [-s]
玩家数据
- 物品栏
- 末影箱
- XP 和经验等级
- 药水效果
- 食物和饱和度
- 持久化玩家数据
|
原版文件
- playerdata
- Stats(统计数据)
- Advancements(进度)
- Recipes(配方)
- 进度完成情况
- 可选的外部排名重置
|
出于安全考虑,封禁时自动清除默认处于关闭状态:
wipe-on-ban: false
? 样式化消息
BadBans 使用整洁、现代的处罚消息,并采用 小型大写 Unicode 样式。
示例:
ʏᴏᴜʀ ᴀᴄᴄᴏᴜɴᴛ ʜᴀꜱ ʙᴇᴇɴ ʙᴀɴɴᴇᴅ
| 消息类型 |
样式 |
| 封禁界面 |
红色小型大写惩罚布局 |
| IP 封禁界面 |
简洁的连接封禁布局 |
| 静音消息 |
紧凑警告风格格式 |
| 警告通知 |
对工作人员友好的实时消息 |
| 重复 IP 输出 |
状态颜色的账户列表 |
| 广播 |
简洁的公共惩罚格式 |
| 静默操作 |
仅工作人员的通知风格 |
? 重复 IP 扫描器
使用 /dupeip <玩家名/IP> 查找连接到同一 IP 的账号。
BadBans 会以基于状态的着色显示关联账号,使小号检测快速且易于阅读。
| 状态 |
含义 |
| 在线 |
玩家当前在线 |
| 离线 |
玩家当前离线 |
| 封禁 |
玩家处于有效封禁状态 |
| 禁言 |
玩家处于有效禁言状态 |
| IP 封禁 |
玩家与被封禁的 IP 关联 |
? Pretty Punishment ID
BadBans 生成简洁、稳定的惩罚 ID。
| 玩家 |
示例 ID |
PupillaViola |
#PPLV4821 |
Bad_0320 |
#BAD04821 |
惩罚 ID 将永久保存,且玩家重新加入时不会更改。
? 命令
? 封禁命令
| 命令 |
描述 |
/ban <player> [time] [reason] [-s] |
永久或临时封禁一名玩家 |
/ipban <player/IP> [time] [reason] [-s] |
封禁一个 IP 地址 |
/tempban <player> <time> [reason] [-s] |
临时封禁一名玩家 |
/tempipban <player/IP> <time> [reason] [-s] |
临时封禁一个 IP 地址 |
/unban <player> |
移除活跃账号封禁 |
/unbanip <player/IP> |
移除活跃 IP 封禁 |
? 静音命令
| 命令 |
描述 |
/mute <玩家> [时间] [原因] [-s] |
永久或暂时禁止某玩家发言 |
/tempmute <玩家> <时间> [原因] [-s] |
暂时禁止某玩家发言 |
| /unmute <玩家> | 解除正在进行的禁言 |
| /ipmute <玩家/IP> [时间] [原因] [-s] | 对 IP 地址进行禁言 |
| /unipmute <玩家/IP> | 移除活动的 IP 封禁 |
⚠️ 警告命令
| 命令 |
描述 |
/warn <玩家> [原因] [-s] |
警告一名玩家 |
/tempwarn <玩家> <时长> [原因] [-s] |
暂时警告一名玩家 |
| /unwarn <玩家> [id/全部] | 移除一条警告或清除所有活跃警告 |
? 踢出命令
| 命令 |
描述 |
/kick <玩家> [原因] [-s] |
立即踢出某玩家 |
/kickall [原因] [-s] |
踢出所有在线玩家 |
? 信息类命令
| 命令 |
描述 |
/check <玩家> |
查看当前处罚 |
/history <玩家> |
查看完整处罚历史 |
/iphistory <玩家/IP> |
查看 IP 历史 |
| /dupeip <玩家/IP> | 查看来自同一 IP 的关联账户 |
⚙️ 管理员命令
| 命令 |
描述 |
/badbans reload |
重新加载配置文件 |
/badbans rollback <staff> [time] |
回退由某工作人员发出的处罚 |
/wipe <player> [-s] |
完全重置一名玩家 |
? 权限
惩罚相关权限
| 权限 |
命令 |
badbans.command.ban |
/ban |
badbans.command.ipban |
/ipban |
badbans.command.tempban |
/tempban |
badbans.command.tempipban |
/tempipban |
badbans.command.unban |
/unban |
badbans.command.unbanip |
/unbanip |
badbans.command.mute |
/mute |
badbans.command.tempmute |
/tempmute |
badbans.command.unmute |
/unmute |
badbans.command.ipmute |
/ipmute |
badbans.command.unipmute |
/unipmute |
badbans.command.warn |
/warn |
badbans.command.tempwarn |
/tempwarn |
badbans.command.unwarn |
/unwarn |
badbans.command.kick |
/kick |
badbans.command.kickall |
/kickall |
员工工具权限
| 权限 |
访问功能 |
badbans.command.check |
当前处罚查询 |
badbans.command.history |
完整处罚历史 |
badbans.command.iphistory |
IP 历史记录查询 |
badbans.command.dupeip |
重复 IP 扫描器 |
badbans.command.wipe |
玩家数据清除命令 |
badbans.command.badbans.reload |
重载配置 |
badbans.command.badbans.rollback |
管理员回滚操作 |
badbans.notify.silent |
查看静默处罚 |
? 技术亮点
现代化 Paper 环境配置
- Paper API
paper-plugin.yml
- Java 25+
- Maven 构建
- Tab 补全支持
- 简洁的命令处理逻辑
|
性能优化重点
- 异步数据库逻辑
- 运行时库依赖
- 轻量级 Jar 包
- 无 NMS 代码
- 无用反射调用
- 清晰的模块化结构
|
? 管理反馈
当处罚成功应用时,执行操作的管理员会听到经典的 Minecraft 经验球音效。
这能让管理体验变得快速、响应灵敏且精致,同时不会干扰普通玩家。
? Web 历史记录支持
BadBans 包含网页历史记录支持,允许在游戏外查看处罚记录。
对于需要快速访问玩家记录、过往处罚及管理历史的服务器管理团队非常有用。
?️ 为什么选择 BadBans?
BadBans 专为希望拥有现代、简洁且强大的处罚插件的服务器所有者打造。
高效管理。清晰的历史记录。安全的性能表现。
更智能地处罚。更快速地同步。保护你的 TPS。
?️ BadBans
⚡ Modern Zero-Lag Punishment System for Paper Servers
BadBans is a lightweight, powerful and modern punishment plugin built for Minecraft Paper servers.
Manage punishments, IP tracking, dupe IP checks, staff tools, web history and multi-server sync with a clean and fast system.
Author: Bad_0320
Platform: Paper
Minecraft: 26.1.2
Java: 25+
Storage: MariaDB / SQLite
Sync: Redis
✨ Overview
BadBans is a complete punishment system inspired by LiteBans, designed for modern Minecraft servers that need clean moderation tools, fast database handling and reliable staff control.
It includes bans, IP bans, mutes, IP mutes, warnings, kicks, dupe IP checks, history lookup, silent punishments, rollback tools, web history support and optional player wipe systems.
Built to punish players, not your TPS.
? Feature Highlights
? Punishment System
Everything needed to manage player punishments in a clean and reliable way.
- Account bans
- Temporary bans
- IP bans
- Temporary IP bans
- Mutes
- Temporary mutes
- IP mutes
- Warnings
- Temporary warnings
- Kicks
- Kick all
|
? Staff Investigation Tools
Powerful tools to track players, IPs, punishments and linked accounts.
- Full punishment history
- Active punishment check
- IP history
- Dupe IP scanner
- UUID tracking
- IP tracking
- Status-colored alt accounts
- Pretty punishment IDs
- Staff rollback system
|
? Network Ready
Designed for both single servers and multi-server networks.
- MariaDB support
- Redis synchronization
- SQLite fallback
- Multi-server punishment sync
- Safe fallback behavior
- Runtime library loading
- Lightweight final jar
|
? Premium Experience
Clean visuals, polished messages and smooth staff feedback.
- Small caps punishment screens
- Styled ban messages
- Styled mute messages
- Clean public broadcasts
- Silent staff notifications
- XP orb success sound
- Tab completion
- Web history support
|
⚡ Zero-Lag Design
BadBans is designed to keep your server smooth, even during active moderation.
Database operations, punishment checks and sync actions are handled asynchronously where possible, reducing main-thread work and helping protect server TPS.
| Design Goal |
Result |
| Async punishment handling |
Less main-thread pressure |
| Database work off-thread |
Better server performance |
| Redis synchronization |
Fast network-wide updates |
| Lightweight jar |
Faster deployment |
| Paper API usage |
Better compatibility |
| No NMS dependency |
Easier updates |
? Multi-Server Support
BadBans is ready for server networks and shared punishment data.
| Component |
Purpose |
| MariaDB |
Main source of truth for punishment data |
| Redis |
Real-time synchronization between servers |
| SQLite |
Local fallback when MariaDB is unavailable |
If MariaDB or Redis are not available, BadBans can safely fall back to SQLite and disable multi-server sync automatically.
? Silent Punishments
Every punishment command supports silent mode using -s.
| Example |
Visibility |
/ban Player 7d Cheating |
Visible to everyone online |
/ban Player 7d Cheating -s |
Visible only to staff with silent notify permission |
Silent notifications are shown only to console and players with:
badbans.notify.silent
⚠️ Warning Auto-Ban
BadBans includes an automatic warning punishment system.
| Setting |
Default |
| Active warnings required |
3 |
| Automatic action |
Ban |
| Duration |
1 day |
| Reason |
Too many warnings reached |
When a player reaches the configured warning limit, BadBans automatically applies the punishment.
? Wipe System
BadBans includes a powerful player reset system.
/wipe <player> [-s]
Player Data
- Inventory
- Ender chest
- XP and levels
- Potion effects
- Food and saturation
- Persistent player data
|
Vanilla Files
- Playerdata
- Stats
- Advancements
- Recipes
- Advancement progress
- Optional external rank reset
|
Automatic wipe on ban is disabled by default for safety:
wipe-on-ban: false
? Styled Messages
BadBans uses clean, modern punishment messages with Small Caps Unicode styling.
Example:
ʏᴏᴜʀ ᴀᴄᴄᴏᴜɴᴛ ʜᴀꜱ ʙᴇᴇɴ ʙᴀɴɴᴇᴅ
| Message Type |
Style |
| Ban screen |
Red small-caps punishment layout |
| IP ban screen |
Clean connection-ban layout |
| Mute message |
Compact warning-style format |
| Warn notification |
Staff-friendly live message |
| Dupe IP output |
Status-colored account list |
| Broadcasts |
Clean public punishment format |
| Silent actions |
Staff-only notification style |
? Dupe IP Scanner
Use /dupeip <player/IP> to find accounts connected to the same IP.
BadBans displays linked accounts with status-based colors, making alt detection fast and readable.
| Status |
Meaning |
| Online |
Player is currently online |
| Offline |
Player is currently offline |
| Banned |
Player has an active ban |
| Muted |
Player has an active mute |
| IP Banned |
Player is linked to a banned IP |
? Pretty Punishment IDs
BadBans creates clean, stable punishment IDs.
| Player |
Example ID |
PupillaViola |
#PPLV4821 |
Bad_0320 |
#BAD04821 |
Punishment IDs are saved permanently and do not change when the player rejoins.
? Commands
? Ban Commands
| Command |
Description |
/ban <player> [time] [reason] [-s] |
Ban a player permanently or temporarily |
/ipban <player/IP> [time] [reason] [-s] |
Ban an IP address |
/tempban <player> <time> [reason] [-s] |
Temporarily ban a player |
/tempipban <player/IP> <time> [reason] [-s] |
Temporarily ban an IP address |
/unban <player> |
Remove an active account ban |
/unbanip <player/IP> |
Remove an active IP ban |
? Mute Commands
| Command |
Description |
/mute <player> [time] [reason] [-s] |
Mute a player permanently or temporarily |
/tempmute <player> <time> [reason] [-s] |
Temporarily mute a player |
/unmute <player> |
Remove an active mute |
/ipmute <player/IP> [time] [reason] [-s] |
Mute an IP address |
/unipmute <player/IP> |
Remove an active IP mute |
⚠️ Warning Commands
| Command |
Description |
/warn <player> [reason] [-s] |
Warn a player |
/tempwarn <player> <time> [reason] [-s] |
Temporarily warn a player |
/unwarn <player> [id/all] |
Remove one warning or clear all active warnings |
? Kick Commands
| Command |
Description |
/kick <player> [reason] [-s] |
Kick a player instantly |
/kickall [reason] [-s] |
Kick every online player |
? Information Commands
| Command |
Description |
/check <player> |
View active punishments |
/history <player> |
View complete punishment history |
/iphistory <player/IP> |
View IP history |
/dupeip <player/IP> |
View linked accounts from the same IP |
⚙️ Admin Commands
| Command |
Description |
/badbans reload |
Reload configuration files |
/badbans rollback <staff> [time] |
Roll back punishments issued by a staff member |
/wipe <player> [-s] |
Fully reset a player |
? Permissions
Punishment Permissions
| Permission |
Command |
badbans.command.ban |
/ban |
badbans.command.ipban |
/ipban |
badbans.command.tempban |
/tempban |
badbans.command.tempipban |
/tempipban |
badbans.command.unban |
/unban |
badbans.command.unbanip |
/unbanip |
badbans.command.mute |
/mute |
badbans.command.tempmute |
/tempmute |
badbans.command.unmute |
/unmute |
badbans.command.ipmute |
/ipmute |
badbans.command.unipmute |
/unipmute |
badbans.command.warn |
/warn |
badbans.command.tempwarn |
/tempwarn |
badbans.command.unwarn |
/unwarn |
badbans.command.kick |
/kick |
badbans.command.kickall |
/kickall |
Staff Tool Permissions
| Permission |
Access |
badbans.command.check |
Active punishment lookup |
badbans.command.history |
Full punishment history |
badbans.command.iphistory |
IP history lookup |
badbans.command.dupeip |
Dupe IP scanner |
badbans.command.wipe |
Player wipe command |
badbans.command.badbans.reload |
Reload configs |
badbans.command.badbans.rollback |
Staff rollback |
badbans.notify.silent |
View silent punishments |
? Technical Highlights
Modern Paper Setup
- Paper API
paper-plugin.yml
- Java 25+
- Maven build
- Tab completion
- Clean command handling
|
Performance Focus
- Async database logic
- Runtime libraries
- Lightweight jar
- No NMS
- No useless reflection
- Clean modular structure
|
? Staff Feedback
When a punishment is successfully applied, the staff member hears the classic Minecraft XP orb sound.
This makes moderation feel fast, responsive and polished without disturbing normal players.
? Web History Support
BadBans includes web history support, allowing punishment records to be viewed outside the game.
Useful for staff teams that need fast access to player records, previous punishments and moderation history.
?️ Why BadBans?
BadBans is made for server owners who want a punishment plugin that feels modern, clean and powerful.
Fast moderation. Clean history. Safe performance.
Punish smarter. Sync faster. Keep your TPS safe.
评论 0
登录后参与评分
还没有评论,来抢沙发吧