# Velocity Telegram Bridge<\/p>\n
## Features<\/p>\n
– Forwards chat messages from Telegram to Minecraft and vice versa.
\n– Configurable message formats for different events such as join, leave, and server change.<\/p>\n
## Commands and Permissions<\/p>\n
The plugin provides the following commands:<\/p>\n
– `\/vtb reload`: Reads and reloads the plugin configuration from the `config.toml` file. Requires `vtb.reload` permission.<\/p>\n
## Installation<\/p>\n
1. Download the latest version of the plugin.
\n2. Place the downloaded jar file into your Velocity `plugins` folder.
\n3. Restart your Velocity proxy.
\n4. The plugin will generate a default `config.toml` file inside `velocity-telegram-bridge` folder. Modify this file with your Telegram API credentials and desired settings.
\n5. Restart your Velocity proxy or reload the plugin with `\/vtb reload` command.<\/p>\n
### Note
\n> \u2139\ufe0f If you want to handle death and advancement messages, you need to install YepLib plugin on velocity and YepTwo mod for backend servers<\/p>\n
## Configuration<\/p>\n
The `config.toml` file contains the following sections:<\/p>\n
– `Telegram`: Contains the token and chat_id for your Telegram bot.
\n– `Events`: Contains the message formats for different events. You can enable or disable each event and customize the message format.<\/p>\n
This is the default configuration:<\/p>\n
“`toml
\n#Telegram bot api configuration
\n[Telegram]
\n #Telegram bot api token
\n token = “0:ABCDEFG”
\n #Telegram chat id to send messages to
\n chat_id = 0
\n#Events configuration
\n[Events]
\n #Should messages from chat be sent to the chat?
\n message_enabled = true
\n #Format of the message
\n #Available placeholders: {player}, {message}
\n message_format = “{player}<\/b>: {message}”
\n #Should messages from telegram be sent to the server?
\n message_from_telegram_enabled = true
\n #Format of the message
\n #Available placeholders: {author}, {message}
\n message_from_telegram_format = “{author}: {message}”
\n #Should join messages be sent to the chat?
\n join_enabled = true
\n #Format of the message
\n #Available placeholders: {player}
\n join_format = “{player} joined the server<\/b>”
\n #Should leave messages be sent to the chat?
\n leave_enabled = true
\n #Format of the message
\n #Available placeholders: {player}
\n leave_format = “{player} left the server<\/b>”
\n #Should server change messages be sent to the chat?
\n server_change_enabled = true
\n #Format of the message
\n #Available placeholders: {server}, {new_server}, {player}
\n server_change_format = “{player} moved from {server} to {new_server}<\/b>”
\n #Should status messages be sent to the chat?
\n status_enabled = true
\n #Format of the message
\n #Available placeholders: {player_count}, {players}
\n status_format = “There are {player_count}<\/b> players online:n{players}”
\n #Should death messages be sent to the chat?
\n #Note: This requires YepLib installed on velocity and YepTwo on backend servers
\n death_enabled = true
\n #Format of the message
\n #Available placeholders: {death_message}
\n death_format = “{death_message}<\/b>”
\n #Should advancement messages be sent to the chat?
\n advancement_enabled = true
\n #Format of the message
\n #Available placeholders: {player}, {advancement_title}, and {advancement_description}
\n advancement_format = “{player}<\/b> has made the advancement {advancement_title}n{advancement_description}<\/i>”
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
Velocity plugin for telegram messages forwarding<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"velocitytelegrambridge","_minecraft_project_id":"RqGStcsu","_minecraft_author":"FeeeeK","_minecraft_license":"MIT","_minecraft_downloads":302,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"velocitytelegrambridge.zip","_minecraft_size_bytes":7533348,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T11:43:02.234153Z","_minecraft_date_created":"2025-01-07T22:26:13.577994Z","_minecraft_date_modified":"2025-01-10T15:27:19.532862Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/velocitytelegrambridge","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T17:55:20+00:00","_minecraft_import_hash":"f16dd8ab06c8c4f9ddbba682f51c5a8b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,867,92,985],"mod_loader":[986],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38],"class_list":["post-165626","mod","type-mod","status-publish","hentry","mod_category-management","mod_category-social","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4"],"yoast_head":"\n