PvPBot
PvPBot 为 Paper 1.21.11 添加了 PvP 机器人,它们的行为方式与真实玩家一致。
大多数“PvP 机器人”只是轨道上的 NPC:它们冲向最近的玩家,挥击,并以相同的方式死亡。PvPBot 的机器人则与众不同。每个机器人都是一个完整的玩家实体,拥有原版物理行走效果,使用原版攻击冷却时间,并通过与现实客户端相同的代码路径使用物品。它们会侧移和暴击,举起盾牌,用斧头破坏你的盾牌,受伤时进食,被逼入绝境时使用末影珍珠传送,在缺口处搭桥,从空中坠落时使用坠击(Mace),并像真正的战队一样跟随队长。
你可以生成一个来练习,或者生成数百个来打一场战争。
目标不是制造一个只会战斗的机器人。目标是制造一个会“玩”游戏的机器人。
⚡ 快速开始
/pvpbot kit create diamond # 将当前背包保存为装备包
/pvpbot masspawn 20 diamond red # 生成 20 个机器人,穿着该装备包,所属阵营为 "red"
/pvpbot massspawn 20 diamond blue
/pvpbot faction red attack blue # 派遣 red 阵营攻击 blue 阵营
/pvpbot faction red formation wedge # 或者先让它们排成楔形阵
/pvpbot set red difficulty expert # 随时更改在线机器人的难度
/pvpbot removeall
这就是完整流程:生成、装备包、阵营、难度、战斗。
⚔️ 战斗
机器人使用真实的原版攻击和真实的攻击冷却时间进行战斗。没有任何作弊或瞬移。
- 身法: 冲刺、侧移、环形侧移、W-tapping、S-tapping、兔跳移动
- 进攻: 暴击、跳跃重置、命中选择、P-crit(利用距离优势进行的暴击)以及距离控制(保持既能打到你而你又打不到它的距离)
- 防御: 盾牌格挡,以及用斧头破坏敌方盾牌
- 武器: 剑、斧、坠击、长矛、三叉戟、弓和弩,根据情况切换
- 目标选择: 优先攻击威胁最近的目标,但权重会根据敌人的受伤程度、护甲状况以及有多少友军已经集火该目标而调整
- 集火: 小队共同选择目标,并保护被攻击的成员
- 脱离战斗: 机器人受伤后会撤退治疗,然后重新投入战斗
- 模式: 敌对、中立、仅协助,或静止的训练假人
难度
四个等级,简单 → 普通 → 困难 → 专家。难度会影响机器人的转头速度、瞄准精度、反应时机、失误频率、攻击距离以及使用的技巧。
可以在一条命令中混合设置。50%easy,35%normal,15%expert 会为每个生成的机器人随机分配一个难度。
? 坠击、鞘翅与长矛
较新的武器拥有专门的行为逻辑,而不是被当作剑来处理。
- 坠击猛击: 可以从高处平台、风弹、末影珍珠抓取点或带有烟花加速的全速鞘翅俯冲中发起。当机器人坠落砸向人群时,它会重新锁定正下方的目标。
- 破甲与属性切换: 在剑和坠击之间切换,以及对盾牌使用“斧头接坠击”连招。
- 长矛突进: 用于迅速拉近差距。
- 鞘翅长矛冲锋: 当距离目标 16 个方块以上且视线直线畅通时,机器人可能会起飞,用烟花加速,伸出长矛贯穿目标,并刺穿身后排成一列的所有人。随后它会滑翔下降并着陆。
❤️ 生存
机器人默认不会死战到底。它们会照顾自己。
- 吃食物和金苹果,喝治疗药水,投掷喷溅药水
- 在有益时会获得力量、速度、抗性火焰和缓降等增益效果
- 当生命值低时将不死图腾放入副手,并在图腾激活后执行恢复程序
- 逃跑时保持盾牌举起
- 使用末影珍珠和风弹逃脱
- 挣脱蜘蛛网
- 攀爬、垫脚或挖掘逃出坑洞,即使头顶有重力方块
- 从携带的潜影盒中补充不死图腾、珍珠、风弹、经验瓶和金苹果
治疗与战斗是分开决定的,因此机器人可以判断是继续战斗更重要还是存活更重要。
? 威胁感知
机器人能察觉危险情况并做出响应。
- ** incoming 坠击猛击:** 举起盾牌,弓箭手会对空中的坠击使用者射出一支减速箭
- TNT 矿车 PvP: 附近铺设铁轨会触发反应,根据具体情况,机器人会建造墙壁、破坏矿车、逃跑、举起盾牌或使用珍珠传送离开
- 击退: 以客户端应有的方式承受击退,包括利用风弹发射
反应时间遵循难度设定,因此简单难度的机器人不会在事件发生的瞬间知晓一切。
? 移动与寻路
机器人通过游戏自身的玩家物理引擎进行移动。
- A 寻路:* 在共享地形缓存上运行,搜索过程在主线程之外进行
- 实时重规划。 机器人在行走时刷新路线,迟到的搜索结果会被无缝拼接而不中断其行动,开阔地面会直接走直线而不进行搜索
- 搭桥、垫高、跑酷式跳跃、攀爬、游泳、开门
- 致命边缘感知: 机器人拒绝踏出致命落差的边缘,并避开岩浆和火焰
- 人群路由: 机器人会在彼此之间绕行
- 学习地形: 舰队反复卡住的位置会被记住,重启后依然有效
- 挖掘逃生: 当没有路径时才会挖掘,但前提是绕行失败
? 阵营、小组与队长
- 同一阵营的机器人永远不会互相攻击,并会保卫自己的成员
- 同盟允许不同阵营站在同一边
- 队长可以是真实玩家或其他机器人。小队会护送、跟随并保护其队长,当队长撤退时重新集结
- 小组将一个阵营拆分为多个小队,每个小队都有自己的队长
- 指挥官机器人会走到你面前点头示意,然后执行打击任务
faction <a> attack <b> 派遣一个阵营攻击另一个阵营,moveto 则让一个阵营行军到指定位置,散开并绕过障碍物
stopattack 让一个阵营停止攻击,以便进行队形排列和截图
1 名玩家 + 20 个 PvP 机器人 的运行方式正如你所期望的那样。
? 阵型
19 种阵型:网格、圆形、弧形、直线、纵列、楔形、正方形、菱形、三角形、十字、交叉、星形、螺旋、梯队、双线、V 形、盾墙、散兵线和先锋。
- 即时: 机器人立即放置到位
- 平滑: 机器人步行至指定位置
- 跟随领袖: 阵型随阵营领袖移动
- 间距可调节
- 插槽会根据实际地形进行适配,因此阵型会挤入走廊,而不是卡在墙壁内部
- 当任何成员受到攻击时,阵型会自动解散
? 传送门波次、猎杀与珍珠棒
三种带有演出效果的将机器人投入战斗的方式。
传送门波次会在你周围打开一圈浮动的下界传送门,机器人依次从中走出。
/pvpbot portals random 10 50 red 0.5s kit diamond r100 h8
猎杀是针对其他目标的类似操作。每个走出的机器人都会直接追击该目标。
/pvpbot hunt Steve 8 40 diamond red
珍珠棒为你提供一根普通的钓鱼竿。抛出并收回:终界珍珠会从天空掉落并在浮标周围落地,每颗珍珠落地的地方都会出现一个携带装备的机器人。
/pvpbot pearlrod 25 red diamond
⛏️ 职业与指令
机器人不仅能战斗。
- 采矿: 基于路径的针对特定方块类型的隧道挖掘,或对区域进行共享挖掘;如果携带 TNT,则进行爆破拆除
- 农业: 收割和重新种植地块,检查箱子
- 运输: 从领袖处携带潜影盒到指定坐标
- 建造: 覆盖式的三格宽路径和桥梁、群体上方的屋顶,以及末地岛屿之间的岛屿桥
- 守卫哨位: 占据某个位置,或守护领袖
- 巡逻路线: 手动放置的路径点,可步行或疾跑通过
- 傀儡练习: 机器人召唤铁傀儡,搭建高台并与之战斗
?️ 语音命令
用声音指挥你的军队。阵营领袖可以使用 PvPBot Voice Link 客户端模组配合 Simple Voice Chat 大声下达指令。
“所有人,杀掉 Steve。” “红队,向前推进。” “找掩体。” “挖到我这里来。”
工作原理
- 领袖安装 Voice Link Fabric 模组,需依赖 Fabric API 和 Simple Voice Chat。
- 他们运行一次
/voicelink setup。这会下载一个离线英语语音模型(小模型约 40 MB,最大模型约 2.3 GB)。使用 /voicelink model small|medium|large|gigaspeech 可在不同模型间切换。
- 在服务器上,将其设为阵营领袖:
/pvpbot faction leader add <player> <faction>。
- 他们说话。指令仅送达他们所领导的阵营中的机器人。其他人会被忽略。
隐私: 语音识别在玩家自己的计算机上运行,音频数据永远不会离开本地计算机。只有看起来像机器人指令的句子才会发送到服务器,且以文本形式发送。
你在对谁说话
句首可以指定听话者,或者直接以命令开头。
| 称呼对象 |
示例 |
| 所有人 |
everyone, guys, team, squad, boys, troops |
| 某个阵营 |
red team attack blue, blue, push forward |
| 单个机器人 |
Andy come here, Nexar Void follow me |
| 指挥官 |
commander kill Steve, red commander come here |
名字不需要完全符合发音规则。NexarVo1d 会被识别为 "nexar void",Steve123 为 "steve",Pinapple 为 "pineapple",且听错的名字会与当前在线的玩家和机器人进行模糊匹配。
你可以说什么
| 类别 |
示例短语 |
| 攻击 |
kill Steve, focus Steve, take out Steve, all on Steve, Steve is our target, don't let Steve escape, kill him (注视的目标), kill the closest guy, red team attack blue |
| 冲锋 |
push them, rush them, go get them |
| 停火 |
hold your fire, stop fighting, cease fire, calm down, stand down |
| 自由开火 |
weapons free, fight back, engage |
| 重组 |
come to me, get over here, regroup, stay together, rally |
| 跟随 |
follow me, stay with me, stick with me |
| 前进 |
push forward, move up, move out, let's go, go go go |
| 坚守 |
stay here, stay put, hold your position, don't move |
| 警戒 |
watch out, behind you, they're coming, get ready, heads up |
| 阵型 |
get behind me, form up, fall in,随后是 break formation 或 at ease |
| 散开 |
scatter, spread out, split up, run for your lives |
| 看我 |
look at me, eyes on me (机器人会清理你周围 10 格半径的区域,部分人搭建高台,所有人注视你) |
| 找掩体 |
take cover, take shelter, build a roof, hide (队伍会在自身上方建造屋顶,外围的机器人会冲刺进入) |
| 搭高至 |
pillar up to Steve, tower up to Steve, get to Steve |
| 射箭 |
bow Steve, shoot Steve, snipe Steve (持弓的机器人保持距离,其余近战) |
| 采矿 |
mine the area, dig here, excavate (你注视的区域,自上而下) |
| 向下挖至 |
mine down to Steve, dig down to me, tunnel to Steve |
| 摧毁 |
destroy the area, blow it up, level the area (如果携带 TNT 则使用,否则使用工具) |
| 挖掘隧道 |
tunnel this way, dig a tunnel (每个机器人在你面对的方向挖掘各自的隧道) |
| 向上搭建 |
build up, pillar up, get up high (每个机器人在各自的柱子上搭建) |
| 路径 |
make a path there, build a bridge there (通往你注视方块的有顶桥梁) |
| 岛屿桥 |
bridge to the next island (末地) |
| 盔甲 |
gear up, armor off, put your best armor on, put your worst armor on |
| 停止工作 |
stop mining, stop digging, stop building |
每条新指令都会替换上一条:机器人会放弃当前正在做的事情并开始执行新任务。盔甲、“看我”和“自由开火”是例外,因为它们会叠加在当前运行的状态之上。
一些额外的细节:
- 像 “stop” 或 “wait” 这样的单个单词需要一个地址(例如 “everyone stop”),以免正常的聊天触发它们。
- 指令之间有一个短暂的冷却时间,以防止误听的闲聊造成刷屏。
- 服务器管理员可以在
config.yml 中开启 voice-feedback: true,以便在测试时在动作栏显示机器人听到的内容。
- 从任何不应能使用它的人身上撤销
pvpbot.voice 权限。
? Kits
将你的物品栏、盔甲和副手保存为一个可重复使用的 kit,然后交给机器人、阵营或自己。
/pvpbot kit create diamond
/pvpbot kit give diamond Steve
/pvpbot faction givekit red diamond
随机 kits 使用经过归一化处理的权重,因此它们不必加起来等于 100:
/pvpbot faction giverandomkit red 5%diamond,25%archer,70%anarchy
? Names, Skins and Bot Types
- Clean names for normal play
- Random "alt-account" names (
x8u21wqz, 128s12uwinsok) that don't look generated
- Void names with a black skin
- Real skins can be pulled from accounts listed in the config
- Neutral bots wander and don't fight, frozen bots are training dummies that still take damage and knockback
- Quiet spawning: bots from portals, hunts and the Pearl Rod arrive without a join message each
⚙️ Customization
About 70 AI settings cover strafing, tapping, sprinting, crits, shielding, reach, aim speed, reaction time, flee and re-engage health, leash distance, mace and elytra behavior, pathfinding, restocking, pearling, team targeting and more.
/pvpbot settings opens a GUI that edits the defaults for future bots
/pvpbot set <bot|faction|all|global> <setting> <value> changes live bots, one, a whole faction, or everyone
? Performance
Built to keep big fights playable.
- Pathfinding runs on background threads with a per-tick budget
- Terrain is snapshotted once and shared by every bot instead of read separately
- Quiet bots out of everyone's sight think less often, and fighting bots always get full attention
- Bots keep only a few chunks loaded and don't affect mob spawning
- A hardware profile lowers the limits automatically on small servers
/pvpbot performance reports tick time, the full/light AI split, pathfinder load and terrain cache hit rate
Bots survive restarts with their faction, settings, guard posts and patrol routes.
Commands
Everything is /pvpbot ... and needs pvpbot.admin (op by default). Tab completion covers all of it.
Spawning
/pvpbot spawn [kit] [faction] [difficulty]
/pvpbot spawnrandom | spawnvoid | spawnneutral | spawnfrozen (same arguments)
/pvpbot massspawn <count> [kit] [faction] [difficulty] (up to 50)
/pvpbot masspawnrandom | masspawnvoid | masspawnneutral | masspawnfrozen | masspawngrid
/pvpbot remove <bot>
/pvpbot removeall
/pvpbot list
Use none to skip the kit or faction slot.
Waves
/pvpbot portals <random|normal|void> <portals> <bots> [faction] [delay] [kit <name>] [r<radius>] [h<height>]
/pvpbot portals stop | close
/pvpbot hunt <target> <portals> <bots> [kit] [faction]
/pvpbot pearlrod <bots> [faction] [kit]
Kits, Settings and Difficulty
/pvpbot kit create <kit> | remove <kit> | give <kit> [bot|player]
/pvpbot give <bot|@bot> <item> [amount]
/pvpbot difficulty <bot> <Easy|Normal|Hard|Expert>
/pvpbot settings
/pvpbot set <bot|faction|all|global> <setting> <value>
Factions
/pvpbot faction list | info <faction> | create <faction> | remove <faction>
/pvpbot faction add <faction> <player|bot> | addall <faction> | addnear <radius> <faction>
/pvpbot faction leader add <player|bot> [faction] | remove <faction|player|bot> | list
/pvpbot faction commander <faction> <bot|clear>
/pvpbot faction givekit <faction|player> <kit>
/pvpbot faction giverandomkit <faction|player> <weights>
/pvpbot faction formation <faction> <shape> [smooth|instant|leader] [spacing]
/pvpbot faction <faction> moveto <x> <y> <z>
/pvpbot faction <faction> attack <faction|off>
/pvpbot faction alliance create|add|remove|delete|list
/pvpbot faction stopattack <faction> <true|false>
/pvpbot faction armor <on|off|best|worst> <faction>
/pvpbot group create <faction> <group> <amount> | disband | list | info | <group> leader add|remove
Orders and Jobs
/pvpbot attack <target|off> <bot>
/pvpbot guard <bot> [radius|here|leader|off]
/pvpbot path create <name> | point create | walk <bot|all|faction> [sprint] | stop | list
/pvpbot mine <bot> <block> <x1 y1 z1> <x2 y2 z2> <seconds>
/pvpbot faction minearea <faction> [radius] [seconds]
/pvpbot farm <bot> <x1 y1 z1> <x2 y2 z2> [seconds]
/pvpbot deliver <bot> <x> <y> <z>
/pvpbot checkchest <bot> <x> <y> <z>
/pvpbot golem <bot> fight | stop
Diagnostics
/pvpbot debug [bot] [watch [seconds]]
/pvpbot performance [on|off|reset]
Permissions
| permission |
default |
|
pvpbot.admin |
op |
all /pvpbot commands |
pvpbot.voice |
everyone |
voice orders (they still only work for faction leaders) |
Requirements
- Minecraft: 1.21.11
- Server: Paper
- Java: 21
- Optional: Simple Voice Chat, so bots join voice chat and voice orders work
- Optional: the PvPBot Voice Link Fabric mod on each leader's client, for voice commands
Good to Know
- Bots are players with a stub connection. If an anticheat or packet plugin kicks them, exempt them; PvPBot blocks outside kicks and tells you once in the log.
- Portal waves build obsidian frames in the world.
/pvpbot portals close removes them.
- Mining, tunnelling and building orders change blocks. Use them somewhere you can undo.
- This is a PvP and testing tool, not something to leave running unattended on a survival world.
Built For PvP
Use it for:
- ⚔️ 大规模 PvP 战斗与阵营战争
- ?️ 训练竞技场、瞄准练习与破盾演练
- ? 战斗与反作弊测试
- ? AI 对战 AI
- ?️ 玩家及其专属机器人小队
- ?️ 通过语音指挥军队
- ? 活动、预告片与压力测试
生成它们。为它们配备装备。将它们分成阵营。选择难度。列队完毕,从空中投放,并下达指令。然后开始战斗。
PvPBot
PvPBot adds PvP bots to Paper 1.21.11 that play Minecraft the way real players do.
Most "PvP bots" are NPCs on rails: they run at the nearest player, swing, and die the same way every time. PvPBot bots are different. Each one is a full player entity that walks with vanilla physics, attacks with vanilla cooldowns and uses items through the same code paths a real client does. They strafe and crit, raise shields, break your shield with an axe, eat when they are hurt, pearl away when they are cornered, bridge over gaps, fall out of the sky with a mace, and follow a leader like a real squad.
You can spawn one to practice against, or a few hundred to fight a war.
The goal isn't a bot that fights. The goal is a bot that plays.
⚡ Quick Start
/pvpbot kit create diamond # save your current inventory as a kit
/pvpbot masspawn 20 diamond red # 20 bots, wearing it, in faction "red"
/pvpbot masspawn 20 diamond blue
/pvpbot faction red attack blue # send red at blue
/pvpbot faction red formation wedge # or line them up first
/pvpbot set red difficulty expert # change live bots at any time
/pvpbot removeall
That is the whole loop: spawn, kit, faction, difficulty, fight.
⚔️ Combat
Bots fight with real vanilla attacks and real attack cooldowns. Nothing is faked and nothing teleports.
- Footwork: sprinting, strafing, circle-strafing, W-tapping, S-tapping, bunny-hop movement
- Offense: critical hits, jump resets, hit selection, P-crit, and outspacing (holding the distance where they can hit and you cannot)
- Defense: shield blocking, plus axe hits to break enemy shields
- Weapons: swords, axes, maces, spears, tridents, bows and crossbows, switched by the situation
- Target choice: closest threat, but weighted by how hurt the enemy is, how well armored it is, and how many allies are already on it
- Focus fire: a squad picks targets together and defends whoever is hit
- Disengage: bots retreat when hurt, heal, then come back into the fight
- Modes: hostile, neutral, assist-only, or a frozen training dummy
Difficulty
Four levels, Easy → Normal → Hard → Expert. Difficulty changes how fast a bot turns its head, how well it aims, how soon it reacts, how often it misses, what reach it has and which techniques it uses at all.
Mix them in one command. 50%easy,35%normal,15%expert rolls a difficulty for every bot spawned.
? Maces, Elytras and Spears
The newer weapons get proper behavior instead of being treated as swords.
- Mace smashes launched from a ledge, from a Wind Charge, from an Ender Pearl grapple, or from a full elytra dive with fireworks. A bot falling onto a crowd re-targets whoever is directly underneath it.
- Breach and attribute swaps between sword and mace, and axe-then-mace combos against shields.
- Spear lunges to close a gap in a hurry.
- Elytra spear charge. From 16 or more blocks away, with a clear straight line to the target, a bot may take off, boost with fireworks, hold its spear out and drive through the target, piercing anyone lined up behind it. Then it glides down and lands.
❤️ Survival
Bots don't fight to the death by default. They look after themselves.
- Eat food and golden apples, drink healing potions, throw splash potions
- Buff with Strength, Speed, Fire Resistance, and Turtle Master when it helps
- Swap totems into the offhand when health is low, and run a recovery routine after a pop
- Keep a shield raised while fleeing
- Escape with Ender Pearls and Wind Charges
- Cut themselves out of cobwebs
- Climb, pillar or dig their way out of a hole, even when there is a gravity block overhead
- Restock totems, pearls, Wind Charges, XP bottles and golden apples from a shulker box they carry
Healing and fighting are decided separately, so a bot can tell when staying in the fight matters more than staying alive.
? Threat Awareness
Bots notice dangerous situations and respond to them.
- Incoming mace smash: shield up, and an archer will shoot a slow-falling arrow at an airborne mace user
- TNT minecart PvP: a rail placed nearby sets off a reaction, and depending on the situation a bot builds a wall, breaks the cart, runs, raises its shield, or pearls away
- Knockback is ridden out the way a client would, including Wind Charge launches
Reaction time follows the difficulty, so an Easy bot doesn't know everything the instant it happens.
? Movement and Pathfinding
Bots move through the game's own player physics.
- A* pathfinding on a shared terrain cache, searched off the main thread
- Live re-planning. Routes are refreshed while the bot walks, a late answer is spliced in without stopping it, and open ground gets a straight line with no search at all
- Bridging, pillaring, parkour-style jumps, climbing, swimming, doors
- Lethal-edge awareness: bots refuse to step off a deadly drop, and avoid lava and fire
- Crowd routing: bots path around each other
- Learned terrain: places the fleet keeps getting stuck are remembered, across restarts
- Digging out when no route exists, but only after going around has failed
? Factions, Groups and Leaders
- Bots in a faction never hit each other, and they defend their own
- Alliances let factions share a side
- Leaders can be a real player or another bot. The squad escorts, follows and protects its leader, and regroups when the leader retreats
- Groups split a faction into squads, each with its own leader
- A commander bot walks up to you, nods, and then carries out a strike
faction <a> attack <b> sends one faction at another, and moveto marches one to a spot, spread out and pathing around obstacles
stopattack stands a faction down for lineups and screenshots
1 player + 20 PvP bots works the way you'd hope it would.
? Formations
19 shapes: grid, circle, arc, line, column, wedge, square, diamond, triangle, cross, saltire, star, spiral, echelon, double line, chevron, shield wall, skirmish and vanguard.
- Instant: bots are placed immediately
- Smooth: bots walk into position
- Leader follow: the formation travels with the faction leader
- Spacing is adjustable
- Slots are fitted to the real terrain, so a formation squeezes into a corridor instead of standing inside the walls
- A formation breaks automatically when any member is attacked
? Portal Waves, Hunts and the Pearl Rod
Three ways to bring bots into a fight with some theater.
Portal waves open a ring of floating nether portals around you, and bots step out of them one after another.
/pvpbot portals random 10 50 red 0.5s kit diamond r100 h8
Hunts are the same thing around somebody else. Every bot that comes out is already after them.
/pvpbot hunt Steve 8 40 diamond red
The Pearl Rod gives you a plain fishing rod. Cast it and reel in: ender pearls drop out of the sky around the bobber, and a bot appears with its kit wherever each pearl lands.
/pvpbot pearlrod 25 red diamond
⛏️ Jobs and Orders
Bots can do more than fight.
- Mining: lane-based tunnelling for a block type, or a shared excavation of an area, with TNT demolition when they carry it
- Farming: harvest and replant a plot, check chests
- Deliveries: carry a shulker box from the leader to a coordinate
- Building: covered 3-wide paths and bridges, roofs over a group, and island bridges between End islands
- Guard posts: hold a spot, or guard a leader
- Patrol routes: hand-placed waypoint paths, walked or sprinted
- Golem practice: a bot summons an iron golem, pillars up and fights it
?️ Voice Commands
Talk to your army. Faction leaders can give orders out loud, using the PvPBot Voice Link client mod together with Simple Voice Chat.
"Everyone, kill Steve." "Red team, push forward." "Take cover." "Mine down to me."
How it works
- The leader installs the Voice Link Fabric mod, with Fabric API and Simple Voice Chat.
- They run
/voicelink setup once. This downloads an offline English speech model (about 40 MB for the small model up to about 2.3 GB for the biggest). /voicelink model small|medium|large|gigaspeech switches between them.
- On the server they are made a faction leader:
/pvpbot faction leader add <player> <faction>.
- They talk. Orders reach only the bots of the factions they lead. Everyone else is ignored.
Privacy: speech recognition runs on the player's own computer and audio never leaves it. Only sentences that look like bot orders are sent to the server, and they are sent as text.
Who you are talking to
Begin a sentence with whoever should obey, or just open with the command.
| address |
examples |
| Everyone |
everyone, guys, team, squad, boys, troops |
| A faction |
red team attack blue, blue, push forward |
| One bot |
Andy come here, Nexar Void follow me |
| The commander |
commander kill Steve, red commander come here |
Names don't have to be pronounceable. NexarVo1d works as "nexar void", Steve123 as "steve", Pinapple as "pineapple", and a misheard name is fuzzy-matched against the players and bots actually online.
What you can say
| category |
example phrases |
| Attack |
kill Steve, focus Steve, take out Steve, all on Steve, Steve is our target, don't let Steve escape, kill him (whoever you're looking at), kill the closest guy, red team attack blue |
| Rush |
push them, rush them, go get them |
| Stand down |
hold your fire, stop fighting, cease fire, calm down, stand down |
| Weapons free |
weapons free, fight back, engage |
| Regroup |
come to me, get over here, regroup, stay together, rally |
| Follow |
follow me, stay with me, stick with me |
| Advance |
push forward, move up, move out, let's go, go go go |
| Hold |
stay here, stay put, hold your position, don't move |
| Alert |
watch out, behind you, they're coming, get ready, heads up |
| Formation |
get behind me, form up, fall in, then break formation or at ease |
| Scatter |
scatter, spread out, split up, run for your lives |
| Look at me |
look at me, eyes on me (bots clear a 10-block ring around you, some pillar up, and everyone watches you) |
| Take cover |
take cover, take shelter, build a roof, hide (the group builds a roof over itself, and bots further out sprint in) |
| Pillar to |
pillar up to Steve, tower up to Steve, get to Steve |
| Bow |
bow Steve, shoot Steve, snipe Steve (bots with bows keep range, the rest go melee) |
| Mine |
mine the area, dig here, excavate (the area you're looking at, top-down) |
| Mine down to |
mine down to Steve, dig down to me, tunnel to Steve |
| Destroy |
destroy the area, blow it up, level the area (TNT if they carry it, tools if not) |
| Tunnel |
tunnel this way, dig a tunnel (each bot digs its own tunnel in the direction you face) |
| Build up |
build up, pillar up, get up high (each bot on its own column) |
| Path |
make a path there, build a bridge there (covered bridge to the block you're looking at) |
| Island bridge |
bridge to the next island (the End) |
| Armor |
gear up, armor off, put your best armor on, put your worst armor on |
| Stop work |
stop mining, stop digging, stop building |
Every new order replaces the last one: bots drop what they were doing and take up the new task. Armor, "look at me" and "weapons free" are the exceptions, since they sit on top of whatever is running.
A few extra details:
- Single words like "stop" or "wait" need an address ("everyone stop") so normal talk doesn't trigger them.
- There is a short cooldown between orders to keep misheard chatter from spamming.
- Server owners can turn on
voice-feedback: true in config.yml to show what the bot heard on the action bar while testing.
- Revoke
pvpbot.voice from anyone who shouldn't be able to use it.
? Kits
Save your inventory, armor and offhand as a reusable kit, then hand it to a bot, a faction or yourself.
/pvpbot kit create diamond
/pvpbot kit give diamond Steve
/pvpbot faction givekit red diamond
Random kits use weights that are normalized for you, so they don't have to add up to 100:
/pvpbot faction giverandomkit red 5%diamond,25%archer,70%anarchy
? Names, Skins and Bot Types
- Clean names for normal play
- Random "alt-account" names (
x8u21wqz, 128s12uwinsok) that don't look generated
- Void names with a black skin
- Real skins can be pulled from accounts listed in the config
- Neutral bots wander and don't fight, frozen bots are training dummies that still take damage and knockback
- Quiet spawning: bots from portals, hunts and the Pearl Rod arrive without a join message each
⚙️ Customization
About 70 AI settings cover strafing, tapping, sprinting, crits, shielding, reach, aim speed, reaction time, flee and re-engage health, leash distance, mace and elytra behavior, pathfinding, restocking, pearling, team targeting and more.
/pvpbot settings opens a GUI that edits the defaults for future bots
/pvpbot set <bot|faction|all|global> <setting> <value> changes live bots, one, a whole faction, or everyone
? Performance
Built to keep big fights playable.
- Pathfinding runs on background threads with a per-tick budget
- Terrain is snapshotted once and shared by every bot instead of read separately
- Quiet bots out of everyone's sight think less often, and fighting bots always get full attention
- Bots keep only a few chunks loaded and don't affect mob spawning
- A hardware profile lowers the limits automatically on small servers
/pvpbot performance reports tick time, the full/light AI split, pathfinder load and terrain cache hit rate
Bots survive restarts with their faction, settings, guard posts and patrol routes.
Commands
Everything is /pvpbot ... and needs pvpbot.admin (op by default). Tab completion covers all of it.
Spawning
/pvpbot spawn [kit] [faction] [difficulty]
/pvpbot spawnrandom | spawnvoid | spawnneutral | spawnfrozen (same arguments)
/pvpbot masspawn <count> [kit] [faction] [difficulty] (up to 50)
/pvpbot masspawnrandom | masspawnvoid | masspawnneutral | masspawnfrozen | masspawngrid
/pvpbot remove <bot>
/pvpbot removeall
/pvpbot list
Use none to skip the kit or faction slot.
Waves
/pvpbot portals <random|normal|void> <portals> <bots> [faction] [delay] [kit <name>] [r<radius>] [h<height>]
/pvpbot portals stop | close
/pvpbot hunt <target> <portals> <bots> [kit] [faction]
/pvpbot pearlrod <bots> [faction] [kit]
Kits, Settings and Difficulty
/pvpbot kit create <kit> | remove <kit> | give <kit> [bot|player]
/pvpbot give <bot|@bot> <item> [amount]
/pvpbot difficulty <bot> <Easy|Normal|Hard|Expert>
/pvpbot settings
/pvpbot set <bot|faction|all|global> <setting> <value>
Factions
/pvpbot faction list | info <faction> | create <faction> | remove <faction>
/pvpbot faction add <faction> <player|bot> | addall <faction> | addnear <radius> <faction>
/pvpbot faction leader add <player|bot> [faction] | remove <faction|player|bot> | list
/pvpbot faction commander <faction> <bot|clear>
/pvpbot faction givekit <faction|player> <kit>
/pvpbot faction giverandomkit <faction|player> <weights>
/pvpbot faction formation <faction> <shape> [smooth|instant|leader] [spacing]
/pvpbot faction <faction> moveto <x> <y> <z>
/pvpbot faction <faction> attack <faction|off>
/pvpbot faction alliance create|add|remove|delete|list
/pvpbot faction stopattack <faction> <true|false>
/pvpbot faction armor <on|off|best|worst> <faction>
/pvpbot group create <faction> <group> <amount> | disband | list | info | <group> leader add|remove
Orders and Jobs
/pvpbot attack <target|off> <bot>
/pvpbot guard <bot> [radius|here|leader|off]
/pvpbot path create <name> | point create | walk <bot|all|faction> [sprint] | stop | list
/pvpbot mine <bot> <block> <x1 y1 z1> <x2 y2 z2> <seconds>
/pvpbot faction minearea <faction> [radius] [seconds]
/pvpbot farm <bot> <x1 y1 z1> <x2 y2 z2> [seconds]
/pvpbot deliver <bot> <x> <y> <z>
/pvpbot checkchest <bot> <x> <y> <z>
/pvpbot golem <bot> fight | stop
Diagnostics
/pvpbot debug [bot] [watch [seconds]]
/pvpbot performance [on|off|reset]
Permissions
| permission |
default |
|
pvpbot.admin |
op |
all /pvpbot commands |
pvpbot.voice |
everyone |
voice orders (they still only work for faction leaders) |
Requirements
- Minecraft: 1.21.11
- Server: Paper
- Java: 21
- Optional: Simple Voice Chat, so bots join voice chat and voice orders work
- Optional: the PvPBot Voice Link Fabric mod on each leader's client, for voice commands
Good to Know
- Bots are players with a stub connection. If an anticheat or packet plugin kicks them, exempt them; PvPBot blocks outside kicks and tells you once in the log.
- Portal waves build obsidian frames in the world.
/pvpbot portals close removes them.
- Mining, tunnelling and building orders change blocks. Use them somewhere you can undo.
- This is a PvP and testing tool, not something to leave running unattended on a survival world.
Built For PvP
Use it for:
- ⚔️ Large PvP battles and faction wars
- ?️ Training arenas, aim practice and shield-breaking drills
- ? Combat and anticheat testing
- ? AI vs AI fights
- ?️ A player and their personal bot squad
- ?️ Commanding an army with your voice
- ? Events, trailers and stress tests
Spawn them. Kit them. Split them into factions. Pick a difficulty. Form them up, drop them out of the sky, and tell them what to do. Then start the fight.
评论 0
登录后参与评分
还没有评论,来抢沙发吧