# \ud83d\udcf1 TELEGRAM BOT FOR MINECRAFT – SETUP GUIDE<\/p>\n
## \ud83c\udfaf WHAT IS THIS?
\nA plugin that allows you to manage your Minecraft server through Telegram. Players can send commands to a Telegram group, and the bot will execute them on the server.<\/p>\n
## \ud83d\ude80 QUICK INSTALLATION (5 MINUTES)
\n– Step 1: Create a bot in Telegram
\n– Open Telegram
\n– Find @BotFather
\n– Send \/newbot
\n– Choose a bot name (e.g., MyServerBot)
\n– Get the token (save it!)<\/p>\n
“`
\nToken looks like this: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
\n“`
\n1. Step 2: Add bot to group
\n1. Create a new Telegram group
\n1. Add your bot to the group
\n1. Make the bot an administrator
\n– Get the group ID:
\n– Add @getidsbot to the group
\n– Send \/start
\n– Copy the group ID (starts with -100)<\/p>\n
## Step 3: Install plugin on server
\n– Download UniversalTelegramBot.jar file
\n– Place it in your server’s plugins\/ folder
\n– Restart the server<\/p>\n
## Step 4: Configure settings
\nAfter first launch, the file plugins\/TelegramBot\/config.yml will appear<\/p>\n
Edit it:<\/p>\n
“`
\ntelegram:
\n enabled: true
\n bot-token: “PASTE_YOUR_TOKEN_HERE”
\n group-chat-id: “PASTE_YOUR_GROUP_ID_HERE”
\n“`<\/p>\n
## Step 5: Reload the plugin
\nIn-game, execute:<\/p>\n
“`
\n\/telegrambot reload
\n“`
\n## \u2699\ufe0f IN-GAME MANAGEMENT COMMANDS
\nBasic commands:<\/p>\n
“`
\n\/telegrambot status – Check bot status
\n\/telegrambot reload – Reload configuration
\n\/telegrambot test – Send test message
\n\/telegrambot list – Show all commands
\n\/telegrambot debug – Toggle debug mode
\n“`<\/p>\n
Permission management:<\/p>\n
“` ## \ud83d\udd27 CONFIGURING COMMANDS Command parameters: PLACEHOLDERS FOR COMMANDS ## \ud83d\udd10 PERMISSION SYSTEM 2. Granting permissions: ## \ud83d\udee0\ufe0f TROUBLESHOOTING Console errors: Done! Now players can manage the server through Telegram. Start with simple commands and gradually expand functionality. \ud83c\udfae<\/p>\n","protected":false},"excerpt":{"rendered":" Manage your Minecraft server via Telegram! Add custom commands with ease!<\/p>\n","protected":false},"featured_media":162571,"template":"","meta":{"_minecraft_slug":"universal-telegram-bot","_minecraft_project_id":"L5BCRHAc","_minecraft_author":"KonskoeDyplo","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":19,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"universal-telegram-bot.zip","_minecraft_size_bytes":23967,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:36:38.638349Z","_minecraft_date_created":"2026-02-10T01:37:10.596356Z","_minecraft_date_modified":"2026-02-09T10:16:13.176312Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/universal-telegram-bot","_minecraft_icon_attachment_id":162571,"_minecraft_imported_at":"2026-06-09T16:08:58+00:00","_minecraft_import_hash":"65d1f86f019efa5414660ce1a40b2ef7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,867],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-162570","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/telegrambot addperm
\n\/telegrambot removeperm
\n\/telegrambot listperms – List all permissions
\n“`
\nExample of granting permission:
\n“`
\n\/telegrambot addperm (id)123456789 telegrambot.restart
\n“`
\n## \ud83d\udcac TELEGRAM COMMANDS
\nFor all players (if configured):
\n“`
\n\/help – Show command list
\n\/fly
\n\/money
\n\/kit
\n\/online – Check online players
\n“`
\nFor admins (require permissions):
\n“`
\n\/kick
\n\/ban
\n\/restart – Restart server
\n\/give
\n“`<\/p>\n
\nCommand example:
\n“`
\ncommands:
\n fly:
\n command: “lp user %player% permission settemp essentials.fly true 60m”
\n cooldown: 86400 # 24 hours in seconds
\n eho: “Fly for 1 hour | ” # Description in \/help
\n message: “\u2705 Fly granted!” # Success message
\n error-message: “\u274c Error” # Error message
\n permission: “” # Required permission (empty = for everyone)
\n run-as-console: true # Execute as console
\n “`<\/p>\n
\n– command – command to execute on server
\n– cooldown – cooldown between uses (seconds)
\n– eho – description in \/help menu
\n– message – bot response on success
\n– error-message – response on error
\n– permission – required permission (leave empty for everyone)
\n– run-as-console – execute as console (better to keep true)<\/p>\n
\nUse in “`command“` field:
\n“`
\n%player% – Player nickname from Telegram command
\n%args% – All arguments after command
\n%user% – Telegram username
\n%user_id% – Telegram user ID
\n“`
\nExample:
\n“`
\ncommand: “eco give %player% 1000” # Will give 1000 money to player
\ncommand: “msg %player% Hello from %user%” # Will send message
\n“`<\/p>\n
\n1. How to get user ID:
\n– Ask user to send any message to group
\n– Check server logs – their ID will be there
\n– Or use @getidsbot<\/p>\n
\n“`
\n\/telegrambot addperm 123456789 telegrambot.restart
\n\/telegrambot addperm 123456789 telegrambot.ban
\n“`
\n3. Standard permissions:
\n– “`telegrambot.restart“` – restart permission
\n– “`telegrambot.ban“` – ban permission
\n– “`telegrambot.kick“` – kick permission
\n– “`telegrambot.admin“` – all permissions (for operators)<\/p>\n
\n1. Bot not responding:
\n– Check token: \/telegrambot status
\n– Check group ID
\n– Ensure bot is group administrator
\n– Enable debug: \/telegrambot debug
\n2. Commands not executing:
\n– Check server logs
\n– Ensure required plugins are installed
\n– Check command syntax in config<\/p>\n
\n“`
\n[TelegramBot] ERROR: … – check config.yml
\n[TelegramBot] WARNING: … – usually not critical
\n“`
\nUseful diagnostic commands:
\n“`
\n\/telegrambot execute say Test command # Test execution
\n\/telegrambot debug # Enable detailed logs
\n\/telegrambot reload # Reload settings
\n“`
\n## \ud83c\udf89 USEFUL TIPS
\n1. For beginners:
\n– Start with one command \/fly
\n– Test in a small group
\n– Gradually add new commands
\n2. For administrators:
\n– Create separate group for commands
\n– Assign responsible people for permissions
\n– Regularly check logs
\n3. For players:
\n– Use format: \/command player_nickname
\n– Respect cooldowns
\n– Use \/help for command list<\/p>\n