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
- 将
PvPIndexBattles-<version>.jar放入plugins/目录。 - 启动服务器,配置文件将自动生成。
- 停止服务器,然后在
plugins/PvPIndexBattles/config.yml中添加你的 API 密钥:
api:
api_key: "your-api-key-here"
server:
id: "my-server"
- 重新启动并运行
/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
链接
- 官网与排行榜 - pvpindex.com
- 文档 - docs.pvpindex.com
- 源码 (插件) - github.com/PVP-Index/pvpindex-battles
- 源码 (ELO 公式 / 反作弊) - github.com/PVP-Index/battle-validator
- 问题追踪 - github.com/PVP-Index/pvpindex-battles/issues
许可
你是这个资源的作者?登录后可认领此资源。
相似资源
使床在所有维度中爆炸的模组
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为 Armor Poser 模组添加兼容性
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
一个高度兼容、功能完善且稳定的 TPA 模组
AbAcc AbAcc 是一款适用于 Minecraft 服务器的管理插件,可简化玩家作弊检测与举报管理工作。工作人员可以发起并管理对可疑玩家的检查流程,并在检查完成后将其释放。
评论 0
登录后参与评分
还没有评论,来抢沙发吧