![pvp](https://github.com/user-attachments/assets/c578ff0c-e801-4366-9f81-861e1f53e298) > **An advanced mod for Minecraft Fabric that adds AI bots for PvP** This mod adds bots to the server with advanced combat AI, a faction system, automatic equipment, and navigation. Bots can fight players, mobs, and each other, using a variety of weapons and tactics. # [![github](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/github_64h.png)](https://github.com/Stepan1411/pvp-bot-fabric) [![jitpack](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/jitpack_64h.png) ](https://jitpack.io/#Stepan1411/pvp-bot-fabric)[![modrinth](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/modrinth_64h.png) ](https://modrinth.com/mod/pvp-bot-fabric)[![ghpages](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/documentation/ghpages_64h.png)](https://stepan1411.github.io/pvpbot-docs.html) ## 🎮 Main Features ### 🤖 Bot Management - **Bot spawn** with unique names (random name generation) - **Mass spawn** of up to 50 bots simultaneously - **Automatic restoration** of bots after a server restart - **Synchronization** of the bot list with the server ### ⚔️ Combat System - **Advanced combat AI** with various tactics - **Critical hits** when jumping - **Many weapon types**: - Melee: swords, axes - Ranged: bows, crossbows - Mace with jumping attacks (wind charges) - Crystal PVP (obsidian + crystals) - Anchor PVP (respawn anchor + glowstone) - **Auto-potions** healing, strength, speed, fire resistance - **Shield mechanics** - blocking, shield breaking, mace defense prediction ### 🛡️ Utilities and Survival - **Auto-equip** armor and weapons - **Auto-totem** offhand - **Auto-shield** on low HP - **Auto-food** - **Auto-repair** armor with Mending XP bottles - **Cobweb use** to slow enemies ### 🚶 Navigation and Movement - **Bunny hop** for faster travel - **Adjustable speed** - **Wander mode** when no target - **Retreat** on low HP - **Smart navigation** to targets - **Combat strafing** - **Path following system** ### 👥 Faction System - **Faction creation** for bots - **Hostile relations** - set factions as enemies for automatic combat - **Member Management** - add/remove bots and players - **Faction-wide commands** - attack, give items, follow paths - **Friendly Fire** toggle ### 🎒 Kit System - **Creating kits** from your inventory - **Giving kits** to bots and factions - **Saving kits** across restarts ### 🛤️ Path System - **Create paths** for bots to follow - **Add waypoints** to paths - **Loop mode** - back-and-forth or circular movement - **Walk types** - bhop, sprint, or walk - **Visual indicators** - particles showing path points and lines - **Distribute** bots evenly along a path ### 🎯 Realism - **Miss Chance** - **Mistake Chance** - attack wrong direction - **Shield Break Chance** ### 📊 Live Stats Dashboard - **Real-time bot statistics** — total spawns, kills, damage, active bots - **Live graphs** — server activity history with downsampling (500 points max) - **Top names** — most frequently spawned bot names - **All-time records** — max online servers and max active bots - **Server-Sent Events** — instant dashboard updates - **History stored in DuckDB** — efficient time-series storage, 30-day retention - **Backend** — standalone Velocity plugin with embedded HTTP server - **Dashboard URL**: [http://pvpbotstats.survivalworld.win/](http://pvpbotstats.survivalworld.win/) --- ## 📋 Commands ### Basic Commands ``` /pvpbot spawn [name] - Spawn a bot (random name if not specified) /pvpbot remove - Remove a bot /pvpbot removeall - Remove all bots /pvpbot reload - Reload all configurations ``` ### Bot Management ``` /pvpbot bot-management list - List all active bots /pvpbot bot-management inventory - Show bot's inventory /pvpbot bot-management mass-spawn - Spawn multiple bots (1-50) /pvpbot bot-management attack - Order bot to attack /pvpbot bot-management stop-attack - Stop bot from attacking ``` ### Settings ``` /pvpbot settings - Show all settings /pvpbot settings auto-armor [true/false] - Auto-equip armor /pvpbot settings auto-weapon [true/false] - Auto-equip weapons /pvpbot settings drop-armor [true/false] - Drop worse armor /pvpbot settings drop-weapon [true/false] - Drop worse weapons /pvpbot settings drop-distance <1-10> - Item pickup distance /pvpbot settings interval <1-100> - Check interval (ticks) /pvpbot settings combat [true/false] - Enable combat /pvpbot settings revenge [true/false] - Revenge mode /pvpbot settings auto-target [true/false] - Auto target search /pvpbot settings target-players [true/false] - Attack players /pvpbot settings target-mobs [true/false] - Attack mobs /pvpbot settings target-bots [true/false] - Attack other bots /pvpbot settings criticals [true/false] - Critical hits /pvpbot settings ranged [true/false] - Use bow/crossbow /pvpbot settings mace [true/false] - Use mace /pvpbot settings attack-cooldown <1-40> - Attack cooldown (ticks) /pvpbot settings melee-range <2-6> - Melee range /pvpbot settings move-speed <0.1-2.0> - Movement speed /pvpbot settings view-distance <5-128> - Target search range /pvpbot settings retreat [true/false] - Retreat when low HP /pvpbot settings auto-totem [true/false] - Auto-equip totem /pvpbot settings totem-priority [true/false] - Totem over shield /pvpbot settings auto-shield [true/false] - Auto-use shield /pvpbot settings shield-break [true/false] - Break shields with axe /pvpbot settings shield-break-chance <0-100> - Shield break chance (%) /pvpbot settings shield-hold-ticks <10-200> - Max shield hold ticks /pvpbot settings shield-raise-ticks <2-40> - Shield raise ticks /pvpbot settings shield-mace [true/false] - Raise shield vs mace /pvpbot settings prefer-sword [true/false] - Prefer sword over axe /pvpbot settings auto-eat [true/false] - Auto-eat food /pvpbot settings auto-potion [true/false] - Auto-use potions /pvpbot settings auto-mend [true/false] - Auto-repair armor /pvpbot settings bhop [true/false] - Bunny hop /pvpbot settings idle [true/false] - Wander without target /pvpbot settings idle-radius <3-50> - Wander radius /pvpbot settings friendly-fire [true/false] - Damage allies /pvpbot settings miss-chance <0-100> - Miss chance (%) /pvpbot settings mistake-chance <0-100> - Mistake chance (%) /pvpbot settings aim-speed <3-45> - Rotation speed /pvpbot settings special-names [true/false] - Use special names /pvpbot settings bot-leave-on-death [true/false] - Remove on death /pvpbot settings attack-invincible [true/false] - Attack creative/spectator /pvpbot settings safe-spawn [true/false] - Random offset on spawn /pvpbot settings clear-on-remove [true/false] - Clear inventory on kill /pvpbot settings shield-mace [true/false] - Raise shield vs mace /pvpbot settings view-distance <5-128> - Target search range /pvpbot settings max-mass-spawn <50-10000> - Max bots per mass-spawn /pvpbot settings profile-lagg-fix [true/false] - Prevent lag on bot spawn ``` ### Ranged Combat Settings ``` /pvpbot settings ranged-min-range <3.0-20.0> - Min bow distance /pvpbot settings ranged-optimal-range <10.0-50.0> - Ideal bow distance /pvpbot settings ranged-max-range <15.0-100.0> - Max bow engagement range /pvpbot settings bow-draw-ticks <5-100> - Bow full draw time /pvpbot settings arrow-prediction [true/false] - Predictive bow aiming /pvpbot settings ranged-strafe [true/false] - Strafe while shooting bow /pvpbot settings ranged-retreat [true/false] - Retreat with bow when close ``` ### Critical & Misc Settings ``` /pvpbot settings crit-fall-ticks <1-10> - Falling ticks for crit /pvpbot settings shield-hold-ticks <10-200> - Max shield hold ticks /pvpbot settings shield-raise-ticks <2-40> - Shield raise anticipation /pvpbot settings aim-speed <3.0-90.0> - Rotation speed ``` ### Faction Commands ``` /pvpbot faction list - List all factions /pvpbot faction create - Create a faction /pvpbot faction delete - Delete a faction /pvpbot faction info - Faction information /pvpbot faction add - Add player/bot /pvpbot faction remove - Remove player/bot /pvpbot faction add-near - Add nearby bots /pvpbot faction add-all - Add all bots /pvpbot faction hostile [true/false] - Set hostile /pvpbot faction attack - All bots attack /pvpbot faction give - Give item to all /pvpbot faction path start - Start path /pvpbot faction path stop - Stop path /pvpbot faction tp - Teleport entire faction gradually ``` ### Faction Kit Commands ``` /pvpbot faction kit give-kit - Give kit to all members /pvpbot faction kit give-kit-random % [ % ...] - Give random weighted kit ``` ### Kit Commands ``` /pvpbot kit create-kit - Create a kit from your inventory /pvpbot kit delete-kit - Delete a kit /pvpbot kit kits - List all kits /pvpbot kit give-kit - Give kit to a player/bot /pvpbot kit give-kit-near [radius] - Give kit to nearby bots /pvpbot kit give-kit-near-random % [ % ...] - Give random weighted kit to bots within radius ``` ### Path Commands ``` /pvpbot path create - Create a new path /pvpbot path delete - Delete a path /pvpbot path add-point - Add waypoint (current pos) /pvpbot path remove-point [index] - Remove waypoint /pvpbot path clear - Remove all waypoints /pvpbot path list - List all paths /pvpbot path info - Show path information /pvpbot path loop - Toggle loop mode /pvpbot path walk-type - Set walk type (bhop/sprint/walk) /pvpbot path show - Toggle visualization /pvpbot path start - Make bot follow path /pvpbot path stop - Stop bot from following /pvpbot path distribute - Distribute bots evenly /pvpbot path start-near - Start path for nearby bots /pvpbot path stop-all - Stop all bots on path ``` --- ## 🖼️ Screenshots - Bots in battle ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/545149264-168fd083-5157-491b-a129-fb256f351681.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=3e4c5dda543c515776400c885c7aab9b00eb35b6e3aec71b8793890947c540a6&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) - Faction system ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/545155532-a11d896f-f454-4333-a4b0-cf328ff9f437.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=769c83270d07f445aa0e26a26bb8b9100b8aea1094bf435757c43e4c08f183ee&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/545155612-06d4bf94-824d-4307-b463-bf8e4de0fd4e.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=ee9d49231c0157d69f1594a83a28cbf82b406e87818e50c80ec23c560279959f&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) - Crystal PVP in action ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/545156885-e63bb460-97e5-45f7-bc94-8db54e299222.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=8215e0877548c5e9fea4ae57ea0d1166512d9583f56aaa60e198e6080816db78&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/545156908-522a5072-5a28-4e60-abd3-53a183039a1c.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=0d88e4a8a35975b7b6761852b7c0671cc2b646da82637de6f2113574acb5f518&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) - Mass bot spawn ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/613517033-fb37dc89-0eff-45be-81f4-82edd1135076.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=58dd3271ebd7aad8f68389cbbeef10ebb3ebf7f530556d01785763b4761d74de&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) - Path system in action ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/556313885-1e609988-78b7-4261-a831-75587380b270.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=16e7edbed3dc06e3781318a60e57797cc13de07756afe0eb0d8cc27afbca9544&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) ![screenshot](https://github-production-user-asset-6210df.s3.amazonaws.com/215346748/556313982-6a2c5679-41b2-4792-bda6-fdeca4fb107c.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAVCODYLSA53PQK4ZA%2F20260802%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260802T112213Z&X-Amz-Expires=300&X-Amz-Signature=5f2b6e218216a64d4383e593f44b3cf1e82824f96fbaaa252d1d33fae761219b&X-Amz-SignedHeaders=host&response-content-type=image%2Fpng) ## 🔗 Links - **Modrinth**: https://modrinth.com/mod/pvp-bot-fabric - **GitHub**: https://github.com/Stepan1411/pvp-bot-fabric - **Issues**: https://github.com/Stepan1411/pvp-bot-fabric/issues - **Wiki**: https://stepan1411.github.io/pvpbot-docs.html - **Live Stats Dashboard**: http://pvpbotstats.survivalworld.win/ **Have a nice pvp! 🎮**

PvP BOT

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details

pvp bot banner

V3 icon

V2 icon

V1 icon