Чат

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

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

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

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

ru_ru.ymlen_us.yml

yml

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

yml

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

`null-chat`

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

`null-recipient`

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

`types`

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

⚙️ Настройка

📂 Путь message.yml → chat

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

yml

chat:
  enable: true
  types:
    local:
      enable: true
      null-recipient: true
      cancel: true
      range: 100
      priority: 0
      trigger: ""
      destination:
        type: CHAT
      cooldown:
        enable: false
      sound:
        enable: false
    global:
      enable: true
      null-recipient: true
      cancel: false
      range: -2
      priority: 5
      trigger: "!"
      destination:
        type: CHAT
      cooldown:
        enable: false
      sound:
        enable: false

`enable`

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

`types`

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

Настройка чата

Любой чат по умолчанию выглядит так

yaml

название_чата:
  enable: true
  null-recipient: true
  cancel: true
  range: число
  priority: число
  trigger: ""
  destination:
    type: CHAT
  cooldown:
    enable: false
  sound:
    enable: false

`enable`

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

`null-recipient`

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

`cancel`

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

`range`

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

Значение	Объяснение
`-4`	Сообщение будет отправлено только игрокам, которые имеют право `flectonepulse.world.type.название_измерения`
`-3`	Сообщение будет отправлено только игрокам, которые имеют право `flectonepulse.world.name.название_папки_мира`
`-2`	Сообщение будет отправлено всем игрокам на сервере и на Proxy
`-1`	Сообщение будет отправлено всем игрокам на сервере
`0`	Сообщение будет отправлено только отправителю
любое число `> 0`	Сообщение будет отправлено игрокам, у которых расстояние между ними и отправителем меньше этого числа

ИНФОРМАЦИЯ

Если указан диапазон больше, чем 0, например 100, то получатели также должны находиться в одном измерении с отправителем

`priority`

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

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

yaml

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

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

`trigger`

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

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

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

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

`destination`

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

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

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

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

Настройка 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 челлендж)

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

Может вызывать задержки, поэтому не рекомендуется использовать

`cooldown`

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

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

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

Замени false на true и перезапусти FlectonePulse с помощью комманды /flectonepulse reload. Дополнительные параметры для настройки задержки появятся ПОСЛЕ ПЕРЕЗАГРУЗКИ

В итоге настройка задержки выглядит так

yaml

cooldown:
  enable: true
  duration: 60

`sound`

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

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

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

Замени false на true и перезапусти FlectonePulse с помощью комманды /flectonepulse reload, дополнительные параметры для настройки звука появятся ПОСЛЕ ПЕРЕЗАГРУЗКИ

В итоге настройка звука выглядит так

yaml

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

🔐 Права

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

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

yml

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

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

Модерация

Чат ​

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

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

null-chat ​

null-recipient ​

types ​

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

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

enable ​

types ​

Настройка чата ​

enable ​

null-recipient ​

cancel ​

range ​

priority ​

trigger ​

destination ​

times ​

duration ​

health ​

overlay ​

color ​

play-boos-music ​

create-world-fog ​

darken-screen ​

subtext ​

times ​

icon ​

style ​

cooldown ​

sound ​

🔐 Права ​

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

name ​

type ​

types ​

cooldown-bypass ​

sound ​

Чат

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

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

`null-chat`

`null-recipient`

`types`

⚙️ Настройка

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

`enable`

`types`

Настройка чата

`enable`

`null-recipient`

`cancel`

`range`

`priority`

`trigger`

`destination`

`times`

`duration`

`health`

`overlay`

`color`

`play-boos-music`

`create-world-fog`

`darken-screen`

`subtext`

`times`

`icon`

`style`

`cooldown`

`sound`

🔐 Права

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

`name`

`type`

`types`

`cooldown-bypass`

`sound`