This bot notifies a group chat, channel or private chat in Telegram of players joining or leaving your Minecraft server.
The goal of this script is to incentivise players to join their friends on your server without having to open up a website or the game itself. The script can easily be run on any webserver.
- Easily deployable script that will work on any webserver.
- Multiple events within a short time span will be merged into a single message.
- The script works with any Minecraft server, whether it's spigot or the plain Java server without the need to install any additional plugins.
- Support for multiple languages (currently English, German, Russian and Polish)
You will need a running minecraft server and php installed on it with curl and mbstring modules. To install php on ubuntu/debian machine, you can run:
sudo apt-get update
sudo apt-get install php
sudo apt-get install php-mbstring php-curlMake sure that the query property is enabled in your Minecraft server settings.
git clone https://github.com/Pechente/minecraft-telegram-bot.git
cd minecraft-telegram-botThen change the permissions of the cache file in this repo like:
chmod 755 cache
Create your Telegram Bot, save its token for later and add it to the group, super-group or channel your bot should be posting the updates to.
Login to https://web.telegram.com and open up the wanted channel or group. The id is part of the website url which is a bit different for each of the different kinds of chat types (group, channel or super group).
For Simple Groups:
Same as for channels, but way simpler. The id (in the browser url) is the last part of the url and starts also with a dash. For example:
Browser Url: https://web.telegram.org/z/#-9693613342
Your Group Id would be: -9693613342
For Super Groups:
The url-id-way won’t work as expected for «super group» chats. You will need an extra step to get to the right chat id:
- Populate the
config.phpfile with the chat id from the simple groups steps along with the other config options. - Then run
php index.phpand check the bad telegram api response info. You will then find the right chat id underparameters. - Copy the supplied chat id from the error response into your config.php and try the second step again.
The config.php holds your telegram and minecraft server configs. Copy the file from the template and change the settings:
cp config.php.sample config.php
# you can use for example nano to edit the file:
nano config.phpThe comments in the config will help you determine the right values.
To let run the script periodically you can add a script to the crontab:
- Run
crontab -e - Add a new entry like:
* * * * * cd /YOUR_REPO_LOCATION/minecraft-telegram-bot; php index.php(runs every minute)
Every time the script is called, it will compare who’s currently online to who was online the last time the cript was executed. If changes are detected, the script will dispatch a message on Telegram. It's therefore recommended to call the script in intervals using bash or a cron job / webcron. I find that an interval between 5–15 seconds works best.
ℹ️ Notice: The shorter the interval, the quicker the messages get posted. The longer the interval, the slower the bot will post updates to your chat but it will also post more events in a single message, therefore avoiding spam when multiple users join or leave within a short time frame. Figure out what works best for you.
If the bot doesn't work, just visit index.php manually on your webserver and check the output. Messages to chat will be mirrored and possible errors will be displayed alongside it. Make sure to reload it to see changes as there's no auto-reload feature on index.php itself.
This script is based on PHP Minecraft Query by xPaw, TelegramBotPHP by Eleirbag89 and was slightly updated by @Coderwelsch