TelegramSRV is a lightweight and powerful Minecraft plugin that fully integrates your server with Telegram. Manage your server, sync chat, and receive real-time notifications — all from your favorite messenger.
- Chat Sync — Messages sent in Minecraft appear in Telegram and vice versa
- Remote Server Control — Execute console commands directly from Telegram
- Player Notifications — Get alerts when players join, leave, or die
- Advancement Tracking — Receive notifications when players earn achievements
- Whitelist Management — Add or remove players from whitelist via Telegram
- Server Status — Check online players, TPS, memory usage, and uptime
- Fully Configurable — Custom commands, aliases, messages, and language
- Lightweight — Minimal performance impact on your server
- Permission Support — Role-based access control for Telegram commands
- Multi-Language — Easily translatable message files
- Download the latest
TelegramSRV.jarfrom the Releases page - Place the JAR file into your server's
plugins/folder - Start your server to generate configuration files
- Stop the server and edit
plugins/TelegramSRV/config.yml - Add your bot token and chat ID
- Restart your server — you're all set!
Create a Telegram bot via @BotFather and get your token. Then configure config.yml:
bot:
token: "YOUR_BOT_TOKEN"
chat-id: "YOUR_CHAT_ID"
settings:
chat-sync: true
notify-join: true
notify-leave: true
notify-death: true
notify-advancements: true
command-prefix: "/"
permissions:
admin-roles: ["Admin", "Owner"]
command-whitelist: ["list", "say", "status"]💡 Tip: To get your chat ID, send a message to your bot and check the server logs, or use
@getmyid_bot.
| Command | Description |
|---|---|
/telegram link <code> |
Link your Minecraft account to Telegram |
/telegram reload |
Reload plugin configuration |
/telegram help |
Show available commands |
| Command | Description |
|---|---|
/list |
Show online players |
/say <message> |
Send a message as console |
/cmd <command> |
Execute any server command |
/whitelist add <player> |
Add player to whitelist |
/whitelist remove <player> |
Remove player from whitelist |
/status |
Show server performance stats |
/uptime |
Show server uptime |
/help |
List all available commands |
| Permission | Description |
|---|---|
telegramsrv.use |
Allows linking account to Telegram |
telegramsrv.admin |
Grants access to all admin commands |
telegramsrv.whitelist |
Allows whitelist management via Telegram |
telegramsrv.execute |
Allows executing server commands via Telegram |
Found a bug or have a suggestion? Please open an issue with a clear description and steps to reproduce.
Contributions are welcome! Feel free to submit pull requests for bug fixes, improvements, or new features. Please ensure your code follows the existing style and includes appropriate tests.
This project is licensed under the MIT License — see the LICENSE file for details.
- Join our Discord for community support
- ⭐ Star this repository if you find it useful!
TelegramSRV — Your server, always in your pocket via Telegram.
Note: Replace
KreizerStYTwith your actual GitHub username and update the Discord invite link before publishing.