📱 TELEGRAM BOT FOR MINECRAFT - SETUP GUIDE

🎯 WHAT IS THIS?

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

🚀 QUICK INSTALLATION (5 MINUTES)

• Step 1: Create a bot in Telegram
• Open Telegram
• Find @BotFather
• Send /newbot
• Choose a bot name (e.g., MyServerBot)
• Get the token (save it!)

Token looks like this: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

1. Step 2: Add bot to group
2. Create a new Telegram group
3. Add your bot to the group
4. Make the bot an administrator

• Get the group ID:
• Add @getidsbot to the group
• Send /start
• Copy the group ID (starts with -100)

Step 3: Install plugin on server

• Download UniversalTelegramBot.jar file
• Place it in your server's plugins/ folder
• Restart the server

Step 4: Configure settings

After first launch, the file plugins/TelegramBot/config.yml will appear

Edit it:

telegram:
  enabled: true
  bot-token: "PASTE_YOUR_TOKEN_HERE"
  group-chat-id: "PASTE_YOUR_GROUP_ID_HERE"

Step 5: Reload the plugin

In-game, execute:

/telegrambot reload

⚙️ IN-GAME MANAGEMENT COMMANDS

Basic commands:

/telegrambot status          - Check bot status
/telegrambot reload          - Reload configuration
/telegrambot test            - Send test message
/telegrambot list            - Show all commands
/telegrambot debug           - Toggle debug mode

Permission management:

/telegrambot addperm <ID> <permission>     - Grant permission to user
/telegrambot removeperm <ID> <permission>  - Remove permission
/telegrambot listperms                     - List all permissions

Example of granting permission:

/telegrambot addperm (id)123456789 telegrambot.restart

💬 TELEGRAM COMMANDS

For all players (if configured):

/help          - Show command list
/fly <nick>    - Grant 1 hour of fly
/money <nick>  - Give money
/kit <nick>    - Give kit
/online        - Check online players

For admins (require permissions):

/kick <nick>   - Kick player
/ban <nick>    - Ban player
/restart       - Restart server
/give <nick>   - Give items

🔧 CONFIGURING COMMANDS

Command example:

commands:
  fly:
    command: "lp user %player% permission settemp essentials.fly true 60m"
    cooldown: 86400                    # 24 hours in seconds
    eho: "Fly for 1 hour | "           # Description in /help
    message: "✅ Fly granted!"          # Success message
    error-message: "❌ Error"           # Error message
    permission: ""                     # Required permission (empty = for everyone)
    run-as-console: true               # Execute as console

Command parameters:

• command - command to execute on server
• cooldown - cooldown between uses (seconds)
• eho - description in /help menu
• message - bot response on success
• error-message - response on error
• permission - required permission (leave empty for everyone)
• run-as-console - execute as console (better to keep true)

PLACEHOLDERS FOR COMMANDS Use in command field:

%player%    - Player nickname from Telegram command
%args%      - All arguments after command
%user%      - Telegram username
%user_id%   - Telegram user ID

Example:

command: "eco give %player% 1000"      # Will give 1000 money to player
command: "msg %player% Hello from %user%"  # Will send message

🔐 PERMISSION SYSTEM

1. How to get user ID:

• Ask user to send any message to group
• Check server logs - their ID will be there
• Or use @getidsbot

2. Granting permissions:

/telegrambot addperm 123456789 telegrambot.restart
/telegrambot addperm 123456789 telegrambot.ban

3. Standard permissions:

• telegrambot.restart - restart permission
• telegrambot.ban - ban permission
• telegrambot.kick - kick permission
• telegrambot.admin - all permissions (for operators)

🛠️ TROUBLESHOOTING

1. Bot not responding:

• Check token: /telegrambot status
• Check group ID
• Ensure bot is group administrator
• Enable debug: /telegrambot debug

2. Commands not executing:

• Check server logs
• Ensure required plugins are installed
• Check command syntax in config

Console errors:

[TelegramBot] ERROR: ... - check config.yml
[TelegramBot] WARNING: ... - usually not critical

Useful diagnostic commands:

/telegrambot execute say Test command  # Test execution
/telegrambot debug                     # Enable detailed logs
/telegrambot reload                    # Reload settings

🎉 USEFUL TIPS

1. For beginners:

• Start with one command /fly
• Test in a small group
• Gradually add new commands

2. For administrators:

• Create separate group for commands
• Assign responsible people for permissions
• Regularly check logs

3. For players:

• Use format: /command player_nickname
• Respect cooldowns
• Use /help for command list

Done! Now players can manage the server through Telegram. Start with simple commands and gradually expand functionality. 🎮