Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
🤖 PracticeBotPvP
Advanced PvP practice bots for every server. No friends required.
Spawn a fully AI-driven bot that crits, strafes, combos, and blocks just like a real player — across four difficulty levels, eight equipment presets, and fully configurable reach and health.
📖 Overview
PracticeBotPvP is an advanced PvP practice plugin that spawns a personal combat bot for each player. The bot uses a multi-behavior AI system to replicate real player techniques: sprint combos (W-taps), jump crits, circular strafing, smart shield blocking, and evasive dodging at low health. Everything scales with difficulty — from a slow, forgiving Easy bot to a Hacker-tier opponent with frame-perfect timing and instant shields.
Each player's bot settings (difficulty, reach, health, loadout) are saved persistently and remembered across sessions. Players manage their bot entirely through simple commands or an in-game GUI, with no configuration files to touch.
Compatible with Paper, Spigot, Purpur, and Folia (1.21–26.x), with optional PlaceholderAPI, Vault, and WorldGuard support.
✨ Why Choose PracticeBotPvP?
⚡ Multi-Behavior AI – Six distinct combat behaviors (crits, combos, strafing, shielding, dodging, reach control) work together each tick to simulate a real player.
🎨 4 Difficulty Levels – Easy, Medium, Hard, and Hacker, each with configurable crit chance, combo chance, strafe frequency, reaction speed, and shield timing.
🔧 8 Equipment Presets – Leather, Chainmail, Iron, Diamond, Netherite, Naked, Tank, and Default — applied instantly with one command.
🚀 Performance Friendly – Per-player bot limits, global bot caps, async data saving, and an in-memory cache keep overhead minimal.
🛠️ Fully Configurable – Difficulty profiles, knockback values, crit multipliers, spawn limits, world restrictions, and auto-respawn all editable in config.yml and difficulties.yml.
✨ Features
🔴 Core Features
🤖 Personal combat bot per player spawned at their location
⚔️ Continuous attack AI with configurable cooldown (default: 10 ticks / 0.5s)
💀 Auto-respawn when bot dies (configurable delay, default: 60 ticks / 3s)
🌐 World blacklist/whitelist support
📊 Per-player statistics tracking: kills, deaths, damage dealt/taken, total spawns
🟡 Advanced AI Systems
🎯 Critical Hit Behavior – Jump (Y velocity 0.42) → fall → attack on tick 7 for guaranteed crit
⚡ Combo Behavior – Sprint → attack → W-tap stop (tick 0→1→3 sequence) for max knockback
🌀 Strafe Behavior – Circle, zigzag, and random patterns; direction flips with configurable randomness
🛡️ Shield Behavior – Raises shield within detection window (500ms) of a player swing; instant lower to resume attacking
🏃 Dodge Behavior – Backward, left, right, and jump-back evasion at ≤30% health
📐 Reach Behavior – Maintains 80% optimal / 60% minimum distance ratio relative to configured reach
🟢 Customization & Integration
🎨 GUI settings and loadout menus
🌐 PlaceholderAPI, Vault, WorldGuard soft-dependencies
📦 8 built-in equipment presets with enchantments
🔔 Configurable welcome messages and join tutorial
💾 Async YAML data saving with configurable interval and memory cache
📚 Documentation
🤖 Bot AI & State Machine
The bot runs a tick-based state machine with 9 states:
| State | Description |
|---|---|
IDLE |
Waiting for owner to be in range |
ENGAGING |
Moving to optimal combat range |
ATTACKING |
Performing a normal attack |
JUMPING |
Mid-jump for a critical hit |
FALLING |
Falling, crit window is open |
BLOCKING |
Shield raised to block incoming hit |
STUNNED |
Shield disabled (axe hit) |
DODGING |
Evasive maneuver at low health |
STRAFING |
Circling the target |
Each tick, the CombatAI evaluates whether to attempt a critical hit (jump-attack), a sprint combo (W-tap), or a normal attack based on the difficulty's crit/combo chance percentages. The ShieldBehavior runs in parallel every tick — it detects player swings within a 500ms window, applies the difficulty's reaction delay, then raises or lowers the shield automatically.
⚙️ Difficulty System
Four built-in difficulty levels, each fully editable in difficulties.yml:
| Difficulty | Crit Chance | Combo Chance | Strafe Freq | Reaction Mult | Shield Raise Speed |
|---|---|---|---|---|---|
| 🟢 Easy | 10% | 10% | 30% | ×1.5 (slower) | 10 ticks |
| 🟡 Medium | 40% | 50% | 60% | ×1.0 (normal) | 5 ticks |
| 🟠 Hard | 80% | 90% | 85% | ×0.5 (2× faster) | 2 ticks |
| 🔴 Hacker | 100% | 100% | 100% | ×0.3 (3× faster) | 1 tick (instant) |
The reaction-multiplier scales all bot delays server-wide. movement-randomness (0.0–1.0) controls how unpredictable the strafe timing is — higher is harder to read.
Custom difficulties can be added directly to difficulties.yml with any name and any values.
🗡️ Equipment Presets
Eight built-in presets applied with /bot loadout <preset>:
| Preset | Armor | Weapon | Shield | Enchantments |
|---|---|---|---|---|
default |
Iron | Iron Sword | Yes | None |
leather |
Leather | Stone Sword | Yes | None |
chainmail |
Chainmail | Iron Sword | Yes | None |
iron |
Iron | Iron Sword | Yes | None |
diamond |
Diamond | Diamond Sword | Yes | Prot II, Sharp II |
netherite |
Netherite | Netherite Sword | Yes | Prot IV, Sharp V |
naked |
None | Iron Sword | No | None |
tank |
Netherite + Unbr III | Netherite Axe | No | Prot IV, Sharp V |
Equipment can also be customized fully through the in-game Loadout GUI (/bot gui or /bot loadout).
📐 Reach & Health
Reach (/bot reach <3.0–6.0>) controls the bot's maximum attack range. The ReachBehavior automatically keeps the bot at 80% of that range (optimal) and no closer than 60% (minimum), creating realistic spacing.
Health (/bot health <20–100>) sets the bot's max HP. 20 = 10 hearts (vanilla), up to 100 = 50 hearts. The bot's health persists and is restored on respawn.
Both values are saved per-player and persist across sessions.
⚙️ Configuration
Configuration files: config.yml · difficulties.yml · messages.yml
# Key settings in config.yml
bot:
defaults:
attack-cooldown: 10 # Ticks between attacks (10 = 0.5s)
name-format: '§6{player}''s Bot'
baby: false # Spawn as baby zombie
fall-damage: false
auto-spawn:
enabled: false # Spawn bot when player joins
notify: true
auto-respawn:
enabled: true # Respawn bot on death
delay-ticks: 60 # 3 seconds
starting-settings:
difficulty: MEDIUM
reach: 3.5
health: 20.0
combat:
crit:
multiplier: 1.5
show-particles: true
knockback:
base-strength: 0.4
sprint-bonus: 0.5
vertical: 0.35
multiplier: 1.0
shield:
disable-duration: 100 # Ticks shield is disabled by axe
worlds:
mode: BLACKLIST # BLACKLIST or WHITELIST
list:
- world_the_end
- lobby
limits:
max-bots-per-player: 1
max-bots-global: 100
data:
auto-save-interval: 300 # Seconds
max-cached-players: 100
📋 Notable Configuration Options
| Option | Description | Default |
|---|---|---|
bot.defaults.attack-cooldown |
Ticks between bot attacks | 10 |
bot.auto-respawn.enabled |
Auto-respawn bot on death | true |
bot.auto-respawn.delay-ticks |
Ticks before respawn | 60 |
bot.auto-spawn.enabled |
Spawn bot when player joins | false |
combat.knockback.multiplier |
Global knockback multiplier | 1.0 |
combat.shield.disable-duration |
Axe shield disable duration (ticks) | 100 |
worlds.mode |
BLACKLIST or WHITELIST |
BLACKLIST |
limits.max-bots-per-player |
Max bots per player | 1 |
limits.max-bots-global |
Total server bot cap | 100 |
worldguard.require-pvp |
Require PvP flag in region | false |
worldguard.use-custom-flag |
Use practicebot-spawn region flag |
true |
💡 Note: Reload config with /bot admin reload. Difficulty changes apply to live bots immediately; reach/health/loadout changes require /bot respawn.
💻 Commands
👤 Player Commands
| Command | Description | Permission | Aliases |
|---|---|---|---|
/bot spawn |
Spawn your practice bot at your location | practicebot.spawn |
create, summon |
/bot remove |
Remove (despawn) your bot | practicebot.remove |
delete, despawn, dismiss |
/bot respawn |
Remove and respawn bot with current settings | practicebot.respawn |
reset, restart, reload |
/bot teleport |
Teleport bot to your location | practicebot.teleport |
tp, bring |
/bot difficulty <easy|medium|hard|hacker> |
Change bot difficulty | practicebot.difficulty |
diff, level |
/bot reach <3.0-6.0> |
Set bot attack reach | practicebot.reach |
— |
/bot health <20-100> |
Set bot maximum health | practicebot.health |
— |
/bot loadout [preset] |
Open loadout GUI or apply preset | practicebot.loadout |
— |
/bot settings |
Open settings GUI | practicebot.settings |
— |
/bot gui |
Open main settings GUI | practicebot.gui |
— |
/bot info |
View current bot settings and stats | practicebot.use |
— |
/bot help [page] |
Show help menu | practicebot.use |
?, commands |
Main command aliases: /practicebot, /pbot, /pvpbot
🔧 Admin Commands
| Command | Description | Permission |
|---|---|---|
/bot admin reload |
Reload all configuration files | practicebot.admin.reload |
/bot admin removeall |
Remove all active bots on the server | practicebot.admin.removeall |
/bot debug |
Toggle debug mode (AI and combat logging) | practicebot.debug |
🔐 Permissions
practicebot.*
├── practicebot.use
├── practicebot.spawn
├── practicebot.remove
├── practicebot.respawn
├── practicebot.teleport
├── practicebot.gui
├── practicebot.settings
├── practicebot.loadout
├── practicebot.reach
├── practicebot.health
├── practicebot.difficulty
├── practicebot.difficulty.*
│ ├── practicebot.difficulty.easy
│ ├── practicebot.difficulty.medium
│ ├── practicebot.difficulty.hard
│ └── practicebot.difficulty.hacker (default: op)
├── practicebot.autospawn (default: false)
└── practicebot.admin
├── practicebot.admin.reload
├── practicebot.admin.removeall
├── practicebot.admin.bypass
└── practicebot.debug
| Permission | Description | Default |
|---|---|---|
practicebot.use |
Basic command access | true |
practicebot.spawn |
Spawn bots | true |
practicebot.difficulty.hacker |
Use Hacker difficulty | op |
practicebot.admin.bypass |
Bypass cooldowns and limits | op |
practicebot.autospawn |
Auto-spawn on join | false |
practicebot.admin.* |
All admin permissions | op |
🔤 PlaceholderAPI
PracticeBotPvP supports PlaceholderAPI!
| Placeholder | Description |
|---|---|
%practicebot_has_bot% |
Whether the player has a bot spawned (true/false) |
%practicebot_difficulty% |
Current difficulty name |
%practicebot_difficulty_color% |
Difficulty name with color code |
%practicebot_reach% |
Configured reach value |
%practicebot_health% |
Configured max health |
%practicebot_hearts% |
Max health in hearts (health ÷ 2) |
%practicebot_bot_health% |
Bot's current live health |
%practicebot_bot_health_max% |
Bot's maximum health |
%practicebot_bot_state% |
Bot's current AI state |
%practicebot_total_spawns% |
Total bot spawns by player |
%practicebot_total_kills% |
Times player has killed their bot |
%practicebot_total_deaths% |
Times player has died to their bot |
%practicebot_damage_dealt% |
Total damage dealt to bot |
%practicebot_damage_taken% |
Total damage taken from bot |
%practicebot_auto_spawn% |
Auto-spawn enabled (true/false) |
%practicebot_show_particles% |
Particles enabled (true/false) |
%practicebot_play_sounds% |
Sounds enabled (true/false) |
Requirements: PlaceholderAPI must be installed and features.placeholderapi: true in config.yml.
📥 Installation
Getting started is easy!
📋 Requirements
| Requirement | Version |
|---|---|
| Minecraft | 1.21.x – 26.x |
| Server Software | Paper, Spigot, Purpur, or Folia |
| Java | 21+ |
| Dependencies | None |
Optional integrations:
- PlaceholderAPI
- Vault
- WorldGuard (region-based bot spawn control)
- Citizens (soft-depend)
🚀 Installation Steps
- 📦 Download the latest version of PracticeBotPvP.
- 📂 Place the
.jarfile inside your server'splugins/folder. - 🔄 Restart your server.
- ⚙️ Configure the plugin in
plugins/PracticeBotPvP/config.ymlanddifficulties.yml. - 🎉 Use
/bot spawnto get started!
🆘 Support & Bug Reports
Need help, found a bug, or have a suggestion?
Join the GetUrPlugins Discord community!
🐛 Bug Reports – Report bugs and unexpected behavior.
💬 Support – Get help with installation and configuration.
💡 Suggestions – Share ideas for future improvements.
📢 Announcements – Stay informed about updates and releases.
⚠️ Please include your Minecraft version, server software, and relevant error logs when reporting an issue.
📜 Credits & License
Developed by: GetUrPlugins
License: All Rights Reserved (ARR).
© GetUrPlugins. All rights reserved.
❌ Unauthorized redistribution or resale is prohibited.
❌ Modification, decompilation, or republishing is prohibited without explicit permission.
✅ Usage is permitted under the conditions set by the author.
See https://gcl.onl/licenses/arr for the full license terms.
Made with ❤️ by GetUrPlugins
🤖 PracticeBotPvP – Train harder. Fight smarter.


