⚔ PvP+
适用于 Paper 1.21.11+ 的功能齐全的 PvP 插件 —— 包含决斗、小队、竞技场、套装、匹配和观战功能。专为希望获得开箱即用且无冗余代码的竞技服务器而构建。
✨ 功能概览
| 系统 |
功能说明 |
| ? 竞技场 (Arenas) |
管理员定义长方体竞技场,支持完整的方块快照与恢复 |
| ? 竞技场再生 (Arena Regeneration) |
每次战斗结束后自动修复竞技场 |
| ? 套装 (Kits) |
从背包中捕获精确到 NBT 数据的套装,支持图标和默认回合数设置 |
| ? 小队 (Parties) |
完整的小队系统,支持聊天、邀请以及小队对小队决斗 |
| ⚔ 决斗 (Duels) |
1v1 挑战,可通过 GUI 配置套装、竞技场和回合数 |
| ? 队列 (Queue) |
基于套装的匹配机制 —— 加入队列并自动进行匹配 |
| ? 观战 (Spectating) |
在竞技场范围内观看实时战斗 |
| ? 计分板 (Scoreboards) |
每场战斗中显示实时的回合/分数侧边栏 |
| ? 战斗摘要 (Fight Summary) |
战斗结束后的聊天回顾,包含击杀数、分数和胜者 |
? 竞技场系统
管理员通过在游戏中的位置行走来定义竞技场,完全不需要输入坐标。
/arena create <name> 开始设置
/arena setpos1 设置角点 1(站在该位置)
/arena setpos2 设置角点 2(站在该位置)
/arena addspawn1 添加队伍 1 的出生点
/arena addspawn2 添加队伍 2 的出生点
/arena save 捕捉方块并保存
/arena restore <name> 手动恢复竞技场方块
/arena delete <name> 删除一个竞技场
/arena list 列出所有竞技场及其状态
每个竞技场在创建时都会保存完整的方块快照。当战斗结束时,所有方块——包括门的方向、台阶类型和楼梯朝向等方块状态——都会恢复到原来的样子。竞技场数据会在重启后持久保留。
? 套装系统
套装会捕获你的整个背包内容。这意味着潜影盒内容、包裹内容、附魔以及自定义物品数据都会被完整保留。
/kit create <name> 创建一个新的空套装
/kit save <name> 将当前背包快照保存到套装中
/kit load <name> 应用套装到你的背包以预览效果
/kit icon <name> 将你手持的物品设置为套装的 GUI 图标
/kit rounds <name> <n> 设置该套装的默认回合数
/kit delete <name> 删除一个套装
/kit list 列出所有套装
/kit config <name> (可扩展)打开套装配置界面
套装以 .kit 文件格式存储在 plugins/pvp-plus/kits/admin/ 和 kits/player/ 目录下。
⚔ 决斗系统
向任何玩家发起可配置的决斗挑战。决斗会通过 GUI 配置界面 进行,挑战者可以选择:
- 套装 (Kit) —— 带有图标的套装浏览器
- 回合数 (Rounds) —— 左右键调整(默认为套装的设置)
- 竞技场 (Arena) —— 竞技场浏览
/duel <player> 打开针对该玩家的决斗配置 GUI
/duel accept 接受待处理的决斗请求
/duel deny 拒绝待处理的决斗请求
/duel toggle 切换是否接收决斗请求
请求会在 30 秒 后自动过期。
? 小队系统
完整的小队支持,包含队长控制、小队聊天等功能。
/party create 创建新小队(你将成为队长)
/party invite <player> 邀请一名玩家
/party accept 接受小队邀请
/party deny 拒绝小队邀请
/party kick <player> 踢出成员(仅限队长)
/party leave 离开小队
/party disband 解散小队(仅限队长)
/party list 显示所有成员及其在线状态
/party chat 切换自己的小队聊天模式
小队战斗
/party duel <leader> 挑战另一个小队 —— 打开配置 GUI
/party duel accept 接受来自其他小队的小队决斗挑战
/party duel deny 拒绝小队决斗挑战
/party split 将小队随机分为两个队伍 —— 打开配置 GUI
/party ffa 每位成员单独作战 —— 打开配置 GUI
Split(分队) 会将小队随机划分为两个人数均等的队伍。FFA(自由混战) 则让每位成员成为独立的队伍 —— 最后存活者获胜。
? 队列系统
基于套装的匹配机制。玩家为特定套装加入队列,当另一名玩家加入同一队列时,系统将自动进行匹配。
/queue 打开队列 GUI
队列 GUI 显示所有可用的套装,并包含以下信息:
- 玩家数量显示为物品堆叠大小
- 若有人已在等待,物品会显示附魔光泽
- 物品描述中显示实时队列大小
? 战斗系统
每场战斗——无论是决斗、小队决斗、分队、FFA 还是队列匹配——都使用相同的引擎:
流程
- 双方队伍被传送至竞技场中的出生点
- 播放 3 秒倒计时 作为标题提示 —— 玩家处于冻结状态
- 当显示 FIGHT! 时,玩家解除冻结并开始战斗
- 玩家死亡后,进入该回合的观战模式
- 当一支队伍的所有成员被淘汰后,宣布回合胜者
- 所有回合结束后,宣布最终胜者并显示完整摘要
回合制
战斗采用 三局两胜 制 —— 先赢得多数回合的队伍获得最终胜利。回合分数显示在实时侧边栏计分板上。
投降
/leavefight 放弃当前战斗或退出观战模式
投降会立即将你移出战斗,通知所有参与者,如果你是你方队伍的最后一人,则对方队伍直接获胜。
? 观战
/spectate <玩家> 观战某玩家的当前战斗
/leavefight 停止观战
spectator(旁观者)会被放置于竞技场内的旁观者模式。移动被限制在竞技场范围内——旁观者无法飞出战斗区域。实时计分板也会向旁观者显示。
? 要求
| 要求 |
版本 |
| 服务器 |
Paper |
| Minecraft 版本 |
1.21.1 |
| Java |
21+ |
⚙ 设置系统
管理员可以在游戏内配置插件,无需编辑文件。所有设置都会持久化保存到 config.yml 中。
/pvpsettings 列出所有设置及其当前值
/pvpsettings <setting> <value> 更改某项设置
自动补全功能根据设置类型提供上下文感知建议:
- 位置(Location) 设置会建议
here(捕获你当前位置)和 clear(清除设置)
- 布尔值(Boolean) 设置会建议
true 和 false
可用设置
| 设置项 |
类型 |
描述 |
hub_location |
location |
战斗结束、放弃或离开旁观模式后,玩家将被传送到的位置 |
Hub Location
/pvpsettings hub_location here 将枢纽设置为你当前位置
/pvpsettings hub_location clear 清除设置 — 玩家将回落到竞技场角落上方
? 计划中 / 进行中
- 数据统计追踪(每位玩家的击杀数、胜场数、K/D)
- 战斗历史日志
- 排行榜
- 玩家套装创建
- 套装配置(每个套装的自定义选项)
- 按套装队列的排名匹配
- 基于 ELO 的队列匹配
- 套装编辑器
- 用于展示排名的自定义网站
? 许可证
MIT — 可免费使用、修改和分发。
⚔ PvP+
A fully featured PvP plugin for Paper 1.21.11+ - duels, parties, arenas, kits, matchmaking, and spectating. Built for competitive servers that want a complete out-of-the-box pvp plugin without bloat.
✨ Features at a Glance
| System |
What it does |
| 🏟 Arenas |
Admin-defined cuboid arenas with full block snapshot & restore |
| 🔄 Arena Regeneration |
Regenerates the Arena after every fight |
| 🎒 Kits |
NBT-accurate kit capture from inventory, with icons and round defaults |
| 👥 Parties |
Full party system with chat, invites, and party-vs-party duels |
| ⚔ Duels |
1v1 challenges with configurable kit, arena, and round count via GUI |
| 🎯 Queue |
Kit-based matchmaking — join a queue and get matched automatically |
| 👁 Spectating |
Watch live fights from inside the arena bounds |
| 📊 Scoreboards |
Live round/score sidebar during every fight |
| 📋 Fight Summary |
Post-fight chat recap with kills, score, and winner |
🏟 Arena System
Admins define arenas by walking to positions in-world with ABSOLUTELY NO coordinate typing required.
/arena create <name> Start setup
/arena setpos1 Set corner 1 (stand at position)
/arena setpos2 Set corner 2 (stand at position)
/arena addspawn1 Add a Team 1 spawn point
/arena addspawn2 Add a Team 2 spawn point
/arena save Capture blocks and save
/arena restore <name> Manually restore arena blocks
/arena delete <name> Delete an arena
/arena list List all arenas and their status
Every arena saves a full block snapshot on creation. When a fight ends, every block — including block states like door orientation, slab type, and stair facing: is restored exactly as it was. Arenas persist across restarts.
🎒 Kit System
Kits capture your entire inventory. This means shulker box contents, bundle contents, enchantments, and custom item data are all preserved.
/kit create <name> Create a new empty kit
/kit save <name> Snapshot your current inventory into the kit
/kit load <name> Apply a kit to your inventory to preview it
/kit icon <name> Set the kit's GUI icon to your held item
/kit rounds <name> <n> Set the default number of rounds for this kit
/kit delete <name> Delete a kit
/kit list List all kits
/kit config <name> (Extensible) Open kit configuration
Kits are stored in plugins/pvp-plus/kits/admin/ and kits/player/ as .kit files.
⚔ Duel System
Challenge any player to a configurable duel. Duels go through a GUI configuration screen where the challenger picks:
- Kit — kit browser with icons
- Rounds — left/right click to adjust (defaults to kit's setting)
- Arena — arena browse
/duel <player> Open duel config GUI targeting that player
/duel accept Accept a pending duel request
/duel deny Deny a pending duel request
/duel toggle Toggle whether you receive duel requests
Requests expire after 30 seconds automatically.
👥 Party System
Full party support with leader controls, party chat, and more.
/party create Create a new party (you become leader)
/party invite <player> Invite a player
/party accept Accept a party invite
/party deny Deny a party invite
/party kick <player> Kick a member (leader only)
/party leave Leave the party
/party disband Disband the party (leader only)
/party list Show all members and their online status
/party chat Toggle party chat mode for yourself
Party Combat
/party duel <leader> Challenge another party — opens config GUI
/party duel accept Accept an incoming party duel challenge
/party duel deny Deny a party duel challenge
/party split Split party into two random teams — opens config GUI
/party ffa Every member fights solo — opens config GUI
Split randomly divides the party into two even teams. FFA makes every member their own team - last one standing wins.
🎯 Queue System
Kit-based matchmaking. Players join a queue for a specific kit and are automatically matched when another player joins the same queue.
/queue Open the queue GUI
The Queue GUI shows all available kits with:
- Player count as the item stack size
- Enchanted glow when someone is already waiting
- Live queue size in the item lore
🎮 Fight System
Every fight — whether a duel, party duel, split, FFA, or queue match — goes through the same engine:
Flow
- Both teams are teleported to their spawn points in the arena
- A 3-second countdown plays as a title — players are frozen
- On FIGHT!, players are unfrozen and combat begins
- On death, the player enters spectator mode for that round
- When all members of a team are eliminated, the round winner is announced
- After all rounds, the fight winner is announced with a full summary
Rounds
Fights use a best-of system - the first team to win the majority of rounds wins the fight. Round scores are displayed on a live sidebar scoreboard.
Forfeit
/leavefight Forfeit the current fight or leave spectator mode
Forfeiting removes you from the fight immediately, notifies all participants, and if you were the last member of your team the other team wins.
👁 Spectating
/spectate <player> Spectate a player's current fight
/leavefight Stop spectating
Spectators are placed in Spectator mode inside the arena. Movement is bounded to the arena box — spectators cannot fly outside the fight area. The live scoreboard is shown to spectators as well.
🔧 Requirements
| Requirement |
Version |
| Server |
Paper |
| Minecraft version |
1.21.1 |
| Java |
21+ |
⚙ Settings System
Admins can configure the plugin in-game without editing files. All settings are persisted to config.yml.
/pvpsettings List all settings and their current values
/pvpsettings <setting> <value> Change a setting
Autocomplete is context-aware per setting type:
- Location settings suggest
here (captures your current position) and clear (unsets)
- Boolean settings suggest
true and false
Available Settings
| Setting |
Type |
Description |
hub_location |
location |
Where players are sent after a fight, forfeit, or leaving spectator mode |
Hub Location
/pvpsettings hub_location here Set hub to your current position
/pvpsettings hub_location clear Unset — players fall back to above the arena corner
🚧 Planned / In Progress
- Statistics tracking (kills, wins, K/D per player)
- Fight history logs
- Leaderboards
- Player kit creation
- Kit configuration (custom options per kit)
- Per-kit queue ranked matching
- ELO based queue
- Kiteditor
- Custom site to show rankings
📄 License
MIT — free to use, modify, and distribute.
评论 0
登录后参与评分
还没有评论,来抢沙发吧