LiteBans – 一款完善、现代化、跨服Ban解决方案

LiteBans 是一个跨服惩罚管理系统，具有许多高级的可自定义功能，可增强您的管理体验。

通过 LiteBans 进行的所有惩罚将在链接到同一数据库的所有服务器上同步生效。

LiteBans 可以在 Spigot、Folia、BungeeCord 和 Velocity 下本地运行，在所有平台上提供相同的功能。

• 从开始设计就考虑到了 UUID 支持。所有惩罚都是基于 UUID 的。​
• 完全可定制的被禁止玩家的踢出通知，可以使用多行消息颜色代码，以及禁令信息变量 – 禁令到期前的持续时间、原因、发布禁令的工作人员、被施加禁令的服务器、自施加禁令以来的时间、原始禁令日期和持续时间等等。​
• 模板系统允许您制作完全可定制的惩罚。每次你使用模板惩罚某人时，他们都会爬上你创建的阶梯并受到越来越大的惩罚。人话:禁令阶梯就是从低等级处罚逐步升级为高等级处罚。每个禁令模板都可以分配自定义踢出消息！​
• 支持自定义警告模板，允许您定义警告类别，每个警告都有自己的一组触发惩罚命令，这些命令在玩家被警告特定次数后进行。​
• 支持模板组 – 通过这些模板组，您可以通过在一个惩罚阶梯下组合模板来共享模板进程。​
• 支持服务器范围，使您能够设置每台服务器的惩罚和全局惩罚。​
• Discord Webhook 支持 – 将可定制的 Discord 嵌入消息发送到您的 Discord 服务器！易于配置。​
• 所有消息都可以在 messages.yml 中自定义。有许多有用的变量可放置在涉及禁止、禁言或警告的任何可配置消息中。支持悬停文本和十六进制颜色。​
• 您可以查看玩家的处罚历史（/history）和工作人员发出的处罚（/staffhistory）。​
• 支持多种数据库类型，包括 MySQL、MariaDB、PostgreSQL 和 H2。默认情况下使用 H2，这意味着在单服务器设置中使用 LiteBans 不需要 MySQL。​
• 多帐户通知 – 当同一 IP 上的被禁止帐户的玩家加入时，所有具有正确权限的玩家都会收到通知。​
• 多实例同步系统允许全局惩罚和广播在连接到同一数据库的所有服务器上立即生效，即使插件没有安装在 BungeeCord 下。就比如你有两个服务器，一个生存服 一个创造服。你在创造服ban了一个人，这个ban和消息会在使用同一数据库的生存服上播报并且生效。​
• 工作人员可以“回滚”——他们发出的所有惩罚都可以随时通过一个命令取消。处理员工虐待行为从未如此简单。​
• 可以从原版（包括 Essentials）和 7 个流行插件（包括 MaxBans、BanManager、AdvancedBan 和 BungeeAdminTools）导入禁令。​
• 可以使用“/litebans allowed”命令允许已被 IP 禁止或 GeoIP 阻止的用户，该命令将其帐户从 IP 禁止中排除，而无需完全删除禁令。​
• 离线玩家可以收到警告；他们加入后将看到所有新警告。这适用于跨服务器。​
• 除非获得许可，否则玩家不能通过设置非常短的禁令或静音来推翻惩罚。​
• 轻量级、多线程且专为性能而设计。 LiteBans 使用最少的内存，并且启动后不会阻塞主服务器线程进行任何数据库查询。​

LiteBans 网络的最佳功能之一是其跨服务器同步系统。

例如：
服务器A、服务器B和服务器C都运行LiteBans，连接到同一个MySQL数据库。
如果A服务器的玩家在B服务器被禁言，则A服务器立即生效，该玩家将被禁言，并且A、B、C服务器上的所有玩家都会看到该玩家被禁言的广播：他们有权限并且启用了广播同步。如果玩家离开服务器A并加入服务器B或服务器C，他们仍然会被禁言。

Web 界面列出了所有Ban、禁言、警告和踢出。

安装指南：https://gitlab.com/ruany/litebans-php/-/wikis/Installation

LiteBans 允许您在所有消息（包括广播）中设置自定义悬停文本。
只有拥有权限 (litebans.json.hover_text) 的玩家才会看到悬停文本。
messages.yml 中可用的所有变量以及颜色和换行符也可以包含在悬停文本中。

例子：

broadcast_ban: '&e$bannedPlayer &chas been banned. {hoverText: &aHover text here!}'

LiteBans拥有强大的模板系统。模板可应用于Ban、禁言、警告和踢出。

这只是冰山一角。请参阅 wiki 上的模板以获取完整的文档和示例！

所有命令和标志都记录在 wiki 上 – 单击此处查看它们。

在发表评论或报告插件问题之前，请先阅读常见问题解答！

常见问题解答可以在这里查看。

完整的权限列表可以在此处查看。

除非另有明确说明，配置中的所有选项在插件的所有版本（Spigot/Bungee/Velocity）上同样有效。

该插件已针对 H2 进行了预先配置，因此如果您没有 MySQL 数据库，则无需配置任何内容。

包含信息、说明和示例的完整指南可在此处查看：

https://gitlab.com/ruany/LiteBans/-/wikis/Importing

为了在插件中支持 MySQL，需要一个可用的 MySQL 数据库。

需要有效的互联网连接，但仅限第一次启动插件时。依赖项（每次更新仅下载一次，并且可以单独下载）存储在 LiteBans 数据文件夹中后将离线工作。

LiteBans 可以通过多种方式安装。它可以在单个 Spigot 服务器上运行，也可以在链接到同一 MySQL 数据库的多个 Spigot 服务器上运行，也可以直接安装在 BungeeCord 或 Velocity 上。

LuckPerms 有 BungeeCord 和 Velocity 支持。如果安装正确，权限将在 Spigot 和代理之间桥接。

如果您希望 LiteBans 在 Spigot 存在（Spigot 权限，可与使用 /ban、/mute、/kick 等的 Spigot 插件一起使用），那么您可以将其安装在每个 Spigot 服务器上，并将所有插件实例与同一数据库链接在一起。

对于单服务器 Spigot 设置：

1. 将插件下载到 Spigot 插件文件夹。​
2. 启动服务器（如果它已经在运行请重新启动它）​
3. 根据需要编辑 config.yml 和 messages.yml，然后运行“/litebans reload”。​
4. 使用您安装的任何权限插件设置权限。​

使用多个 Spigot 服务器：

1. 使用上面针对每台服务器的说明，在要链接在一起的所有服务器上安装插件。
2. 配置插件以连接到所有服务器上的同一数据库。

使用BungeeCord:

1. 将插件下载到 BungeeCord 插件文件夹。该插件不需要安装在链接到代理的任何服务器上。
2. 启动 BungeeCord（如果它已经在运行请重启它)
3. 根据需要编辑 config.yml 和 messages.yml，然后运行“/litebans reload”。
4. 使用您安装的任何权限插件设置权限。如果您希望玩家看到播报，您需要将“litebans.notify.broadcast”权限添加到默认组。
5. 如果您正在运行离线模式服务器，则需要将您的身份验证系统（例如 AuthMe）与 BungeeCord 链接，否则用户无需登录即可运行命令。

使用多个 BungeeCord 实例：

配置简单直观 – 您只需将服务器连接到同一个数据库，无需其他任何操作。

1. 下载插件并将其复制到每个 BungeeCord 实例的插件文件夹中。
2. 配置 config.yml 和 messages.yml 并将它们复制到所有实例中。插件第一次启动后，默认配置将放置在“plugins/LiteBans/”中。所有实例都需要连接到同一个 MySQL 数据库才能正确同步。
3. 在每个 BungeeCord 实例的 config.yml 中设置权限并重新启动。如果您希望玩家看到广播，您需要将“litebans.notify.broadcast”权限添加到默认组。
4. 如果您运行的是离线模式服务器，则需要安装 AuthMeBungee，否则用户无需登录即可运行命令。

安装插件的多个实例后，您可以检查一切是否配置正确

通过运行“/litebans info”命令。它会告诉您是否有多个服务器连接到数据库。

LiteBans 可以直接在 Spigot 或 BungeeCord 下运行– 它可以安装在 Spigot 插件文件夹或 BungeeCord 插件文件夹中。

BungeeCord版本的特点：

• 网络上所有服务器上的玩家都被视为在同一服务器上。​
• 无需在具有相同 MySQL 配置的所有服务器上设置 LiteBans。仅在 BungeeCord 代理上进行一次设置就足以使禁令在每台服务器上起作用。​
• BungeeCord 版本可以使用本地文件数据库 (H2)，并且仍然可以跨多个服务器工作（使用单代理设置），但是，没有对此提供官方 Web 界面支持。​
• Spigot 插件无法覆盖代理级别发生的情况，因此其他插件干扰 LiteBans 的可能性要小得多。​
• LiteBans 不介意您在代理后面运行什么类型的服务器 – 它们不必是 Spigot 服务器，并且不需要“桥接”插件。如果您可以在 Bungee 后面运行 Vanilla 服务器，您仍然可以在其上使用 LiteBans！​

使用 BungeeCord 版本的注意事项：

• 您将需要一个原生的 Bungee 权限系统（推荐使用 LuckPerms）。
• 每个插件实例只有一个全局配置。 (config.yml, messages.yml) – 这也可以被认为是积极的。
• Spigot 插件不能直接执行 BungeeCord 命令，反之亦然。例如，如果无法从后端服务器运行 /ban 命令，Anticheat 插件将无法全局禁止玩家。
• 禁止使用控制台时，您必须使用 BungeeCord 控制台。

https://gitlab.com/ruany/LiteBansAPI/wikis/home