Skip to content

GustyCube/minecraft-afkbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Minecraft AFK System

Minecraft Status

An AFK system for Minecraft with a user-friendly web interface. This tool helps you stay AFK in Minecraft servers with various automation features.

Features

  • 🖥️ Web-Based Dashboard - Control your AFK bot through an intuitive browser interface
  • 👤 Multiple Account Support - Add and switch between Microsoft and Mojang accounts
  • 🤖 Anti-AFK Mechanisms:
    • Automatic head movement (wiggle) to prevent AFK detection
    • Customizable chat pings to stay active on servers
  • 🔄 Auto-Reconnection - Automatically reconnects if kicked from the server
  • 💬 Chat Integration - Send and receive chat messages through the dashboard
  • ⚙️ Customizable Settings:
    • Wiggle interval and amplitude adjustments
    • Chat ping intervals and messages
    • Server connection parameters

Prerequisites

  • Node.js (v14 or newer recommended)
  • A valid Minecraft account (Microsoft or Mojang)

Installation

  1. Clone this repository:

    git clone https://github.com/GustyCube/minecraft-afk.git
    cd minecraft-afk
  2. Install dependencies:

    npm install
  3. Start the application:

    node server.js
  4. Open your browser and navigate to:

    http://localhost:3000
    

Configuration

The application creates a config.json file that stores your settings between sessions. Initial default configuration:

{
  "accounts": [
    { "username": "you@example.com", "auth": "microsoft" }
  ],
  "selectedAccount": 0,
  "host": "your.server.address",
  "port": 25565,
  "wiggleInterval": 30000,
  "wiggleAmplitude": 0.1,
  "chatPingEnabled": false,
  "chatPingInterval": 300000,
  "chatPingMessage": "afk",
  "afkRetryInterval": 5000
}

Usage

  1. Add Accounts:

    • Enter your Minecraft account email
    • Select the authentication type (Microsoft/Mojang)
    • Click "Add Account"
  2. Configure Settings:

    • Set server address and port
    • Adjust wiggle interval (in milliseconds) and amplitude
    • Enable/disable chat ping and set message
    • Click "Save & Restart" to apply changes
  3. AFK Commands:

    • Send commands via the chat input
    • The system recognizes /afk commands for re-sending after disconnections

Dependencies

License

This project is available as open source under the terms of the MIT License.

Author

Created by GustyCube


Note: Using automated clients on Minecraft servers may be against some server rules. Use responsibly and only on servers where such tools are permitted.

Last updated: 2025-04-21

About

An AFK system for Minecraft with a UI

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published