# TelegramControl \ud83c\udfae\ud83d\udd25<\/p>\n
**TelegramControl** is a \ud83d\udca5 powerful plugin for managing your Minecraft server (Spigot\/Paper) via Telegram! \ud83d\ude3a
\nCheck online status, execute commands, read console logs \u2014 all in just a couple of clicks!
\nThe plugin is perfect for beginners and experienced admins, with simple setup and awesome features. \ud83c\udf1f<\/p>\n
\n
\n<\/p>\n
—<\/p>\n
## \ud83d\ude80 Features<\/p>\n
– **Server Control** \ud83d\udd79\ufe0f:
\n – \ud83d\udcca **Server Status**: Number of online players, version, and TPS.
\n – \ud83d\udcdc **Console Logs**: View the latest lines from the full server console (`latest.log`).
\n – \u26a1 **Commands**: Execute any server command with accurate output capture (including asynchronous commands like `\/lp editor`).
\n – \ud83d\udd11 **Authorization**: Secure login with username and password.<\/p>\n
– **Logging** \ud83d\udcdd:
\n – All actions (login, logout, commands, status\/logs requests) are logged to the console with timestamp and Chat ID.<\/p>\n
– **Security** \ud83d\udd12:
\n – Protection via login and password (configurable in `config.yml`).
\n – Forbidden commands list (`stop`, `reload`, `op`, `deop` and any custom commands).<\/p>\n
– **Convenience**:
\n – Clean inline keyboard with buttons: Server Status, Console, Command, Logout.
\n – **Multilingual support**: English and Russian out of the box (`language: en` or `ru` in config.yml).
\n – Optional separate bot for plugin startup notifications.<\/p>\n
– **Admin Tools**:
\n – In-game command `\/tgcontrol reload` \u2014 safely reloads config and language without restarting bots.
\n – Permission: `tgcontrol.reload` (default: op).<\/p>\n
– **Compatibility** \ud83d\udee0\ufe0f:
\n – Fully compatible with **Spigot\/Paper 1.16.5 and newer** (recommended: Paper or Purpur).
\n – Works on all modern Minecraft versions up to the latest (including 1.21+).<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
| Requirement | Version |
\n|———————-|———————————-|
\n| Minecraft Server | Spigot\/Paper 1.16.5+ |
\n| Java | 17 or higher (Java 21 recommended for newer MC versions) |
\n| Dependencies | Spigot API, TelegramBots library |<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Installation<\/p>\n
1. **Download the plugin** \ud83d\udce5:
\n – Get the latest version from GitHub Releases or Modrinth.<\/p>\n
2. **Add to the server** \u2699\ufe0f:
\n – Place `TelegramControl.jar` in your server’s `plugins\/` folder.<\/p>\n
3. **Create Telegram bots** \ud83e\udd16:
\n – Open Telegram and message @BotFather.
\n – Use `\/newbot` to create your control bot and get the token.
\n – (Optional) Create a second bot for startup notifications.<\/p>\n
4. **Configure `config.yml`** \ud83d\udcdd:
\n – The file is generated on first launch in `plugins\/TelegramControl\/`.
\n – Edit it:
\n “`yaml
\n language: en # en or ru<\/p>\n
bot:
\n token: “YOUR_BOT_TOKEN_HERE” # Main control bot token
\n username: “YourBotUsername” # Bot username without @ (e.g., MyControlBot)<\/p>\n
auth:
\n login: “admin” # Login
\n password: “securepassword” # Password (change it!)<\/p>\n
forbidden_commands:
\n – “stop”
\n – “reload”
\n – “op”
\n – “deop”<\/p>\n
log_lines: 20 # Number of console lines to show <\/p>\n
5. **Restart the server** \ud83d\udd04:
\n – Restart the server, and the bots will start automatically!<\/p>\n
—<\/p>\n
## \ud83c\udf89 How to Use<\/p>\n
1. **Authorization** \ud83d\udd11:
\n – Message your ControlBot and send `\/login`.
\n – Enter the login and password from `config.yml`.
\n – You will receive a handy keyboard with controls.<\/p>\n
2. **Commands** \ud83d\uddb1\ufe0f:
\n – **Server Status** \ud83d\udcca \u2014 shows online players, version, and TPS.
\n – **Console** \ud83d\udcdc \u2014 displays the latest full server logs.
\n – **Command** \u26a1 \u2014 enter any command (output is captured cleanly after 3 seconds).
\n – **Logout** \ud83d\udeaa \u2014 ends the session.<\/p>\n
You can also send commands directly (starting with `\/`).<\/p>\n
3. **Reload plugin config**:
\n – In-game command: `\/tgcontrol reload` (requires `tgcontrol.reload` permission).<\/p>\n
—<\/p>\n
## \ud83d\udcdc License<\/p>\n
[MIT License](LICENSE) \u2014 use, modify, share! \ud83d\ude0e<\/p>\n
## \u2753 Need Help?<\/p>\n
– Create an Issue on GitHub.
\n– Ask on SpigotMC or Modrinth once published.<\/p>\n
—<\/p>\n
## \ud83d\ude4c Credits<\/p>\n
– SpigotMC for the awesome API! \ud83d\udee0\ufe0f
\n– TelegramBots for seamless Telegram integration. \ud83d\udce9
\n– Everyone who uses TelegramControl! \u2764\ufe0f<\/p>\n
—<\/p>\n
**Made with \ud83d\udc96 by Neon4ick**
\n*Manage your server with pleasure \u2014 anywhere, anytime! \ud83d\ude3a*<\/p>\n","protected":false},"excerpt":{"rendered":"
TelegramControl is a powerful plugin for managing your Minecraft server (Spigot\/Paper) via Telegram!<\/p>\n","protected":false},"featured_media":152776,"template":"","meta":{"_minecraft_slug":"telegramcontrol","_minecraft_project_id":"ddInRswZ","_minecraft_author":"Neon4icks","_minecraft_license":"MIT","_minecraft_downloads":23,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"telegramcontrol.zip","_minecraft_size_bytes":11011153,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:23:46.970322Z","_minecraft_date_created":"2026-01-05T21:36:32.880029Z","_minecraft_date_modified":"2025-12-31T14:15:27.344617Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/telegramcontrol","_minecraft_icon_attachment_id":152776,"_minecraft_imported_at":"2026-06-09T05:53:03+00:00","_minecraft_import_hash":"4a40391bc0bcedfe882818dbe77b3441","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,123,92],"mod_loader":[132,133],"minecraft_version":[118,49,51,54,59,62],"class_list":["post-152775","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-16","minecraft_version-1-17","minecraft_version-1-18","minecraft_version-1-19","minecraft_version-1-20","minecraft_version-1-21"],"yoast_head":"\n