Minecraft Telegram Bot

A Telegram-controlled Minecraft bot powered by Python + Aiogram + Node.js + Mineflayer.

This project lets you connect a Minecraft bot to a server and control it remotely through Telegram. It combines a Python Telegram interface with a Node.js Mineflayer bot that performs actions directly in the game world.

Features

• Connect a Minecraft bot to a server using username, host, port, and version
• Control the bot through Telegram
• Run in-game actions through Node.js + Mineflayer
• Follow players
• Mine resources automatically
• View bot status and inventory
• Stop the current action or disconnect from the server
• Use a bridge layer between Telegram logic and the Minecraft bot process

Architecture

The project is split into two main parts:

• bot/ — the Python Telegram bot, handlers, states, and bridge logic
• mc-bot/ — the Node.js Mineflayer bot that connects to the Minecraft server and performs in-game actions

This structure keeps responsibilities clean: Telegram handles the control interface, while Mineflayer handles the in-game behavior.

Tech Stack

• Python
• Aiogram
• Node.js
• Mineflayer
• Minecraft-Data
• Mineflayer-Pathfinder

Quick Start

1. Clone the repository

git clone https://github.com/your-username/Minecraft-Bot.git
cd Minecraft-Bot

2. Install Python dependencies

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Install Node.js dependencies

cd mc-bot
npm install
cd ..

4. Configure environment variables

Create a .env file in the project root and add your Telegram bot token:

TELEGRAM_BOT_TOKEN=your_telegram_bot_token

5. Run the bot

python bot/main.py

Project Structure

Minecraft-Bot/
├── bot/
│   ├── main.py
│   ├── handlers.py
│   ├── mc_bridge.py
│   ├── keyboards.py
│   └── states.py
├── mc-bot/
│   ├── bot.js
│   ├── package.json
│   └── package-lock.json
├── .env.example
├── .gitignore
├── requirements.txt
└── README.md

Purpose

This project is designed as a remote-control assistant for Minecraft through Telegram. The goal is to make bot management simple, accessible, and easy to extend for automation experiments or personal gameplay helpers.

Work In Progress

This bot is still actively being developed.

Planned improvements include:

• more stable server connections
• more in-game commands
• better navigation and target tracking
• smarter mining and world interaction
• improved Telegram controls
• better diagnostics and error logging

Notes

This project is still in active development, so some features may behave differently depending on the server, Minecraft version, or hosting environment.

It can be used as a foundation for your own Minecraft automation, assistant bot, or Telegram-controlled game integration.