Ztelegram

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.

Click Me

Telegram Integration: Two-way chat sync between Minecraft and Telegram
Notifications: Real-time server alerts in Telegram (player join/leave, deaths, and more)
Console Access: Remotely execute server console commands via Telegram
Registration System: Link Minecraft accounts to Telegram for secure communication
Mini-Game: "Guess the Word" game with reward support
Statistics: View player stats directly in Telegram
️ Access Control: Whitelist and blacklist systems to manage channel access
Customization: Flexible message formatting with gradient and HTML support
Multi-Channel Support: Separate channels for chat, console, and registration

In-game Commands

• 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

Telegram Commands
In the Main Channel:

• 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

In the Console Channel:

• 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

In the Registration Channel:
This channel uses a special command format:
To register by nickname:
Simply send your Minecraft nickname (e.g., Zoobastik)
To register using a code:
Send the code you received in-game (e.g., 123456)

By default, all permissions are granted only to server operators (op), unless otherwise noted.

• 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

Installation

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.

Configuration

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.

Configuration File Setup

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

bot:
  token: 'YOUR_BOT_TOKEN_HERE'  # The token you received from BotFather

channels:
  main: 'YOUR_MAIN_CHANNEL_ID'  # Main channel ID
  console: 'YOUR_CONSOLE_CHANNEL_ID'  # Console channel ID
  register: 'YOUR_REGISTER_CHANNEL_ID'  # Registration channel ID

Message Formatting
The plugin supports rich message formatting:

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.