AnyServer Bots

AnyServerBots is a highly configurable, server-side Minecraft plugin that lets you spawn advanced NPC bots for both PvP practice and resource automation. Powered by the Citizens 2 API, these bots mimic player behaviors and can be customized to fit your server's needs. Whether you want to challenge players with ruthless AI combatants or deploy lumberjack workers to gather resources, AnyServerBots provides a comprehensive framework to do so.

Core Features

1. Advanced Combat AI

Combat bots are engineered to fight like real players. They do not simply walk up and hit their targets; they leverage actual Minecraft PvP strategies:

• Combat Movement: Bots will circle-strafe and space themselves dynamically during fights to throw off their targets.
• Sprint and Critical Attacks: Bots will sprint-attack to deal knockback and jump to land critical hits on their descent.
• Shield Blocking: Bots can equip and raise shields, blocking incoming attacks with configurable success rates.
• Combo System: Features a built-in combo system where bots can chain multiple attacks together, reducing their attack cooldowns and unleashing critical combo-finishers.
• Pillaring and Bridging: If a target player builds up (pillars) or bridges away, the combat bots will automatically place blocks to chase them down or cross gaps.

2. Autonomous Lumberjack Bots

Lumberjack bots automate wood harvesting tasks:

• Automatic Tree Detection: Once spawned, these bots scan the surrounding area for log blocks.
• Pathfinding and Harvesting: Bots will pathfind to nearby trees, display realistic block-breaking progress/animations, and play wood-chopping sound effects as they cut down logs.
• Intelligent Pathfinding Assistance: If a lumberjack bot gets stuck or cannot reach a log due to elevation, it will automatically place planks to pillar up or bridge across gaps to reach its destination.

3. Fully Customizable Presets

Every bot is governed by a difficulty tier (Easy, Medium, and Hard) that dynamically scales their stats. Through the configuration file, server administrators can adjust:

• Max health and attack damage.
• Attack speed (cooldown ticks).
• Movement speed.
• Shield block chance.
• Toggle abilities like strafing, critical hits, sprint-attacks, and combos.
• Set combo chains (minimum/maximum hit counts, cooldown multipliers, and critical finisher chances).

How to Use

All interaction with the plugin is handled via the /bot command. Below is the command reference guide:

Spawning Bots

• /bot spawn <combat|lumberjack> [name] Spawns a bot at your current location. If no type is specified, it defaults to a combat bot.
  • Example: /bot spawn combat Gladiator
  • Example: /bot spawn lumberjack Woody

Customizing and Equipping

• /bot equip <id> <slot> <material> Equips a specific item or piece of armor onto your bot.
  • Slots: helmet (or head), chestplate (or chest), leggings (or legs), boots (or feet), hand, offhand
  • Example: /bot equip 12 hand diamond_sword
  • Example: /bot equip 12 offhand shield
• /bot skin <id> <username> Changes the bot's skin to match the skin of any premium Minecraft player.
  • Example: /bot skin 12 gentraxyz
• /bot name <id> <new_name> Renames the bot in-game.
  • Example: /bot name 12 Tank

Adjusting Difficulty

• /bot difficulty <id> <easy|medium|hard> Changes the difficulty tier of the specified bot, updating its attributes and default equipment setup.
  • Example: /bot difficulty 12 hard

Movement Commands

• /bot follow <id> Instructs the bot to follow its owner. While following, lumberjack harvesting and combat AI are temporarily paused.
• /bot stay <id> Commands the bot to stop following and remain at its current position. This resumes normal combat or harvesting tasks in its vicinity.

Managing and Removing

• /bot list Displays a list of all your active bots, their current health, equipment slots, difficulty, type, and real-time status.
• /bot remove <id> Despawns and deletes the specified bot.
• /bot removeall Despawns all bots that you have created.
• /bot admin removeall (Admin only) Forcefully removes every active bot currently spawned on the server.

Server Permissions

Administrators can control access using the following permission nodes:

• anyserverbots.spawn: Allows spawning, listing, and removing personal bots.
• anyserverbots.equip: Allows equipping armor and weapons on bots.
• anyserverbots.difficulty: Allows changing the difficulty of bots.
• anyserverbots.name: Allows renaming bots.
• anyserverbots.skin: Allows changing bot skins.
• anyserverbots.admin: Grants access to server-wide cleanup commands and overrides ownership restrictions.

Requirements and Installation

1. Ensure your server is running a compatible Spigot/Paper environment (Minecraft 1.21 or higher).
2. Download and install the Citizens 2 plugin.
3. Drop the AnyServerBots.jar into your server's plugins folder.
4. Restart the server to generate the configuration files.