LibertyBans 是处罚管理领域闪耀而卓越的武器。
为什么选择它?
现有的处罚插件都存在缺陷。它们要么饱受漏洞和并发问题的困扰,要么是闭源且需要付费,或者两者兼有。
没有任何现有的处罚插件拥有能与 LibertyBans 广泛的自动化测试相媲美的测试框架。这意味着许多漏洞会被自动捕获,永远不会进入稳定版本。
LibertyBans 提供了一整套与处罚相关的工具。它是一个通用的处罚插件,专注于有效的设计、优质的体验以及无与伦比的代码质量。它可以高效地扩展到大型网络,并在单台服务器上以极少的资源运行,同时仍然提供丰富且模块化的功能集。
功能
- 添加和移除处罚:
- /ban, /ipban, /unban, /unbanip - 封禁或解封玩家或 IP 地址
- /mute, /ipmute, /unmute, /unmuteip - 禁言或解除禁言玩家或 IP 地址
- /warn, /ipwarn, /unwarn, /unwarnip - 警告或取消警告玩家或 IP 地址
- /kick, /ipkick - 踢出玩家或 IP 地址
- 临时版本的封禁、禁言和警告
- 所有玩家数据均使用 UUID 存储。
- 列出处罚:
- /banlist - 显示所有封禁
- /mutelist - 显示所有禁言
- /history - 显示某玩家的所有处罚记录
- /warns - 显示某玩家的所有警告记录
- /blame - 显示某位工作人员执行的所有处罚
- 多种阻止小号(Alt 账号)的方式:
- 自动执行以阻止小号。默认情况下,当使用 IP 封禁时,如果主账号被封禁,小号将自动被禁止加入。 此行为可配置,您甚至可以增加小号检查的严格程度。
- 手动 /alts 命令 - 显示某玩家的疑似小号。
- 加入时的小号通知 - 当疑似小号的玩家被封禁或禁言时,会告知工作人员。
- 豁免权。例如,实习生不能封禁管理员;管理员不能封禁服主。
- 布局与处罚模板。例如,第一次因骂人而被禁言持续 10 天,第二次为 30 天,第三次则为永久禁言。支持计算原因、时间甚至处罚类型。
- 选项和行为完全可配置。您甚至可以调整连接池和语句缓存设置以微调性能。
- 该插件经过精心设计,具有高性能且轻量级。它使用高效的 SQL 架构,存储 UUID 和 IP 地址的原始字节,而不是将其存储为字符串/文本。
- 完全支持多代理和多实例。如果您使用单个代理,可以将 LibertyBans 放置在代理上,也可以放置在多个后端服务器上。
命令、权限、配置
所有内容均在 Wiki 中解释:
Wiki 包含大量信息,包括关于配置的内容。
- 配置文件带有详尽的注释,选项也有详细解释。
- 如果您更新 LibertyBans,若有新选项,您的旧配置将自动更新。
命令
运行:
- /libertybans usage 以显示所有命令。当在控制台中输入此命令时,请省略斜杠。
创建临时处罚时,使用的命令与永久处罚相同。只需在用户名后添加时间即可:
- /ban Player1 30d 这是一个临时封禁
如需扩展指南,请参阅 此 Wiki 页面。
设计
- 高效且轻量。无需复杂的安装,并避免了不必要的功能。
- 可选择使用基于本地文件的数据库 (HyperSQL) 或远程数据库 (MariaDB, MySQL, PostgreSQL)。
- 高度可扩展,注重面向数据库的性能,强调在 SQL 中进行计算。由于处罚几乎完全存储在数据库中,因此内存占用很低。遵循连接池和异步计算的最佳实践。
- 结构良好的 API,为其他插件协同工作提供了框架。由 Dmitri 维护的外部 Web 界面 使用了该 API。
视频展示 - 西班牙语
视频展示 - 俄语
.
信息库
要求
- Java 17
支持的平台:
- Bukkit / Spigot / Paper / Purpur (+Folia)
- BungeeCord / Waterfall
- Sponge
- Velocity
兼容 Geyser/Floodgate 用户名。在合理的情况下支持平台分支版本。
由于 1.19+ 的聊天签名机制,在 Velocity 代理上安装 LibertyBans 需要 SignedVelocity 才能使禁言功能生效。Velocity 用户需要在他们的代理和后端服务器上安装 SignedVelocity,或者改为在后端服务器上使用 LibertyBans。
安装
LibertyBans 对大多数用户来说即装即用。
如果您正在运行代理:
- 当使用单个代理时,建议将 LibertyBans 直接安装在代理上。
- 如果您愿意配置多实例同步,也可以将 LibertyBans 安装在后端服务器上。
另请参阅关于代理安装的 此 Wiki 页面。
外部连接
当插件首次启动时,它会下载其内部依赖项。这是正常现象,第一次可能需要几秒钟。此后,插件启动速度会更快。下载依赖项的方法与将依赖项打包(shaded)一样安全——依赖项的预期哈希值是硬编码的,因此如果下载的依赖项哈希值不匹配,则不会保存到文件系统中。
趣味事实
- LibertyBans 于 2020 年 7 月 4 日首次发布,这一天是美国的独立日。
- 更新通常在重大节日或重要日子当天或不久后发布:
- 0.8.0 发布于 2021 年 9 月 11 日。
- 0.8.1 发布于感恩节 3 天后。
- 1.0.0 发布于新年 2 天后。
- 1.0.1 发布于情人节 2 天后。
- 1.0.2 发布于 2022 年 7 月 4 日,恰好是首次发布 2 周年。
- 1.0.4 发布于 2022 年 9 月 11 日。
- 1.1.0-M1 发布于 2022 年圣诞节。
- 1.1.0-M2 发布于圣帕特里克节 2 天后。
- 1.1.0-M3 发布于 7 月 4 日 5 天后。
- 1.1.0-RC1 发布于 2023 年 9 月 11 日。
- 1.1.0-RC2 发布于 2024 年 2 月 29 日。
- 1.1.0-RC3 发布于 2025 年 3 月 30 日。
- 1.1.1 发布于 2025 年 7 月 4 日。
报告漏洞
请使用 Github Issues:https://github.com/A248/LibertyBans/issues
但更大的问题是,你真的能找到任何漏洞吗?
选择礼物
使用社区积分,为喜欢的作品送上一份支持
打赏记录
感谢每一位送出礼物的社区成员



