RankedBot is a highly customizable practice utility designed for Competitive PvP (CPvP) training on modern Paper servers. It allows players to spawn an advanced NPC bot to practice crystal placement, anchor charges, timing sequences, and positioning tactics in a fully controlled sandbox environment.

Dependencies:

• Citizens 2 » https://ci.citizensnpcs.co/job/Citizens2/
• Paper » https://papermc.io/downloads/paper (Compatable forks work)

Core Features

• Customizable NPC Gear: Cycle dynamically through multiple armor tiers and weapon sets directly from an in-game GUI menu.
• Intelligent Movement & Action: Toggle follow modes, basic attack behavior, automatic shielding, and weapon properties to test defensive configurations.
• Comprehensive God Mode: Stay completely protected from environmental hazards, standard player strikes, and destructive blast radii caused by anchors, crystals, or explosive blocks.
• Persistent Traits & Effects: Apply status modifiers like Fire Resistance and Slow Falling natively to the bot, which automatically persist across lethal item configurations.
• Infinite Totems: The bot functions with an integrated resurrection protocol that replicates totem triggers infinitely without requiring inventory item refills.
• Administrative Controls: Protect server performance using built-in world blacklists via the primary configuration file to prevent usage inside restricted zones or dimensions.

Commands & Permissions

• /bot - Opens the primary management interface to control bot deployment and properties. (Requires: rankedbot.use)

Installation & Dependencies

RankedBot requires a modern Paper server running Java 21 or newer, alongside the Citizens core plugin to drive the background NPC engine. Copy the jar file directly into your plugins directory and configure world rules inside the generated configuration asset file.