- 版权类型
- 原创
- 插件中文名称
- PluxMatch
- 插件英文名称
- PluxMatch
- 支持的核心(代理-服务端)
- Bungee
- WaterFall
- Velocity
- Spigot
- PaperSpigot
- Folia
- Purpur
- 其他核心
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
- 1.7
PluxMatch —— 使用手册
PluxMatch 是一款面向 BungeeCord / Velocity 代理的跨服匹配插件,后端 Bukkit/Spigot/Paper 通过转发插件把命令与 GUI 交回代理处理。匹配采用「每人独立找房」的轻量模型。
特性
- 跨平台:支持 BungeeCord 与 Velocity 3.x;兼容 Bukkit 1.7 → 最新 全版本
- 匹配算法:FIFO、POPULATION(population-mode:RANDOM / LEAST / MOST)
- ELO 段位系统:动态 K 值、expand_elo 超时策略(等待越久,可接受的分段带宽越宽)、段位(青铜 → 大师)晋升事件
- 组队匹配(Party):创建 / 邀请 / 接受 / 拒绝 / 踢出 / 解散 / 组队进队列
- 服务器池管理:ping 健康检查、最大失败次数、回退服务器、按组分配房间
- 多后端存储:MySQL / SQLite / MongoDB
- Redis 跨代理同步:多代理共享队列与玩家数据
- Chest GUI:匹配主菜单与房间列表,跨版本材质 / Title 自动降级
- 排行榜 / 个人统计 / 对局历史
- PlaceholderAPI 变量支持
- 配置热重载 /matchadmin reload
组件构成
| 组件 | 部署位置 | 作用 |
|---|---|---|
| PluxMatch 代理端 | BungeeCord 或 Velocity 的 plugins/ | 匹配核心与命令处理(二选一) |
| PluxMatch-Bukkit | 每个后端游戏服的 plugins/ | 把命令 / GUI / 匹配结果转发回代理 |
安装
- 将代理端插件放入 BungeeCord 或 Velocity 的 plugins/。
- 将 PluxMatch-Bukkit 放入每个后端游戏服的 plugins/。
- 首次启动后在 plugins/PluxMatch/ 生成配置,修改后用 /matchadmin reload 热重载。
配置说明
| 文件 | 作用 |
|---|---|
| config.yml | 主配置:数据库、Redis、匹配 / ELO / 段位、排行榜、服务器、消息、安全 |
| queues.yml | 队列定义与队列分组(用于 GUI) |
| servers.yml | 服务器池 / 分组 |
| gui.yml | GUI 物品与文本 |
| messages.yml | 消息文案 |
代码:
database:
type: sqlite # sqlite | mysql | mongodb
matchmaking:
default-algorithm: FIFO
elo:
initial: 1000
k-factor: 32
timeout-strategy: expand_elo # 等待越久,ELO 分段带宽越宽
elo-band:
initial: 100
max: 500
per-second: 25
redis:
enabled: false # 多代理同步时开启
tiers: # 段位(按 ELO 阈值映射展示名,含颜色代码)
bronze: { min-elo: 0, display: "&c青铜" }
# ... silver / gold / platinum / diamond / master
server:
ping-interval: 5
max-failures: 3
fallback-server: lobby
queues.yml 片段:
queues:
solo-bedwars:
name: "单人起床战争"
enabled: true
group: bedwars
min-players: 2
max-players: 16
team-size: 1
algorithm: POPULATION
population-mode: RANDOM
allow-party: false
server-group: bedwars
queue-groups:
bedwars:
name: "起床战争"
queues: [solo-bedwars, team-bedwars, vip-bedwars]
命令
玩家命令 /match(别名 pm / pp / matchmaking)| 命令 | 说明 |
|---|---|
| /match | 查看帮助 |
| /match gui <组名> | 打开指定组的匹配 GUI |
| /match join <队列> | 加入匹配队列 |
| /match leave | 退出队列 |
| /match status | 查看匹配状态 |
| /match party create|invite|accept|deny|kick|disband|list|join | 组队操作 |
| /match history | 查看对局记录 |
| /match stats | 查看个人统计 |
| /match leaderboard [winrate] | 查看排行榜 |
管理员命令 /matchadmin(别名 pma / matchadm)
| 命令 | 说明 |
|---|---|
| /matchadmin reload | 重载配置 |
| /matchadmin queue create|delete|enable|disable|list <名称> | 队列管理 |
| /matchadmin add <玩家> <队列> | 强制加入队列 |
| /matchadmin remove <玩家> | 强制移出队列 |
| /matchadmin server add <服务器> <组名> | remove <服务器> | list | 服务器池管理 |
| /matchadmin forcestart <队列> | 强制触发匹配 |
| /matchadmin stats <玩家> | 查看指定玩家统计 |
权限节点
| 节点 | 说明 |
|---|---|
| pluxmatch.admin | 代理端管理命令的门控权限 |
| match.admin | 核心逻辑校验的管理权限(默认 op) |
| match.queue.<队列ID> | 进入特定队列的权限 |
跨版本兼容(1.7 → 最新)
- 物品材质:1.13+ 使用扁平化材质名(LIME_WOOL 等);1.7–1.12 自动回退旧材质名 + 数据(WOOL / INK_SACK / STAINED_GLASS_PANE)。
- Title:≥1.14 用五参重载,≥1.8 用两参,1.7 无 Title API 时降级为聊天消息。
- 代理端:老构建缺少 createTitle / ACTION_BAR 时,Title 退化为普通消息、ActionBar 静默跳过。
- Velocity:仅支持 3.x 系列。