TelegramControl

Minecraft 版本： 1.16 1.17 1.18 1.19 1.20 1.21

平台： paper purpur

标签： management technology utility

TelegramControl ??

TelegramControl is a ? powerful plugin for managing your Minecraft server (Spigot/Paper) via Telegram! ?
Check online status, execute commands, read console logs — all in just a couple of clicks!
The plugin is perfect for beginners and experienced admins, with simple setup and awesome features. ?

? Features

• Server Control ?️:

  • ? Server Status: Number of online players, version, and TPS.
  • ? Console Logs: View the latest lines from the full server console (latest.log).
  • ⚡ Commands: Execute any server command with accurate output capture (including asynchronous commands like /lp editor).
  • ? Authorization: Secure login with username and password.

• Logging ?:

  • All actions (login, logout, commands, status/logs requests) are logged to the console with timestamp and Chat ID.

• Security ?:

  • Protection via login and password (configurable in config.yml).
  • Forbidden commands list (stop, reload, op, deop and any custom commands).

• Convenience:

  • Clean inline keyboard with buttons: Server Status, Console, Command, Logout.
  • Multilingual support: English and Russian out of the box (language: en or ru in config.yml).
  • Optional separate bot for plugin startup notifications.

• Admin Tools:

  • In-game command /tgcontrol reload — safely reloads config and language without restarting bots.
  • Permission: tgcontrol.reload (default: op).

• Compatibility ?️:

  • Fully compatible with Spigot/Paper 1.16.5 and newer (recommended: Paper or Purpur).
  • Works on all modern Minecraft versions up to the latest (including 1.21+).

? Requirements

?️ Installation

1. Download the plugin ?:

   • Get the latest version from GitHub Releases or Modrinth.

2. Add to the server ⚙️:

   • Place TelegramControl.jar in your server's plugins/ folder.

3. Create Telegram bots ?:

   • Open Telegram and message @BotFather.
   • Use /newbot to create your control bot and get the token.
   • (Optional) Create a second bot for startup notifications.

4. Configure config.yml ?:

   • The file is generated on first launch in plugins/TelegramControl/.

   • Edit it:

     
     language: en  # en or ru
     
     bot:
       token: "YOUR_BOT_TOKEN_HERE"       # Main control bot token
       username: "YourBotUsername"        # Bot username without @ (e.g., MyControlBot)
     
     auth:
       login: "admin"                     # Login
       password: "securepassword"         # Password (change it!)
     
     forbidden_commands:
       - "stop"
       - "reload"
       - "op"
       - "deop"
     
     log_lines: 20                        # Number of console lines to show 

5. Restart the server ?:

   • Restart the server, and the bots will start automatically!

? How to Use

1. Authorization ?:

   • Message your ControlBot and send /login.
   • Enter the login and password from config.yml.
   • You will receive a handy keyboard with controls.

2. Commands ?️:

   • Server Status ? — shows online players, version, and TPS.
   • Console ? — displays the latest full server logs.
   • Command ⚡ — enter any command (output is captured cleanly after 3 seconds).
   • Logout ? — ends the session.

   You can also send commands directly (starting with /).

3. Reload plugin config:

   • In-game command: /tgcontrol reload (requires tgcontrol.reload permission).

? License

MIT License — use, modify, share! ?

❓ Need Help?

• Create an Issue on GitHub.
• Ask on SpigotMC or Modrinth once published.

? Credits

• SpigotMC for the awesome API! ?️
• TelegramBots for seamless Telegram integration. ?
• Everyone who uses TelegramControl! ❤️

Made with ? by Neon4ick
Manage your server with pleasure — anywhere, anytime! ?