BXBot

BXBot – Advanced Player Bot Plugin
BXBot is a Minecraft plugin designed to let server administrators create and manage player-like bots directly inside their Minecraft server. Unlike traditional NPC plugins, BXBot aims to add bots to the server's internal player system, allowing them to appear in the player list and trigger player join and quit events.

Built for Minecraft server owners who want more control over their server environment, BXBot provides a variety of commands for creating, managing, customizing, and interacting with bots.

✨ Features

• Player-Like Bots: Create bots designed to behave like real players rather than traditional NPCs.
  
  
• Custom Bot Names: Choose a name for each bot when creating it.
  
  
• Skin Customization: Apply player skins using skin names retrieved from Mojang.
  
  
• Bot Teleportation: Teleport yourself to a bot or bring a bot directly to your location.
  
  
• Bot Chat: Make bots send custom messages in chat.
  
  
• Command Execution: Execute server commands through a selected bot.
  
  
• Crouching and Movement Utilities: Access additional bot interaction commands.
  
  
• Game Mode Management: Change a bot's game mode.
  
  
• Bot Management: List existing bots, remove individual bots, or remove all bots at once.
  
  
• Persistent Storage: Bot information is saved in bots.yml so the plugin can restore bots after a server restart.
  
  
• Configurable Settings: Manage plugin behavior, including bot persistence and join/quit message visibility.
  
  
• Permission-Based Access: Restrict bot management commands to authorized administrators.
  

Commands
Command Description
/bot create <name> [skin] Create a bot with an optional skin
/bot delete <name> Delete a specific bot
/bot skin <name> <skin> Change a bot's skin
/bot teleport <name> Teleport yourself to a bot
/bot bring <name> Teleport a bot to you
/bot list Display all existing bots
/bot removeall Remove all bots
/bot chat <name> <message> Make a bot send a message
/bot command <name> <command> Execute a command through a bot
/bot crouch <name> Make a bot crouch
/bot look <name> Adjust a bot's looking direction
/bot zip <name> Access the additional bot utility
/bot mode <name> <gamemode> Change a bot's game mode
/bot reload Reload the plugin configuration
/bot help Display available commands
Some commands may depend on the implementation and server version. The commands above use English equivalents of the plugin's Turkish command names.

Permissions

• bxbot.admin — Grants access to bot management commands.
  
  
• Default access: Operators (OP).
  

⚙️ Configuration and Storage
BXBot uses configuration files to manage its settings and bot data.

• config.yml — Configure plugin behavior and message visibility.
  
  
• bots.yml — Store bot information for restoration after server restarts.
  

These files allow server administrators to customize the plugin without manually editing its source code.

️ Minecraft Version Compatibility
BXBot is designed with compatibility in mind for Minecraft 1.16.5 through 26.3, targeting Paper and Spigot servers.

Because Minecraft's internal server code (NMS) changes between versions, the plugin uses reflection-based techniques and separate compatibility paths for different server versions.

Important: Compatibility across all listed versions has not yet been verified through compilation and live server testing. Some bot behaviors, particularly movement and ticking, may vary depending on the Minecraft version and server software.

Installation

1. Download or build the BXBot source code.
   
   
2. Extract BXBot-kaynak.zip.
   
   
3. Open a terminal in the project directory.
   
   
4. Run mvn package to compile the plugin.
   
   
5. Locate BXBot-1.0.0.jar in the target directory.
   
   
6. Place the JAR file inside your server's plugins folder.
   
   
7. Restart your server and configure the plugin as needed.
   

Requirements: A compatible Java development environment, Maven, and a supported Minecraft server.

⚠️ Important Notes
BXBot is intended for server administration and testing. Although it aims to register bots within the server's internal player system, it is not a conventional NPC plugin, and successful behavior depends on the underlying server implementation.

The source code has not yet been compiled or tested on a live server. Certain features may require adjustments for specific Minecraft versions. If a bot fails to spawn or a command does not work correctly, check the server console for errors and use them to identify the necessary compatibility fixes.

Why Choose BXBot?
BXBot brings bot creation, player-like server integration, skin customization, teleportation, chat interaction, and persistent storage together in one plugin. Its command-based management system gives administrators a convenient way to experiment with bots and customize their server environment.

BXBot — Create, customize, and manage your Minecraft bots.