转载 工具 Vulkans PvPBot 1.1.0

[MD]
## 简介

PvPBot 是一款面向 Paper 1.21.11 的高级 Minecraft PvP 机器人插件。

# PvPBot

**PvPBot** 是一款面向 **Paper 1.21.11** 的高级 Minecraft PvP 机器人插件。

它可创建完全模拟玩家行为的机器人，用于战斗、移动、治疗、使用物品、防御、团队协作、跟随阵营领袖，并能应对风弹、重锤、TNT 矿车等 PvP 威胁。

它的目标并非让机器人只会冲向玩家并挥剑。

**而是让它们像真正的玩家一样玩 Minecraft。**

## 战斗 AI

PvPBot 机器人可以：

- 使用原版玩家攻击方式进行战斗
- 冲刺、横移、W-tap 和重置冲刺
- 执行暴击
- 智能使用盾牌
- 破坏敌人的盾牌防御
- 管理攻击冷却时间
- 智能切换攻击目标
- 集火攻击同一名玩家
- 对受到的伤害作出反应
- 保护阵营成员和领袖
- 在生命值过低时撤退
- 治疗后重新投入战斗

机器人还提供多种难度等级：

**简单 → 普通 → 困难 → 专家**

不同难度会影响机器人的反应、瞄准、移动、战斗方式和决策能力。

## 生存与治疗

机器人不会只战斗到死亡。

它们可以：

- 食用食物
- 饮用药水
- 使用喷溅型药水
- 使用力量和迅捷效果
- 使用抗火效果
- 使用龟壳大师药水
- 使用不死图腾
- 逃跑时举盾防御
- 使用末影珍珠脱离险境
- 撤退后重新集结
- 管理饥饿值和饱和度
- 在不死图腾触发后作出反应

治疗和战斗决策彼此独立，因此机器人能够判断何时应继续战斗，何时应优先保命。

## 移动系统

PvPBot 使用 Minecraft 原版玩家的移动与物理机制，而非通过传送直接移动机器人。

机器人可以：

- 冲刺
- 跳跃
- 横移
- 攀爬地形
- 绕过障碍物
- 游泳
- 应对击退
- 对风弹作出反应
- 追击目标
- 跟随路径
- 跟随阵营领袖
- 以队形行进
- 从危险情况中撤退

移动逻辑基于 Minecraft 玩家所使用的原版系统设计。

## 威胁检测

机器人能够对危险的 PvP 情况作出反应，而不是盲目持续攻击。

### 风弹

机器人可以检测来袭的风弹威胁，并采取举盾、调整站位等防御行动。

### 重锤

机器人能够识别即将到来的重击攻击，并尝试进行防御。

### TNT 矿车

机器人能够在爆炸发生前，检测附近的铁轨铺设和矿车。

视具体情况而定，机器人可能会：

- 搭建防御墙
- 摧毁矿车
- 撤退
- 举起盾牌
- 使用末影珍珠

反应速度会受到难度影响，因此低难度机器人不会立即察觉周围发生的一切。

## 阵营

你可以创建由机器人和玩家组成的队伍。

阵营系统使机器人能够：

- 识别队友
- 避免攻击友方阵营成员
- 与敌对阵营交战
- 保护阵营成员
- 跟随阵营领袖
- 在领袖受攻击时进行防御
- 在领袖撤退时重新集结
- 以队形一同行动

生成机器人时，可以直接为其分配阵营。

## 阵营领袖

你可以将真实玩家或其他机器人设为阵营领袖。

阵营成员能够自动：

- 护送领袖
- 跟随领袖
- 在领袖受攻击时保护领袖
- 在领袖撤退时重新集结
- 在领袖周围维持队形

例如，你可以创建：

**1 名玩家 + 20 个 PvP 机器人**

机器人将像该玩家的小队一样行动。

## 队形

PvPBot 支持多种队形：

- 网格
- 圆形
- 弧形
- 横线
- 纵列
- 楔形
- 方形

队形支持以下模式：

**即时**：机器人立即排列到位。

**平滑**：机器人自行行走至指定位置。

**跟随领袖**：队形跟随阵营领袖移动。

队形间距也可以自定义。

## 套装

你可以创建可重复使用的 PvP 套装，并将其发放给单个机器人或整个阵营。

支持：

- 创建套装
- 删除套装
- 向机器人发放套装
- 向整个阵营发放套装
- 按权重百分比随机分配套装

示例：

```text
5% diamond
25% archer
70% anarchy
```

权重会自动归一化，无需确保总和恰好为 100%。

## 机器人名称

PvPBot 支持普通名称，以及随机生成的“Alt 账号风格”名称。

示例：

```text
128s12uwinsok
wqyha78imcym298
92qweu18
x8u21wqz
```

随机名称会尽量避免呈现出明显的 NPC 或自动生成名称特征。

## 中立机器人

如果你只需要会在世界中游荡的机器人，可使用：

```text
/pvpbot spawnneutral
```

中立机器人不会主动战斗，但仍可作为普通的游荡机器人存在于世界中。

## 自定义设置

PvPBot 提供大量可配置的 AI 设置，包括：

- 横移
- W-tap
- 冲刺
- 暴击
- 举盾
- 攻击距离
- 横移速度
- 攻击冷却
- 目标范围
- 撤退生命值阈值
- 瞄准行为
- 反应时间
- 战斗行为
- 破盾行为
- 矿车防御
- 隐身处理
- 更多设置

所有选项均通过集中的设置系统进行管理。

## 性能

PvPBot 内置性能监控功能。

使用：

```text
/pvpbot perf
```

可查看：

- 存活机器人数量
- 机器人 Tick 耗时
- 平均 Tick 耗时
- AI 完整 Tick 与轻量 Tick 的分布
- 寻路器负载
- 延后执行的寻路操作

插件采用性能预算和不同层级的 AI 细节处理，以帮助大型机器人战斗维持可控的性能表现。

# 命令

## 机器人命令

```text
/pvpbot spawn [faction]
/pvpbot spawnrandom [faction]
/pvpbot spawnalt [faction]
/pvpbot spawnneutral [faction]
/pvpbot spawnpassive [faction]

/pvpbot masspawn <count> [faction] [grid] [spacing] [difficulty]
/pvpbot masspawnrandom <count> [faction] [grid] [spacing] [difficulty]
/pvpbot massspawnalt <count> [faction] [grid] [spacing] [difficulty]
/pvpbot massspawnneutral <count> [faction] [grid] [spacing] [difficulty]

/pvpbot remove <bot>
/pvpbot removeall
/pvpbot list

/pvpbot diff <bot> <Easy|Normal|Hard|Expert>
/pvpbot difficulty <bot> <Easy|Normal|Hard|Expert>

/pvpbot give <bot|@bot> <item> [amount]
```

批量生成支持可选阵营、网格队形、间距设置和按权重分配的难度。批量生成命令最多可一次生成 50 个机器人。

## 设置命令

```text
/pvpbot settings
/pvpbot settings <option>
/pvpbot settings <option> <value>
```

## 套装命令

```text
/pvpbot kit create <kit>
/pvpbot kit remove <kit>
/pvpbot kit give <kit> <bot>
```

## 阵营命令

```text
/pvpbot faction list
/pvpbot faction info <faction>
/pvpbot faction members <faction>

/pvpbot faction create <faction>
/pvpbot faction remove <faction>

/pvpbot faction add <faction> <player|bot>
/pvpbot faction addall <faction>
/pvpbot faction addnear <radius> <faction>

/pvpbot faction givekit <faction> <kit>
/pvpbot faction giverandomkit <faction> <weights>

/pvpbot faction leader list
/pvpbot faction leader add <player|bot> [faction]
/pvpbot faction leader remove <faction|player|bot>

/pvpbot faction formation <faction> <shape> [smooth|instant] [spacing]
/pvpbot faction group <group> formation grid [spacing]
```

阵营领袖可以是玩家或机器人。阵营队形支持平滑移动、即时定位、间距调整和跟随领袖。

## 调试与性能命令

```text
/pvpbot debug
/pvpbot perf
/pvpbot performance
/pvpbot perf reset
```

# 运行要求

| 项目 | 要求 |
| --- | --- |
| Minecraft | 1.21.11 |
| 服务端 | Paper |
| Java | 21 |

# 为 PvP 而生

PvPBot 适用于不满足于静态 NPC 的服务器。

你可以利用它构建：

- 大型 PvP 战斗
- PvP 训练场
- 战斗测试环境
- AI 对 AI 对战
- 阵营战争
- 玩家与机器人军团
- 小游戏
- 大规模 PvP 活动

**生成机器人，为它们发放套装，创建阵营，选择难度，编组队形，然后开始战斗。**
[/MD]