PvP Train Bot

# ⚔️ TrainBot — PvP Training Bot **TrainBot** lets players spawn a fully customizable PvP training dummy directly in-game. Configure armor, totems, movement, shield behavior and more — all through a clean GUI, no commands needed. <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/kaluuv5oqF0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> --- ## 🎮 Features ### 🛡️ Armor Configuration - Switch between **Diamond** and **Netherite** for each armor piece individually - Toggle between **Protection IV** and **Blast Protection IV** per piece - Changes apply to the bot instantly ### 💀 Totem System - Set an exact number of totems the bot can pop before dying - Or set it to **Unlimited** — the bot will always come back - Totem count is shown live in the GUI ### 🛡️ Shield Blocking - The bot actually **holds and uses** its shield (real blocking pose via NMS) - Hitting the bot with an **axe** breaks the shield for **5 seconds** - Shield blocking sound and knockback cancellation — just like a real player - Toggle the shield on/off anytime ### 🏃 Movement Modes - **Following** — the bot tracks you and keeps a 2-block distance - **Random Movement** — the bot walks around unpredictably like a mob - Both modes include automatic block-jumping - Modes are mutually exclusive and toggleable mid-fight ### ✨ Effects - **Slow Falling** — reduces fall speed - **Glowing** — visible through walls for better tracking - **Fire Resistance** — immune to fire and lava ### 🔧 Fully Configurable - Every **message** and **GUI text** is editable in `config.yml` - Supports **&-color codes** and **formatting codes** (`&l`, `&o`, etc.) - Restrict the plugin to specific **worlds** — with a bypass permission for admins - Config reloads cleanly without restart ### 🌍 World Restrictions - Define a list of allowed worlds in `config.yml` - Players without the bypass permission cannot use `/train` or `/bot` outside allowed worlds - Leave the list empty to allow the bot everywhere --- ## 📋 Commands | Command | Description | |---------|-------------| | `/train` | Opens the TrainBot GUI | | `/bot` | Alias for `/train` | --- ## 🔑 Permissions | Permission | Description | Default | |------------|-------------|---------| | `trainbot.use` | Allows using `/train` and `/bot` | `op` | | `trainbot.bypass-world` | Allows using TrainBot in any world | `false` | --- ## 🤖 Bot Behavior - The bot **despawns automatically** when you log out - The bot **drops nothing** when it dies - The bot uses a **player skin** (your own skin by default) - All settings are saved **per player** for the session --- ## ⚙️ Configuration ```yaml # Worlds where /train and /bot are allowed (empty = everywhere) allowed-worlds: - world - world_nether messages: wrong-world: "&cYou cannot use the TrainBot in this world." # ... all messages fully editable gui: title: "&cTrainBot" shield-name: "Shield Blocking" shield-desc: "&7Allows the bot to block attacks with a shield." # ... every GUI label and description editable ``` --- ## 📦 Requirements - **Paper** 1.21.9+ - Java 21+ - (https://ci.citizensnpcs.co/job/citizens2/) *Optional* --- ## 🐛 Bug Reports & Suggestions Found a bug or have a feature request? Open an issue on the project page or join the Discord. --- *Made with ❤️ by oafachBene*