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.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 → afk

⚖️ Default

afk:
  enable: true
  range: "SERVER"
  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
WORLD_TYPE	The message will only be sent to players who have the permission flectonepulse.world.type.dimension_name
WORLD_NAME	The message will only be sent to players who have the permission flectonepulse.world.name.world_folder_name
PROXY	The message will be sent to all players on the server and on Proxy
SERVER	The message will be sent to all players on the server
PLAYER	The message will only be sent to the sender
Any number greater than 0 (e.g., range: 100)	The message will be sent to players whose distance from the sender is less than this number. Players must also be in the same world 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

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

HOW TO CHANGE THE DESTINATION?

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

---

If type is ACTION_BAR

destination:
  type: "ACTION_BAR"
  times:
    stay: 60

times

Field	Explanation
stay	Time in ticks to hold the message

If type is 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

If type is 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

If type is 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)

ticker

Updates every certain interval of time

HOW TO USE TICKER?

Change false to true and restart FlectonePulse using the /flectonepulse reload command. Additional ticker settings will appear AUTOMATICALLY

enable

Whether to update or not

period

How often in ticks it should update

🔐 Permissions

📂 Path permission.yml → message.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 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

cooldown-bypass

Permission to bypass the cooldown between uses

sound

Permission to use sound