UltimateBot 2.0.1

ULTIMATEBOT
The Ultimate PvP Training Bot for Modern Networks

UltimateBot is a premium, multi-version plugin that completely transforms your Minecraft server into a professional and highly realistic PvP training arena. Forget about simple static dummies that just stand still and take damage. This plugin introduces highly evolved, AI-driven fake-player bots designed to give your community the most authentic and challenging combat experience possible.

Built from the ground up to be modern, perfectly extensible, and deeply optimized, UltimateBot is the definitive solution for practice servers, SMPs, and massive networks looking to elevate their combat mechanics and offer a top-tier feature to their players.

Our custom combat AI relies on a highly advanced state machine that continuously evaluates the flow of the battle in real time. The bots do not just spam clicks; they behave like real, experienced human players.

1. Dynamic Combat States: Bots seamlessly switch between aggressive pushes, defensive maneuvering, tactical repositioning, and strategic retreats when overwhelmed.
2. Modern PvP Controllers: Native and flawless handling of Crystal PvP setups, Respawn Anchor mechanics, and Mace combat capabilities on the latest Minecraft versions.
3. Smart Recovery & Healing: Bots automatically manage their own healing, intelligently track and use Totems of Undying, and calculate precise Ender Pearl throws to close the gap or escape dangerous situations.
4. Safe Repositioning: Advanced logic for recovery teleports and finding safe ground, ensuring the bot always maintains a tactical advantage during the fight.

UltimateBot adapts to any gameplay scenario with four completely distinct and deeply customizable modes. Whether you need a private sparring partner or a server-wide boss, we have you covered:

1. SINGLE: A personal training bot assigned to a single player. This is the absolute best mode for intense 1v1 practice arenas or private duels.
2. EVENT: A global arena bot featuring dynamic targeting. Perfect for hosting server-wide boss fights, free-for-all warzones, or public community events.
3. ALLY: A loyal, defensive companion that follows a single owner and fiercely protects them against any incoming attackers.
4. TEAM ALLY: A shared defensive companion specifically designed for groups, clans, or factions. It features built-in team management commands to seamlessly share ownership and protection among multiple players.

Offer the perfect challenge for every single player, from beginners to PvP veterans. You can instantly choose between five distinct tiers: EASY, NORMAL, MEDIUM, HARD, and GOD.

These are not just visual labels or basic health multipliers. The difficulty setting actively modifies real, under-the-hood behavioral parameters:

1. Attack Precision: Alters hit timings, CPS, and overall attack speed.
2. Reach Distance: Adjusts combat reach and optimal targeting distances based on the tier.
3. Defensive Thresholds: Changes the exact damage limits required to trigger defensive reactions and retreats.
4. Reaction Time: Modifies the environment scanning frequency and how fast the bot acquires new targets.

Manage everything instantly without forcing your players or admins to type complex commands. The clean, InvUI-powered interface is divided into dedicated, easy-to-navigate tabs:

1. Kit Room: Quickly configure custom armor sets, weapons, offhand items, and adjust blast protection levels.
2. Combat Settings: Toggle Totems of Undying, manage follow modes, and enable or disable aggressive combat states on the fly.
3. Bot Control: Instantly spawn, despawn, or teleport bots directly to your location with a single click.
4. Targets & Owners: Dynamically manage who the bot is allowed to attack and who it must protect in real time.

UltimateBot features a highly optimized, multi-version NMS architecture and offers full native Folia support to handle the most demanding server environments without lag.

It utilizes a powerful NMS boot scanner with detailed verification of materials, packets, and reflection for your specific version. Advanced features like offhand mechanics, totems, and modern items are managed via runtime capability checks, ensuring everything works flawlessly on the latest Minecraft updates without breaking legacy setups.

Built for professionals, UltimateBot features a massive suite of tools for developers and large networks looking to fully automate their infrastructure:

1. Remote API & Java SDK: A robust, token-authenticated remote endpoint allows you to spawn, update, remove, and monitor bots directly from external web panels, dashboards, or CI tools. It even includes a remote SSE EventBus.
2. Public API: Access the UltimateBotAPI, UltimateBotReadyEvent, and a strictly typed EventBus for custom plugin integrations covering lifecycle, combat, state, and action events.
3. Professional Boot Logging: Features a phased diagnostic logger, NMS compatibility scanning, config reporting, and module initialization timing for smooth and predictable maintenance.

UltimateBot seamlessly integrates with your existing server ecosystem to provide maximum control:

1. Soft-Dependencies: Full support for WorldGuard and LuckPerms out of the box to protect your regions and manage access safely.
2. PlaceholderAPI: Extensive support with the identifier %UltimateBot_key%. Available keys include armor, combat, combat_state, difficulty, distance, follow, healing, health, health_bar, health_percentage, location, online_time, status, and totems.
3. Deep Configuration: Highly customizable configuration files featuring dedicated sections for performance caches, world protection, blocked worlds, bot limits, naming, and specific behavior overrides.

Player & Admin Commands:

1. /bot — Open the Single bot GUI
2. /botevent — Open the Event bot GUI
3. /botally — Open the Ally bot GUI
4. /botteamally — Open the Team Ally GUI
5. /botteamally create (owner 1) (owner 2) — Create a shared team ally
6. /botteamally addowners (player 1) (player 2) — Add owners to an existing team ally
7. /botteamally removeowners (player 1) (player 2) — Remove owners from a team ally
8. /ultimatebotreload config | bot | maps | all — Perform a safe runtime reload and cleanup

Permissions:

1. ultimatebot.bot.use (Default: true) — Grants access to Single, Ally, and Team Ally GUIs
2. admin.host.bot (Default: op) — Grants access to the global Event bots
3. ultimatebot.admin.use (Default: op) — Grants access to the admin reload commands