Чат

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

КАК ОТКЛЮЧИТЬ ЛОКАЛЬНЫЙ ЧАТ?

Внутри message.yml выключи local с помощью enable: false, а также сделай пустой trigger: "" для global

yaml

chat:
  enable: true
  mode: "BUKKIT"
  priority: "NORMAL"
  types:
    local:
      enable: false # поставь 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

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

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

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

ru_ru.ymlen_us.yml

yml

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

yml

chat:
  null_chat: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>Chat is disabled on this server"
  null_receiver: "<color:#ff7171><sprite_or:⁉:gui:icon/chat_modified>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

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

yml

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`

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

yaml

название_чата:
  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`

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. Выбирается тот, у кого приоритет больше

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

yaml

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

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

`trigger`

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

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

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

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

`destination`

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

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

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

`ACTION_BAR`

action bar

yaml

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

- `times`

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

`BOSS_BAR`

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

Будет ли затемнён экран при сообщении

`TEXT_SCREEN`

text screen

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

Это работает только на версии 1.19.4 и выше, на старых будет использоваться CHAT

yaml

destination:
  type: "TEXT_SCREEN"
  background: "#00000040"
  has_shadow: false
  see_through: true
  animation_time: 2
  live_time: 10
  width: 100000
  scale: 0.5
  offset_x: 0.0
  offset_y: -0.3
  offset_z: -0.8

- `background`

Цвет фона сообщения, он имеет прозрачность т.е. альфа-канал. Сайт для выбора цвета

- `has_shadow`

Включает тень у текста

`see_through`

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

- `animation_time`

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

- `live_time`

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

- `width`

Длина текста на одной строчке в пикселях. Если текст будет больше, то он перейдёт на вторую строчку

- `scale`

Размер текста. Если будет отрицательным, текст будет перевёрнутым

- `offset_x`

Смещение по координате X (вправо +, влево -) относительно центра экрана игрока

- `offset_y`

Смещение по координате Y (вверх +, вниз -) относительно центра экрана игрока

- `offset_z`

Смещение по координате Z (вперёд +, назад -) относительно центра экрана игрока

`TITLE` (или `SUBTITLE`)

title

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`

toast

yaml

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

- `icon`

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

- `style`

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

`cooldown`

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

Как использовать?

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

yaml

cooldown:
  enable: true
  duration: 60

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

`sound`

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

Как его использовать?

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

yaml

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

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

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_receiver ​

types ​

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

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

enable ​

mode ​

event_priority ​

types ​

enable ​

null_recipient ​

enable ​

destination ​

cancel ​

range ​

priority ​

trigger ​

destination ​

ACTION_BAR ​

- times ​

BOSS_BAR ​

- duration ​

- health ​

- overlay ​

- color ​

- play_boos_music ​

- create_world_fog ​

- darken_screen ​

TEXT_SCREEN ​

- background ​

- has_shadow ​

see_through ​

- animation_time ​

- live_time ​

- width ​

- scale ​

- offset_x ​

- offset_y ​

- offset_z ​

TITLE (или SUBTITLE) ​

- subtext ​

- times ​

TOAST ​

- icon ​

- style ​

cooldown ​

sound ​

🔐 Права ​

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

name ​

type ​

types ​

cooldown_bypass ​

sound ​

Чат

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

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

`null_chat`

`null_receiver`

`types`

⚙️ Настройка

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

`enable`

`mode`

`event_priority`

`types`

`enable`

`null_recipient`

`enable`

`destination`

`cancel`

`range`

`priority`

`trigger`

`destination`

`ACTION_BAR`

- `times`

`BOSS_BAR`

- `duration`

- `health`

- `overlay`

- `color`

- `play_boos_music`

- `create_world_fog`

- `darken_screen`

`TEXT_SCREEN`

- `background`

- `has_shadow`

`see_through`

- `animation_time`

- `live_time`

- `width`

- `scale`

- `offset_x`

- `offset_y`

- `offset_z`

`TITLE` (или `SUBTITLE`)

- `subtext`

- `times`

`TOAST`

- `icon`

- `style`

`cooldown`

`sound`

🔐 Права

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

`name`

`type`

`types`

`cooldown_bypass`

`sound`