转载 开源 反作弊 防止玩家击杀 1.0.1 2026-09-12

[MD]
# 防止玩家击杀（Anti Player Kill / AntiPK）1.0.1

Anti Player Kill（简称 AntiPK）是一款适用于 Paper 与 Purpur 服务端的插件，用于防止未经授权的 PvP 与玩家击杀行为。插件提供违规判定、警告与处罚、死亡背包保护、队伍系统以及双方同意的 PvP 决斗功能。

本插件采用 GPLv3 许可证发布。

## 功能

- **战斗与攻击判定**
在可配置的时间窗口内追踪玩家攻击次数与伤害数值，准确识别未经授权的攻击行为。

- **警告与处罚系统**
违规击杀会累计警告次数，警告可随时间自动衰减。达到设定阈值后，插件可执行自定义控制台处罚命令，例如封禁、踢出或临时封禁。系统还支持针对重复违规者的处罚时长倍率。

- **死亡背包转储系统**
玩家因未经授权的 PvP 死亡时，插件会自动保存其背包快照，并清除掉落物，避免攻击者夺取战利品。管理员可通过命令查询和恢复背包转储记录。

- **队伍与群组系统**
玩家可以创建和管理队伍，用于协调队伍成员之间的互动及进行团队决斗。

- **双方同意的 PvP 与决斗**
玩家或队伍可以发起双方同意的 PvP 请求。决斗期间将完全跳过随机击杀（RDM）检测与处罚机制。

- **MiniMessage 格式支持**
所有系统消息均支持 MiniMessage 富文本格式与现代颜色代码。

## 运行要求

- **Java：** 21 或更高版本
- **服务端：** Paper / Purpur 1.20.5+

## 命令与权限

### 命令

| 命令 | 说明 | 权限 |
|---|---|---|
| `/antipk reload` | 重载插件配置。 | `antipk.reload` |
| `/antipk dump <dumps \| info \| restore> [page \| id \| confirm]` | 管理并恢复玩家背包转储记录。 | `antipk.dumps` |
| `/pvp <nickname \| confirm \| deny \| end>` | 管理双方同意的 PvP 请求与决斗。 | 所有玩家 |
| `/group <create \| invite \| accept \| exile \| leave \| delete \| info>` | 管理队伍与群组。 | 所有玩家 |

### 权限节点

| 权限节点 | 说明 | 默认值 |
|---|---|---|
| `antipk.bypass.aggression` | 允许玩家击杀其他玩家时不被标记为攻击者。 | `false` |
| `antipk.reload` | 允许使用 `/antipk reload` 重载配置。 | `op` |
| `antipk.dumps` | 允许使用 `/antipk dump` 管理背包转储记录。 | `op` |

## 默认配置

以下为默认配置中的主要部分：

```yaml
warns:
warns-is-enabled: true
warn-msg: "[!] You committed an unauthorized kill. Violation logged: [%warns%/%max_warns%]."
last-warn-msg: "<dark_red>[WARNING]</dark_red> Maximum limit reached. Any subsequent unauthorized kill will trigger an immediate punishment."
static-warn-msg: "[!] You committed an unauthorized kill of a player."
warns-msg-is-enabled: true
warn-is-dynamic: true
warn-decay-minutes: 180
warn-limit: 2

actions:
actions-is-enabled: true
punishment-command: "ban %player% %duration% %reason%"
default-reason: "Exceeded maximum RDM violation limit."
relapse-detect: true
base-punishment-duration: "24h"
repeat-multiplier: 2.0
max-duration: "30d"

combat:
ttl-seconds: 30
min-damage-threshold: 4.0
min-hits-threshold: 2
```
[/MD]