
用于 Paper 服务器的 PvP 练习机器人。这些机器人看起来像玩家,战斗方式也与之相同。它们会冲刺击打(sprint-hit)并在挥击之间使用 W-tap 技巧跳跃以获得暴击,同时保持在最大攻击距离进行走位。当自己的挥击正在冷却而你的已经就绪时,它们会后退。玩家只需从菜单中选择一名机器人、难度和装备套件即可开始战斗。无需掌握任何命令。
要求: Paper 1.21.9 或更高版本(已在 1.21.11 和 26.1.2 上测试),Java 21+。无需其他插件。
展示

每个机器人都是带有真实玩家皮肤的原版木偶实体(Mannequin entity),因此标签页列表中不会出现假人,也没有数据包欺骗行为。该插件每秒(tick)直接移动和调整木偶自身的朝向。
- 瞄准转向速度有限制并带有轻微随机抖动,就像鼠标指针一样。简单难度的机器人追踪你较慢,疯狂难度的机器人几乎不会失手。
- 近战机器人会冲刺击打、W-tap、预判跳跃暴击并在下落时攻击。在远距离时沿长弧线侧向移动,在近距离或你拉弓时会切换为 ADAD 左右横移。
- 命中选择:当机器人的挥击处于冷却中而你的已就绪时,它会走出你的攻击范围而不是与你交换攻击。
- 弓箭手会根据你的移动轨迹预判射击,并为箭矢下坠增加瞄准高度。
- 盾牌使用者在你蓄力完毕时格挡,然后放下盾牌进行反击。斧头会使盾牌失效 5 秒,与对玩家的效果相同。
- 血量低时机器人会吃金苹果,追击跑动的玩家时使用末影珍珠,并且不会走进岩浆或高台边缘。

该插件自带十一种机器人。每一个都对应 bots/ 目录下的一个 YAML 文件,你可以编辑、删除或添加你自己的机器人。
| 机器人 |
风格 |
| Rookie |
石剑、皮革甲、速度慢、无暴击。适合学习连招。 |
| Swordsman |
钻石剑和铁甲。作为衡量自身水平的基准线。 |
| Knight |
斧头和盾牌。格挡你的蓄力攻击,破坏你的盾牌。 |
| Archer |
在 10 到 18 格距离风筝,预判射击。 |
| Berserker |
下界合金斧,几乎没有护甲,血量越低越强。 |
| Skyfall |
在自己脚下放置风之电荷,然后在下落时砸碎战锤。 |
| Duelist |
下界合金剑、保护附魔盔甲、良好的走位,追击时使用末影珍珠。 |
| FlameFrags |
中距离使用火焰弓,被近身时使用火焰剑。 |
| Wemmbu |
40 血量的坦克,配备斧头、盾牌、末影水晶和战锤砸击。 |
| ??? |
60 血量的 Boss。半透明隐身,会在你身后闪烁,低血量时狂暴。 |
| Training Dummy |
从不反击,永不死亡。由假人模式使用。 |
各项能力针对每个机器人单独开启:bow(弓)、shield(盾)、crystals(水晶)、wind-mace(风锤)、blink(闪烁)、pearls(珍珠)、gapples(金苹果)、enrage(狂暴)和 hurt-resistance(伤害抗性)。每项能力都有独立的冷却时间和范围限制。水晶爆炸永远不会破坏方块。

决斗。 一名机器人,3-2-1 倒计时,然后开始战斗。回合结束时,聊天栏会显示总结信息:时间、命中次数、暴击数、造成伤害与受到的伤害、最佳连击、平均和最大攻击距离以及最高 CPS(每秒点击次数)。分数会在回合间累计(如 3-1 等)。随后会出现可点击的 [REMATCH] [MENU] [LEAVE] 按钮,或者如果你开启了自动重赛,下一回合将自动开始。
波次生存。 机器人不断涌来。每波都会增加更多机器人并给予它们更高的生命值。波次之间你会恢复部分生命。可以选择特定机器人或随机混合阵容,尝试刷新个人最佳波次记录(记录按玩家保存)。
训练假人。 用于练习连招、攻击距离和点击的目标。它可以静止不动、侧向移动、绕着你转圈、后退或跳跃。你可以选择其护甲(从无到下界合金)以查看实际伤害,并可以关闭击退效果。动作栏会显示 CPS、攻击距离、连击、上次命中和 DPS。
在任何战斗中,动作栏都会显示实时 HUD,伤害数字会浮现在机器人上方。只有你能看到它们。

装备套件。 插件自带五种:剑、斧与盾、战锤、弓箭手和下界合金药水。它们在 kits.yml 中定义,包含物品槽、附魔、药水和皮革染色颜色。玩家也可以使用自己的背包进行战斗。
当使用套件时,玩家的真实背包、护甲、经验值、生命值、状态效果、游戏模式和位置会在任何更改之前保存到磁盘。会话结束时这些数据会恢复。如果服务器崩溃、玩家被踢出或死亡,所有数据将在重生或下次加入时恢复。每次回合开始前都会重新给予套件,因此食物和药水会补充。套件中的物品无法丢弃、放入箱子、物品展示框或盔甲架,也无法与拾取的物品混合。
竞技场。 站在玩家应生成的位置运行 /pvpbots arena create <name>,然后站在机器人应生成的位置运行 /pvpbots arena setbot <name>。一次会话只使用一个竞技场。玩家可以选择特定竞技场、使用第一个可用的竞技场,或在当前站立的位置战斗(此功能可关闭)。
击杀判定结束回合而非杀死玩家,因此不会出现死亡屏幕且没有任何掉落物。双手持有不死图腾仍会正常触发。

/pvpbots 打开菜单。从这里玩家可以:
- 设置决斗、波次挑战或假人会话并按 START;
- 浏览机器人及其描述、生命值、伤害、速度、攻击距离和能力;
- 选择难度并查看其影响;
- 选择套件,右键点击查看内部物品,或使用自己的背包;
- 选择竞技场并查看哪些正在使用中;
- 切换 HUD、倒计时、自动重赛、聊天总结和伤害数字。
选择和设置存储在玩家独立的数据文件中,重启后依然存在,且插件不依赖数据库。

| 命令 |
权限 |
描述 |
/pvpbots |
pvpbots.use |
打开菜单 |
/pvpbots duel [bot] [difficulty] [kit] |
pvpbots.mode.duel |
开始一场决斗,跳过菜单环节 |
/pvpbots waves [difficulty] [kit] |
pvpbots.mode.waves |
开始波次生存模式 |
/pvpbots dummy [pattern] |
pvpbots.mode.dummy |
生成训练假人 |
/pvpbots rematch |
pvpbots.use |
开始下一轮 |
/pvpbots leave |
pvpbots.use |
结束会话并归还所有物品 |
/pvpbots settings |
pvpbots.use |
打开玩家设置 |
/pvpbots kits |
pvpbots.use |
打开装备列表 |
/pvpbots arena <create|setplayer|setbot|delete|tp|list> [name] |
pvpbots.admin |
管理竞技场 |
/pvpbots stop <player> |
pvpbots.admin |
结束其他玩家的会话 |
/pvpbots list |
pvpbots.admin |
显示正在训练的玩家 |
/pvpbots reload |
pvpbots.admin |
重载配置、消息、机器人、装备和竞技场 |
别名:/ptb, /pvpbot, /trainbot。默认情况下,所有玩家都拥有玩家级权限。pvpbots.anywhere 允许玩家在竞技场之外进行战斗。机器人或装备也可以需要其专属权限,该权限可在其配置文件中设置。

config.yml 包含会话规则(倒计时、重赛延迟、最大距离、会话限制、强制生存)、装备保护、波次缩放、HUD 布局、伤害数字格式、音效、默认玩家设置以及难度选项。
- 共有四种难度:Easy(简单)、Normal(普通)、Hard(困难)和 Insane(疯狂)。每种难度分别设定瞄准速度、瞄准抖动、挥剑延迟、暴击率以及速度、伤害和生命值倍率。它还设定弓的精准度,以及机器人是否使用 W-tap(瞬移步)、目标选择和珍珠传送。你可以添加更多难度。
bots/<id>.yml 每个文件包含一个机器人:名称、皮肤、菜单图标、描述、生命值、速度、攻击距离、伤害、挥动速度、暴击几率、装备和能力。
kits.yml 存储装备信息。
messages.yml 存储所有文本,包括菜单项,采用 MiniMessage 格式,因此你可以翻译整个插件。
一个机器人配置文件示例:
name: '<white>Swordsman'
order: 2
icon: DIAMOND_SWORD
description:
- '<gray>Plain sword fighter in iron.'
skin: '' # 任意 Minecraft 用户名,为空则使用默认皮肤
permission: ''
in-wave-pool: true
health: 20.0
speed: 0.28 # 冲刺时每秒区块数
reach: 3.0
melee:
damage: 7.0
attack-ticks: 12
crit-chance: 0.4
equipment:
weapon: {material: DIAMOND_SWORD}
helmet: {material: IRON_HELMET}
chestplate: {material: IRON_CHESTPLATE}
leggings: {material: IRON_LEGGINGS}
boots: {material: IRON_BOOTS}
abilities:
gapples:
health-below: 0.35
cooldown-ticks: 400

- 将
PvPTrainingBots.jar 放入 plugins/ 目录。
- 启动服务器。插件会自动创建
config.yml、messages.yml、kits.yml 以及 bots/ 文件夹。
- 可选:建造一个竞技场,并使用
/pvpbots arena create 和 /pvpbots arena setbot 注册它。
- 玩家运行
/pvpbots。

PvP practice bots for Paper servers. The bots look like players and fight like them too. They sprint-hit and W-tap between swings, jump for crits, and keep spacing at max reach. They back off while their own swing recharges and yours is ready. Players pick a bot, a difficulty and a kit from a menu and start fighting. They don't need to know a single command.
Requirements: Paper 1.21.9 or newer (tested on 1.21.11 and 26.1.2), Java 21+. No other plugins needed.
SHOWCASE

Every bot is a vanilla Mannequin entity with a real player skin, so there are no fake players in the tab list and no packet tricks. The plugin moves and aims the Mannequin itself every tick.
- Aim turns at a capped speed with a bit of random jitter, the way a mouse does. Easy bots are slow to track you, Insane bots barely miss.
- Melee bots sprint-hit, W-tap, plan jump crits and hit on the way down. They strafe in long arcs at range and switch to ADAD up close or when you draw a bow.
- Hit selecting: when the bot's swing is recharging and yours is charged, it steps out of your reach instead of trading.
- Archers lead their shots based on how you are moving and aim higher for arrow drop.
- Shield users block when you're charged up and drop the shield to swing. An axe disables the shield for 5 seconds, the same as for a player.
- Bots eat golden apples when low, pearl after players who run, and won't walk into lava or off a high drop.

The plugin ships with eleven bots. Each one is a YAML file in bots/, so you can edit them, delete them or add your own.
| Bot |
Style |
| Rookie |
Stone sword, leather, slow, no crits. Good for learning to combo. |
| Swordsman |
Diamond sword and iron armor. A plain baseline to measure yourself against. |
| Knight |
Axe and shield. Blocks your charged hits, breaks your shield. |
| Archer |
Kites from 10 to 18 blocks, leads its shots. |
| Berserker |
Netherite axe, almost no armor, gets stronger as it loses health. |
| Skyfall |
Wind charge at its own feet, then a mace smash on the way down. |
| Duelist |
Netherite sword, protection armor, good spacing, pearls after you. |
| FlameFrags |
Fire bow at mid range, fire sword when rushed. |
| Wemmbu |
40 HP tank with axe, shield, end crystals and mace smashes. |
| ??? |
60 HP boss. Half invisible, blinks behind you, enrages at low health. |
| Training Dummy |
Never fights back, never dies. Used by the dummy mode. |
Abilities are switched on per bot: bow, shield, crystals, wind-mace, blink, pearls, gapples, enrage and hurt-resistance. Each has its own cooldown and ranges. Crystal explosions never break blocks.

Duel. One bot, a 3-2-1 countdown, then you fight. When the round ends you get a summary in chat: time, hits, crits, damage dealt and taken, best combo, average and max reach, and top CPS. The score carries over between rounds (3-1 and so on). Clickable [REMATCH] [MENU] [LEAVE] buttons follow, or the next round starts on its own if you turned on auto rematch.
Wave survival. Bots keep coming. Every wave adds more of them and gives them more health. You get some health back between waves. Pick one bot or a random mix, and try to beat your best wave, which is saved per player.
Training dummy. A target for practicing combos, reach and clicking. It can stand still, strafe, circle you, back away or jump. You choose its armor (none up to netherite) to see your real damage, and you can turn knockback off. The action bar shows CPS, reach, combo, last hit and DPS.
During any fight the action bar shows a live HUD, and damage numbers float over the bot. Only you see them.

Kits. Five come with the plugin: Sword, Axe and Shield, Mace, Archer and Netherite Pot. They are defined in kits.yml with slots, enchantments, potions and leather colors. Players can also fight with their own inventory.
When a kit is in use, the player's real inventory, armor, XP, health, effects, gamemode and position are written to disk before anything changes. They come back when the session ends. If the server crashes, the player is kicked or they die, everything is restored on respawn or on the next join. The kit is given again before every round, so food and potions refill. Kit items can't be dropped, put in chests, item frames or armor stands, or mixed with picked-up items.
Arenas. Stand where the player should spawn and run /pvpbots arena create <name>, then stand where the bot should spawn and run /pvpbots arena setbot <name>. One session uses an arena at a time. Players can pick a specific arena, take the first free one, or fight right where they stand (you can turn that off).
A killing blow ends the round instead of killing the player, so there's no death screen and nothing drops. A totem of undying in either hand still pops normally.

/pvpbots opens the menu. From there a player can:
- set up a duel, wave run or dummy session and press START;
- browse bots with their description, health, damage, speed, reach and abilities;
- pick a difficulty and see what it changes;
- pick a kit, right click to look inside it, or keep their own inventory;
- pick an arena and see which ones are in use;
- toggle the HUD, countdown, auto rematch, chat summary and damage numbers.
Picks and settings are stored in the player's own data, so they're still there after a restart and the plugin keeps no database.

| Command |
Permission |
Description |
/pvpbots |
pvpbots.use |
Opens the menu |
/pvpbots duel [bot] [difficulty] [kit] |
pvpbots.mode.duel |
Starts a duel, skipping the menu |
/pvpbots waves [difficulty] [kit] |
pvpbots.mode.waves |
Starts wave survival |
/pvpbots dummy [pattern] |
pvpbots.mode.dummy |
Spawns the training dummy |
/pvpbots rematch |
pvpbots.use |
Starts the next round |
/pvpbots leave |
pvpbots.use |
Ends the session and gives everything back |
/pvpbots settings |
pvpbots.use |
Opens player settings |
/pvpbots kits |
pvpbots.use |
Opens the kit list |
/pvpbots arena <create|setplayer|setbot|delete|tp|list> [name] |
pvpbots.admin |
Manages arenas |
/pvpbots stop <player> |
pvpbots.admin |
Ends someone else's session |
/pvpbots list |
pvpbots.admin |
Shows who is training |
/pvpbots reload |
pvpbots.admin |
Reloads config, messages, bots, kits and arenas |
Aliases: /ptb, /pvpbot, /trainbot. Everyone has the player permissions by default. pvpbots.anywhere lets a player fight outside an arena. A bot or kit can also require its own permission, set in its file.

config.yml has the session rules (countdown, rematch delay, max distance, session limit, forced survival), kit protection, wave scaling, HUD layouts, damage number format, sounds, default player settings, and the difficulties.
- There are four difficulties: Easy, Normal, Hard and Insane. Each one sets aim speed, aim jitter, swing delay, crit rate, and speed, damage and health multipliers. It also sets bow accuracy and whether the bot W-taps, hit-selects and pearls. You can add more.
bots/<id>.yml holds one bot per file: name, skin, menu icon, description, health, speed, reach, damage, swing speed, crit chance, equipment and abilities.
kits.yml holds the kits.
messages.yml holds every text, including menu items, in MiniMessage format, so you can translate the whole plugin.
A bot file:
name: '<white>Swordsman'
order: 2
icon: DIAMOND_SWORD
description:
- '<gray>Plain sword fighter in iron.'
skin: '' # any Minecraft username, empty = default skin
permission: ''
in-wave-pool: true
health: 20.0
speed: 0.28 # blocks per tick while sprinting
reach: 3.0
melee:
damage: 7.0
attack-ticks: 12
crit-chance: 0.4
equipment:
weapon: {material: DIAMOND_SWORD}
helmet: {material: IRON_HELMET}
chestplate: {material: IRON_CHESTPLATE}
leggings: {material: IRON_LEGGINGS}
boots: {material: IRON_BOOTS}
abilities:
gapples:
health-below: 0.35
cooldown-ticks: 400

- Put
PvPTrainingBots.jar in plugins/.
- Start the server. The plugin creates
config.yml, messages.yml, kits.yml and the bots/ folder.
- Optional: build an arena and register it with
/pvpbots arena create and /pvpbots arena setbot.
- Players run
/pvpbots.
评论 0
登录后参与评分
还没有评论,来抢沙发吧