Bungee Queue - 玩家队列防崩溃插件

💡简介

这是一个适用于 BungeeCord 或 Waterfall [1.8-1.15.2] 的高度可配置的排队系统。如果您喜欢这个插件，请提交评论，这将激励我添加更多内容并创建更多类似的有用插件！

本插件专为拥有 100 名以上玩家的中大型服务器设计，旨在保持极低的资源开销。虽然也可用于小型服务器，但其核心设计目标是轻量化和高效。

🎮权限

• bungeequeue.skip

授予玩家跳过队列的权限。此权限将强制覆盖配置中定义的等待队列或最大玩家数限制。

• bungeequeue.donor

授予玩家进入独立“捐赠者队列”的权限。该队列拥有可调整的等待时间倍率和独立的消息提示。

🎮命令

• /join <servername>

将您加入指定服务器的队列。

• /queuetime <servername>

显示指定服务器的当前预计排队时间。

• /qtime <servername>

显示指定服务器的当前预计排队时间（/queuetime 的快捷方式）。

⭐更新 3.0.0 重写说明

• 移除服务器分组功能：如果您需要此功能，请使用旧版本。
• 新增服务器满员队列：当服务器在线玩家数超过配置中设置的 MaximumSize 时，后续玩家将进入等待队列。插件会每秒检查一次是否有空位。
• 改进配置与占位符：移除了旧的 message1、message2 系统，现在可以直接在配置中使用新的占位符（注意：这不是 PlaceholderAPI 支持）。
• 更改基础命令：主命令从 /move 更改为 /join。
• 优化配置文件：配置文件现在更美观、更易读。

🔧配置详解

以下是对配置文件 config.yml 中主要选项的说明：

核心设置

• Multiplier: 1

等待时间倍率。队列中每增加一名玩家，其后的玩家等待时间将按此倍率指数级增加。例如，第 2 位玩家的等待时间为 倍率 * 2。如果玩家加入过快导致服务器崩溃，请尝试调高此值。

• IsServerSizeCalculated: false

是否将服务器当前在线人数计入等待时间计算。若为 true，则新公式为：(队列玩家人数 * 倍率) + 服务器在线人数。

• DonorWaitMultiplier: 1

捐赠者队列的等待时间倍率。

消息提示

您可以在消息中使用以下占位符

• %queuetime%：预计还需等待的秒数。
• %queueposition%：您在队列中的当前位置。
• %queuetotal%：队列中的总人数。
• %donorqueuetotal%：捐赠者队列中的总人数。
• %waitposition%：在服务器满员等待队列中的位置。

主要消息配置项

• EnteringQueueMessage

普通玩家加入队列时收到的消息。

• ShowDonorQueueTimer: true

是否向捐赠者显示队列计时。

• EnterningDonorQueueMessage

捐赠者加入队列时收到的消息。

• SkippingQueueMessage

玩家跳过队列时收到的消息。

• FullServerCannotConnectMessage

当服务器已满，玩家进入等待队列时收到的消息。

• DenialToQueueMessage

当玩家尝试加入被阻止的服务器时收到的消息。

服务器管理

• FallBackServer: lobby

备用服务器名称。在某些情况下（如配置错误）可能使用。

• MaximumSize: 1

服务器最大玩家数阈值。当服务器在线人数超过此值时，新玩家将进入“服务器满员等待队列”。拥有 bungeequeue.skip 权限的玩家将不受此限制，始终尝试连接。

• BlockedServers

禁止使用 /join 命令加入的服务器列表。

  BlockedServers:
    - example-server

✨安装与更新

警告：如果玩家同时拥有多个捐赠者或跳过权限，可能会导致错误或崩溃。

从旧版本更新至新版本，必须遵循以下步骤：

• 停止 BungeeCord/Waterfall 服务端。
• 删除旧的 BungeeQueue.jar 文件。
• 删除整个 BungeeQueue 插件文件夹及其所有内容。
• 将新的 BungeeQueue.jar 放入 BungeeCord/Waterfall 的 plugins 文件夹。
• 启动 BungeeCord/Waterfall 以生成新的配置文件。
• 再次停止服务端。
• 根据配置文件内的说明，配置 config.yml。
• 重新启动您的 BungeeCord/Waterfall 服务端。

❓支持与常见问题

• 支持 Discord：如需帮助，请通过 Discord 联系我。我的 Discord 用户名可在我的 Spigot 个人资料页面找到，插件启动时也会在 BungeeCord 控制台中显示。
• 反馈渠道：请不要在未阅读任何文档或加入支持 Discord 的情况下，将问题、功能请求或疑问作为负面评论留下。我会积极维护这个插件并尽力满足大家的需求，直接联系我即可！
• 问题排查：更新后请务必按照上述步骤操作，并仔细检查配置文件。