Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
PvPBot
PvPBot is an advanced Minecraft PvP bot plugin for Paper 1.21.11.
It creates fully simulated player bots designed to fight, move, heal, use items, defend themselves, work together, follow faction leaders, and react to situations like Wind Charges, Maces, TNT Minecarts, and other PvP threats.
The goal isn't to make bots that simply run toward a player and swing.
The goal is to make them play Minecraft like actual players.
⚔️ Combat AI
PvPBot bots can:
- Fight using vanilla player attacks
- Sprint, strafe, W-tap and reset sprint
- Perform critical hits
- Use shields intelligently
- Break enemy shields
- Manage attack cooldowns
- Switch between targets intelligently
- Coordinate attacks against the same player
- React to incoming damage
- Protect faction members and leaders
- Retreat when heavily damaged
- Re-engage after healing
Bots also have different difficulty levels:
Easy → Normal → Hard → Expert
Each difficulty changes how the bot reacts, aims, moves, fights, and makes decisions.
❤️ Survival & Healing
Bots don't just fight until they die.
They can:
- Eat food
- Drink potions
- Use splash potions
- Use Strength and Speed
- Use Fire Resistance
- Use Turtle Master
- Use Totems
- Raise shields while fleeing
- Use Ender Pearls to escape
- Regroup after retreating
- Manage hunger and saturation
- React after a Totem pop
Healing and combat decisions are handled independently so bots can decide when fighting is more important and when survival comes first.
🧠 Movement
PvPBot uses Minecraft's own player movement and physics rather than simply teleporting bots around.
Bots can:
- Sprint
- Jump
- Strafe
- Climb terrain
- Navigate obstacles
- Swim
- Handle knockback
- React to Wind Charges
- Chase targets
- Follow paths
- Follow faction leaders
- March into formations
- Retreat from dangerous situations
Movement is designed around the same vanilla systems used by Minecraft players.
💥 Threat Detection
Bots can react to dangerous PvP situations instead of blindly continuing to attack.
Wind Charges
Bots can detect incoming Wind Charge threats and prepare defensive actions such as shielding and repositioning.
Maces
Bots can detect incoming smash attacks and attempt to defend themselves.
TNT Minecarts
Bots can detect nearby rail placement and minecarts before the explosion happens.
Depending on the situation, they may:
- Build a defensive wall
- Break the minecart
- Retreat
- Raise their shield
- Use an Ender Pearl
The reaction time is deliberately affected by difficulty, so easier bots won't instantly know everything that's happening.
🤝 Factions
Create teams of bots and players.
Factions allow bots to:
- Recognize teammates
- Avoid attacking friendly faction members
- Fight enemy factions
- Protect faction members
- Follow faction leaders
- Defend leaders when attacked
- Regroup when their leader retreats
- Move together in formations
Bots can be assigned to factions directly when spawning.
👑 Faction Leaders
Assign a real player or another bot as a faction leader.
Faction members can automatically:
- Escort their leader
- Follow their leader
- Defend them when attacked
- Regroup when the leader retreats
- Maintain formations around the leader
This makes it possible to create things like:
1 Player + 20 PvP Bots
and have the bots actually behave like the player's squad.
📐 Formations
PvPBot supports multiple formations:
- Grid
- Circle
- Arc
- Line
- Column
- Wedge
- Square
Formations can be:
Instant — bots are immediately arranged.
Smooth — bots walk into position.
Leader Follow — the formation follows a faction leader.
Spacing can also be customized.
🎒 Kits
Create reusable PvP kits and give them to bots or entire factions.
You can:
- Create kits
- Remove kits
- Give kits to bots
- Give kits to entire factions
- Randomly distribute kits using weighted percentages
Example:
5% diamond
25% archer
70% anarchy
The weights are normalized automatically, so they don't have to equal exactly 100%.
👤 Bot Names
PvPBot supports normal names as well as random "alt-account style" names.
Examples:
128s12uwinsok
wqyha78imcym298
92qweu18
x8u21wqz
Random names are designed to look less like obvious generated NPC names.
💤 Neutral Bots
Need bots that simply wander around?
Use:
/pvpbot spawnneutral
Neutral bots won't actively fight.
They can still exist in the world and behave as normal wandering bots.
⚙️ Customization
PvPBot has a large collection of configurable AI settings.
You can customize things such as:
- Strafing
- W-tapping
- Sprinting
- Critical hits
- Shielding
- Reach
- Strafing speed
- Attack cooldown
- Target range
- Flee health
- Aim behavior
- Reaction time
- Combat behavior
- Shield breaking
- Cart defense
- Invisibility
- And more
All settings are managed through a centralized settings system.
📊 Performance
PvPBot includes built-in performance monitoring.
Check:
/pvpbot perf
to view:
- Alive bot count
- Bot tick time
- Average tick time
- AI full/light tick distribution
- Pathfinder workload
- Deferred pathfinding operations
The plugin uses performance budgeting and different AI levels of detail to help keep large bot battles manageable.
Commands
Bot Commands
/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]
Mass spawning supports optional factions, grid formations, spacing, and weighted difficulty distributions. Up to 50 bots can be spawned through the mass-spawn command.
Settings
/pvpbot settings
/pvpbot settings <option>
/pvpbot settings <option> <value>
Kit Commands
/pvpbot kit create <kit>
/pvpbot kit remove <kit>
/pvpbot kit give <kit> <bot>
Faction Commands
/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]
Faction leaders can be players or bots, and faction formations support smooth movement, instant placement, spacing, and leader-following behavior.
Debug & Performance
/pvpbot debug
/pvpbot perf
/pvpbot performance
/pvpbot perf reset
Requirements
Minecraft: 1.21.11 Server: Paper Java: 21
Built For PvP
PvPBot is made for servers that want more than stationary NPCs.
Whether you want to create:
- ⚔️ Massive PvP battles
- 🏟️ PvP training arenas
- 🧪 Combat testing environments
- 🤖 AI vs AI battles
- 👑 Faction wars
- 🛡️ Player + bot armies
- 🎮 Minigames
- 💥 Large-scale PvP events
PvPBot gives you the tools to build it.
Spawn them. Give them kits. Create factions. Choose their difficulty. Put them into formation. Then start the fight.