Телеграм

Интеграция с 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

NOTE

If you have your own chats with custom names, for example admin, then you will need to specify CHAT_ADMIN

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

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

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

ru_ru.yml

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

en_us.yml

telegram:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  message-channel:
    CHAT_GLOBAL: "<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:
      - "123456"
    CHAT_GLOBAL:
      - "123456"
  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

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

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