PluxMatch - 个人自用匹配插件 | 开源 | 多模式 | 多核心版本适配 | GUI | 智能分配

原创 开源 传送 PluxMatch - 个人自用匹配插件 | 开源 | 多模式 | 多核心版本适配 | GUI | 智能分配 1.5.2

完成注册/登录后下载
版权类型
原创
插件中文名称
PluxMatch
插件英文名称
PluxMatch
原帖地址
https://github.com/Reationura/PluxMatch
支持的核心(代理-服务端)
  1. Bungee
  2. WaterFall
  3. Velocity
  4. Spigot
  5. PaperSpigot
  6. Folia
  7. Purpur
  8. 其他核心
语言支持
中文(简体)
适配版本(Java)
  1. 最新版本
  2. 26.x
  3. 1.21
  4. 1.20
  5. 1.19
  6. 1.18
  7. 1.17
  8. 1.16
  9. 1.15
  10. 1.14
  11. 1.13
  12. 1.12
  13. 1.11
  14. 1.10
  15. 1.9
  16. 1.8
  17. 1.7

PluxMatch —— 使用手册​

Match 匹配插件,附属于 Plux 系列,原为个人自用插件,现开源。

本文档面向服务器管理员与玩家,介绍功能、命令与配置。关于源码编译与安装包下载,请见 README.md。
由于平台限制以及文件大小原因,无法上传BungeeCord代理端文件jar,请前往Github下载:https://github.com/Reationura/Plux-Match/releases

GtPlux Dev社区交流:1030291600 | 欢迎加入!
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 / 匹配结果转发回代理

🚀 安装​

  1. 将代理端插件放入 BungeeCord 或 Velocity 的 plugins/。
  2. 将 PluxMatch-Bukkit 放入每个后端游戏服的 plugins/。
  3. 首次启动后在 plugins/PluxMatch/ 生成配置,修改后用 /matchadmin reload 热重载。

⚙️ 配置说明​

文件作用
config.yml主配置:数据库、Redis、匹配 / ELO / 段位、排行榜、服务器、消息、安全
queues.yml队列定义与队列分组(用于 GUI)
servers.yml服务器池 / 分组
gui.ymlGUI 物品与文本
messages.yml消息文案
config.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>进入特定队列的权限
管理命令在代理端由 pluxmatch.admin 放行、在核心由 match.admin 校验,建议对管理员同时授予两者。

🪧 跨版本兼容(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 系列。

📄 许可​

本项目基于 GPL-3.0 开源。
作者
Reationura
下载
0
查看
10
首次发布
最后更新

评分

0.00 星 0 次评分
后退
顶部 底部