# 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 版本：

*更新日志不见啦*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pvprdoc.jonjs.cn/0.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.