Telegram Control

Control and monitor your Minecraft world over Telegram — right from your phone

📖 What is this?

A client-side Fabric mod (Minecraft 26.2, Kotlin) that hooks your game up to a Telegram bot. Get pinged when your HP drops, grab a screenshot without touching your PC, run commands or chat remotely, and keep an eye on things while you're away from the keyboard.

Fully client-side — install it on your own client and it works whether you're in singleplayer or on any server, no server-side install needed.

✨ Features

• ❤️ Low HP alert — configurable threshold and cooldown
• 💀 Death notification
• ▶️/⏹ Join/leave world notification
• 📸 /screenshot (or /ss) — screenshot of the current frame, straight to your Telegram chat
• 🎒 /invscreenshot — same, but opens your inventory first
• 📶 /status — HP, hunger, coordinates, world
• 👥 /nearby [radius] — your coordinates + every visible player within range, with name/distance/coordinates
• 🧰 /inventory (or /inv) — full inventory + armor + off-hand dump
• ✨ /effects — active potion effects
• 📡 /ping — your ping to the server
• 🛠 /f3 (or /debug) — MC version, mod count, biome, light level, memory usage, world time
• 🚧 /geofence — alert when you leave (or return to) a radius around a point
• ⚔️ /pvpalert — alert the moment another player gets within range
• 🔧 /durabilityalert — alert when your held item or armor is about to break
• ⏱ /autoscreenshot <minutes> — periodic auto-screenshot on a timer
• 🕹 /<command> — run any Minecraft command remotely, or send plain text straight to in-game chat
• 💬 Echo of in-game chat (and, optionally, server system messages) into Telegram
• 🌐 Bot replies switch between Russian and English automatically — or lock them yourself
• ⚙️ Full in-game settings screen via ModMenu — every option above, editable with a mouse, no JSON editing required (see below)

⚙️ In-game settings screen

If you have ModMenu installed, Telegram Control shows up in your mods list with a config screen covering every setting the mod has, grouped into sections:

• Connection — bot token, bound-chat status, reply language (Auto/RU/EN)
• Chat & commands — chat echo, system-message echo, remote command execution, remote chat
• Alerts — low HP threshold + cooldown, death alert, join/leave alert, durability alert + threshold
• Location — default /nearby radius, geofence (center + radius), PvP alert + radius
• Misc — auto-screenshot interval

It's a single scrollable page (mouse wheel to scroll, Save/Cancel always pinned at the bottom), so you can set up the whole mod without ever touching config/telegram-control.json by hand. Editing the JSON directly still works too — the mod hot-reloads it live either way.

🎮 Setup guide

1. Create a bot. Talk to [@BotFather] on Telegram, /newbot, grab the token it gives you.
2. Install the mod (and optionally [ModMenu] for the settings screen) and launch the game once — this generates config/telegram-control.json.
3. Paste your token in. Either:
   • open Mods → Telegram control → ⚙ in-game and paste it into the Bot token field, or
   • edit config/telegram-control.json directly:

     {
       "botToken": "123456:ABC-DEF...",
       "ownerChatId": 0
     }
     

4. Message your bot on Telegram (e.g. /start) — the mod auto-binds that chat as the owner and confirms it. Every other chat is ignored from that point on, so only you can control the bot.
5. Tune it to taste from the settings screen, or straight in the JSON — changes apply live, no restart needed.
6. Send /help to your bot any time for the full command list.

🔢 Compatibility

Fabric only. Client-side, so it doesn't need to be on the server. ModMenu is optional — only needed for the in-game settings screen, everything else works without it.

🔒 Security notes

• Never share your bot token or config/telegram-control.json — whoever has it can chat and run commands as you.
• Until ownerChatId is bound (it starts at 0), whoever messages the bot first becomes the owner. Don't publicize your bot's name until you've bound the chat yourself.

❓ FAQ

Bot isn't responding at all? Double-check the bot token in the settings screen (or config/telegram-control.json), and that you actually rejoined the world (or restarted) after adding it.

Told the bot to run a command and nothing happened? Check Command execution in the settings screen — it might be turned off.

Alerts aren't firing? Geofence and PvP alerts are off by default — enable them from the settings screen, or with their own command, e.g. /pvpalert on 50.

Screenshots failing? Make sure you're actually loaded into a world; there's nothing to capture from the main menu.

📜 License

Licensed under CC BY-NC-ND 4.0 — see LICENSE. Credit raskajanie, no commercial use, no redistributing modified versions.~~~~