Телеграм
Интеграция с Telegram позволяет отправлять сообщения:
- из Minecraft в Telegram
- из Telegram в Minecraft
Типы сообщений
| Тип | Пояснение |
|---|---|
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 |
ПРИМЕЧАНИЕ
Если у тебя есть собственные чаты со своими именами, например admin, тебе нужно будет указать CHAT_ADMIN. Если есть свои собственные группы из модуля vanilla, тебе нужно указать их название
🌍 Локализация
📂 Путь localizations → язык.yml → integration.telegram
⚖️ По умолчанию
telegram:
for_minecraft: "<fcolor:2><user_name> <fcolor:1>» <fcolor:4><message>"
info_channel:
айди: "ТПС <tps>"
message_channel:
CHAT_GLOBAL: "<final_message>"telegram:
for_minecraft: "<fcolor:2><user_name> <fcolor:1>» <fcolor:4><message>"
info_channel:
id: "TPS <tps>"
message_channel:
CHAT_GLOBAL: "<final_message>"Плейсхолдеры
Ты можешь использовать все плейсхолдеры, которые используются в начальном сообщении для майнкрафта
НАПРИМЕР ДЛЯ СООБЩЕНИЯ О БЛОКИРОВКЕ
Там есть плейсхолдер <reason>, значит я могу использовать <reason> внутри телеграм сообщений
Также есть плейсхолдеры, которые ТОЧНО будут заменяться в любом сообщении
<final_message>сообщение, отправленное в майнкрафт<final_clear_message>сообщение, отправленное в майнкрафт без unicode-смайлов<player>ник игрока, который отправил сообщение<message>сырое сообщение, которое написал игрок<plain_message>отформатированное сообщение, которое написал игрок- Очевидно, что все плейсхолдеры из
PlaceholderAPIиFlectonePulseтоже будут работать
for_minecraft
Формат сообщения, которое будет отправлено из Телеграма в Майнкрафт
| Плейсхолдер | Что возвращает |
|---|---|
<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
token: ""
channel_info:
enable: false
ticker:
enable: true
period: 1200
message_channel:
FROM_TELEGRAM_TO_MINECRAFT:
- "123456"
CHAT_GLOBAL:
- "123456"
destination:
type: "CHAT"enable
Включает или выключает работоспособность модуля
ПРЕДУПРЕЖДЕНИЕ
- Перед включением, вставь токен бота Telegram
- После включения, ЖЕЛАТЕЛЬНО перезагрузить сервер
token
Токен бота для подключения. Можно использовать environment variables, например ${VALUE}
channel_info
Настройка каналов с информацией
enable
Нужен ли канал информации
ticker
Обновление каждый раз в какой-то промежуток времени
message_channel
Список типов сообщений и айди чатов в Telegram
Например я хочу, чтобы из Minecraft отправлялось сообщение комманды /ban в Telegram
- Копирую айди чата, в которое нужно отправить сообщение (
-1002341720267_49)
Если бот подключён и добавлен в канал, то можно использовать команду /id в телеграме, чтобы узнать айди канала
- Прописываю:
message-channel:
COMMAND_BAN:
- "-1002341720267_49"Чатов может быть сколько угодно, главное, чтобы к ним был доступ у бота из секреты. Локализацию можно не настраивать, по умолчанию сообщение будет отправляться с форматом <final_message>
ВАЖНО
Если ваш канал является Форумом (Топиком), то айди ГЛАВНОГО канала нужно указывать без _
- Айди моего главного канала (он всегда заканчивается на
_1) это-1002341720267_1 - Значит вписывать нужно ТОЛЬКО
-1002341720267
Для других чатов из форума это правило не действует и нужно вписывать ПОЛНЫЙ айди
destination
Куда будет отправлено сообщение
| Тип | Пояснение | Требует дополнительной настройки? |
|---|---|---|
ACTION_BAR | Сообщение над инвентарём игрока | Да |
BOSS_BAR | Сообщение в верхней части экрана | Да |
BRAND | Сообщение в F3 | Нет |
CHAT | Сообщение в чат | Нет |
TITLE | Сообщение на весь экран | Да |
SUBTITLE | Сообщение на весь экран (нижняя строчка) | Да |
TAB_HEADER | Сообщение в ТАБ (сверху) | Нет |
TAB_FOOTER | Сообщение в ТАБ (снизу) | Нет |
TOAST | Сообщение в правом верхнем углу (достижение) | Да |
Чтобы это изменить, замени значение type: сюды и перезапусти FlectonePulse с помощью комманды /flectonepulse reload, дополнительные настройки появятся САМИ
Если тип ACTION_BAR
destination:
type: "ACTION_BAR"
times:
stay: 60- times
| Поле | Пояснение |
|---|---|
stay | Время в тиках на удержание сообщения |
Если тип BOSS_BAR
destination:
type: "BOSS_BAR"
duration: 100
health: 1.0
overlay: "PROGRESS"
color: "BLUE"
play-boos-music: false
create-world-fog: false
darken-screen: false- duration
Длительность отображения сообщения
- health
Насколько будет заполнена шкала босс бара
- overlay
| Тип | Пояснение |
|---|---|
PROGRESS | Одной линией |
NOTCHED_6 | Разделённое на 6 частей |
NOTCHED_10 | Разделённое на 10 частей |
NOTCHED_12 | Разделённое на 12 частей |
NOTCHED_20 | Разделённое на 20 частей |
- color
Цвет отображения
| Тип |
|---|
PINK |
BLUE |
RED |
GREEN |
YELLOW |
PURPLE |
WHITE |
- play_boos_music
Будет ли музыка при сообщении
- create_world_fog
Будет ли туман при сообщении
- darken_screen
Будет ли затемнён экран при сообщении
Если тип TITLE (или SUBTITLE)
destination:
type: "TITLE" (или "SUBTITLE")
subtext: ""
times:
fade-in: 20
stay: 60
fade-out: 20- subtext
Сообщение для второй части отображения. Например, если выбран TITLE, то subtext будет показываться под ним и наоборот
- times
| Поле | Пояснение |
|---|---|
fade_in | Время в тиках на появление сообщения |
stay | Время в тиках на удержание сообщения |
fade_out | Время в тиках на удаления сообщения |
Если тип TOAST
destination:
type: "TOAST"
icon: "minecraft:diamond"
style: "TASK"- icon
Аватарка достижения, которая может быть любым предметом из майнкрафта (нужно обязательно указывать полный путь)
- style
Вид достижения (TASK обычное, GOAL цель, CHALLENGE челлендж)
🔐 Права
📂 Путь permission.yml → integration.telegram
⚖️ По умолчанию
telegram:
name: "flectonepulse.module.integration.telegram"
type: "TRUE"name
Название права
type
Вид права
| Вид | Объяснение |
|---|---|
TRUE | Доступно для любого игрока |
FALSE | Никому не доступно, должно быть выдано отдельно (например с помощью LuckPerms) |
OP | Доступно для операторов сервера |
NOT_OP | Доступно для НЕ операторов сервера |