L-Bedwars Proxy

插件

· 作者 squezsaz

支持代理的插件,兼容 L-Bedwars!

0 本站下载 0 关注 更新于 2 个月前

最新 2.0.1 · 26.2 · Bukkit / Folia

一键开服(送7天)

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

安装方法

  1. 将 L-BedWarsProxy.jar 放入你的代理/大厅服务器的 plugins/ 文件夹中
  2. 重启服务器以生成默认配置文件
  3. 编辑 config.yml:
    • 将 socket-token 设置为一个安全的随机字符串
    • 配置 bind-address 和 socket-port(需与游戏服务器配置一致)
    • 在游戏服务器 IP 列表中添加至 allowed-ips(留空则允许所有连接)
  • 配置 database 部分以支持 MySQL(用于统计数据和排行榜功能)
  1. 在每个游戏服务器上,设置 proxy-mode: true、proxy-socket-address: <代理IP>:<端口>,以及匹配的 socket-token
  2. 重启代理服务器,然后重启游戏服务器

验证连接

  • 游戏服务器控制台:[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 — 队列优先级(可配置节点名称)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源