Телеграм

Интеграция с Telegram позволяет отправлять сообщения:

• из Minecraft в Telegram
• из Telegram в Minecraft

Типы сообщений

Тип	Пояснение
CHAT	Глобальное сообщение чата
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

🌍 Локализация

📂 Путь localizations → язык.yml → integration.telegram

⚖️ По умолчанию

ru_ru.yml

telegram:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  message-channel:
    CHAT: "<final_message>"

en_us.yml

telegram:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  message-channel:
    CHAT: "<final_message>"

Плейсхолдеры

Ты можешь использовать все плейсхолдеры, которые используются в начальном сообщении для майнкрафта

НАПРИМЕР ДЛЯ СООБЩЕНИЯ О БЛОКИРОВКЕ

Там есть плейсхолдер <reason>, значит я могу использовать <reason> внутри телеграм сообщений

Также есть плейсхолдеры, которые ТОЧНО будут заменяться в любом сообщении

• <final_message> сообщение, отправленное в майнкрафт
• <final_clear_message> сообщение, отправленное в майнкрафт без unicode-смайлов
• <player> ник игрока, который отправил сообщение

Очевидно, что все плейсхолдеры из PlaceholderAPI и FlectonePulse тоже будут работать

for-minecraft

Формат сообщения, которое будет отправлено из Телеграма в Майнкрафт

message-channel

Список сообщений с форматом итогового сообщения

ЕСЛИ ХОЧЕШЬ ДОБАВИТЬ ДРУГОЕ СООБЩЕНИЕ:

1. Возьми название из списка типы сообщений
2. Вставь в message-channel

название_сообщения: "<final_message>"

⚙️ Настройка

📂 Путь integration.yml → telegram

⚖️ По умолчанию

telegram:
  enable: false
  token: ""
  message-channel:
    FROM_TELEGRAM_TO_MINECRAFT: []
    CHAT: []
  destination:
    type: CHAT

enable

Включает или выключает работоспособность модуля

ПРЕДУПРЕЖДЕНИЕ

• Перед включением, вставь токен бота Telegram
• После включения, ЖЕЛАТЕЛЬНО перезагрузить сервер

token

Токен бота для подключения. Можно использовать environment variables, например ${VALUE}

message-channel

Список типов сообщений и айди чатов в Telegram

Например я хочу, чтобы из Minecraft отправлялось сообщение комманды /ban в Telegram

1. Копирую айди чата, в которое нужно отправить сообщение (-1002341720267_49)

Если бот подключён и добавлен в канал, то можно использовать команду /id в телеграме, чтобы узнать айди канала

2. Прописываю:

message-channel:
  COMMAND_BAN:
    - "-1002341720267_49"

Чатов может быть сколько угодно, главное, чтобы к ним был доступ у бота из секреты

ВАЖНО

Если ваш канал является Форумом (Топиком), то айди ГЛАВНОГО канала нужно указывать без _

1. Айди моего главного канала (он всегда заканчивается на _1) это -1002341720267_1
2. Значит вписывать нужно ТОЛЬКО -1002341720267

Для других чатов из форума это правило не действует и нужно вписывать ПОЛНЫЙ айди

destination

Куда будет отправлено сообщение

КАК ПОМЕНЯТЬ НАЗНАЧЕНИЕ?

Замени значение type: сюды и перезапусти FlectonePulse с помощью комманды /flectonepulse reload, дополнительные настройки появятся сами

Тип	Пояснение	Требует дополнительной настройки?
ACTION_BAR	Сообщение над инвентарём игрока	Да
BOSS_BAR	Сообщение в верхней части экрана	Да
BRAND	Сообщение в F3	Нет
CHAT	Сообщение в чат	Нет
TITLE	Сообщение на весь экран	Да
SUBTITLE	Сообщение на весь экран (нижняя строчка)	Да
TAB_HEADER	Сообщение в ТАБ (сверху)	Нет
TAB_FOOTER	Сообщение в ТАБ (снизу)	Нет
TOAST	Сообщение в правом верхнем углу (достижение)	Да

Настройка 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	Доступно для НЕ операторов сервера