PracticeBotPvP

** 🤖 PracticeBotPlus - Complete Plugin Overview 📋 Executive Summary **PracticeBotPlus** is a cutting-edge PvP practice plugin for Minecraft Paper/Spigot servers (1.21.1-1.21.4) that spawns intelligent AI zombies to help players improve their combat skills. Unlike basic target dummies, PracticeBotPlus implements authentic Minecraft combat mechanics including critical hits, sprint combos, W-tapping, and player-like movement patterns—all controlled by a sophisticated difficulty system ranging from beginner-friendly to frame-perfect execution. At a Glance - **Type**: PvP Practice / Combat Training - **Platform**: Paper 1.21.1 - 1.21.11 - **Java Version**: 21+ - **Dependencies**: None (optional: PlaceholderAPI, Vault, WorldGuard) - **License**: All Rights Reserved - **Performance**: ~5MB per bot, minimal server impact --- 🎯 What is PracticeBotPlus? The Problem It Solves Most Minecraft PvP servers face common challenges: - Players need practice partners but may not have opponents available - New players struggle to learn combat mechanics - Skilled players want consistent training without human variability - Practice arenas require other players to be online - Target dummies don't simulate real combat behavior The Solution PracticeBotPlus creates **intelligent AI practice partners** that: - ✅ Simulate real player combat behavior - ✅ Scale from beginner to expert difficulty - ✅ Work 24/7 without needing other players - ✅ Provide consistent, repeatable practice - ✅ Teach proper PvP techniques through authentic mechanics - ✅ Adapt to each player's skill level and preferences --- ✨ Core Features 🎮 1. Authentic Combat Mechanics True Vanilla Critical Hits ``` How It Works: 1. Bot detects crit opportunity (based on difficulty) 2. Bot jumps (Y velocity = 0.42, same as player) 3. Bot waits ~7 ticks to reach falling state 4. Bot attacks while falling = TRUE CRITICAL HIT 5. 1.5x damage multiplier applied (vanilla formula) ``` **Validates ALL 8 vanilla conditions:** - ✅ Entity must be falling (negative Y velocity) - ✅ Fall distance > 0 - ✅ Not on ground - ✅ Not in water - ✅ Not climbing ladder/vine - ✅ No blindness effect - ✅ Not in vehicle - ✅ No levitation/slow falling effects Sprint Combo System (W-Tapping) ``` Tick-Perfect Sequence: Tick 0: Start sprint Tick 0: Attack target (with sprint knockback bonus) Tick 1: Stop sprint (W-tap reset) Tick 3: Ready for next attack ``` **Benefits:** - Teaches proper W-tap timing - Realistic knockback mechanics - Sprint reset for consecutive combos - Difficulty-based accuracy (10% to 100%) --- 🧠 2. Intelligent AI System State-Based Behavior Machine ``` AI States: IDLE → Bot waiting for engagement ENGAGING → Moving to optimal range ATTACKING → Executing attack sequence JUMPING → Mid-air for critical hit FALLING → Crit window active DODGING → Evasive maneuvers (low health) STRAFING → Circling target ``` Movement Patterns **Circle Strafing:** ``` Behavior: • Maintains 3-3.5 block distance • Circles clockwise/counterclockwise • Adjusts radius dynamically • Frequency: 30% (Easy) to 100% (Hacker) ``` **Zigzag Strafing:** ``` Behavior: • Moves left-right-left pattern • Random direction changes • Keeps player in front • Unpredictable timing ``` **Natural Movement:** ``` Behavior: • Random jumps every 20-60 ticks • Sprint when chasing (>4 blocks) • Walk in optimal range • Back up when too close (<2 blocks) • Evasive dodging at low health ``` --- 🎚️ 3. Difficulty System (The Accuracy Engine) How It Works Each difficulty level controls **accuracy percentages** for every bot action: | Difficulty | Crit % | Combo % | Strafe % | Reaction Speed | Description | |------------|--------|---------|----------|----------------|-------------| | **EASY** | 10% | 10% | 30% | 1.5x slower | Rarely uses advanced techniques. Perfect for beginners learning basic mechanics. | | **MEDIUM** | 40% | 50% | 60% | Normal | Balanced difficulty. Uses techniques half the time. Good for intermediate practice. | | **HARD** | 80% | 90% | 85% | 2x faster | Highly skilled. Almost always optimal. Challenges experienced players. | | **HACKER** | 100% | 100% | 100% | 3x faster | Frame-perfect execution. Always crits, always combos. For masochists. | Difficulty Impact Examples **Easy Bot:** ``` Combat Pattern (10 attacks): • 1 critical hit (10%) • 1 sprint combo (10%) • 8 basic attacks • Slow reactions (1.5x delay) • Minimal strafing (30% of time) Result: Predictable, forgiving practice ``` **Hacker Bot:** ``` Combat Pattern (10 attacks): • 10 critical hits (100%) • 10 sprint combos (100%) • 0 basic attacks (all optimized) • Instant reactions (0.3x delay) • Constant strafing (100% of time) Result: Brutal, unforgiving training ``` --- 👕 4. Equipment System Loadout Presets (7 Built-In) **Leather Set:** ```yaml Armor: Leather (full set) Weapon: Stone Sword Shield: Yes Defense: Low Best For: Early game practice ``` **Iron Set (Default):** ```yaml Armor: Iro