黑插件 LiteBans 2.18.7

站内为老版本，我更新了一下，来自blackminecraft(https://black-minecraft.com/resources/litebans.1162/)​

LiteBans 插件的描述：​

LiteBans 是一个服务器间封禁管理系统，拥有许多额外的可自定义功能，旨在提升你的 Minecraft 服务器管理体验。

所有通过LiteBan实施的处罚将在所有关联同一数据库的服务器上全球生效。
虽然LiteBans设计用于高效同步数百台服务器，但它可以在没有MySQL数据库的单台服务器上运行。

LiteBan可以运行Spigot、BungeeCord和Velocity，在所有平台上提供相同的体验。

LiteBans 插件的功能：​

• 从零开始设计，考虑了UUID支持。所有处罚均基于 UUID。
• 被封禁玩家可完全自定义踢球画面，可使用多条线条和颜色，封禁信息可变数——封禁持续时间、原因、封禁员工、封禁服务器、封禁生效时间、封禁日期和持续时间等。
• 模板系统允许你创建完全自定义的惩罚阶梯。每次你用模板惩罚别人，他们就会爬上你建立的阶梯，受到越来越多的惩罚。每个封禁模板都可以在踢球界面上分配自定义信息！
• 游戏支持自定义警告模板，允许你定义警告类别，每个类别都有自己的惩罚命令，玩家在达到一定数量警告后触发。
• 支持服务器范围，允许你设置每个服务器的惩罚和全局惩罚。
• 所有消息都已配置在messages.yml文件中。在任何包含封禁、静音或警告的自定义消息中，都可以加入许多有用的变量。支持悬停文字和RGB颜色。
• 你可以查看球员处罚历史（/history）和员工处罚（/staffhistory）。
• 支持多种类型的数据库，包括MySQL、MariaDB、PostgreSQL和H2。H2是默认的，这意味着MySQL不需要在单一服务器上使用LiteBan。
• 多账号通知——当同一IP被封账号的玩家加入时，所有拥有相应权利的玩家都会收到通知。
• 多实例同步系统允许全局惩罚和广播即时在所有连接到同一数据库的服务器上生效，即使该插件未安装在 BungeeCord 中。
• 员工可以被“抽干”——他们施加的所有处罚可以被某个团队随时解除。员工虐待从未如此容易应对。
• 封禁可以从原版（包括 Essentials）导入，也可以导入六个流行插件，包括 MaxBans、BanManager、AdvancedBan 和 BungeeAdminTools。
• 被IP或GeoIP封禁的用户可以通过“/litebans allow”命令免于封禁。
• 离线玩家可能会收到警告;他们加入时会看到所有新的警告。这适用于所有服务器。
• 玩家无法通过设置非常短暂的封禁或未获许可静音来撤销惩罚。
• 轻量化、多线程且性能优良。LiteBans 使用极少的内存，启动后不会通过查询数据库阻断主服务器线程。

LiteBan中的服务器间同步​

LiteBan 在网络中最出色的特点之一是其服务器间同步系统。

例如：
服务器A、服务器B和服务器C都运行LiteBan，并且连接到同一个MySQL数据库。

点击展开...

如果服务器A上的玩家在服务器B上静音音频，服务器A会立即发生，玩家会被静音，所有服务器A、B和C上的玩家都会看到广播，表示玩家已被静音，只要他们有权限并且开启了流媒体同步。如果玩家离开服务器A并加入服务器B或C，他们仍然会被断开连接。

LiteBans 的网页界面​

网页界面显示所有禁令、静音、警告和踢击。
你可以用它查看特定球员或工作人员的所有处罚，并查看这些处罚何时到期。
* 免费网站不包含在内，您需要自己的网站托管。


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

LiteBan中的JSON支持。​

LiteBans 允许你在所有消息中设置自定义悬停文本，包括广播。
只有获得许可的玩家（litebans.json.hover_text）才能看到这段文字。messages.yml文件
中可用的所有变量也可以包含在悬停文本中，同时还包括颜色和新行。

例：
YAML：

broadcast_ban: '&e$bannedPlayer &cбыл забанен. {hoverText: &aТекст при наведении!}'

LiteBan中的模板系统​

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

每个模板都有可自定义的天梯，比如你可以有一个模板，第一次使用模板时禁赛球员2周，第二次禁赛一个月，第三次禁用3个月。
这只是冰山一角。详见templates.yml详细介绍！

LiteBans 插件命令​

ban （/ban） 命令的使用方式如下：

/ban [-s] <target> [duration] [reason] [server：*]
另外：/tempban、/ipban、/unban

<Target>可以是名称、UUID 或 IP 地址。

如果你按IP封禁玩家，他们的UUID和IP地址会同时被封禁，所以他们不能用不同的IP地址加入同一个账号。

[server：*] 是一个可选参数，如果插件安装在 Bungee/Velocity 上，或者你有多个 LiteBan 实例，可以使用。
默认情况下，所有惩罚都是全局的（*）。
服务器范围（每个服务器的惩罚）详见这里的维基。

例： /ban Ник 7d [причина] server:Survival

除非特别说明，否则 /ban 和 /mute 命令的持续时间是固定的。如果玩家没有litebans.无限权限，游戏时长将被限制在config.yml中规定的最大时长（每组）。

/ban、/mute、/warn 和 /kick 的原因可以包含颜色和新行（“\n”）。例如：
/ban Ник &cПервая строка\n&aВторая строка

支持带有万数符号的IP封禁，例如/ipban 127.0.0.*
举例：/ban 玩家 -s 7d [理由]。

你也可以这样用：
/ban Player -s 7天[原因]。

或者这样：
/ban Player[reason] -s 7d

或者如果你真的想要的话：
/ban 7d -s Player[reason]。

目标必须排在最前面。理由（可选）必须在进球后给出。持续时间可以任意指定。

如果未明确规定持续时间，将会被永久封禁。

这些标志可用于封禁、禁用、警告和踢球：

• ——代表无声惩罚。只有拥有 litebans.notify.silent 权限的在线玩家才能观看该直播。
• ——S，表示额外的无声惩罚。只有控制台能看到广播。需要litebans。extrasilent权限才能使用。
• -p 代表公开惩罚 - 如果你默认启用了无声惩罚，可以用该标志将惩罚设置为公开（非静默）。
• -N 以防止现有处罚被新处罚取消，除非（调整后）规定的时长超过现有处罚的时长。

如果你在说明惩罚原因前使用“--”（双划），旗帜将被忽略，它们会显示在原因中。任何出现在“--”之后的旗帜都被视为文字文本。

你可以封禁线上和线下玩家，包括那些从未登录过服务器的玩家。
其他接受目标和原因的命令（如 /mute 和 /warn）也可以像 ban 命令一样使用。

参数：<必需>[可选]

可用单位：（秒）、分钟、（小时）、时间、时间、年。

时间单位示例（上述命令均有效）：
法典：

/ban Player 3 days [reason]
/ban Player 3d [reason]
/ban Player 3days [reason]
/ban Player 1 day [reason]
/ban Player 1day [reason]

静音命令（/mute [-s] <target> [duration] [reason] [server：*]）允许你禁用播放器。当玩家断开连接时，无法聊天或使用黑名单命令。
相关命令：/tempmute（需要持续时间）、/ipmute、/unmute

warn 命令（/warn [-s] <target> <reason> [server：*]）允许你警告玩家。警报在可配置的时间后会过期。当玩家收到一定数量的警告时，可以执行指定的命令。
相关命令：/unwarn（移除玩家的最后警告）。

历史命令（/history <target> [server：*]）显示玩家最近收到的封禁、断线、踢球和警告，按日期排序。

您可以使用 /warnings <target>查看玩家的活跃警告。
/staffhistory <target>可用于显示玩家施加的禁令、残疾、踢球和警告。
/prunehistory <target> [持续时间] 可用于清除玩家的惩罚历史。
示例：/prunehistory 玩家 5天
/staffrollback <target>[持续时间]可以用来回滚所有人员作（封禁、关闭、警告、踢出），并可选择延长时间。

对于 /prunehistory 和 /staffrollback，显示的时长表示自今天起已经过的时间。

如果你使用命令“/staffrollback StaffMember 3天”，过去3天内对该员工施加的所有惩罚将被移除，过去3天内对其施加的所有解封或权限也会被撤销。

注意：这两个命令除非你有备份，否则无法撤销。


dupeip命令（/dupeip<target>）允许你查看所有与目标IP相同IP加入的账户，看看它们是在线、离线还是被封禁。
你也可以用 /ipreport 命令，检查所有在线玩家。
你也可以用 /iphistory 检查玩家最近加入服务器的 IP 地址。（需要config.yml中的“delete_previous_history：false”参数）

“检查禁止”命令（/checkban <target>）可以让你检查目标是否被封禁。它还会告诉你封禁的时间、封禁的时间、是否有IP封禁，以及是否是无声封禁。
相关命令：/checkmute

踢击命令（/kick [-s] <player> [reason]）允许你击打在线玩家。这些记录会被记录在玩家的历史记录中。

你也可以踢出其他服务器的玩家，并且使用LiteBan的 #i 连接到同一数据库的p###。
这适用于所有版本的插件（Spigot/Bungee/Velocity），不需要 Bungee/Velocity。

如果在配置中启用geoip命令（/geoip<target>），可以让你检查玩家来自哪个国家。这也可以用于离线玩家。

你可以用命令 /lastuuid <target> 检查玩家的 UUID（在线或离线）。
可以通过 /clearchat 命令清除聊天。拥有“litebans.notify.clearchat”权限的玩家在聊天被清除时会收到通知。
和锁定一样，默认情况下，这个功能只影响服务器的本地区域。（服务器：本地）

您可以使用 /banlist [page] 命令查看当前封禁列表。

你可以随时用 /litebans reload 命令重新加载配置。
这会重启config.yml和messages.yml并应用新的设置。
重启LiteBans也会强制它重新连接到数据库。

服务器可以通过使用 /lockdown 命令 <cause> 来锁定。没有绕过权限的玩家将在封禁开始时被踢出，且在封禁结束前无法加入。你可以用 /lockdown end 结束这个模式。

在Bungee/Velocity中，你可以为/lockdown提供服务器范围。目前，/lockdown一次只能影响一个范围。
示例：/lockdown <cause> server：Survival
Global lockdown 适用于同一网络上的所有服务器：/lockdown <cause> server：*

注意：/togglechat 不能用于 Bungee/Velocity 版本的插件。
对于拥有litebans.togglechat权限的用户，可以通过/togglechat命令切换聊天功能。该命令允许用户“静音”其他玩家的消息。

聊天功能可以通过 /mutechat 命令在全局中暂时禁用。拥有litebans.mutechat.bypass权限的玩家仍然可以聊天。

LiteBans 管理员工具的命令：​

/litebans reload：重新加载插件并重新连接数据库。
/liteban 允许：允许特定用户加入服务器，即使他们被 IP 或 GeoIP 屏蔽。
/litebans 信息：提供数据库连接状态、活跃连接数量的信息，并显示连接到同一数据库的服务器。
/litebans broadcast <message>：该命令允许您使用 LiteBans 广播通道广播任何消息。该消息会覆盖所有连接到同一数据库的服务器，可能包含聊天颜色和新行，只有拥有“litebans.notify.broadcast”的玩家才能看到。“broadcast-type：<perm>”参数允许你覆盖观看广播所需的分辨率（litebans.notify.<perm>），该命令需要“litebans.broadcast”权限。
/litebans 时区 [时区]：参见维基：时区
/liteban 解除绑定 <player>：解除该玩家所有 IP 地址与 /alts 的绑定。这样目标账户就会被解绑。如果未来这些账户再次添加相同的IP地址，它们将再次被关联。
/litebans cleariphistory<name/UUID/IP>：清除特定名称、UUID或IP地址的IP地址历史。一般使用时，最好使用unlink命令，因为它可以正确显示罚则历史。
/litebans reset-database：清除数据库中的所有惩罚。该命令需要确认，只能通过控制台执行。
/litebans fixhistory：通常不需要。在历史表中添加了缺失的用户名+UUID条目。可以在 cleariphistory 之后使用，但这只能在线使用，因为用户名来源于 Mojang。
/litebans addhistory <name> <UUID> <IP>：允许你直接向数据库添加IP历史。

常见问题​

在发布评测或举报插件问题前，请务必阅读常见问题！

常见问题解答可在此查看。

权限​

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

LiteBans 插件配置​

配置中的所有选项在所有版本（Spigot/Bungee/Velocity）中工作方式相同，除非特别说明。

插件配置（config.yml）：​

标准config.yml可以在这里查看。

自定义消息（messages.yml）：​

标准messages.yml可以在这里查看。
所有变量现在都已在messages.yml文件中文档化，可以上方查看。

数据库配置​

插件是预先配置的，所以如果你没有MySQL数据库，也不需要配置任何东西。
H2不需要任何配置，并且可以处理磁盘上的文件。

要配置MySQL插件，打开config.yml，将“driver”改为“MySQL”，并根据需要设置“username”、“password”、“address”和“database”。

导入LiteBan​

完整指南、信息、说明和示例可在此处找到：

导入 ·维基百科 ·Ruan / LiteBans ·GitLab​

LiteBan 的官方问题追踪/维基。
gitlab.com

Litebans 插件要求​

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

如果你只用插件的单一实例，不需要网页界面，也不需要MySQL服务器，插件安装后开箱即用。
需要
有活跃的网络连接，但仅在插件首次启动时才需要。依赖——每次更新只能下载一次，且可以单独下载——一旦保存到LiteBans数据文件夹，离线即可工作。

安装LiteBans插件​

LiteBan 可以通过多种方式安装。它可以运行在单一 Spigot 服务器上，也可以在多个 Spigot 服务器上运行，连接到单一 MySQL 数据库，也可以直接安装在 BungeeCord 或 Velocity 上。
我
应该在所有Spigot服务器上安装这个插件，还是只在Bungee/Velocity上安装？

请注意，您在Spigot上设置的权限不会自动转移到BungeeCord或Velocity。

LuckPerms 支持 BungeeCord 和 Velocity。如果安装正确，权限会在 Spigot 和 p####i 之间转移。

如果你想在 Spigot 中保留 LiteBan（Spigot 权限，可用于使用 /ban、/mute、/kick 等的 Spigot 插件），那么你可以在每个 Spigot 服务器上安装它，并通过一个数据库将所有插件实例关联起来。

否则，如果你愿意用 Bungee/Velocity 权限系统（推荐用 LuckPerms），而且没有需要用 LiteBans 命令的 Spigot 插件，那么你可以直接在 BungeeCord/Velocity 上安装，不需要安装在连接到 p####i 的任何服务器上。

要在单台服务器上安装Spigot：​

1. 把插件上传到plugins文件夹。
2. 启动服务器（或者如果已经运行的话重启）。
3. 根据需要编辑config.yml和messages.yml，然后运行命令“/litebans reload”。
4. 使用你安装的任何权限插件来配置权限。

使用多个Spigot服务器：​

1. 按照上述每台服务器的说明，在所有你想连接的服务器上安装插件。
2. 配置插件连接所有服务器的同一个数据库。

与BungeeCord合作：​

1. 把插件下载到BungeeCord插件文件夹里。该插件无需安装在任何与 p####i 关联的服务器上。
2. 启动BungeeCord（如果已经运行，则重启）。
3. 根据需要编辑config.yml和messages.yml，然后运行“/litebans reload”。
4. 使用你安装的任何权限插件来配置权限。如果你想让玩家看到广播，你需要在默认组里添加“litebans.notify.broadcast”权限。
5. 如果你在离线使用服务器，你需要将认证系统（例如 AuthMe）连接到 BungeeCord，否则用户将可以无授权执行命令。

使用多个BungeeCord实例：​

注意：LiteBans 不要求也不使用 RedisBungee 来跨多个服务器同步。

只要 LiteBan 连接的多个 BungeeCord p####i 服务器，只要连接到同一数据库，封禁、静音、广播、通知和点击都会同步。
配置简单直观——你只需将服务器连接到同一个数据库，其他无需。

1. 下载插件并复制到每个BungeeCord实例的plugins文件夹。
2. 配置config.yml和messages.yml，并将它们复制到所有实例。默认配置会在插件首次运行后放置到“plugins/LiteBans/”文件夹中。为了实现正确的同步，所有实例必须连接到同一个 MySQL 数据库。
3. 配置每个 BungeeCord 实例config.yml权限并重启。如果你想让玩家看到广播，你需要在默认组里添加“litebans.notify.broadcast”权限。
4. 如果你是离线运行服务器，需要安装AuthMeBungee，否则用户可以在不注册的情况下执行命令。

Spigot 版本与 BungeeCord 版本​

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

所有LiteBan的命令和功能都可以在BungeeCord中使用（除了/togglechat）。

弹力绳版本的特点：​

• 网络中所有服务器上的玩家都被视为同一服务器。
• 无需在所有使用相同MySQL配置的服务器上配置LiteBan。在p####i BungeeCord上设置一个配置，就足以让所有服务器的封禁生效。
• BungeeCord的一个版本可以使用本地文件数据库（H2），并在多个服务器上运行（如果配置在一个p####i 上），但目前没有官方基于网页的支持。
• Spigot 插件无法覆盖 p####i 层面的处理，所以其他插件干扰 LiteBan 的可能性要小得多。
• LiteBan 不管你在 p#### 后面运行什么类型的服务器 #i 都不一定非得是 Spigot 服务器，也不需要“桥接”插件。如果你能在 Bungee 后面运行一个原版服务器，你仍然可以使用 LiteBans 来运行！

使用BungeeCord版本时的顾虑：​

• 你需要Bungee自己的权限系统（推荐使用LuckPerms）。
• 每个插件实例只有一个全局配置。（config.yml，messages.yml）——这也可以被视为一个优点。
• Spigot 插件不能直接执行 BungeeCord 命令，反之亦然。例如，反作弊插件如果无法在后台执行 /ban 命令，就无法全局封禁玩家。
• 关闭主机时，必须使用蹦极绳游戏控制台。

首页 ·维基 ·Ruan / LiteBansAPI ·GitLab​

官方LiteBans API仓库、维基和问题追踪器。 https://ruany.gitlab.io/LiteBansAPI/
gitlab.com