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

Requirement	Version
Minecraft Server	Spigot/Paper 1.16.5+
Java	17 or higher (Java 21 recommended for newer MC versions)
Dependencies	Spigot API, TelegramBots library

---

🛠️ 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! 😺