LoginSequence2

LoginQueue2 - Next-Generation Minecraft Login Queue System
==========================================================

Tip: The plugin group has been renamed from LoginSequence2 to LoginQueue2.

Since version 1.3, a single LoginQueue2 plugin can handle over 99% of the functionality, allowing for a nearly perfect login queue without needing the Online/BC/VC plugins.


Core Features
-------------

- Smart player queuing system with VIP priority and custom sorting rules
- Automatic load balancing across multiple main servers
- Four strategies: LEAST_PLAYERS, LEAST_LOAD, ROUND_ROBIN, RANDOM
- Restrict movement, interaction, and block breaking for queued players
- Disable Nether/End dimensions and portals
- Spawn protection (anti-explosion, anti-damage, no PVP)
- Performance-saving mode (disable mob spawning, time flow, weather changes)
- UDP Direct Sync: Get subserver status without proxy plugins via UDP
- BungeeCord/Velocity Native Channels: Compatible with mainstream proxies
- Multi-main server support with automatic failover
- Lightweight Limbo Support: Use Limbo as login server with minimal resource usage
- Click beacon to join queue, simple and convenient
- Built-in optional authentication system (register/login/change password)


Plugin Components
-----------------

- LoginQueue2 (Spigot/Paper 1.13+) - Main plugin (login server)
- LoginQueue2Limbo (Limbo) - Lightweight login server plugin
- LoginQueue2Online (Spigot/Paper 1.14+) - Subserver status reporting (UDP)
- LoginQueue2BC (BungeeCord) - Proxy companion plugin (optional)
- LoginQueue2VC (Velocity 3.x) - Velocity proxy companion plugin (optional)


Deployment Recommendations
--------------------------

Single Server Mode:
Only LoginQueue2 main plugin needed. Place it in the login server's plugins/ folder.

Network Mode (Recommended):
1. Install LoginQueue2 (or LoginQueue2Limbo) on the login server
2. Install LoginQueue2Online on each main server (for TPS status reporting)
3. No BC/VC proxy plugins required

Full Mode (Optional):
If you need proxy-side IP limits, database logging, etc., install LoginQueue2BC or LoginQueue2VC.

Note: Unless new features are required, the BC/VC and Online companion plugins typically do not need to be updated.


Commands & Permissions
----------------------

Player Commands:
/join - Join the queue (no permission required)
/logseq help - Show help information (no permission required)

Admin Commands:
/logseq skip [player] - Skip queue (Permission: loginqueue.admin.skip)
/logseq list - View queue list (Permission: loginqueue.admin.list)
/logseq status - View server status (Permission: loginqueue.admin.status)
/logseq refresh - Manually refresh status cache (Permission: loginqueue.admin.refresh)
/logseq reload - Reload config and language files (Permission: loginqueue.admin.reload)
/logseq debug - Toggle debug mode (Permission: loginqueue.admin.debug)
/logseq info - View detailed info of all main servers (Permission: loginqueue.admin.info)

Command alias: /ls is an alias for /logseq


Other Permission Nodes
----------------------
loginqueue.admin.bypass - Bypass login server restrictions (movement, interaction, etc.)
loginqueue.vip - VIP queue priority
loginqueue.priority - Priority queue permission


Supported Languages
-------------------
Simplified Chinese (zh_CN)
Traditional Chinese (zh_TW)
English (en_US)


Requirements
------------
Java 8+ (LoginQueue2VC requires Java 17)


Build
-----
mvn clean package

After building, JAR files are automatically copied to the dist/ folder at the project root.


================================================================================


LoginQueue2 - 新一代 Minecraft 登录队列系统
============================================

提示：插件组已从 LoginSequence2 更名为 LoginQueue2。

自 1.3 版本后，单个 LoginQueue2 插件即可完成 99% 以上的功能，无需 Online/BC/VC 插件即可实现接近完美的登录队列功能。


核心功能
--------

- 智能玩家排队系统，支持 VIP 优先级和自定义排序规则
- 自动负载均衡，在多主服务器环境下选择最优服务器
- 支持 LEAST_PLAYERS、LEAST_LOAD、ROUND_ROBIN、RANDOM 四种策略
- 限制排队中的玩家移动、交互、破坏方块
- 禁用下界/末地维度和传送门
- 出生点保护（防爆、防伤害、禁 PVP）
- 性能节省模式（禁用生物生成、时间流逝、天气更替）
- UDP 直接同步：无需代理端插件，通过 UDP 获取子服务器状态
- BungeeCord/Velocity 原生通道：兼容主流代理端
- 支持多主服务器配置，自动故障转移
- 轻量级 Limbo 支持：使用 Limbo 作为登录服，资源占用极低
- 信标点击即可加入排队，操作便捷
- 内置可选认证系统（注册/登录/改密码）


插件组成
--------

- LoginQueue2 (Spigot/Paper 1.13+) - 主插件（登录服）
- LoginQueue2Limbo (Limbo) - 轻量级登录服插件
- LoginQueue2Online (Spigot/Paper 1.14+) - 子服务器状态上报（UDP）
- LoginQueue2BC (BungeeCord) - 代理端配套插件（可选）
- LoginQueue2VC (Velocity 3.x) - Velocity 代理端配套插件（可选）


部署建议
--------

单服务器模式：
仅需 LoginQueue2 主插件，放入登录服 plugins 文件夹即可。

群组服模式（推荐）：
1. 登录服安装 LoginQueue2（或 LoginQueue2Limbo）
2. 各主服务器安装 LoginQueue2Online（用于上报 TPS 等状态）
3. 无需安装 BC/VC 代理端插件

完整模式（可选）：
如需代理端 IP 限制、数据库记录等功能，再安装 LoginQueue2BC 或 LoginQueue2VC。

提示：除非新功能需要，否则通常不需要更新 BC/VC 和 Online 端插件。


指令与权限
----------

玩家指令：
/join - 加入排队队列（无权限要求）
/logseq help - 显示帮助信息（无权限要求）

管理员指令：
/logseq skip [玩家] - 跳过排队（权限: loginqueue.admin.skip）
/logseq list - 查看排队列表（权限: loginqueue.admin.list）
/logseq status - 查看服务器状态（权限: loginqueue.admin.status）
/logseq refresh - 手动刷新状态缓存（权限: loginqueue.admin.refresh）
/logseq reload - 重载配置和语言文件（权限: loginqueue.admin.reload）
/logseq debug - 切换调试模式（权限: loginqueue.admin.debug）
/logseq info - 查看所有主服务器详细信息（权限: loginqueue.admin.info）

指令别名：/ls 是 /logseq 的别名

其他权限节点
------------
loginqueue.admin.bypass - 不受登录服限制（移动、交互等）
loginqueue.vip - VIP 排队优先级
loginqueue.priority - 优先排队权限

支持语言
--------
简体中文 (zh_CN)
繁体中文 (zh_TW)
English (en_US)

依赖
----
Java 8+（Velocity 版本需要 Java 17）

构建
----
mvn clean package

构建完成后，jar 文件会自动复制到项目根目录的 dist/ 文件夹。