Chat
A module responsible for messages sent by players in chat
🌍 Localization
📂 Path localizations → language.yml → message.chat
⚖️ Default
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>"
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
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
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
Message if no one saw the player's 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 |
---|---|
-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
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)
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 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