AFK

A player goes AFK if they do nothing for a certain period of time

If a player is AFK, they receive a specific suffix

🌍 Localization

📂 Path localizations → language.yml → message.contact.afk

⚖️ Default

ru_ru.yml

afk:
  suffix: " <color:#FFFF00>⌚</color>"
  format-true:
    global: "<gradient:#ffd500:#FFFF00>⌚ <player> отошёл"
    local: "<gradient:#ffd500:#FFFF00>⌚ Ты отошёл от игры"
  format-false:
    global: "<gradient:#ffd500:#FFFF00>⌚ <player> вернулся"
    local: "<gradient:#ffd500:#FFFF00>⌚ Ты вернулся в игру"

en_us.yml

afk:
  suffix: " <color:#FFFF00>⌚</color>"
  format-true:
    global: "<gradient:#ffd500:#FFFF00>⌚ <player> is now afk"
    local: "<gradient:#ffd500:#FFFF00>⌚ Now you're afk"
  format-false:
    global: "<gradient:#ffd500:#FFFF00>⌚ <player> isn't afk now"
    local: "<gradient:#ffd500:#FFFF00>⌚ Now you're not afk"

suffix

The suffix assigned to a player when they go AFK

format-true

Message when a player goes AFK

format-false

Message when a player returns

⚙️ Setting

📂 Path message.yml → contact.afk

⚖️ Default

afk:
  enable: true
  range: -1
  delay: 3000
  ignore:
    - "afk"
  destination:
    type: CHAT
  ticker:
    enable: true
    period: 20

enable

Enables or disables the functionality of the module

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

delay

How long (in ticks) a player must be inactive to go AFK

ignore

List of actions that are ignored and do not affect AFK status

Actions that can be ignored
Any command names
chat - when a player types in chat
quit - when a player logs out

EXAMPLE

If I add the command tell to the list and a player is AFK, they can use the tell command without leaving AFK mode

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

ticker

Updates every certain interval of time

• enable

Whether to update or not

• period

How often in ticks it should update

🔐 Permissions

📂 Path permission.yml → message.contact.afk

⚖️ Default

afk:
  name: "flectonepulse.module.command.afk"
  type: TRUE
  cooldown-bypass:
    name: "flectonepulse.module.command.afk.cooldown.bypass"
    type: OP
  sound:
    name: "flectonepulse.module.command.afk.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)

cooldown-bypass

Permission to bypass the cooldown between uses

sound

Permission to use sound