PvpArena 多模式竞技场插件
插件介绍
PvpArena 是一款基于 LSE QuickJS 开发的 Minecraft 基岩版多人竞技插件，提供完整的竞技场创建、PVP 对战、观战、战绩统计和经济下注系统。插件支持多个独立竞技场同时运行，每个竞技场可自定义比赛区域、双方出生点、观战位置、比赛模式和装备规则。插件内置多种竞技玩法，包括默认 PVP 模式、弓箭模式、空手模式以及特色足球击退模式。玩家比赛开始前，插件会自动备份完整玩家数据，包括背包、装备栏、副手、附魔物品、潜影盒内部物品、当前位置和个人重生点，比赛结束后自动恢复，避免因竞技导致物品丢失。
默认模式支持自由装备战斗；弓箭模式支持自定义高等级弓箭附魔，可突破原版附魔等级限制；空手模式限制玩家使用武器、防具辅助物品，进行纯操作竞技；足球模式采用特殊击退玩法，玩家使用自定义击退弓进行对抗，不会死亡，通过将敌方玩家击入指定球门区域判定胜利。足球模式支持自定义红蓝双方球门区域，通过 A、B 两个坐标点自动生成检测范围。
插件支持 BO1、BO3、BO5 多局比赛模式，根据双方胜负局数自动判定最终胜者，并支持记分板 money 和 LLmoney 两种经济系统，可用于比赛下注、奖励和竞技排名。
PvpArena 具备完善的比赛保护机制，包括比赛中禁止逃离竞技场、异常退出判负、观战区域限制、装备防复制、NBT 数据恢复、离线玩家恢复等功能，适用于 PVP 服务器、小游戏服务器、公会竞技、赛事活动等场景。
指令、菜单与配置说明
玩家指令
/pvp
打开 PvpArena 玩家主菜单。包含：
- 发起竞技邀请
- 查看竞技场大厅
- 进入比赛观战
- 查看玩家战绩
- 战绩炫耀
- 管理员入口（管理员权限）
/pvpcancel
取消当前正在进行的区域坐标采集。/pvprestore
打开玩家数据恢复菜单。用于异常情况下恢复比赛前备份数据。
管理员指令
/pvpadmin
打开管理员管理菜单。包含：
- 创建竞技场
- 编辑竞技场
- 删除竞技场
- 设置竞技场参数
- 设置比赛模式
- 设置比赛装备
- 玩家数据恢复
- 查看竞技状态
竞技场配置
每个竞技场支持以下配置：基础设置
- 竞技场名称
- 比赛区域范围
- 比赛模式
- 默认模式
- 弓箭模式
- 空手模式
- 足球模式
传送点设置
每个竞技场独立设置：- 红队出生点
- 蓝队出生点
- 观战传送点
红蓝双方分别传送至对应出生点。
观战玩家：
进入观战点并切换旁观状态。
足球模式配置
足球模式额外支持：- 红队球门 A 点
- 红队球门 B 点
- 蓝队球门 A 点
- 蓝队球门 B 点
其他模式：
球门参数保存为：
<span>null</span>
不会参与足球判定。
模式装备配置
管理员可以针对不同模式设置比赛装备。支持：
主手物品
示例：<span>minecraft:bow</span>
附魔设置
支持填写：- 附魔 ID
- 附魔等级
<span>附魔ID:</span><br><span>20</span><br><br><span>等级:</span><br><span>20</span>
表示：
<span>Punch（冲击）20级</span>
弹药设置
例如：<span>minecraft:arrow</span>
可设置：
- 弹药类型
- 弹药数量
- 锁定位置
副手设置
例如：<span>minecraft:air</span>
表示禁止使用副手。
经济配置
支持：记分板经济
默认：<span>money</span>
LLmoney
管理员可以自由选择比赛下注经济类型。数据保护
比赛开始自动保存：- 玩家背包
- 装备
- 副手
- 附魔数据
- 潜影盒内容
- 位置
- 重生点
支持：
- 玩家中途退出
- 玩家掉线
- 服务器异常
## 常用示例
足球模式冲击 20 弓：
```text
主手物品 ID：minecraft:bow
附魔数字 ID：20
附魔等级：20
```
其中 `20` 是 **Punch（冲击）** 的数字 ID。
## 稳定数字 ID 对照表
| 数字ID | 英文名称 | 中文名称 | 原版最高等级 |
|---:|---|---|---:|
| 0 | `protection` | 保护 | 4 |
| 1 | `fire_protection` | 火焰保护 | 4 |
| 2 | `feather_falling` | 摔落保护 | 4 |
| 3 | `blast_protection` | 爆炸保护 | 4 |
| 4 | `projectile_protection` | 弹射物保护 | 4 |
| 5 | `thorns` | 荆棘 | 3 |
| 6 | `respiration` | 水下呼吸 | 3 |
| 7 | `depth_strider` | 深海探索者 | 3 |
| 8 | `aqua_affinity` | 水下速掘 | 1 |
| 9 | `sharpness` | 锋利 | 5 |
| 10 | `smite` | 亡灵杀手 | 5 |
| 11 | `bane_of_arthropods` | 节肢杀手 | 5 |
| 12 | `knockback` | 击退 | 2 |
| 13 | `fire_aspect` | 火焰附加 | 2 |
| 14 | `looting` | 抢夺 | 3 |
| 15 | `efficiency` | 效率 | 5 |
| 16 | `silk_touch` | 精准采集 | 1 |
| 17 | `unbreaking` | 耐久 | 3 |
| 18 | `fortune` | 时运 | 3 |
| 19 | `power` | 力量 | 5 |
| 20 | `punch` | 冲击 | 2 |
| 21 | `flame` | 火矢 | 1 |
| 22 | `infinity` | 无限 | 1 |
| 23 | `luck_of_the_sea` | 海之眷顾 | 3 |
| 24 | `lure` | 饵钓 | 3 |
| 25 | `frost_walker` | 冰霜行者 | 2 |
| 26 | `mending` | 经验修补 | 1 |
| 27 | `binding` | 绑定诅咒 | 1 |
| 28 | `vanishing` | 消失诅咒 | 1 |
| 29 | `impaling` | 穿刺 | 5 |
| 30 | `riptide` | 激流 | 3 |
| 31 | `loyalty` | 忠诚 | 3 |
| 32 | `channeling` | 引雷 | 1 |
| 33 | `multishot` | 多重箭 | 1 |
| 34 | `piercing` | 穿透 | 4 |
| 35 | `quick_charge` | 快速装填 | 3 |
| 36 | `soul_speed` | 灵魂疾行 | 3 |
| 37 | `swift_sneak` | 迅捷潜行 | 3 |
## 新版附魔名称
当前官方 `/enchant` 文档还列出了以下名称：
| 英文名称 | 中文名称 | 原版最高等级 | 数字 ID |
|---|---|---:|---|
| `wind_burst` | 风爆 | 3 | 官方当前页面未给出 |
| `density` | 致密 | 5 | 官方当前页面未给出 |
| `breach` | 破甲 | 4 | 官方当前页面未给出 |
| `lunge` | 突进 | 3 | 官方当前页面未给出 |
