FlectonePulse

Оформление

Дискорд ​

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

  • из Minecraft в Discord
  • из Discord в Minecraft

discord messageminecraft 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

NOTE

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

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

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

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

yml
discord:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  info-channel:
    айди: "ТПС <tps>"
  message-channel:
    CHAT_GLOBAL:
      content: "<final_message>"
      webhook:
        enable: false
        avatar: "https://mc-heads.net/avatar/<skin>/32.png"
        content: ""
      embed:
        enable: false
        color: ""
        title: ""
        url: ""
        author:
          name: ""
          url: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
        description: ""
        thumbnail: ""
        image: ""
        timestamp: true
        footer:
          text: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
yml
discord:
  for-minecraft: "<fcolor:2><name> <fcolor:1>» <fcolor:4><message>"
  info-channel:
    id: "TPS <tps>"
  message-channel:
    CHAT_GLOBAL:
      content: "<final_message>"
      webhook:
        enable: false
        avatar: "https://mc-heads.net/avatar/<skin>/32.png"
        content: ""
      embed:
        enable: false
        color: ""
        title: ""
        url: ""
        author:
          name: ""
          url: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"
        description: ""
        thumbnail: ""
        image: ""
        timestamp: true
        footer:
          text: ""
          icon-url: "https://mc-heads.net/avatar/<skin>/16.png"

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

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

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

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

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

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

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

for-minecraft ​

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

info-channel ​

Список айди каналов и их названий

message-channel ​

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

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

discord

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

content ​

Содержание обычного сообщения от лица бота дискорда discord content

webhook ​

Дискорд вебхук discord webhook

enable ​

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

avatar ​

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

content ​

Содержание сообщения вебхука

embed ​

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

enable ​

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

color ​

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

title ​

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

url ​

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

author ​

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

name ​

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

url ​

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

icon-url ​

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

description ​

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

thumbnail ​

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

name ​

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

value ​

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

inline ​

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

image ​

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

timestamp ​

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

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

text ​

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

icon-url ​

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

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

  1. Возьми название из списка типы сообщений
  2. Вставь в message-channel
yaml
название_сообщения:
  content: ""
  webhook:
    enable: false
    avatar: "https://mc-heads.net/avatar/<skin>/32.png"
    content: ""
  embed:
    enable: false
    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

  1. Копирую ID канала в дискорде 1286666844358316083
  2. Прописываю COMMAND_BAN: "1286666844358316083"
yaml
message-channel:
  COMMAND_BAN: "1286666844358316083"

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