Телеграм
Интеграция с Telegram позволяет отправлять сообщения (Telegram ↔ Minecraft) между сервером Minecraft и Telegram.

Типы сообщений
| Тип | Пояснение |
|---|---|
CHAT_GLOBAL | Сообщение из чата global |
CHAT_LOCAL | Сообщение из чата local |
AFK | Сообщение от действия afk |
ADVANCEMENT | Сообщение от достижения |
DEATH | Сообщение от смерти |
JOIN | Сообщение, когда игрок зашёл на сервер |
QUIT | Сообщение, когда игрок вышел с сервера |
FROM_DISCORD_TO_MINECRAFT | Сообщение из Discord в Minecraft |
FROM_TWITCH_TO_MINECRAFT | Сообщение из Twitch в Minecraft |
FROM_TELEGRAM_TO_MINECRAFT | Сообщение из Telegram в Minecraft |
COMMAND_ME | Сообщение комманды /me |
COMMAND_BALL | Сообщение комманды /ball |
COMMAND_BAN | Сообщение комманды /ban |
COMMAND_BROADCAST | Сообщение комманды /broadcast |
COMMAND_COIN | Сообщение комманды /coin |
COMMAND_DICE | Сообщение комманды /dice |
COMMAND_DO | Сообщение комманды /do |
COMMAND_HELPER | Сообщение комманды /helper |
COMMAND_MUTE | Сообщение комманды /mute |
COMMAND_POLL_CREATE_MESSAGE | Сообщение комманды /poll |
COMMAND_SPY | Слежка за игроками, которая отправляется в /spy |
COMMAND_STREAM | Сообщение комманды /stream |
COMMAND_TRANSLATETO | Сообщение комманды /translateto |
COMMAND_TRY | Сообщение комманды /try |
COMMAND_WARN | Сообщение комманды /warn |
COMMAND_KICK | Сообщение комманды /kick |
SERVER_ENABLE | Сообщение при включении сервера |
SERVER_DISABLE | Сообщение при выключении сервера |
Если у тебя есть собственные чаты со своими именами, например admin, тебе нужно будет указать CHAT_ADMIN. Если есть свои собственные группы из модуля vanilla, тебе нужно указать их название
🌍Локализация
Путьlocalizations → язык.yml → integration.telegram
telegram:
null_player: "Игрок не найден"
format_reply: "<fcolor:4><hover:show_text:'<fcolor:4><reply_message>'>[Ответ на @<reply_user>]</hover> "
custom_command:
id: "Айди чата: <id>"
ping: "Пинг игрока <player> равен <replacement:ping>"
info_channel:
айди: "ТПС <replacement:tps>"
message_channel:
FROM_TELEGRAM_TO_MINECRAFT: "<fcolor:2><user_name> <fcolor:1>» <fcolor:4><reply><message>"
CHAT_GLOBAL: "<final_message>"telegram:
null_player: "This player does not exist"
format_reply: "<fcolor:4><hover:show_text:'<fcolor:4><reply_message>'>[Reply to @<reply_user>]</hover> "
custom_command:
id: "Channel id: <id>"
ping: "<player>'s ping is <replacement:ping>"
info_channel:
id: "TPS <replacement:tps>"
message_channel:
FROM_TELEGRAM_TO_MINECRAFT: "<fcolor:2><user_name> <fcolor:1>» <fcolor:4><reply><message>"
CHAT_GLOBAL: "<final_message>"null_player
Сообщение, если введённый игрок через custom_command не найден
format_reply
Формат сообщения для тега <reply>, когда сообщение является ответом на другое
custom_command
Список кастомных комманд интеграции, где ключом является название комманды, а значением её формат сообщения
custom_command:
tps:
content: "<tps>"Комманда, чтобы получить значение tps на сервере. Не забудь сделать её в inegration.yml
Плейсхолдеры
Ты можешь использовать все плейсхолдеры, которые используются в начальном сообщении для майнкрафта
Там есть плейсхолдер <reason>, значит я могу использовать <reason> внутри телеграм сообщений
Также есть плейсхолдеры, которые ТОЧНО будут заменяться в любом сообщении
<final_message>сообщение, отправленное в майнкрафт<final_clear_message>сообщение, отправленное в майнкрафт без unicode-смайлов<player>ник игрока, который отправил сообщение<message>сырое сообщение, которое написал игрок<plain_message>отформатированное сообщение, которое написал игрок<reply>отформатированное сообщение-ответ, оно будет пустым, если основное сообщение не ответ- Очевидно, что все плейсхолдеры из
PlaceholderAPIиFlectonePulseтоже будут работать
У сообщения, которое будет отправлено из Телеграма в Майнкрафт есть свои плейсхолдеры:
| Плейсхолдер | Что возвращает |
|---|---|
<name> | Тег пользователя в Telegram |
<user_name> | Тег пользователя в Telegram |
<first_name> | Имя пользователя в Telegram |
<last_name> | Фамилия пользователя в Telegram |
<chat> | Названия чата Telegram (откуда было отправлено сообщение) |
info_channel
Список айди каналов и их названий, для отображения какой-нибудь информации, например TPS
message_channel
Список сообщений с форматом итогового сообщения
Возьми название из списка типы сообщений
Вставь в message_channel
название_сообщения: "<final_message>"⚙️Настройка
Путьintegration.yml → telegram
telegram:
enable: false
parse_mode: "NONE"
token: ""
custom_command:
id:
need_player: false
aliases:
- "!id"
ping:
need_player: true
aliases:
- "!ping"
channel_info:
enable: false
ticker:
enable: true
period: 1200
message_channel:
FROM_TELEGRAM_TO_MINECRAFT:
- "123456"
CHAT_GLOBAL:
- "123456"
destination:
type: "CHAT"
sound:
enable: falseenable
Включает или выключает работоспособность модуля
- Перед включением, вставь токен бота Telegram
- После включения, ЖЕЛАТЕЛЬНО перезагрузить сервер
parse_mode
В каком режиме будет отправляться сообщение в телеграм
| Режим | Что будет? |
|---|---|
MARKDOWN | Сообщение будет отформатировано относительно устаревшего формата Markdown |
MARKDOWN_V2 | Сообщение будет отформатировано относительно нового формата Markdown |
HTML | Сообщение будет отформатировано относительно формата HTML |
NONE | Сообщение никак не будет отформатировано |
token
Токен бота для подключения. Можно использовать environment variables, например ${VALUE}
custom_command
Список кастомных комманд интеграции, ключом является название комманды и оно может быть любым. Комманды могут быть ТОЛЬКО информационными, на сервере они ничего не выполняют и не будут выполнять
| Параметр | Пояснение |
|---|---|
need_player | Проверять ли первый аргумент комманды на имя игрока, например !ping TheFaser |
aliases | Список псевдонимов для использования комманды |
custom_command:
tps:
need_player: false
aliases:
- "!tps"
- "!tickpersecond"Комманда, чтобы получить значение tps на сервере с помощью !tps или !tickpersecond. Не забудь сделать сообщение в локализации
channel_info
Настройка каналов с информацией
enable
Нужен ли канал информации
ticker
Обновление каждый раз в какой-то промежуток времени
message_channel
Список типов сообщений и айди чатов в Telegram
- Копирую айди чата, в которое нужно отправить сообщение (
-1002341720267_49)
Если бот подключён и добавлен в канал, то можно использовать команду /id в телеграме, чтобы узнать айди канала
- Прописываю:
message_channel:
COMMAND_BAN:
- "-1002341720267_49"Чатов может быть сколько угодно, главное, чтобы к ним был доступ у бота из секреты. Локализацию можно не настраивать, по умолчанию сообщение будет отправляться с форматом <final_message>
Если ваш канал является Форумом (Топиком), то айди ГЛАВНОГО канала нужно указывать без _
- Айди моего главного канала (он всегда заканчивается на
_1) это-1002341720267_1 - Значит вписывать нужно ТОЛЬКО
-1002341720267
Для других чатов из форума это правило не действует и нужно вписывать ПОЛНЫЙ айди
destination
Куда будет отправлено сообщение
| Тип | Пояснение | Требует дополнительной настройки? |
|---|---|---|
ACTION_BAR | Сообщение над инвентарём игрока | Да |
BOSS_BAR | Сообщение в верхней части экрана | Да |
BRAND | Сообщение в F3 | Нет |
CHAT | Сообщение в чат | Нет |
TEXT_SCREEN | Сообщение в любое место экрана | Да |
TITLE | Сообщение на весь экран | Да |
SUBTITLE | Сообщение на весь экран (нижняя строчка) | Да |
TAB_HEADER | Сообщение в ТАБ (сверху) | Нет |
TAB_FOOTER | Сообщение в ТАБ (снизу) | Нет |
TOAST | Сообщение в правом верхнем углу (достижение) | Да |
Чтобы это изменить, замени значение type: сюды и перезапусти FlectonePulse с помощью комманды /flectonepulse reload, дополнительные настройки появятся САМИ
Изменение
Заменить значение type: сюды
Перезапустить FlectonePulse с помощью комманды /flectonepulse reload
Дополнительные параметры для настройки задержки появятся сами
🔐Права
Путьpermission.yml → integration.telegram
telegram:
name: "flectonepulse.module.integration.telegram"
type: "TRUE"
sound:
name: "flectonepulse.module.integration.telegram.sound"
type: "TRUE"name
Название права
type
Вид права
| Вид | Объяснение |
|---|---|
TRUE | Доступно для любого игрока |
FALSE | Никому не доступно, должно быть выдано отдельно (например с помощью LuckPerms) |
OP | Доступно для операторов сервера |
NOT_OP | Доступно для НЕ операторов сервера |
Последнее обновление
Редактировать на GitHub
FlectonePulse