Дискорд

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

из Minecraft в Discord
из Discord в Minecraft

discord message minecraft message

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

Тип	Пояснение
`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.discord

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

ru_ru.ymlen_us.yml

yml

discord:
  for_minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  info_channel:
    айди: "ТПС <tps>"
  message_channel:
    CHAT_GLOBAL:
      content: "<final_message>"

yml

discord:
  for_minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  info_channel:
    id: "TPS <tps>"
  message_channel:
    CHAT_GLOBAL:
      content: "<final_message>"

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

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

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

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

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

<final_message> сообщение, отправленное в майнкрафт
<final_clear_message> сообщение, отправленное в майнкрафт без unicode-смайлов
<player> ник игрока, который отправил сообщение
<message> сырое сообщение, которое написал игрок
<plain_message> отформатированное сообщение, которое написал игрок
Очевидно, что все плейсхолдеры из PlaceholderAPI и FlectonePulse тоже будут работать

`for_minecraft`

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

`info_channel`

Список айди каналов и их названий, для отображения какой-нибудь информации, например TPS

`message_channel`

Список сообщений с их настройкой

Настройка сообщения

ИНФОРМАЦИЯ

Если параметр пустой или он не написан, то он не будет использован в итоговом сообщении

`content`

Содержание сообщения discord content

`webhook_avatar`

Включение дискорд вебхука с аватаром игрока. Лучше всего использовать https://mc-heads.net/avatar/<skin>/32.png discord webhook

`embed`

Дискорд эмбед сообщение discord embed

`color`

Цвет embed сообщения

`title`

Название embed сообщения

`url`

Ссылка для embed сообщения

`author`

Автор embed сообщения

`name`

Название автора embed сообщения

`url`

Ссылка на автора embed сообщения

`icon_url`

Ссылка на аватарку автора embed сообщения. Если будешь менять на свою, то ссылка должна содержать <skin>

`description`

Описание embed сообщения

`thumbnail`

Маленькое изображение внутри embed сообщения

`fields`

Нижние поля внутри embed сообщения

`name`

Название поля внутри embed сообщения

`value`

Значение поля внутри embed сообщения

`inline`

Если включено, то поле будет расположен в столбик с другими полями

`image`

Главное изображение embed сообщения

`timestamp`

Если включено, то embed сообщение будет включать время создания

`footer`

Нижняя часть embed сообщения

`text`

Текст в нижней части embed сообщения

`icon_url`

Изображение в нижней части embed сообщения

ИНФОРМАЦИЯ

Сообщение со всеми параметрами discord

yaml

название_сообщения:
  content: ""
  webhook_avatar: "https://mc-heads.net/avatar/<skin>/32.png"
  embed:
    color: ""
    title: ""
    url: ""
    author:
      name: ""
      url: ""
      icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
    description: ""
    thumbnail: ""
    fields:
      - name: ""
        value: ""
        inline: false
    image: ""
    timestamp: true
    footer:
      text: ""
      icon-url: "https://mc-heads.net/avatar/<skin>/16.png"

⚙️ Настройка

📂 Путь integration.yml → discord

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

yml

discord:
  enable: false
  token: ""
  presence:
    enable: true
    status: "ONLINE"
    activity:
      enable: true
      type: "PLAYING"
      name: "FlectonePulse"
      url: "https://flectone.net/pulse/"
  channel_info:
    enable: false
    ticker:
      enable: true
      period: 1200
  message_channel:
    FROM_DISCORD_TO_MINECRAFT: ""
    CHAT_GLOBAL: ""
  destination:
    type: "CHAT"

`enable`

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

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

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

`token`

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

`presence`

discord presence

Настройка статуса бота

`enable`

Включает или выключает кастомный статус бота

`status`

Режим	Пояснение
`UNKNOWN`	-
`ONLINE`	В сети
`DO_NOT_DISTURB`	В сети, с режимом не беспокоить
`IDLE`	В сети, но отошёл
`INVISIBLE`	Невидимый
`OFFLINE`	Не в сети

`activity`

Активность бота в дискорде

`enable`

Включает или выключает активность

`type`

Тип	Пояснение
`UNKNOWN`	-
`STREAMING`	Стримит
`LISTENING`	Слушает
`WATCHING`	Смотрит
`CUSTOM`	-
`COMPETING`	Соревнуется

`name`

Название активности

`url`

Ссылка на активности

`channel_info`

discord channel info

Настройка каналов с информацией

`enable`

Нужен ли канал информации

`ticker`

Обновление каждый раз в какой-то промежуток времени

КАК ИСПОЛЬЗОВАТЬ ТИКЕР?

Замени false на true и перезапусти FlectonePulse с помощью комманды /flectonepulse reload, дополнительные параметры для настройки тикера появятся САМИ

`enable`

Нужно ли обновлять

`period`

Как часто в тиках нужно обновлять

`message_channel`

Список типов сообщений и ID каналов в Discord

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

Копирую ID канала в дискорде 1286666844358316083
Прописываю COMMAND_BAN: "1286666844358316083"

yaml

message-channel:
  COMMAND_BAN: "1286666844358316083"

Локализацию можно не настраивать, по умолчанию сообщение будет отправляться с форматом <final_message>

`destination`

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

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

Чтобы это изменить, замени значение type: сюды и перезапусти FlectonePulse с помощью комманды /flectonepulse reload, дополнительные настройки появятся САМИ

Если тип `ACTION_BAR`

yaml

destination:
  type: "ACTION_BAR"
  times:
    stay: 60

- `times`

Поле	Пояснение
`stay`	Время в тиках на удержание сообщения

Если тип `BOSS_BAR`

yaml

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`)

yaml

destination:
  type: "TITLE" (или "SUBTITLE")
  subtext: ""
  times:
    fade-in: 20
    stay: 60
    fade-out: 20

- `subtext`

Сообщение для второй части отображения. Например, если выбран TITLE, то subtext будет показываться под ним и наоборот

- `times`

Поле	Пояснение
`fade_in`	Время в тиках на появление сообщения
`stay`	Время в тиках на удержание сообщения
`fade_out`	Время в тиках на удаления сообщения

Если тип `TOAST`

yaml

destination:
  type: "TOAST"
  icon: "minecraft:diamond"
  style: "TASK"

- `icon`

Аватарка достижения, которая может быть любым предметом из майнкрафта (нужно обязательно указывать полный путь)

- `style`

Вид достижения (TASK обычное, GOAL цель, CHALLENGE челлендж)

🔐 Права

📂 Путь permission.yml → integration.discord

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

yml

discord:
  name: "flectonepulse.module.integration.discord"
  type: "TRUE"

`name`

Название права

`type`

Вид права

Вид	Объяснение
`TRUE`	Доступно для любого игрока
`FALSE`	Никому не доступно, должно быть выдано отдельно (например с помощью LuckPerms)
`OP`	Доступно для операторов сервера
`NOT_OP`	Доступно для НЕ операторов сервера

Форматирование

Модерация

Значения

Статус

Таб

Дискорд ​

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

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

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

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

for_minecraft ​

info_channel ​

message_channel ​

content ​

webhook_avatar ​

embed ​

color ​

title ​

url ​

author ​

name ​

url ​

icon_url ​

description ​

thumbnail ​

fields ​

name ​

value ​

inline ​

image ​

timestamp ​

footer ​

text ​

icon_url ​

⚙️ Настройка ​

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

enable ​

token ​

presence ​

enable ​

status ​

activity ​

enable ​

type ​

name ​

url ​

channel_info ​

enable ​

ticker ​

enable ​

period ​

message_channel ​

destination ​

Если тип ACTION_BAR ​

- times ​

Если тип BOSS_BAR ​

- duration ​

- health ​

- overlay ​

- color ​

- play_boos_music ​

- create_world_fog ​

- darken_screen ​

Если тип TITLE (или SUBTITLE) ​

- subtext ​

- times ​

Если тип TOAST ​

- icon ​

- style ​

🔐 Права ​

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

name ​

type ​

Дискорд

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

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

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

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

`for_minecraft`

`info_channel`

`message_channel`

`content`

`webhook_avatar`

`embed`

`color`

`title`

`url`

`author`

`name`

`url`

`icon_url`

`description`

`thumbnail`

`fields`

`name`

`value`

`inline`

`image`

`timestamp`

`footer`

`text`

`icon_url`

⚙️ Настройка

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

`enable`

`token`

`presence`

`enable`

`status`

`activity`

`enable`

`type`

`name`

`url`

`channel_info`

`enable`

`ticker`

`enable`

`period`

`message_channel`

`destination`

Если тип `ACTION_BAR`

- `times`

Если тип `BOSS_BAR`

- `duration`

- `health`

- `overlay`

- `color`

- `play_boos_music`

- `create_world_fog`

- `darken_screen`

Если тип `TITLE` (или `SUBTITLE`)

- `subtext`

- `times`

Если тип `TOAST`

- `icon`

- `style`

🔐 Права

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

`name`

`type`