PvpBotdocs

Paper & Spigot · 1.21.11, 26.2 and 26.3

PvpBot

Bots that join your server as real players and fight the way people do: jump crits, shields, the mace, bows, pearls, cobwebs and water buckets. Built to train against and record with, not to win every fight.

Download on Modrinth Quick start

What it is

A PvpBot bot is a player with no client attached. To the server and every other plugin it is a person like anyone else: it has an inventory, armour, hunger, potion effects and a skin, and it takes knockback and damage the vanilla way.

Nothing it does is frame-perfect. One skill dial, from 0 to 100, sets how quickly it reacts, how well it times a swing and how far off its aim lands, and it splits into knobs when you want finer control. Even at 100 there is a gap to play around. Bots read you, space, bait and tilt like people, know 27 mace and spear techniques, regear from an ender chest, march in formations and fight in armies that hold or break. And there's a menu for every setting.

The manual

Getting started

Installation
Which jar to use, requirements, compatible plugins.
Quick start
A first bot, a first fight, a first faction.
Next update
Finished on GitHub, not on Modrinth yet.

Reference

Commands
Every /pvpbot and /ghost command.
Selectors
Ordering one bot, a faction or a random group.
Settings
All 215 options, with defaults and limits.
Add-on API
Teach bots to use another plugin's gear.

Features

Difficulty and playstyles
Skill knobs, presets, playstyles, human habits.
Combat
Aim, senses, melee, mace, elytra mace, cart PvP, bows, survival.
Mace and spear techniques
27 moves, each its own switch.
Movement
Pathfinding, bridging, boats, guards and patrols.
Factions
War, peace, alliances, formations, marches and armies.
Regearing
Restocking from an ender chest or a shulker box.
Menus
Every setting, bot, kit and faction in a menu.
Kits and presets
Saved loadouts and difficulty profiles.
Scripts
Whole scenarios saved under a name.
Companions
Bots a player orders around in chat.
Skins and names
Real or random skins, themed name tables.
Ghosts
Scenery NPCs that replay a path or watch you.

Help

Troubleshooting
Bots that are immortal, stuck or won't attack.
Arena, stats and debug view
Test settings, keep score, see what a bot thinks.
Spigot edition
What differs from the Paper build.
Benchmarks
How many bots a server can handle.

At a glance

ServersPaper 1.21.11, 26.2 and 26.3, Spigot 1.21.11, 26.2 and 26.3 (one jar each)
Commands/pvpbot (alias /bot) and /ghost
Permissionpvpbot.admin, ops by default (pvpbot.stats for /pvpbot stats, everyone by default)
DependenciesNone. SkinsRestorer is used if it is installed.
Downloadmodrinth.com/plugin/pvp-bot-plugin-pvpbp