Chat

A module responsible for messages sent by players in chat
chat

🌍 Localization

📂 Path localizations → language.yml → message.chat

⚖️ `Default`

ru_ru.ymlen_us.yml

yml

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

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: "<display_name> <world_prefix>»<fcolor:4> <style><message> <translate>"
    local: "<display_name><fcolor:3>: <style><message> <translate>"

`null-chat`

Message if nothing was sent to chat

`null-receiver`

Message if no one saw the player's message

`types`

List of chats and their formats

⚙️ Setting

📂 Path message.yml → chat

⚖️ `Default`

yml

chat:
  enable: true
  event-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: -2
      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

`event-priority`

The priority of a chat message event. Change this value if there is a conflict with other plugins that also use the chat

Type	Explanation
`LOWEST`	The chat message will be processed before all other plugins
`LOW`	The chat message will be processed after plugins with `LOWEST` priority
`NORMAL`	The chat message will be processed after plugins with `LOW` priority
`HIGH`	The chat message will be processed after plugins with `NORMAL` priority
`HIGHEST`	The chat message will be processed after plugins with `HIGH` priority
`MONITOR`	The chat message will only be observed (no modifications allowed)

`types`

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

Chat Configuration

By default, any chat looks like this

yaml

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

`enable`

Enables chat functionality

`null-recipient`

null recipient

Message if no one saw the player's message

SETTINGS

`enable`

Enables the functionality

`destination`

Where the message will be sent

`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
`-4`	The message will only be sent to players who have the permission `flectonepulse.world.type.dimension_name`
`-3`	The message will only be sent to players who have the permission `flectonepulse.world.name.world_folder_name`
`-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 only be sent 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 a range greater than 0 is specified, for example 100, the recipients must also be in the same dimension as the sender

`priority`

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

EXAMPLE CHATS

yaml

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

yaml

destination:
  type: ACTION_BAR
  times:
    stay: 60

`times`

Field	Explanation
`stay`	Time in ticks to hold the message

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

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)

yaml

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

yaml

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)

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

yaml

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:

yaml

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

🔐 Permissions

📂 Path permission.yml → message.chat

⚖️ `Default`

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`

Permission name

`type`

Permission type

Type	Explanation
`TRUE`	Available to any player
`FALSE`	Not available to anyone, must be granted separately (e.g., using LuckPerms)
`OP`	Available to server operators
`NOT_OP`	Available to not server operators

`types`

List of chats and their permissions

cooldown-bypass

Permission to bypass the cooldown between uses

sound

Permission to use sound

Format

Moderation

Objective

Status

Tab

Chat ​

🌍 Localization ​

⚖️ Default ​

null-chat ​

null-receiver ​

types ​

⚙️ Setting ​

⚖️ Default ​

enable ​

event-priority ​

types ​

Chat Configuration ​

enable ​

null-recipient ​

enable ​

destination ​

cancel ​

range ​

priority ​

trigger ​

destination ​

times ​

duration ​

health ​

overlay ​

color ​

play-boos-music ​

create-world-fog ​

darken-screen ​

subtext ​

times ​

icon ​

style ​

cooldown ​

sound ​

🔐 Permissions ​

⚖️ Default ​

name ​

type ​

types ​

cooldown-bypass ​

sound ​

Chat

🌍 Localization

⚖️ `Default`

`null-chat`

`null-receiver`

`types`

⚙️ Setting

⚖️ `Default`

`enable`

`event-priority`

`types`

Chat Configuration

`enable`

`null-recipient`

`enable`

`destination`

`cancel`

`range`

`priority`

`trigger`

`destination`

`times`

`duration`

`health`

`overlay`

`color`

`play-boos-music`

`create-world-fog`

`darken-screen`

`subtext`

`times`

`icon`

`style`

`cooldown`

`sound`

🔐 Permissions

⚖️ `Default`

`name`

`type`

`types`

`cooldown-bypass`

`sound`