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.