PvPIndex Battles

插件

· 作者 Shadow48402

PvPIndex 排行榜的官方插件

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

最新 1.1.2-bungeecord · 26.1.2 · BungeeCord / Waterfall

一键开服(送7天)

PvPIndex Battles 是一款面向 Paper、Folia、Purpur、Spigot、BungeeCord 和 Velocity 服务器的竞技 PvP 插件。它提供了一套完整的 1v1 决斗与排位匹配系统,包含按模式划分的 ELO 评级、持久化的全球排行榜、战斗回放以及管理套件——所有数据均同步至 pvpindex.com,确保玩家的排名在整个网络中保持一致。

支持的游戏模式: Crystal PvP · Sword PvP · Pot PvP · NoDebuff · Soup PvP · Axe PvP · Mace PvP · Boxing · Sumo · UHC · SMP


功能特点

  • 11 种排位游戏模式 - Crystal、Sword、Pot、NoDebuff、Soup、Axe、Mace、Boxing、Sumo、UHC、SMP - 每种模式拥有独立的 ELO 阶梯和单独的排行榜
  • 1v1 匹配队列 - 完全可配置的 54 格 GUI,支持按模式显示 ELO、倒计时以及自动传送至竞技场
  • 跨服务器决斗 - /battle challenge <player> [mode] 命令既可在单机模式下运行,也可通过 Velocity 或 BungeeCord 代理进行路由
  • 全网络 Tab 补全 - 代理会广播所有在线玩家,因此 /battle challenge <TAB> 会显示来自每个后端服务器的玩家名称
  • 战斗回放系统 - 逐帧记录,可通过 /pvpmod replay <id> 在游戏中查看
  • 竞技场池 - 支持程序生成、结构图(schematic)和世界复制三种生成策略;内置四个捆绑的结构图文件
  • 管理套件 - 玩家举报、本地封禁、联邦式全网络封禁、实时观战
  • PlaceholderAPI 集成 - 为计分板和标签页列表提供 ELO、排名、胜负、队列状态及当前模式的占位符
  • 完全可配置的消息 - 通过 messages.yml 进行配置
  • HMAC 签名载荷 - 提交前对战斗数据进行加密签名;API 会拒绝任何被篡改的数据
  • 开源 ELO 公式 - K=32 信任加权实现已发布在 GitHub 上,采用 MIT 协议:github.com/PVP-Index/battle-validator
  • 兼容 Folia - 适用于 Folia、Paper、Purpur、Spigot 和 Bukkit (1.21+)

依赖要求

依赖项 版本
Java 21+ (若使用 Paper API 26.1.x 则为 25+)
Paper / Folia / Purpur / Spigot 1.21.x 或 1.21.4+ (API 26.1.x)
Velocity 或 BungeeCord (可选) Velocity 3.x / BungeeCord 1.21+
PlaceholderAPI (可选) 2.11+
PvPIndex API 密钥 在 pvpindex.com 免费获取

安装指南

Paper / Folia / Purpur / Spigot

  1. 将 PvPIndexBattles-<version>.jar 放入 plugins/ 目录。
  2. 启动服务器,配置文件将自动生成。
  3. 停止服务器,然后在 plugins/PvPIndexBattles/config.yml 中添加你的 API 密钥:
api:
  api_key: "your-api-key-here"

server:
  id: "my-server"
  1. 重新启动并运行 /pvpindex 以确认一切加载正确。

Velocity / BungeeCord (可选)

将 PvPIndexBattles-velocity-<version>.jar 放入代理的 plugins/ 文件夹,并在 plugins/pvpindex-battles/config.properties 中使用与后端服务器相同的 API 密钥和共享密钥进行配置。

→ 完整代理设置指南:docs.pvpindex.com/server_owner/proxy-setup


命令

/battle 玩家指令

命令 描述
/battle 打开匹配模式选择 GUI
/battle challenge <player> [mode] 发送决斗挑战
/battle accept <id> 接受挑战
/battle decline <id> 拒绝挑战
/battle leave 离开队列或放弃当前战斗

/pvpindex 管理员指令

命令 权限节点 描述
/pvpindex reload pvpindex.reload 重载插件配置
/pvpindex submissions pvpindex.admin 查看待处理的战斗提交记录
/pvpindex sync pvpindex.admin 重试未提交的战斗数据
/pvpindex retryfailed pvpindex.admin 重试失败的 API 提交

/pvpmod 管理指令

命令 权限节点 描述
/pvpmod watch <player> pvpindex.mod 观战一场正在进行的战斗
/pvpmod replay <id> pvpindex.mod 播放已记录的战斗回放
/pvpmod report <player> <reason> pvpindex.mod.report 举报一名玩家
/pvpmod ban <player> <duration> <reason> pvpindex.mod.ban 禁止某玩家参与战斗
/pvpmod unban <player> pvpindex.mod.ban 解除某玩家的封禁

PlaceholderAPI

占位符 返回值
%pvpindex_elo% 总 ELO 评级
%pvpindex_elo_<mode>% 特定模式的 ELO
%pvpindex_rank% 全球阶梯排名
%pvpindex_wins% 本局胜场数
%pvpindex_losses% 本局负场数
%pvpindex_kd% 胜负比
%pvpindex_in_battle% true / false
%pvpindex_queued% true / false
%pvpindex_queued_mode% 当前队列模式或 none
%pvpindex_battle_type% 当前活跃模式的显示名称

配置

# plugins/PvPIndexBattles/config.yml
api:
  api_key: ""
  base_url: "https://api.pvpindex.com/api"

server:
  id: "my-server"
  require_signature: false   # 推荐在生产环境中设置为 true
  debug: false

arena:
  world_prefix: "pvpindex_arena"
  cleanup_delay_ticks: 100

queue:
  max_wait_seconds: 120

→ 完整参考文档:docs.pvpindex.com/server_owner/configuration


链接


许可

ELO 验证器基于 MIT 许可证发布。插件本身的许可信息请参见 LICENSE。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源