# PvPRequest 插件文档
## 概览
PvPRequest 是一个适用于 Paper 服务器（版本 1.21.5）的 Minecraft 插件，允许玩家互相发起 PvP 决斗。当挑战被接受时，双方玩家会被传送到竞技场中指定的地点，并在决斗结束后返回到他们原来的位置。
### 安装
1. 下载插件 JAR 文件 (pvprequest-1.0-SNAPSHOT.jar)
2. 将 JAR 文件放置到服务器的 plugins 目录中
3. 启动或重启您的服务器
4. 使用 /pvppos1 和 /pvppos2 命令设置竞技场位置
### 玩家命令 命令用法
/pvpreq 向另一位玩家发送 PvP 请求，例如：/pvpreq Steve
/pvpyes 接受收到的 PvP 请求，例如：/pvpyes
/pvpno 拒绝收到的 PvP 请求，例如：/pvpno
### 管理员命令 命令描述权限用法
/pvppos1 在竞技场中设置发送请求的玩家的位置 (pvprequest.admin) /pvppos2 在竞技场中设置接受请求的玩家的位置 (pvprequest.admin)
[这两个命令只能由 op 玩家编辑，设置它们是至关重要的步骤。否则，双方玩家将被传送到 (0,64,0) 的生成点进行战斗]
### 功能
请求系统：玩家可以向其他在线玩家发送 PvP 请求
接受/拒绝：接收者可以接受或拒绝收到的请求
时间限制：请求会在 60 秒后自动过期（可在 config.yml 中更改）
独立的生成位置：每个玩家都在竞技场中各自指定的地点生成
位置保留：决斗结束后，玩家将返回到他们原来的位置
决斗跟踪：跟踪当前决斗，防止多个同时进行的请求
退出处理：如果玩家在决斗期间退出，则对方将被宣布为获胜者
### 工作流程
玩家 A 使用 /pvpreq 向玩家 B 发送 PvP 请求
玩家 B 收到通知，可以选择接受 /pvpyes 或拒绝 /pvpno
如果接受，玩家 A 将被传送到位置 1，玩家 B 将被传送到位置 2
当其中一名玩家死亡后，双方都会返回到他们原来的位置
服务器广播决斗的获胜者
## 权限
pvprequest.admin - 使用 /pvppos1 和 /pvppos2 命令的必要权限
配置 插件在设置 /pvppos1 和 /pvppos2 时会自动保存两个竞技场位置。无需手动配置。 设置竞技场位置
前往您希望挑战者（请求发送者）生成的地点
使用命令 /pvppos1 设置位置 1
前往您希望对手（请求接受者）生成的地点
使用命令 /pvppos2 设置位置 2
## 故障排除
位置未设置：如果玩家收到“尚未设置 PvP 竞技场位置！”消息，则管理员需要使用 /pvppos1 和 /pvppos2 命令
权限：确保管理员拥有 pvprequest.admin 权限来设置竞技场位置
找不到玩家：发送请求时，请确保输入的是玩家的确切名称
多个请求：玩家一次只能有一个待处理的请求
## 技术说明
该插件将玩家位置存储在内存中，并在决斗结束后将玩家返回到这些位置
两个竞技场位置都存储在插件的 config.yml 文件中
待处理的请求在 60 秒后超时
该插件处理决斗期间的玩家断开连接
### 限制
目前仅支持 1v1 决斗
一次只能设置一对位置
不保留玩家物品栏或状态效果
# 未来改进
多竞技场支持,
团队决斗,
竞技场选择选项 ,
统计跟踪 ,
物品栏保留选项,