ZTelegram is a powerful plugin for Minecraft servers that seamlessly integrates Telegram with your server.
It creates a reliable bridge between your Minecraft world and Telegram, allowing players to communicate via Telegram,
receive real-time server event notifications, and much more.

• Command: /telegram
• Description: Displays basic plugin information
• Permission: ztelegram.command.use
  
  
• Command: /telegram help
• Description: Shows a list of available commands
• Permission: ztelegram.command.help
• 
  
• Command: /telegram link
• Description: Generates a code to link your account to Telegram
• Permission: ztelegram.command.link.use
• 
  
• Command: /telegram unlink
• Description: Unlinks your account from Telegram
• Permission: ztelegram.command.unlink.use
• 
  
• Command: /telegram reload
• Description: Reloads the plugin configuration
• Permission: ztelegram.command.reload
• 
  
• Command: /telegram unregister <player>
• Description: Unregisters the specified player
• Permission: ztelegram.command.unregister
• 
  
• Command: /telegram addplayer <player>
• Description: Hides the player from Telegram messages
• Permission: ztelegram.command.addplayer
• 
  
• Command: /telegram removeplayer <player>
• Description: Shows a previously hidden player in messages
• Permission: ztelegram.command.removeplayer
• 
  
• Command: /telegram hidden
• Description: Displays the list of hidden players
• Permission: ztelegram.command.hidden
• 
  
• Command: /telegram addchannel <1-3> <id>
• Description: Updates the channel ID (1 - main, 2 - console, 3 - register)
• Permission: ztelegram.command.addchannel
• 
  
• Command: /telegram whitelist add/remove/list/on/off
• Description: Manages the Telegram whitelist
• Permission: ztelegram.command.whitelist
• 
  
• Command: /telegram blacklist add/remove/list/on/off
• Description: Manages the Telegram blacklist
• Permission: ztelegram.command.blacklist

• Command: /online or /онлайн
• Description: Displays the list of online players
• Registration Required: No

• Command: /tps or /тпс
• Description: Shows server performance (TPS)
• Registration Required: No

• Command: /player <name> or /ник <nickname>
• Description: Displays information about the specified player
• Registration Required: No

• Command: /gender [man/girl] or /пол [м/ж]
• Description: Sets the player's gender
• Registration Required: Yes

• Command: /game or /игра
• Description: Starts the "Guess the Word" mini-game
• Registration Required: Yes

• Command: /cmd or /команды
• Description: Shows a list of all available commands
• Registration Required: No

• Command: Any server command
• Description: Executes directly on the server without a prefix

• Command: /whitelist add <player>
• Description: Adds a player to the server whitelist

• Command: /whitelist remove <player>
• Description: Removes a player from the server whitelist

• Command: /whitelist on
• Description: Enables the server whitelist

• Command: /whitelist off
• Description: Disables the server whitelist

• Command: /whitelist list
• Description: Displays the list of whitelisted players

• Command: /help
• Description: Shows a list of available commands for the console channel

• Permission: ztelegram.command.use
• Description: Basic permission to use plugin commands

• Permission: ztelegram.command.link
• Description: View the Telegram channel link using /telegram

• Permission: ztelegram.command.help
• Description: Use the /telegram help command

• Permission: ztelegram.command.reload
• Description: Reload the plugin using /telegram reload

• Permission: ztelegram.command.unregister
• Description: Unregister players

• Permission: ztelegram.command.addplayer
• Description: Hide players from Telegram messages

• Permission: ztelegram.command.removeplayer
• Description: Show previously hidden players in messages

• Permission: ztelegram.command.addchannel
• Description: Update channel IDs

• Permission: ztelegram.command.hidden
• Description: View the list of hidden players

• Permission: ztelegram.command.link.use
• Description: Generate a registration code (available to all players)

• Permission: ztelegram.command.unlink.use
• Description: Unlink Telegram account (available to operators only)

• Permission: ztelegram.command.whitelist
• Description: Manage the Telegram whitelist

• Permission: ztelegram.command.blacklist
• Description: Manage the Telegram blacklist

1. Download the latest version of the plugin from Releases.
2. Place the JAR file into the plugins folder of your server.
3. Restart the server.
Upon the first launch, the following configuration files will be created:
- plugins/Ztelegram/config.yml - main settings
- plugins/Ztelegram/players.yml - registered player data
- plugins/Ztelegram/game.yml - mini-game settings
Configure the plugin according to the instructions below.

Creating a Telegram Bot
1. Open Telegram and search for @BotFather.
2. Send the command /newbot.
3. Follow the instructions, provide a name and username for your bot.
4. After creation, you will receive a bot token, which needs to be copied into the configuration.


1. Open the file plugins/Ztelegram/config.yml and configure the following required parameters:

1. Line Breaks: "First line\nSecond line"
2. Gradients and MiniMessage Formatting:

• <gradient:#FF0000:#A6EB0F>Text with a gradient</gradient>
• <#FF0000>Text in HEX color</#FF0000>
• &4Red text, §1Blue text
• <hover:show_text:"Hint">Text with a hover hint</hover> (works only in-game)

1. Placeholders:

• %player% - Player's name
• %message% - Message text

If you have any questions, suggestions, or found an error:
Write to the Telegram channel for direct support.