L-BedWarsProxy
L-BedWars 的多服务器代理插件 —— 竞技场状态追踪、玩家路由、队列系统、排行榜全息图以及跨服务器观战。
运行于 Paper/Spigot 1.19+(非 BungeeCord 插件),通过 TCP 套接字与游戏服务器通信,并使用经过 HMAC 认证的 JSON 协议。利用 BungeeCord 插件通道实现跨服务器玩家移动。
功能特性
竞技场状态追踪
- 通过来自游戏服务器的 TCP 套接字连接实时监控竞技场状态
- 采用 HMAC-SHA256 签名的 JSON 协议,支持可配置的认证令牌
- 支持 CIDR 的 IP 白名单以保障连接安全
- 每个 IP 的连接限制,最大连接数可配置
- 健康检查超时系统 —— 自动将无响应的服务器标记为离线
- 协议版本握手,确保向前和向后兼容
玩家路由 (/bw join <mode>)
- 智能竞技场选择算法:优先选择人数较多的 WAITING(等待中)大厅,若不可用则回退至 STARTING(进行中)大厅
- 小队感知加入 —— 如果玩家是小队队长,所有队员将被同时发送至同一服务器
- 重新加入支持 (
/bw rejoin) —— 记录玩家上次所在的服务器以便重连
/bw stats [player] —— 查看存储在 MySQL 中的跨服务器统计数据
队列系统
- 当某模式没有可用竞技场时,可选开启自动排队
- 优先级权限用于插队访问(可配置的权限节点)
- 当竞技场空出一个位置时自动连接
- 向玩家显示队列位置
管理员命令 (/bwa)
- GUI —— 分页显示的竞技场概览,使用状态颜色的羊毛物品;点击即可加入
- 传送/观战 ——
/bwa tp <player> —— 通过 BungeeCord Forward 通道进行跨服务器观战
- 排行榜 —— 分页 GUI,显示玩家头像,按任意统计列排序
- 全息图管理 ——
/bwa hologram set/remove/list —— 在游戏中放置排行榜全息图
全息图排行榜
- 基于 ArmorStand 的全息图展示任意统计的前 N 名玩家
- 可配置行数与更新间隔
- 持久化存储至
holograms.yml
- 支持每种统计对应多个全息图
- 根据定时器自动从 MySQL 数据库更新
MySQL 统计数据库
- HikariCP 连接池,提供高性能的 MySQL 访问
- 与游戏服务器共享
player_stats 表(前缀可配置)
- 统计项:击杀、死亡、最终击杀、最终死亡、胜利、失败、破坏床局数、游戏场次
- 支持按任意统计列查询排行榜
- 若在配置文件中省略 database 部分,则优雅地禁用此功能
PlaceholderAPI 扩展
%lbedwars_kills%, %lbedwars_deaths%, %lbedwars_wins%, %lbedwars_losses%
%lbedwars_final_kills%, %lbedwars_final_deaths%
%lbedwars_beds_broken%, %lbedwars_games_played%
%lbedwars_level%, %lbedwars_xp%, %lbedwars_kdr%
%lbedwars_arena_online%(所有服务器上的总在线玩家数)
%lbedwars_arena_count%(在线竞技场服务器总数)
小队集成
- 对 Parties API (alessiodp/parties) 的软依赖
- 小队队长的
/bw join 会将所有成员发送至同一游戏服务器
- 未安装 Parties 插件时优雅降级
Folia 支持
- 基于反射的 Folia 检测
- 双调度器(Folia 区域化 / Bukkit)处理所有定时任务
plugin.yml 中包含 folia-supported: true
命令
玩家命令
| 命令 |
描述 |
/bw join <solo/duo/trio/quad> |
加入某种模式(自动选择最佳竞技场,满员则排队) |
/bw rejoin |
重新连接到上一场游戏的服务器 |
/bw stats [player] |
查看存储在 MySQL 中的统计数据 |
管理员命令
| 命令 |
权限 |
描述 |
/bwa gui [all/solo/duo/trio/quad] |
lbedwarsproxy.admin |
打开竞技场状态 GUI |
/bwa tp <player> |
lbedwarsproxy.admin |
跨服务器观战 |
/bwa leaderboard [stat] |
lbedwarsproxy.admin |
打开排行榜 GUI |
/bwa hologram set <stat> |
lbedwarsproxy.admin |
放置排行榜全息图 |
/bwa hologram remove [id] |
lbedwarsproxy.admin |
移除一个全息图 |
/bwa hologram list |
lbedwarsproxy.admin |
列出所有全息图 |
队列占位符
| 占位符 |
描述 |
%lbedwars_arena_online% |
所有竞技场的在线玩家总数 |
%lbedwars_arena_count% |
在线竞技场服务器数量 |
配置 (config.yml)
language: en
socket-port: 5000
bind-address: 127.0.0.1
socket-token: "change-me"
allowed-ips:
- "127.0.0.1"
max-connections: 50
database:
host: "localhost"
port: 3306
database: "lbedwars"
username: "root"
password: ""
table-prefix: ""
pool-size: 5
health-check:
enabled: true
timeout-seconds: 15
queue:
enabled: false
priority-permissions:
- "lbedwarsproxy.queue.priority"
holograms:
leaderboard:
enabled: false
lines: 10
update-interval: 60
配置节说明
| 节 |
描述 |
language |
代理消息的语言 (en 或 tr) |
socket-port |
游戏服务器连接的 TCP 端口 |
bind-address |
套接字绑定地址 (0.0.0.0 表示所有接口) |
socket-token |
用于 HMAC 认证的共享密钥 |
allowed-ips |
CIDR 白名单(为空 = 允许所有) |
max-connections |
最大并发套接字连接数 |
database |
MySQL 连接设置(省略以禁用) |
health-check |
无响应服务器的超时检测 |
queue |
可选的队列系统设置 |
holograms.leaderboard |
排行榜全息图刷新设置 |
断开连接
- 通过套接字超时检测到客户端断开
TimeOutTask 在超过 timeout-seconds 秒无更新后将服务器标记为离线
- 断开连接时递减每个 IP 的连接计数器
安装指南
前置条件
- Paper/Spigot 1.19+ 服务器(可以是专用的代理/大厅服务器)
- MySQL 数据库(可选,统计数据和排行榜必需)
- 每个游戏服务器上安装 L-BedWars 插件并启用
proxy-mode: true
安装方法
- 将
L-BedWarsProxy.jar 放入你的代理/大厅服务器的 plugins/ 文件夹中
- 重启服务器以生成默认配置文件
- 编辑
config.yml:
- 将
socket-token 设置为一个安全的随机字符串
- 配置
bind-address 和 socket-port(需与游戏服务器配置一致)
- 在游戏服务器 IP 列表中添加至
allowed-ips(留空则允许所有连接)
- 配置
database 部分以支持 MySQL(用于统计数据和排行榜功能)
- 在每个游戏服务器上,设置
proxy-mode: true、proxy-socket-address: <代理IP>:<端口>,以及匹配的 socket-token
- 重启代理服务器,然后重启游戏服务器
验证连接
- 游戏服务器控制台:
[L-BedWars] Socket connection established to proxy
- 代理控制台:
[L-BedWarsProxy] Server <name> connected!
/bwa gui 应显示已连接的竞技场
依赖项
| 依赖项 |
类型 |
是否必需 |
| Paper/Spigot 1.19+ |
服务端 |
是 |
| PlaceholderAPI |
插件 |
否(占位符不可用) |
| Parties (alessiodp) |
插件 |
否(队伍功能已禁用) |
文件
| 文件 |
用途 |
config.yml |
主插件配置 |
holograms.yml |
持久化的全息数据(自动生成) |
languages/messages_en.yml |
英文语言文件 |
languages/messages_tr.yml |
土耳其语语言文件 |
权限
| 权限 |
默认值 |
描述 |
lbedwarsproxy.play |
true |
允许通过 /bw 加入竞技场 |
lbedwarsproxy.admin |
op |
允许通过 /bwa 使用管理命令 |
lbedwarsproxy.queue.priority |
— |
队列优先级(可配置节点名称) |
L-BedWarsProxy
Multi-server proxy plugin for L-BedWars — arena status tracking, player routing, queue system, leaderboard holograms, and cross-server spectate.
Runs on Paper/Spigot 1.19+ (not a BungeeCord plugin) and communicates with game servers via TCP socket with HMAC-authenticated JSON protocol. Uses BungeeCord plugin channels for cross-server player movement.
Features
Arena Status Tracking
- Real-time arena state monitoring via TCP socket connections from game servers
- HMAC-SHA256 signed JSON protocol with configurable authentication token
- IP whitelist with CIDR support for connection security
- Per-IP connection limits with configurable max connections
- Health-check timeout system — automatically marks stale servers as offline
- Protocol version handshake for forward/backward compatibility
Player Routing (/bw join <mode>)
- Smart arena selection algorithm: prefers WAITING lobbies with more players, falls back to STARTING lobbies
- Party-aware join — if player is party leader, all party members are sent to the same server simultaneously
- Rejoin support (
/bw rejoin) — remembers player's last server for reconnection
/bw stats [player] — view MySQL-stored stats across all servers
Queue System
- Optional auto-queue when no arena is available for a mode
- Priority permissions for skip-the-line access (configurable permission nodes)
- Automatic connection when an arena slot opens
- Queue position display for players
Admin Commands (/bwa)
- GUI — Paginated arena overview with status-colored wool items; click to join
- Teleport/Spectate —
/bwa tp <player> — cross-server spectate via BungeeCord Forward channel
- Leaderboard — Paginated GUI with player heads, sorted by any stat column
- Hologram management —
/bwa hologram set/remove/list — in-game leaderboard hologram placement
Hologram Leaderboard
- ArmorStand-based holograms display top N players for any stat
- Configurable line count and update interval
- Persists to
holograms.yml
- Multiple holograms per stat supported
- Automatically updates from MySQL database on a timer
MySQL Stats Database
- HikariCP connection pool for high-performance MySQL access
- Shared
player_stats table with game servers (configurable prefix)
- Stats: kills, deaths, final kills, final deaths, wins, losses, beds broken, games played
- Leaderboard queries for any stat column
- Gracefully disabled when database section is omitted from config
PlaceholderAPI Expansion
%lbedwars_kills%, %lbedwars_deaths%, %lbedwars_wins%, %lbedwars_losses%
%lbedwars_final_kills%, %lbedwars_final_deaths%
%lbedwars_beds_broken%, %lbedwars_games_played%
%lbedwars_level%, %lbedwars_xp%, %lbedwars_kdr%
%lbedwars_arena_online% (total players across all servers)
%lbedwars_arena_count% (total online arena servers)
Party Integration
- Soft dependency on Parties API (alessiodp/parties)
- Party leader's
/bw join sends all members to the same game server
- Graceful fallback when Parties plugin is not installed
Folia Support
- Reflection-based Folia detection
- Dual scheduler (Folia regionized / Bukkit) for all timed tasks
folia-supported: true in plugin.yml
Commands
Player Commands
| Command |
Description |
/bw join <solo/duo/trio/quad> |
Join a mode (auto-selects best arena, queues if full) |
/bw rejoin |
Reconnect to last game server |
/bw stats [player] |
View MySQL-stored stats |
Admin Commands
| Command |
Permission |
Description |
/bwa gui [all/solo/duo/trio/quad] |
lbedwarsproxy.admin |
Open arena status GUI |
/bwa tp <player> |
lbedwarsproxy.admin |
Cross-server spectate |
/bwa leaderboard [stat] |
lbedwarsproxy.admin |
Open leaderboard GUI |
/bwa hologram set <stat> |
lbedwarsproxy.admin |
Place leaderboard hologram |
/bwa hologram remove [id] |
lbedwarsproxy.admin |
Remove a hologram |
/bwa hologram list |
lbedwarsproxy.admin |
List all holograms |
Queue Placeholders
| Placeholder |
Description |
%lbedwars_arena_online% |
Total online players across all arenas |
%lbedwars_arena_count% |
Number of online arena servers |
Configuration (config.yml)
language: en
socket-port: 5000
bind-address: 127.0.0.1
socket-token: "change-me"
allowed-ips:
- "127.0.0.1"
max-connections: 50
database:
host: "localhost"
port: 3306
database: "lbedwars"
username: "root"
password: ""
table-prefix: ""
pool-size: 5
health-check:
enabled: true
timeout-seconds: 15
queue:
enabled: false
priority-permissions:
- "lbedwarsproxy.queue.priority"
holograms:
leaderboard:
enabled: false
lines: 10
update-interval: 60
Configuration Sections
| Section |
Description |
language |
Language for proxy messages (en or tr) |
socket-port |
TCP port for game server connections |
bind-address |
Socket bind address (0.0.0.0 for all interfaces) |
socket-token |
Shared secret for HMAC authentication |
allowed-ips |
CIDR whitelist (empty = allow all) |
max-connections |
Maximum concurrent socket connections |
database |
MySQL connection settings (omit to disable) |
health-check |
Timeout detection for stale servers |
queue |
Optional queue system settings |
holograms.leaderboard |
Leaderboard hologram refresh settings |
Disconnect
- Client disconnect detected via socket timeout
TimeOutTask marks server offline after timeout-seconds of no updates
- Per-IP connection counter decremented on disconnect
Setup
Prerequisites
- Paper/Spigot 1.19+ server (can be a dedicated proxy/lobby server)
- MySQL database (optional, required for stats/leaderboard)
- L-BedWars plugin on each game server with
proxy-mode: true
Installation
- Place
L-BedWarsProxy.jar in your proxy/lobby server's plugins/ folder
- Restart the server to generate default config
- Edit
config.yml:
- Set
socket-token to a secure random string
- Configure
bind-address and socket-port (match game server config)
- Add game server IPs to
allowed-ips (or leave empty to allow all)
- Configure
database section for MySQL (stats/leaderboard)
- On each game server, set
proxy-mode: true, proxy-socket-address: <proxy-ip>:<port>, and matching socket-token
- Restart proxy server, then game servers
Verifying Connection
- Game server console:
[L-BedWars] Socket connection established to proxy
- Proxy console:
[L-BedWarsProxy] Server <name> connected!
/bwa gui should show the connected arena
Dependencies
| Dependency |
Type |
Required |
| Paper/Spigot 1.19+ |
Server |
Yes |
| PlaceholderAPI |
Plugin |
No (placeholders unavailable) |
| Parties (alessiodp) |
Plugin |
No (party features disabled) |
Files
| File |
Purpose |
config.yml |
Main plugin configuration |
holograms.yml |
Persisted hologram data (auto-generated) |
languages/messages_en.yml |
English language file |
languages/messages_tr.yml |
Turkish language file |
Permissions
| Permission |
Default |
Description |
lbedwarsproxy.play |
true |
Allows joining arenas via /bw |
lbedwarsproxy.admin |
op |
Allows admin commands via /bwa |
lbedwarsproxy.queue.priority |
— |
Queue priority (configurable node name) |
评论 0
登录后参与评分
还没有评论,来抢沙发吧