转载 工具 LoginQueue2 1.4.0

[MD]
## 简介

插件组已从 LoginSequence2 更名为 LoginQueue2 。
自 1.3 / 1.3 版本起，单个 LoginQueue2 主插件即可覆盖 99% 以上的功能；在多数场景下，无需安装 Online、BC 或 VC 配套插件，也能实现完善的登录排队系统。

# LoginQueue2

> 插件组已从 **LoginSequence2** 更名为 **LoginQueue2**。
> 自 1.3 / 1.3 版本起，单个 LoginQueue2 主插件即可覆盖 99% 以上的功能；在多数场景下，无需安装 Online、BC 或 VC 配套插件，也能实现完善的登录排队系统。

## 核心功能

- 智能玩家排队系统，支持 VIP 优先级与自定义排序规则。
- 自动在多台主服务器之间进行负载均衡。
- 提供四种服务器选择策略：
- `LEAST_PLAYERS`：优先选择在线人数最少的服务器。
- `LEAST_LOAD`：优先选择负载最低的服务器。
- `ROUND_ROBIN`：轮询分配。
- `RANDOM`：随机分配。
- 可限制排队玩家的移动、交互及方块破坏行为。
- 可禁用下界、末地及对应传送门。
- 提供出生点保护，包括防爆炸、防伤害与禁止 PVP。
- 性能节省模式：可关闭生物生成、时间流逝和天气变化。
- UDP 直接同步：无需代理端插件，即可通过 UDP 获取子服务器状态。
- 支持 BungeeCord 与 Velocity 原生通道，兼容主流代理端。
- 支持多主服务器配置，并可在服务器不可用时自动故障转移。
- 支持轻量级 Limbo 登录服，资源占用更低。
- 玩家可通过点击信标加入排队。
- 内置可选认证系统，支持注册、登录与修改密码。

## 插件组件

| 组件 | 运行环境 | 用途 |
|---|---|---|
| LoginQueue2 | Spigot / Paper 1.13+；Spigot / Paper 1.13+ | 主插件，安装于登录服务器。 |
| LoginQueue2Limbo | Limbo | 轻量级登录服插件。 |
| LoginQueue2Online | Spigot / Paper 1.14+；Spigot / Paper 1.14+ | 用于通过 UDP 上报子服务器状态。 |
| LoginQueue2BC | BungeeCord | BungeeCord 代理端配套插件，可选安装。 |
| LoginQueue2VC | Velocity 3.x | Velocity 代理端配套插件，可选安装。 |

## 部署说明

### 单服务器模式

仅需安装 **LoginQueue2** 主插件。

将插件 JAR 文件放入登录服务器的 `plugins/` 文件夹即可。

### 群组服模式（推荐）

1. 在登录服安装 **LoginQueue2**，或使用 **LoginQueue2Limbo** 作为轻量级登录服方案。
2. 在每台主服务器安装 **LoginQueue2Online**，用于上报 TPS 等状态信息。
3. 通常无需安装 **LoginQueue2BC** 或 **LoginQueue2VC** 代理端插件。

### 完整模式（可选）

若需要使用代理端 IP 限制、数据库日志记录等功能，可按代理端类型额外安装：

- BungeeCord：安装 `LoginQueue2BC`
- Velocity：安装 `LoginQueue2VC`

除非需要新增功能，否则通常无需同步更新 BC、VC 和 Online 配套插件。

## 指令与权限

### 玩家指令

| 指令 | 说明 | 权限 |
|---|---|---|
| /join / /join | 加入排队队列。 | 无需权限 |
| /logseq help / /logseq help | 显示帮助信息。 | 无需权限 |

### 管理员指令

| 指令 | 说明 | 权限节点 |
|---|---|---|
| /logseq skip [player] / /logseq skip [玩家] | 跳过指定玩家的排队。 | `loginqueue.admin.skip` |
| /logseq list / /logseq list | 查看当前排队列表。 | `loginqueue.admin.list` |
| /logseq status / /logseq status | 查看服务器状态。 | `loginqueue.admin.status` |
| /logseq refresh / /logseq refresh | 手动刷新服务器状态缓存。 | `loginqueue.admin.refresh` |
| /logseq reload / /logseq reload | 重载配置文件与语言文件。 | `loginqueue.admin.reload` |
| /logseq debug / /logseq debug | 开启或关闭调试模式。 | `loginqueue.admin.debug` |
| /logseq info / /logseq info | 查看全部主服务器的详细信息。 | `loginqueue.admin.info` |

### 指令别名

- /ls 是 /logseq 的别名。
- /ls 是 /logseq 的别名。

### 其他权限节点

| 权限节点 | 说明 |
|---|---|
| `loginqueue.admin.bypass` | 绕过登录服的限制，例如移动、交互等限制。 |
| `loginqueue.vip` | 获得 VIP 排队优先级。 |
| `loginqueue.priority` | 获得优先排队权限。 |

## 支持语言

- 简体中文：`zh_CN`
- 繁体中文：`zh_TW`
- English：`en_US`

## 运行环境

- Java 8 或更高版本。
- `LoginQueue2VC`（Velocity 版本）需要 Java 17。

## 构建

```bash
mvn clean package
```

构建完成后，生成的 JAR 文件会自动复制到项目根目录的 `dist/` 文件夹。
[/MD]