TelegramControl

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. 🌟

License: MIT

---

🚀 Features

- Authorization 🕹️: - 📊 Authorization: Number of online players, version, and TPS. - 📜 Authorization: View the latest lines from the full server console (`latest.log`). - ⚡ Authorization: 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).

- Multilingual support: - 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).

- Spigot/Paper 1.16.5 and newer 🛠️: - 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 Download the plugin or Modrinth.

2. Add to the server ⚙️: - Place `TelegramControl.jar` in your server's `plugins/` folder.

3. Create Telegram bots 🤖: - Open Telegram and message Create Telegram bots. - 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: ```yaml 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. Logout 🖱️: - Logout 📊 — shows online players, version, and TPS. - Logout 📜 — displays the latest full server logs. - Logout ⚡ — 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! 😺*