Documentation
EssentialsFree

AFK

Detect idle players, let them mark themselves away with /afk, announce it to the server and kick them after a while if you want.

The AFK module notices when a player stops playing and marks them as away. Players can also mark themselves away with /afk. You choose whether the whole server is told, and whether idle players are kicked after some time.

Features

  • Automatic detection: a player goes AFK after a set time without moving, looking around, chatting, typing a command or interacting.
  • Manual toggle: /afk marks you away, or back.
  • Announcements: everyone is told when a player goes AFK and comes back, or only the player, as you prefer. Muted players are never announced, vanished players only to staff who can see them, and announcements from /afk are limited to one every 10 seconds per player to prevent spam.
  • Automatic kick: kick players who stay AFK too long, with an exempt permission for staff.

As soon as an AFK player moves, chats, types a command or interacts, they are back.

AFK status is used elsewhere too: player profiles in the web editor show active time and AFK time separately, and AFK players earn no playtime progress in Progression and Battle pass, and no claim blocks in Claims.

Setting it up

Open the AFK module in the web editor.

Setting What it does Default
Idle after Time without movement, chat or command before going AFK. 0s turns automatic detection off. 5m
Exempt permission Players with this permission are never kicked for being idle. inglis.afk.exempt
Announce to the whole server Tells everyone when a player goes AFK and comes back. Otherwise only the player is told. On
Kick after AFK time before the player is kicked. 0s means never. 0s

Commands

Command What it does Permission
/afk Marks you AFK, or back if you already are. Alias: /away. inglis.afk (everyone)

Permissions

Permission What it grants Default
inglis.afk Use /afk. Everyone
inglis.afk.exempt Never kicked for being idle. You can change this node in the Exempt permission setting. Operators

Placeholders

Placeholder Shows
%ingliscore_afk% true when the player is AFK, false otherwise
%ingliscore_afk_time% How long the player has been AFK, empty when they are not

Tips

  • The kick timer starts when the player goes AFK, not when they stopped playing. With Idle after at 5m and Kick after at 10m, an idle player is kicked after about 15 minutes.
  • Show %ingliscore_afk% in your scoreboard and tab to spot away players at a glance.