Skip to content

nishadayush0001-max/Minecraft-AFK-Bot

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27,727 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– 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)

Key Description
serverHost IP or domain of your Minecraft server
serverPort Server port (default is 25565)
botUsername The bot's visible name in-game
botChunk Radius of loaded chunks (recommended: 1–6)

⚠️ 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

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! ⛏️

About

πŸ€– An AFK bot that moves on-site to keep Aternos servers open 24/7. Not only for Aternos but also applies for different services.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 100.0%