MineCraft Telgram Bot

A Telegram Bot that can manage your mc server and inform you

MTB is a fast, customizable, useful telegram bot for your Minecraft server.

✨ Features (till now)

• Number of online users
• Usernames of online users
• Merging and sending pictures of online users

⚙️ Installation

MTB only and only requires Docker to run.

Install Docker and start the bot, docker takes care of other dependencies.

apt install docker-ce

Now clone the repo:

git clone https://github.com/revisto/minecraft-telegram-bot
cd minecraft-telegram-bot

Let's take care of .env files...

cp mc_bot/.env.example .env

.env file contains your minecraft server and your telegram bot data. fill it like this:

minecraft_server_ip=<IP>
minecraft_server_port=<PORT>
telegram_robot_access_token=<TELEGRAM_ACCESS_TOKEN>

Adding Pictures of Users

You can add pictures of your Minecraft server users in the users_pictures directory. Create a subdirectory for each user with their username and add their pictures there. For example:

users_pictures/revisto:
rev.jpg  another_pic.jpg

users_pictures/mehrshad:
mehrshad.jpg  photo_2024-01-31_10-31-26.jpg

The bot will automatically merge these pictures and send them when requested.

Docker

Make sure that you have done all installation steps and made .env files. then, build it and run it.

docker build -t mc_bot .
docker run -d mc_bot

🤝 Contributing

Contributions, issues and feature requests are welcome.
Feel free to check issues page if you want to contribute.

Show your support

Please ⭐️ this repository if this project helped you!

📝 License

GNUv2

Free Software, Hell Yeah!