MinecraftBot | PvP Practice Bots v1.0.4

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━



━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

MINECRAFTBOT
PvP Practice Bots for Paper 1.21.x
Single, Event, Ally and Team Ally bots with real combat behavior and full in-game control.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NO CITIZENS • NO NPC FRAMEWORK • ZERO REQUIRED DEPENDENCIES
MinecraftBot is fully standalone and built on a native NMS core.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━​

Not a dummy. Not a scripted NPC. A real practice bot system.
MinecraftBot gives your server configurable PvP bots with follow logic, ally defense, event workflows, GUI control, rank scaling and developer API support.​

Click to expand...

• 4 BOT MODES IN ONE PLUGIN — single practice, event bot, ally bot and team ally bot
• REAL PvP BEHAVIOR — not just follow and hit, but combat states, healing, pearl logic and advanced positioning
• CRYSTAL PvP & ANCHOR PvP SUPPORT — dedicated controllers already built into the core
• RANK-BASED DIFFICULTY — Easy to God with actual behavior and timing changes
• CLEAN GUI WORKFLOW — configure armor, blast, totems, combat, follow and rank in-game
• TEAM OWNERSHIP SUPPORT — shared ally bot flow for multiple players
• DEVELOPER-READY API — spawn, inspect and manage bots from other plugins
• MULTI-VERSION SUPPORT — Paper 1.21.4 to 1.21.11 with packaged version bridges
• 100% STANDALONE NMS CORE — no Citizens, no NPC libraries, no required external dependencies

• Personal practice bot for one player
• Perfect for training and testing different combat setups

• Exclusive event bot mode
• Targets nearby players inside the configured range
• Blocks normal bot spawning while the event bot is active

• Protective bot for one owner
• Scans around the owner with pre-range and attack-range logic
• Watches first, then engages only when a threat gets close

• Shared bot for multiple owners
• Supports owner creation, owner add and owner remove flows
• Protects the team and ignores protected owners as attack targets

MinecraftBot is built for PvP servers that want believable pressure and movement, not just an entity that trades hits.

Click to expand...

• COMBAT STATES — aggressive, defensive, repositioning, anchor setup, crystal setup and retreating
• END CRYSTAL WORKFLOW — obsidian search, placement, scoring and crystal attack handling
• RESPAWN ANCHOR WORKFLOW — anchor placement, charging and explosion sequence
• ENDERPEARL LOGIC — aggressive gap close, reposition, escape and emergency recovery
• HEALING BEHAVIOR — healing state detection and recovery flow
• TOTEM MANAGEMENT — configurable min/max logic and live count updates
• FOLLOW / NON-FOLLOW — useful for both passive practice and active combat training

AGGRESSIVE
DEFENSIVE
REPOSITIONING
ANCHOR_SETUP
CRYSTAL_SETUP
RETREATING

EASY

NORMAL

MEDIUM

HARD

GOD

• Crystal distance windows and placement timings
• Attack cooldowns and anchor search cadence
• Prediction depth and safe distance behavior
• Scan intervals and combat reaction quality

• Armor tier per slot and per-slot blast protection
• Totem count, follow toggle, combat toggle
• Rank selection, spawn / despawn
• Bot teleport to player position

• Custom item materials, names and lore
• Custom button texts, alerts and action feedback

• 26 BUILT-IN LANGUAGES — included directly in the plugin
• RUNTIME LANGUAGE LOADING — server owners can add custom .yml language files in plugins/MinecraftBot/langs
• HOT RELOAD SUPPORT — /mcbreload all detects and loads new language files
• STRICT KEY VALIDATION — custom language files must contain all keys from default EN.yml
• SAFE FALLBACK — if a key is missing, plugin logs an error and automatically falls back to EN.yml
• CONFIG LANGUAGE SELECTOR — lang-file: "EN.yml"

Useful for networks, practice cores, duel systems, event plugins and custom server logic.

Click to expand...

• MinecraftBotAPI — singleton entrypoint
• MinecraftBotReadyEvent — safe startup integration
• IBotManager — spawn, update, removal and parsing
• IBotRegistry — live read-only snapshots
• BotSettings / BotSpawnRequest — structured bot creation
• BotSnapshot / BotOperationResult — status inspection and result handling

• Bot creation, removal by source, follow state and combat state
• Blast toggle, totem count and rank updates
• Team-ally ownership resolution
• Skin and name-template configuration

%MinecraftBot_armor%
%MinecraftBot_combat%
%MinecraftBot_combat_state%
%MinecraftBot_distance%
%MinecraftBot_follow%
%MinecraftBot_healing%
%MinecraftBot_health%
%MinecraftBot_health_bar%
%MinecraftBot_health_percentage%
%MinecraftBot_location%
%MinecraftBot_online_time%
%MinecraftBot_rank%
%MinecraftBot_status%
%MinecraftBot_totems%

/bot
/botally
/botevent
/botteamally
/botteamally create <owner1> <owner2> [owner3 ...]
/botteamally addowners <player1> [player2 ...]
/botteamally removeowners <player1> [player2 ...]
/mcbreload <config|bot|maps|all>

mcb.bot.use
admin.host.bot
mcb.admin.use

• SOFTWARE: Paper
• VERSIONS: 1.21.4 — 1.21.5 — 1.21.6 — 1.21.7 — 1.21.8 — 1.21.9 — 1.21.10 — 1.21.11
• JAVA: 21+
• PLACEHOLDERAPI: optional
• VERSION SYSTEM: packaged NMS bridges for all supported 1.21.x builds

MINECRAFTBOT REQUIRES A VALID LICENSE KEY TO RUN.
License keys are issued exclusively through our Discord server via a support ticket.
▸ JOIN OUR DISCORD SERVER​

Click to expand...

• STEP 1 — Join our Discord server
• STEP 2 — Open a ticket in the #ticket channel and select License option
• STEP 3 — Provide your BuiltByBit order ID
• STEP 4 — Receive your license key and activate it in config.yml

• License validated at server startup and via periodic heartbeat
• Each license supports a configurable number of concurrent server installations
• If the license server is temporarily unreachable, a 24-hour grace period keeps the plugin running
• Licenses can be revoked in case of violations or refunds

# config.yml
license-key: "XXXX-XXXX-XXXX-XXXX"

• Practice servers and crystal PvP servers
• Competitive event and training hubs
• Duel networks and premium donor features
• Server owners who want a bot system fully extensible by developers

• Each purchase grants a single personal license for use on your own Minecraft server(s)
• The number of concurrent active installations is limited by the plan purchased
• License keys are non-transferable and must not be shared, resold or distributed
• Attempting to bypass, crack or spoof the license system will result in permanent revocation

• Refunds are handled in accordance with BuiltByBit's refund policy
• A refund will result in immediate license revocation
• No refund will be issued for change of mind after the license key has been activated

• Updates are provided at the developer's discretion and are not guaranteed on any fixed schedule
• Major version updates may require a new purchase depending on the scope of changes
• Bug fixes and compatibility patches for supported versions are provided free of charge

• Support is provided exclusively through the official Discord server via ticket
• Support covers installation, configuration and verified bugs only
• Custom modifications, feature requests and third-party plugin conflicts are not covered
• We reserve the right to decline support to users who are abusive or violate these terms

• Redistribution, resale or public sharing of the plugin jar in any form is strictly prohibited
• Decompiling, reverse engineering or modifying the plugin for redistribution is not permitted
• Private modifications for your own server use only are allowed

• The developer is not responsible for any damage, data loss or downtime caused by use of this plugin
• The plugin is provided as-is with no warranty of fitness for a particular purpose
• It is your responsibility to test the plugin in a staging environment before deploying to production

• These terms may be updated at any time without prior notice
• Continued use of the plugin after a terms update constitutes acceptance of the new terms