Litebans-最全面的封禁管理插件

LiteBans

高效、可靠的 Minecraft 服务器处罚管理插件。提供完整的封禁、禁言、踢出、警告体系，基于 SQL 数据库实现数据持久化与跨服实时同步，并配备可选的 Web 管理面板。

原生支持 Spigot、Folia、Fabric、BungeeCord 与 Velocity，全平台功能一致。
下载链接2是授权的jar文件，放到服务器插件文件夹就能使用，功能100%一样。

为什么选择 LiteBans

原版 /ban 命令仅支持永久封禁与 IP 封禁，缺乏临时封禁、禁言、警告、历史记录与 Web 界面。

LiteBans 在此基础上构建了非常完整的处罚管理体系：
基于 UUID，在线模式与离线模式均完整支持
同一数据库下跨服实时同步，处罚立即在全网生效
支持 MySQL、MariaDB、PostgreSQL、H2（默认）多种数据库
异步查询、缓存机制、SQL 索引优化，对 TPS 影响极小
100% 可自定义消息（颜色、占位符、多语言）
可选 PHP/MySQL Web 面板，公开或私有的处罚历史查询
这是本人服务器web网页端的封禁管理网页https://liquidteam.cn:4366/bans.php 可以结合参考实际效果。
子服安装可以通过将原本反作弊处罚由ban调整为litebans:ban格式，这样其他插件也可以借助litebans来执行惩罚。
注意：本插件为付费插件，需要购买才能使用。如果你真心想要可以联系发帖人QQ:1464670605 获取jar，目前我自己服务器也用的这个封禁管理插件。

核心功能
处罚体系
封禁：永久封禁 /ban、临时封禁 /tempban、IP 封禁 /ipban（支持通配符，如 127.0.0.）
禁言：永久禁言 /mute、临时禁言 /tempmute、IP 禁言 /ipmute；被禁言玩家无法发言或使用黑名单命令
警告：/warn 记录警告，警告到期后可自动执行升级处罚（如多次警告触发临时封禁）
踢出：/kick 跨服踢人，记录写入玩家历史
格式灵活 同时也支持/ban ID 时间如(1d) 原因这种格式来实现临时封禁、禁言等操作。
跨服同步

所有连接到同一数据库的服务器实例共享处罚数据。例如在服务器 B 上对某玩家执行禁言，服务器 A 与 C 上的该玩家会被立即禁言，且有权限的管理员会在三台服务器上同时看到广播。
服务器作用域（Server Scopes）

支持全局处罚与单服处罚。通过 server: 参数指定作用域：

/ban Player 7d 作弊 server:Survival

默认所有处罚为全局（）。
历史与审计
/history <玩家>：查看目标近期收到的封禁、禁言、踢出、警告
/staffhistory <管理员>：查看某管理员发出的所有处罚
/staffrollback <管理员> [时长]：撤回该管理员的所有处罚（用于处理滥用职权）
/prunehistory <玩家> [时长]：清除玩家处罚历史
/dupeip <玩家>（即 /alts）：检测同 IP 下的关联账号，若其中存在被封禁账号会通知有权限的管理员
/iphistory <玩家>：查看玩家近期使用的 IP 地址
/geoip <玩家>：查询玩家所属国家（需在配置中启用）
模板系统（Punishment Ladders）

为封禁、禁言、警告、踢出定义模板，每次使用同一模板处罚时，处罚力度按预设阶梯自动升级。例如首次适用模板禁言 2 周，第二次 1 个月，第三次 3 个月。每个封禁模板可配备独立的踢出画面提示。
静默处罚
-s：静默处罚，仅拥有 litebans.notify.silent 权限的在线玩家可见
-S：极度静默，仅控制台可见，需 litebans.extrasilent 权限

用于在调查中处罚玩家而不打草惊蛇。
聊天管理
/clearchat：清屏，拥有 litebans.clearchat.bypass 的玩家不受影响
/mutechat：全局临时禁言，拥有 litebans.mutechat.bypass 的玩家仍可发言
/togglechat：允许玩家个人关闭其他人的消息（Bungee/Velocity 版本不支持）
服务器管控
/lockdown：进入锁定模式，无绕过权限的玩家被踢出且无法重连；/lockdown end 解除

/lockdown server:Survival # 仅 Survival 服锁定
/lockdown server: # 全网锁定
/litebans broadcast：通过 LiteBans 广播通道向同数据库的所有服务器广播消息，支持颜色代码与悬浮文本
Discord Webhook

可将处罚事件以自定义 Embed 形式推送到 Discord 服务器。
其他功能
从原版（含 Essentials）及 MaxBans、BanManager、AdvancedBan、BungeeAdminTools 等 7 款主流插件导入历史数据
/litebans allow：允许特定玩家加入，即使其 IP 或 GeoIP 处于封锁状态
离线玩家可接收警告，上线时统一展示
全消息支持悬浮文本（hover text）与十六进制颜色

常用命令介绍

| 命令 | 说明 | 所需权限 |
| :--- | :--- | :--- |
| /ban <玩家> [时长] [原因] | 封禁玩家 | litebans.ban |
| /tempban <玩家> <时长> [原因] | 仅临时封禁 | litebans.tempban |
| /ipban <目标> | IP 封禁（支持通配符） | litebans.ipban |
| /unban <玩家> | 解封（需同时持有 litebans.unban 与 litebans.unban.own） | litebans.unban |
| /mute <玩家> [时长] [原因] | 禁言 | litebans.mute |
| /tempmute <玩家> <时长> [原因] | 仅临时禁言 | litebans.tempmute |
| /unmute <玩家> | 解除禁言 | litebans.unmute |
| /warn <玩家> [原因] | 警告 | litebans.warn |
| /unwarn <玩家> | 移除玩家最后一次警告 | litebans.unwarn |
| /kick <玩家> [原因] | 踢出（跨服需 litebans.kick.global） | litebans.kick |
| /history <玩家> | 查看玩家处罚历史 | litebans.history |
| /staffhistory <管理员> | 查看管理员发出的处罚 | litebans.staffhistory |
| /warnings <玩家> | 查看玩家当前警告 | litebans.warnings |
| /banlist [页] | 查看活跃封禁列表 | litebans.banlist |
| /checkban <玩家> | 检查玩家封禁状态 | litebans.checkban |
| /checkmute <玩家> | 检查玩家禁言状态 | litebans.checkmute |
| /checkwarn <玩家> | 检查玩家警告状态 | litebans.checkwarn |
| /dupeip <玩家> | 查同 IP 关联账号 | litebans.dupeip |
| /geoip <玩家> | 查询玩家国家 | litebans.geoip |
| /lockdown [server:xxx] | 服务器锁定模式 | litebans.lockdown |
| /clearchat | 清屏 | litebans.clearchat |
| /mutechat | 全局临时禁言 | litebans.mutechat |
| /litebans reload | 重载配置并重建数据库连接 | litebans.admin |
| /litebans info | 查看数据库连接状态与同库服务器 | litebans.admin |
| /litebans broadcast <消息> | 跨服广播 | litebans.broadcast |
| /litebans reset-database | 清空数据库所有处罚（仅控制台，需确认） | litebans.admin |

时长单位：s（秒）、m（分钟）、h（小时）、d（天）、w（周）、mo（月）、y（年）。原因中支持颜色代码与换行符 \n。

权限节点

litebans. 授予除通知类以外的所有权限。
处罚权限
litebans.ban / litebans.tempban / litebans.ipban / litebans.ipmute
litebans.mute / litebans.tempmute / litebans.kick / litebans.warn
litebans.unban / litebans.unmute / litebans.unwarn（解禁类命令需同时持有 .own 后缀权限）
litebans.override：覆盖已有处罚
litebans.unlimited / litebans.unlimited.ban / litebans.unlimited.mute：绕过时长上限
豁免权限
litebans.exempt：免于封禁/禁言/警告/踢出
litebans.exempt.ban / litebans.exempt.mute / litebans.exempt.warn / litebans.exempt.kick
litebans.exempt.bypass：绕过豁免权限（用于上级管理员处罚下级）
建议在权限系统中启用 use_group_weights，使高级组免疫于低级组的处罚。Spigot 环境下豁免检查需 Vault 支持。
通知权限
litebans.notify：接收所有通知
litebans.notify.broadcast：接收封禁/禁言/警告/踢出广播
litebans.notify.broadcast.<服务器名>.<类型>：仅接收指定服务器指定类型的广播
litebans.notify.silent：查看静默处罚
litebans.notify.banned_join：当有被封禁或 GeoIP 封锁的玩家尝试加入时收到通知
litebans.notify.dupeip_join：玩家加入且同 IP 存在被封禁账号时收到通知
litebans.notify.muted / litebans.notify.warned / litebans.notify.warned.offline
在 Spigot 下这些通知权限默认为 true；若在 Fabric、BungeeCord 或 Velocity 下安装，需手动授予默认组相应权限。

数据库配置

LiteBans 默认使用 H2 文件数据库，单服开箱即用，无需任何配置。如需跨服同步或 Web 面板，请切换到 MySQL/MariaDB。

plugins/LiteBans/config.yml 关键配置：

sql:
driver: mysql # mysql | mariadb | postgresql | sqlite | h2
address: "127.0.0.1:3306"
database: "litebans"
username: "litebans"
password: "your_password"
table_prefix: "lb_"

跨服部署时，所有节点必须使用同一个数据库与同一个 table_prefix。

安装步骤
单服务器（Paper/Spigot）
从 SpigotMC 购买并下载 LiteBans（.jar 文件）
将 LiteBans.jar 放入 plugins/ 目录
启动服务器生成配置文件
按需修改 config.yml 切换数据库驱动
执行 /litebans reload 重载配置
跨服网络（Velocity/BungeeCord + 后端）
在代理端与每个后端服务器均安装 LiteBans
所有节点配置为连接同一个 MySQL/MariaDB 数据库，且 table_prefix 一致
重启代理与所有后端服务器
处罚数据即时全网共享
Web 面板（可选）

前置要求：PHP 8.x、Web 服务器（Apache/Nginx）、MySQL 访问权限。
将 LiteBans 配套的 Web 面板部署到虚拟主机目录
在 inc/settings.php 中填入与插件相同的 MySQL 凭证
配置管理员访问保护（基础认证或 ACL），可选择只读公开索引

Velocity 环境注意事项

在 Velocity 代理端下运行 LiteBans 时，权限系统的接入方式至关重要：
LuckPerms 必须安装在 Velocity 的 plugins/ 文件夹内，且所有后端实例与代理实例连接到同一个权限数据库，否则代理端的权限无法生效
对于 Velocity 插件，LuckPerms 上下文应为 server=proxy world=<世界名>，而非 server=lobby
spigot.yml 中保持 bungeecord: false，在 paper.yml 中使用 velocity-support 配置
安装后请用 /lpv user perm check litebans.ban 验证权限是否生效

若无法将权限系统链接到代理端，则可改为只在后端服务器安装 LiteBans。

技术规格
支持平台：Spigot、Folia、Fabric、BungeeCord、Velocity
数据库：MySQL、MariaDB、PostgreSQL、H2（默认）、SQLite
Java 版本：Java 8 及以上
依赖：单服 H2 模式零依赖；跨服同步需 MySQL/MariaDB；Spigot 下豁免检查需 Vault
性能：异步查询、缓存、SQL 索引优化，即便在网络环境下对 TPS 影响也极小

许可与授权
LiteBans 为付费插件，由 Ruan 开发，请通过 SpigotMC 官方渠道购买获取。