Чат

Модуль, отвечающий за отправленные сообщения игроком в чат

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

📂 Путь localizations → язык.yml → message.chat

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

ru_ru.yml

chat:
  null-chat: "<color:#ff7171><b>⁉</b> На сервер выключен чат"
  null-receiver: "<color:#ff7171><b>⁉</b> Тебя никто не услышал"
  types:
    local: "<delete><display_name><fcolor:3>: <message><reset><translate>"
    global: "<delete><display_name> <world_prefix>»<fcolor:4> <message><reset><translate>"

en_us.yml

chat:
  null-chat: "<color:#ff7171><b>⁉</b> Chat is disabled on this server"
  null-receiver: "<color:#ff7171><b>⁉</b> Nobody heard you"
  types:
    global: "<delete><display_name> <world_prefix>»<fcolor:4> <message><reset><translate>"
    local: "<delete><display_name><fcolor:3>: <message><reset><translate>"

null-chat

Сообщение, если в чат ничего не удалось отправить

null-receiver

Сообщение, если никто не увидел сообщение игрока

types

Список чатов и их формат

⚙️ Настройка

📂 Путь message.yml → chat

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

chat:
  enable: true
  mode: "BUKKIT"
  priority: "NORMAL"
  types:
    local:
      enable: true
      cancel: true
      range: 100
      priority: 0
      trigger: ""
      null-receiver:
        enable: true
        destination:
          type: "ACTION_BAR"
          times:
            stay: 20
      destination:
        type: "CHAT"
      cooldown:
        enable: false
      sound:
        enable: false
    global:
      enable: true
      cancel: false
      range: "PROXY"
      priority: 5
      trigger: "!"
      null-receiver:
        enable: true
        destination:
          type: "ACTION_BAR"
          times:
            stay: 20
      destination:
        type: "CHAT"
      cooldown:
        enable: false
      sound:
        enable: false

enable

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

mode

Режим обработки чата

Тип	Объяснение
PACKET	Сообщения чата обрабатываются через пакеты (полностью асинхронно)
BUKKIT	Сообщения чата обрабатываются через Bukkit (асинхронно, но только в одном потоке чата)
PAPER	Сообщения чата обрабатываются через Paper (асинхронно, но только в одном потоке чата)

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

Если тебе нужно, чтобы твой другой плагин видел сообщения чата, поставь mode: "BUKKIT". В редком случае, если плагин работает через Paper слушатели, то нужно поставить mode: "PAPER"

event-priority

Приоритет ивента сообщения в чате. Измените это значение, если есть конфликт с другими плагинами, использующие чат

Тип	Объяснение
LOWEST	Сообщение в чате будет обработано быстрее всех плагинов
LOW	Сообщение в чате будет обработано после плагинов, у которых приоритет LOWEST
NORMAL	Сообщение в чате будет обработано после плагинов, у которых приоритет LOW
HIGH	Сообщение в чате будет обработано после плагинов, у которых приоритет NORMAL
HIGHEST	Сообщение в чате будет обработано после плагинов, у которых приоритет HIGHEST
MONITOR	Сообщение в чате будет только просмотрено

types

Список всех чатов с их настройкой. Любой чат по умолчанию выглядит так и ты можешь добавлять свои

название_чата:
  enable: true
  cancel: true
  range: PROXY
  priority: число
  trigger: "триггер"
  null-receiver:
    enable: true
    destination:
      type: "ACTION_BAR"
      times:
        stay: 20
  destination:
    type: "CHAT"
  cooldown:
    enable: false
  sound:
    enable: false

enable

Включает работоспособность чата

null-recipient

Включает сообщение о том, что отправленное сообщение никто не увидел

НАСТРОЙКА

enable

Включает работоспособность

destination

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

cancel

• Если true, то ивент сообщения чата отменяется для других плагинов
• Если необходимо, чтобы другой плагин, связанный с чатом (DiscordSRV например) - работал, то нужно ставить false
• Если false, то это также вызывает дублирование в консоль

range

Насколько далеко в блоках отобразится сообщение

Значение	Объяснение
WORLD_TYPE	Сообщение будет отправлено только игрокам, которые имеют право flectonepulse.world.type.название_измерения
WORLD_NAME	Сообщение будет отправлено только игрокам, которые имеют право flectonepulse.world.name.название_папки_мира
PROXY	Сообщение будет отправлено всем игрокам на сервере и на Proxy
SERVER	Сообщение будет отправлено всем игрокам на сервере
PLAYER	Сообщение будет отправлено только отправителю
любое число, которое больше 0, например range: 100	Сообщение будет отправлено игрокам, у которых расстояние между ними и отправителем меньше этого числа. Также игроки должны находиться в одном мире с отправителем

priority

Приоритет чата, который используется для выбора, когда у нескольких чатов одинаковый trigger. Выбирается тот, у кого приоритет больше

НАПРИМЕР ЕСТЬ ЧАТЫ

admin:
  priority: 20
  trigger: "!"
helper:
  priority: 10
  trigger: "!"

Если игрок имеет право на оба чата, то плагином выбран будет admin т.к. у него больше priority

trigger

Сообщение, с которого должно начинаться отправленное сообщение для чата

ЗНАЧЕНИЕ trigger МОЖЕТ БЫТЬ ЛЮБЫМ:

• !, admin, .f и т.д.
• пустым т.е. trigger: "", тогда для этого чата подходит любое сообщение

В итоговом сообщении trigger удаляется, т.е. если игрок отправил !привет, в итоге будет привет без !

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 челлендж)

cooldown

Задержка использования

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

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

cooldown:
  enable: true
  duration: 60

Поле	Тип	Пояснение
enable	boolean	Включает работу задержки
duration	long	Сколько должно пройти тиков между использованиями

sound

Проигрывание звука

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

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

sound:
  enable: true
  volume: 1.0
  pitch: 1.0
  category: "HOSTILE"
  name: "minecraft:entity.llama.spit"

Поле	Тип	Пояснение
enable	boolean	Включает работу звука
volume	float	Громкость звука от 0 до 1.0
pitch	float	Тональность звука от 0 до 1.0
category	String	Категория из MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
name	String	Название звука, например minecraft:entity.llama.spit

🔐 Права

📂 Путь permission.yml → message.chat

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

chat:
  name: "flectonepulse.module.message.chat"
  type: "TRUE"
  types:
    local:
      name: "flectonepulse.module.message.chat.local"
      type: "TRUE"
      cooldown-bypass:
        name: "flectonepulse.module.message.chat.local.cooldown.bypass"
        type: "OP"
      sound:
        name: "flectonepulse.module.message.chat.local.sound"
        type: "TRUE"
    global:
      name: "flectonepulse.module.message.chat.global"
      type: "TRUE"
      cooldown-bypass:
        name: "flectonepulse.module.message.chat.global.cooldown.bypass"
        type: "OP"
      sound:
        name: "flectonepulse.module.message.chat.global.sound"
        type: "TRUE"

name

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

type

Вид права

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

types

Список чатов и их прав

• cooldown-bypass

Право для игнорирования задержки между использованиями

• sound

Право для использования звука