Flectone Logo FlectonePulse

Chat

Module responsible for messages sent by the player to the chat

chat

How to disable local chat?

Inside message.yml disable local using enable: false, and also set an empty trigger: "" for global

chat:
  enable: true
  mode: "BUKKIT"
  priority: "NORMAL"
  types:
    local:
      enable: false # set false
    global:
      enable: true
      cancel: false
      range: "PROXY"
      priority: 5
      trigger: "" # remove trigger
      null_receiver:
        enable: true
        destination:
          type: "ACTION_BAR"
          times:
            stay: 20
      destination:
        type: "CHAT"
      cooldown:
        enable: false
      sound:
        enable: false

🌍 Localization

Path localizations → language.yml → message.chat
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>"
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>"

null_chat

Message if nothing could be sent to the chat

null_receiver

Message if no one saw the player's message

types

List of chats and their format


⚙️ Setting

Path 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

Enables or disables the functionality of the module

mode

Chat processing mode

TypeExplanation
PACKETChat messages are processed via packets (fully asynchronous)
BUKKITChat messages are processed via Bukkit (asynchronous, but only in one chat thread)
PAPERChat messages are processed via Paper (asynchronous, but only in one chat thread)
Warning

If you need another plugin to see chat messages, set mode: "BUKKIT". In rare cases, if the plugin works through Paper listeners, you should set mode: "PAPER"

priority

Priority of the chat message event. Change this value if there is a conflict with other plugins using the chat.

TypeExplanation
LOWESTThe chat message will be processed before all other plugins
LOWThe chat message will be processed after plugins with LOWEST priority
NORMALThe chat message will be processed after plugins with LOW priority
HIGHThe chat message will be processed after plugins with NORMAL priority
HIGHESTThe chat message will be processed after plugins with HIGH priority
MONITORThe chat message will only be observed

types

List of all chats with their settings. Any default chat looks like this, and you can add your own:

chat_name:
  enable: true
  cancel: true
  range: PROXY
  priority: number
  trigger: "trigger"
  null_receiver:
    enable: true
    destination:
      type: "ACTION_BAR"
      times:
        stay: 20
  destination:
    type: "CHAT"
  cooldown:
    enable: false
  sound:
    enable: false

destination

Where the message will be sent

TypeExplanationRequires additional configuration?
ACTION_BARMessage above the player's inventoryYes
BOSS_BARMessage at the top of the screenYes
BRANDMessage in F3No
CHATMessage in chatNo
TEXT_SCREENMessage anywhere on the screenYes
TITLEFull-screen messageYes
SUBTITLEFull-screen message (bottom line)Yes
TAB_HEADERMessage in TAB (top)No
TAB_FOOTERMessage in TAB (bottom)No
TOASTMessage in the top right corner (achievement)Yes

cooldown

Usage delay

sound

Sound playback


🔐 Permissions

Path 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

Permission name

type

Permission type

TypeExplanation
TRUEAvailable to any player
FALSEAvailable to no one, must be granted separately (e.g., using LuckPerms)
OPAvailable to server operators
NOT_OPAvailable to NON-operators of the server

types

List of chats and their permissions

cooldown_bypass

Permission to ignore the cooldown between uses

sound

Permission to use the sound

Last updated on

Edit on GitHub

On this page

Authors of page