Плагин для Paper, обеспечивающий двустороннюю передачу сообщений между игровым чатом и чатами в Telegram с поддержкой команд и уведомлений.
Скачать
Версия игры
1.21.10
1.21.11
1.21.4
1.21.5
1.21.6
1.21.7
1.21.8
1.21.9
26.1
26.1.1
26.1.2
26.2
26.3
Категория
Ссылка на сайт
modrinth.com
Скачиваний:
0
Обновлено:
30.10.2026
ID:
paper-telegram-bridge позволяет синхронизировать чат сервера Minecraft с чатами в Telegram. Плагин поддерживает передачу сообщений, уведомления о действиях игроков и управление белым списком через бота.
paper-telegram-bridge является форком проекта spigot-tg-bridge, расширенным новыми функциями. Основное назначение плагина — бесшовная связь между Minecraft и Telegram, позволяющая сообщениям из игры попадать в мессенджер и наоборот.

Плагин автоматически транслирует события сервера в Telegram-чаты и позволяет пользователям мессенджера взаимодействовать с игровым процессом.
- Передача сообщений из игры в Telegram и из чатов мессенджера в Minecraft.
- Уведомления о входе и выходе игроков на сервер.
- Логирование смертей игроков, их засыпания и получения достижений (advancements).
- Информирование о киках игроков из-за отсутствия в белом списке.
- Отображение изображений инвентаря, предметов или эндер-сундуков в Telegram.
- Управление белым списком сервера напрямую через команды бота.
- Настройка форматирования сообщений для обеих платформ.
Для корректной работы плагина с обычными текстовыми сообщениями (не командами) необходимо отключить режим приватности (Privacy Mode) в настройках бота через BotFather. Перейдите в Bot Settings -> Group Privacy и нажмите Turn Off.
Команды бота настраиваются через конфигурационный файл. Если команда не указана в конфиге, она будет отключена.
| Команда | Описание | Тип | Обязательно | По умолчанию |
|---|---|---|---|---|
| /online | Получение списка игроков, находящихся в сети. | |||
| /time | Получение текущего времени на сервере. | |||
| /chat_id | Получение ID текущего чата для последующего добавления в config.yml. | |||
| /whitelist | (Только для админов) Управление белым списком: просмотр, добавление или удаление игроков. |
Для использования административных команд (таких как /whitelist) необходимо добавить Telegram ID пользователей в соответствующий список в конфигурации.
| Право доступа (Permission) | Описание | Тип | Обязательно | По умолчанию |
|---|---|---|---|---|
| tg-bridge.silentjoinleave | Если установлено в true, бот не будет отправлять сообщения о входе/выходе для игрока и скроет его из команды /online. |
Настройки плагина хранятся в файле config.yml и включают параметры работы бота, логирования и форматирования.
| Поле | Описание | Тип | Обязательно | По умолчанию |
|---|---|---|---|---|
| enable | Включение/выключение плагина | boolean | x | true |
| botToken | Токен Telegram-бота | string | checkmark | - |
| chats | ID чатов для работы бота (защита от неизвестных чатов) | number[] or string[] | checkmark | [] |
| admins | ID пользователей Telegram с правами админа | number[] or string[] | x | [] |
| serverStartMessage | Сообщение при запуске сервера | string | x | 'Server started.' |
| serverStopMessage | Сообщение при остановке сервера | string | x | 'Server stopped.' |
| logJoinLeave | Логирование входа/выхода игроков | boolean | x | true |
| logFromMCtoTG | Передача сообщений из Minecraft в Telegram | boolean | x | true |
| logFromTGtoMC | Передача сообщений из Telegram в Minecraft | boolean | x | true |
| logPlayerDeath | Уведомление о смерти игрока | boolean | x | false |
| logPlayerAsleep | Уведомление о том, что игрок уснул | boolean | x | false |
| logPlayerAdvancement | Уведомление о получении достижения | boolean | x | true |
| logInventory | Отправка изображений инвентаря, предметов или эндер-сундуков | boolean | x | true |
| logWhitelistKick | Уведомление о кике из-за отсутствия в белом списке | boolean | x | true |
| strings | Словарь токенов для локализации (i18n) | Map | x | см. дефолт |
| commands | Словарь команд для Telegram-бота | Map | checkmark | см. ниже |
| telegramMessageFormat | Формат сообщений для Telegram | string | x | см. дефолт |
| minecraftMessageFormat | Формат сообщений для Minecraft | string | x | см. дефолт |
| silentMessages | Отключение уведомлений в Telegram | boolean | x | false |
| apiOrigin | Различный эндпоинт API бота | string | x | https://api.telegram.org |
| disableConfigWatch | Отключить отслеживание изменений конфига | string | x | false |
Для настройки формата сообщений используются специальные строки в конфигурации.
+--------+ >--minecraftMessageFormat(message)-> +--------------+
| Paper | | Telegram bot |
+--------+ <--telegramMessageFormat(message)--< +--------------+
Строки должны содержать переменные %username% и %message%. В Telegram поддерживается цветовое оформление, а в Minecraft — жирный шрифт, курсив и зачеркивание.
| Команда | Описание | Тип | Обязательно | По умолчанию |
|---|---|---|---|---|
| tgbridge_reload | Перезагрузка конфигурации плагина через консоль сервера. |
Плагин поддерживает команды для взаимодействия с предметами и инвентарем через Telegram:
- [inv] — просмотр инвентаря
- [item] — информация о предмете
- [ender] — просмотр эндер-сундука





Войдите, чтобы поставить оценку и оставить отзыв.
| Канал | Файл | Игра | Модлоадер | Язык | Скачиваний | Загружен | |
|---|---|---|---|---|---|---|---|
| Релиз | paper-telegram-bridge-1.21.4-v0.22.0.jar 7.42 MB | 26.3, 26.2, 26.1.2, 26.1.1, 26.1, 1.21.11, 1.21.10, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4 |
|
— | 0 | 20.10.2026 |
Скачать
Версия игры
1.21.10
1.21.11
1.21.4
1.21.5
1.21.6
1.21.7
1.21.8
1.21.9
26.1
26.1.1
26.1.2
26.2
26.3
Категория
Ссылка на сайт
modrinth.com
Скачиваний:
0
Обновлено:
30.10.2026
ID: