Chat

A module responsible for messages sent by players in chat

🌍 Localization

📂 Path localizations → language.yml → message.chat

⚖️ Default

ru_ru.yml

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

en_us.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

Message if nothing was sent to chat

null-recipient

Message if no one saw the player's message

types

List of chats and their formats

⚙️ Setting

📂 Path message.yml → chat

⚖️ Default

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

Enables or disables the functionality of the module

types

List of all chats with their configuration, you can add your own

Chat Configuration

By default, any chat looks like this

chat_name:
  enable: true
  null-recipient: true
  cancel: true
  range: number
  priority: number
  trigger: ""
  destination:
    type: CHAT
  cooldown:
    enable: false
  sound:
    enable: false

enable

Enables chat functionality

null-recipient

Enables a message indicating that no one saw the sent message

cancel

• If true, the chat event is canceled for other plugins
• If you need another chat-related plugin (e.g., DiscordSRV) to work, set this to false
• If false, this also causes duplication in the console
  

range

How far in blocks the message will be displayed

Value	Explanation
-2	The message will be sent to all players on the server and on Proxy
-1	The message will be sent to all players on the server
0	The message will be sent only to the sender
Any number > 0	The message will be sent to players whose distance from the sender is less than this number

NOTE

If the range is greater than 0, for example 100, the recipients must also be in the same dimension as the sender

priority

Chat priority, used for selection when multiple chats have the same trigger. The chat with the higher priority is chosen

EXAMPLE CHATS

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

If a player has permission for both chats, the plugin will select admin because it has a higher priority

trigger

The prefix that a message must start with to be sent to a specific chat

trigger VALUE CAN BE ANYTHING:

• !, admin, .f, etc.
• Empty, i.e., trigger: "", meaning any message fits this chat

In the final message, trigger is removed. For example, if a player sends !hello, the result will be hello without !

destination

Where the message will be sent

HOW TO CHANGE THE DESTINATION?

Replace the value type: here and restart FlectonePulse using the /flectonepulse reload command. Additional settings will appear automatically.

Type	Explanation	Requires additional configuration?
ACTION_BAR	Message above the player's inventory	Yes
BOSS_BAR	Message at the top of the screen	Yes
BRAND	Message in F3	No
CHAT	Message in the chat	No
TITLE	Full-screen message	Yes
SUBTITLE	Full-screen message (bottom line)	Yes
TAB_HEADER	Message in TAB (top)	No
TAB_FOOTER	Message in TAB (bottom)	No
TOAST	Message in the top-right corner (achievement)	Yes

Configuration for ACTION_BAR

destination:
  type: ACTION_BAR
  times:
    stay: 60

times

Field	Explanation
stay	Time in ticks to hold the message

Configuration for 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

Duration of the message display

health

How full the boss bar will be

overlay

Type	Explanation
PROGRESS	Single line
NOTCHED_6	Divided into 6 parts
NOTCHED_10	Divided into 10 parts
NOTCHED_12	Divided into 12 parts
NOTCHED_20	Divided into 20 parts

color

Display color

Type
PINK
BLUE
RED
GREEN
YELLOW
PURPLE
WHITE

play-boos-music

Whether music will play with the message

create-world-fog

Whether fog will appear with the message

darken-screen

Whether the screen will darken with the message

Configuration for TITLE (or SUBTITLE)

destination:
  type: TITLE (or SUBTITLE)
  subtext: ""
  times:
    fade-in: 20
    stay: 60
    fade-out: 20

subtext

Message for the second part of the display. For example, if TITLE is selected, subtext will be displayed below it, and vice versa.

times

Field	Explanation
fade-in	Time in ticks for the message to appear
stay	Time in ticks to hold the message
fade-out	Time in ticks for the message to disappear

Configuration for TOAST

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

icon

Achievement icon, which can be any Minecraft item (must specify the full path)

style

Achievement type (TASK regular, GOAL goal, CHALLENGE challenge)

WARNING

Not recommended for global messages

cooldown

Usage cooldown

Field	Type	Explanation
enable	boolean	Enables the cooldown functionality
duration	long	How many ticks must pass between uses

HOW TO USE COOLDOWN?

Replace false with true and restart FlectonePulse using the /flectonepulse reload command. Additional cooldown settings will appear AFTER RELOADING.

The cooldown configuration will look like this:

cooldown:
  enable: true
  duration: 60

sound

Sound playback

Field	Type	Explanation
enable	boolean	Enables sound functionality
volume	float	Sound volume from 0 to 1.0
pitch	float	Sound pitch from 0 to 1.0
category	String	Category from MASTER, MUSIC, RECORD, WEATHER, BLOCK, HOSTILE, NEUTRAL, PLAYER, AMBIENT, VOICE
name	String	Sound name, for example minecraft:entity.llama.spit

HOW TO USE SOUND?

Replace false with true and restart FlectonePulse using the /flectonepulse reload command. Additional sound settings will appear AFTER RELOADING.

The sound configuration will look like this:

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

🔐 Permissions

📂 Path permission.yml → message.chat

⚖️ Default

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

Type	Explanation
TRUE	Available for any player
FALSE	Available if granted separately (e.g., via LuckPerms)
OP	Available for server operators
NOT_OP	Available if granted separately (e.g., via LuckPerms)

types

List of chats and their permissions

• cooldown-bypass

Permission to bypass the cooldown between uses

• sound

Permission to use sound