> For the complete documentation index, see [llms.txt](https://pvprdoc.jonjs.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pvprdoc.jonjs.cn/0.md).

# 0 - 插件基本信息

## (1) 简介

插件由 Jonjs 开发。   [\[个人博客\]](https://jonjs.cn/)     [\[MCBBS 个人空间\]](https://www.mcbbs.net/home.php?mod=space\&uid=1569082)

插件部分功能和代码借鉴于 [@Valorin](https://www.mcbbs.net/home.php?mod=space\&uid=1367288) 的开源项目。

PVPRewards (2.0版本) 相比于一代，有更加稳定的系统，一些奇妙的BUG\~\~(特性)\~\~已被修复！

PVPRewards (下面简称PVPR) 插件相比于同类插件具有以下出众的功能：

1. 积分商城 (支持翻页、预览物品、限制条件)
2. 排行榜 (支持PlaceholderAPI变量)
3. 段位 (支持PlaceholderAPI变量)
4. 防刷分机制 (可开关)
5. 多样信息提示 (可自定义发送普通消息、ActionBar、Title、关闭)
6. 全息排行榜 (支持HolographicDisplays与TrHologram插件)

## (2) 帖子、文档链接

MCBBS：<https://www.mcbbs.net/thread-810285-1-1.html>

使用教程视频：<https://www.bilibili.com/video/BV1Cq4y1Q77E>

赞助：[\[爱发电\]](https://afdian.net/@Jonjs2333)     [\[微信收款码\]](https://jonmirror-chengdu-1252307665.cos.ap-chengdu.myqcloud.com/pay_wechat.png)     [\[支付宝收款码\]](https://jonmirror-chengdu-1252307665.cos.ap-chengdu.myqcloud.com/pay_alipay.png)

~~文档英文版：English Version Doc: 暂未完成~~

## (3) 运行环境要求

{% hint style="info" %}
此小节的信息均以 PVPRewards 插件**最新版本**为准

适配Minecraft版本仅标注前两个版本号，例如1.19，这表示1.19.X的版本均可用！
{% endhint %}

Java 版本：`>= 8     (MC-1.17及以上请使用Java16、17)`

支持的服务端、MC版本列表：

<table data-header-hidden><thead><tr><th width="187">服务端核心</th><th>支持?</th><th>适配Minecraft版本</th><th>备注</th></tr></thead><tbody><tr><td>服务端核心</td><td>支持?</td><td>适配Minecraft版本</td><td>备注</td></tr><tr><td>Spigot / Paper</td><td>✔️</td><td>1.8~1.20</td><td>2.4.2版本适配更多全息插件</td></tr><tr><td>Purpur</td><td>✔️</td><td>1.8~1.20</td><td>2.4.2版本适配更多全息插件</td></tr><tr><td>CatServer</td><td>✔️</td><td>1.12.2</td><td></td></tr><tr><td>Mohist</td><td>❔</td><td><em>暂未测试</em></td><td></td></tr><tr><td>Arclight</td><td>✔️</td><td>1.16.5、1.18.2</td><td></td></tr><tr><td>LoliServer</td><td>✔️</td><td>1.16.5</td><td></td></tr><tr><td>Folia</td><td>❌</td><td>-</td><td>预计2.5版本适配</td></tr></tbody></table>

## (4) 前置插件

### 可选

* PlaceholderAPI (`>=2.10.10`)   [\[SpigotMC\]](https://www.spigotmc.org/resources/placeholderapi.6245/)
* 全息图插件 **(任选其一)**：
  * HolographicDisplays (`>=2.4.9`)   [\[DevBukkit\]](https://dev.bukkit.org/projects/holographic-displays/files)   [\[MCBBS 转载帖\]](https://www.mcbbs.net/thread-377628-1-1.html)
  * TrHologram (`>=2.0`)   [\[MCBBS\]](https://www.mcbbs.net/thread-923397-1-1.html)

## (5) 版本历史

| 插件版本            | 适配MC版本      | 发布时间      | 本体文件大小 |
| --------------- | ----------- | --------- | ------ |
| **2.4.1**       | 1.8\~1.20.1 | 2023/5/6  | 120 KB |
| **2.4**         | 1.8\~1.19.4 | 2023/5/2  | 120 KB |
| **2.3.1**       | 1.8\~1.19.4 | 2023/4/29 | 115 KB |
| **2.3**         | 1.8\~1.19.4 | 2022/12/7 | 106 KB |
| **2.2**         | 1.8\~1.17   | 2021/8/23 | 103 KB |
| **2.1**         | 1.8\~1.17   | 2021/8/17 | 100 KB |
| **2.0**         | 1.8\~1.17   | 2021/8/15 | 83 KB  |
| **1.2** (2个子版本) | 1.7\~1.13   | 2018/8/4  | 17 KB  |
| **1.1** (2个子版本) | 1.7\~1.13   | 2018/7/30 | 8 KB   |
| **1.0** (2个子版本) | 1.7\~1.13   | 2018/7/30 | <8 KB  |

## (6) 开发历史、更新日志

### 开发历史

2018/7/30：PVPRewards v1.0、v1.1 发布 (v1.0特性过多，发布仅几个小时后被v1.1所替代)

2018/7/31：PVPRewards 支持 1.13 版本了

2018/8/4：PVPRewards v1.2 发布

2019\~2021/8/10：因学业任务繁重暂停更新

2021/8/11：开始重写 PVPRewards 代码

2021/8/13：PVPRewards 2 开发即将完成...

2021/8/15：剪视频、做图片好累好累！！终于完成了。PVPRewards 2 发布

……

2023/5/6：更新2.4.1版本

### 更新日志

#### v2.4.1

2023/5/6 —— MC-1.8\~1.19.4

* \[修复] 修复玩家死亡判定方面的BUG

#### v2.4

2023/5/2 —— MC-1.8\~1.19.4

* \[修复] 防刷分功能冷却时间修改后生效了!
* \[新增] 可设置PVP经验值每日获取上限 (见[页面16](/16.md))
* \[变更] 可设置击杀重复玩家所获经验递减 (见[页面14](/14.md))
* \[新增] 积分、经验数据转换 (见[页面1](/1.md))
* \[新增] 可配置的击杀判定 (见[页面18](/18.md))

#### v2.3.1

2023/4/29 —— MC-1.8\~1.19.4

* \[新增] 远程武器击杀判定 (普通箭、弩箭、药水箭、特殊箭、雪球、药水、三叉戟等)
* \[移除] 无需JonAPI插件作为前置了! 插件本体已内置JonAPI内容

#### v2.3

2022/12/7 —— MC-1.8\~1.19 —— JonAPI (`1.1`版本及以上)

* \[修复] 修复/pvpr reload无法使用的问题，解决某些报错问题
* \[变更] OP不再受PVP切换的冷却时间限制了

#### v2.2

2021/8/23 —— MC-1.8\~1.17 —— JonAPI (`1.1`版本及以上)

* \[新增] PVP状态切换
* \[修复] 修复一些BUG，解决报错问题

####

#### v2.1

2021/8/17 —— MC-1.8\~1.17 —— JonAPI (`1.1`版本及以上)

* \[新增] PVP积分、PVP经验值的MySQL支持
* \[新增] 积分、经验值数据 YAML-MySQL 互转
* \[新增] 每日积分上限 (可设为任意整数、无限)
* \[新增] 死亡扣除积分、经验值 (可设置为任意整数)
* \[新增] 重复击杀一个玩家，获得的积分值可以递减了 (另见：[2 - 配置文件](/2.md#pei-zhi-wen-jian-nei-rong))
* \[变更]config.yml 有 1 个项变更 (需要您重新配置该项，不需要修改配置文件中的所有项)

#### v2.0

2021/8/15 —— MC-1.8\~1.17 —— JonAPI (`1.0-c2` 版本及以上)

* 完全重写代码
* 适配 1.8\~1.17
* 优化防刷分
* 优化信息格式，自定义程度提高
* 重写积分商城架构，修复上古BUG
* 加入“商品快捷编辑器”，在聊天框就可以编辑、查看物品信息了
* 新增PVP经验值系统、段位系统、排行榜、排行榜全息图支持
* 新增一些PAPI变量

#### 1.0\~1.2 版本：

*更新日志不见啦*