🤖 Minecraft AFK Bot (Mineflayer-Based)

This is a lightweight Minecraft Java AFK Bot powered by Mineflayer. It connects to a Java server, performs basic movements to avoid AFK detection, and can be customized via a simple configuration file.

⚠️ Warning Before You Begin

• Before starting the bot, please make sure that the Offline Mode (Pirated/Not Original) option in the settings section of your Aternos server is active.

• Secure the bot to protect it from monsters in the game.

✨ Features

• Connect to Minecraft Java servers (IP + port)
• Customize bot username
• Control chunk loading and memory usage
• Periodic chunk pruning to reduce resource usage
• Auto-movement behavior: step forward/backward, jump, sneak, loop
• Easy configuration via config.json

⚡ Installation

1. Clone the repository

git clone https://github.com/nuekkis/Minecraft-AFK-Bot.git
cd Minecraft-AFK-Bot

2. Install dependencies

npm install

3. Configure config.json

{
  "serverHost": "yourserver.aternos.me",
  "serverPort": 25565,
  "botUsername": "MyBotName",
  "botChunk": 4
}

⚠️ Make sure the server is in offline mode if you're not using premium accounts.

🤖 Starting the Bot

node bot.js

On successful connection:

• You'll see ✅ BotName is Ready! in the console
• After 5 seconds, all loaded chunks are cleared
• Every 20 seconds, any chunks beyond a 6-chunk radius will be removed

⚙️ Configuration Options (config.json)

⚠️ Notes

• Skins: Skins might not appear properly if the server is in offline mode.
• Sneak Movement: The bot uses setControlState('sneak', true), but some servers may block or ignore this action.
• AFK Prevention: The bot periodically moves, sneaks, and jumps to prevent disconnection due to inactivity.

📚 Resources & Contributions

• Mineflayer Docs
• PrismarineJS GitHub

Feel free to contribute by opening a pull request or submitting an issue.

📄 License

This project is licensed under the MIT License.

Get started now and keep your server active with a smart, customizable bot! ⛏️