LibertyBans - 自由禁令

简介

LibertyBans 是一款设计精良、功能全面的 Minecraft 处罚管理插件。它旨在解决现有同类插件普遍存在的错误、并发问题或闭源付费等痛点，通过广泛的自动化测试确保代码质量，并专注于提供高效、稳定且可扩展的惩罚解决方案，无论是大型网络还是小型服务器都能流畅运行。

💡核心特性

处罚管理

• 添加/移除处罚：支持对玩家或 IP 地址执行各类处罚及撤销操作。
• /ban, /ipban, /unban, /unbanip - 封禁或解封玩家/IP
• /mute, /ipmute, /unmute, /unmuteip - 禁言或解除禁言玩家/IP
• /warn, /ipwarn, /unwarn, /unwarnip - 警告或撤销警告玩家/IP
• /kick, /ipkick - 踢出玩家/IP
• 临时处罚：支持为封禁、禁言和警告设置临时时限。
• UUID 存储：所有玩家数据均使用 UUID 进行存储和管理。

查询与列表

• 处罚列表：提供多种命令查看处罚记录。
• /banlist - 显示所有封禁记录
• /mutelist - 显示所有禁言记录
• /history - 显示指定玩家的所有处罚记录
• /warns - 显示指定玩家的所有警告记录
• /blame - 显示指定管理员执行的所有处罚

小号（Alt Account）管控

• 自动执行：当使用 IP 封禁时，若主账号被封，其关联的小号将默认被自动阻止加入（可配置）。
• 手动查询：使用 /alts 命令查看指定玩家的疑似小号。
• 加入通知：当疑似小号所属的玩家加入时，通知管理员成员。
• IP 连接限制：可限制每个 IP 地址的连接数量。

高级功能

• 权限豁免：例如，实习管理员无法封禁正式管理员，管理员无法封禁服主。
• 处罚模板与阶梯制度：可配置阶梯式处罚。例如，第一次因辱骂禁言 10 天，第二次 30 天，第三次永久。支持动态计算处罚原因、时长甚至类型。
• 高度可配置：所有选项和行为均可配置，甚至可以调整数据库连接池和语句缓存设置以优化性能。
• 多实例与跨服支持：完整支持多代理（Proxy）和多后端服务器实例。可在单一代理上安装，也可在多个后端服务器上部署并配置同步。

🎮命令与权限

• 运行 /libertybans usage 可查看所有命令（在控制台中输入时无需斜杠）。
• 创建临时处罚时，使用与永久处罚相同的命令，只需在玩家名后添加时间参数。例如：/ban Player1 30d 这是一个临时封禁。
• 所有命令、权限及配置的详细说明，请查阅官方 Wiki。

🔧设计理念

• 高效轻量：安装简单，避免不必要的功能，资源占用低。
• 数据库优先：可选择本地文件数据库（HyperSQL）或远程数据库（MariaDB, MySQL, PostgreSQL）。采用高效的 SQL 模式，将 UUID 和 IP 地址以原始字节形式存储而非字符串，极大提升性能并减少内存占用。
• 异步优化：遵循异步计算最佳实践，避免盲目创建异步任务导致不必要的上下文切换开销。
• 高并发与一致性：为高可用性和并发设计，通过将主要状态维护在数据库中来实现最小化锁定并保持状态一致。
• 结构良好的 API：为其他插件提供了完善的集成框架。由 Dmitri 维护的外部 Web 管理界面即使用了此 API。

✨安装与要求

系统要求

• Java 17 或更高版本。

支持平台

• 服务端：Bukkit / Spigot / Paper / Purpur (+Folia)
• 代理端：BungeeCord / Waterfall / Velocity
• 其他：Sponge
• 兼容性：支持 Geyser/Floodgate 用户名。在合理范围内支持平台分支。

重要提示（Velocity 用户）

由于 1.19+ 的聊天签名机制，在 Velocity 代理上安装 LibertyBans 需要 SignedVelocity 才能使禁言功能正常工作。您必须在代理和后端服务器上都安装 SignedVelocity，或者改为在后端服务器上安装 LibertyBans。

安装步骤

• LibertyBans 对大多数用户可开箱即用。
• 如果您使用代理：
• 在单一代理环境下，推荐直接将 LibertyBans 安装在代理上。
• 也可以安装在后端服务器上，但需要配置多实例同步。
• 插件首次启动时会下载内部依赖（仅需几秒），后续启动会更快。下载过程是安全的，依赖的预期哈希值已硬编码在插件中，若下载的文件哈希不匹配则不会被保存。

❓常见问题与链接

文档与支持

• Wiki（包含详细配置说明）：所有配置选项均在配置文件中详细注释。更新插件时，旧配置会自动适配新选项。
• 命令扩展指南：请参考 此 Wiki 页面。

问题反馈

• 请通过 GitHub Issues 报告问题：https://github.com/A248/LibertyBans/issues

开发构建

• 开发版本可在 CI 服务器获取：https://ci.hahota.net/job/LibertyBans/

趣闻

LibertyBans 最初于 2020 年 7 月 4 日（美国独立日）发布，其重要更新也常选在节假日或纪念日前后发布，形成了独特的发布传统。