AFK
Automatic and manual AFK detection with player protection and idle kick.
Overview
EssentialsC tracks player activity and marks players as AFK after a configurable timeout. AFK players can be prevented from taking damage, being targeted by mobs, picking up items, and using certain commands. The system can also kick AFK players after a timeout, and broadcast their AFK status to the server.
Commands
| Command | Description |
|---|---|
/afk |
Toggle your AFK status manually. |
/afklist |
List all players currently AFK, with their AFK duration and location details. |
Configuration
AFK settings live under the afk section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
afk.enabled |
Boolean | true |
Enable the AFK system. |
afk.timeout-seconds |
Integer | 300 |
Seconds of inactivity before a player is auto-marked AFK. The value is multiplied by 1000, so a negative value marks players AFK immediately. |
afk.kick-timeout-seconds |
Integer | 1800 |
Seconds of AFK time before the player is kicked. Set to -1 to never kick AFK players. |
afk.tab-placeholder-enabled |
Boolean | true |
Show an AFK prefix next to the player's name in the TAB list. |
afk.tab-placeholder |
String | <color:#FF6B6B>[AFK]</color> |
Prefix shown in TAB while a player is AFK. Supports MiniMessage. |
afk.broadcast-enabled |
Boolean | true |
Broadcast a message when a player enters or leaves AFK mode. |
afk.title-enabled |
Boolean | true |
Show a title on screen when the player enters AFK mode. |
afk.title / afk.subtitle |
String | <color:#FF6B6B>You are now AFK</color> / <color:#FFE66D>Move to return</color> |
Title and subtitle shown on entering AFK mode. |
afk.prevent-damage |
Boolean | true |
Prevent AFK players from taking damage. |
afk.prevent-mob-target |
Boolean | true |
Prevent mobs from targeting AFK players. |
afk.prevent-pickup |
Boolean | true |
Prevent AFK players from picking up items. |
afk.freeze-player |
Boolean | false |
Freeze AFK players in place so they cannot be pushed. |
afk.blocked-commands |
List | spawn, home, tpa, tpahere, warp, shop |
Commands that AFK players cannot use. |
afk.list-show-location |
Boolean | true |
Show coordinates in the /afklist output. |
afk.list-show-world |
Boolean | true |
Show the world in the /afklist output. |
afk.list-sort-by |
String | time |
Sort order for /afklist: time, name, or world. |
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.afk |
Toggle AFK manually with /afk. |
Everyone |
essentialsc.afklist |
Use /afklist to see all AFK players. |
Operators |
essentialsc.afk.bypass.kick |
Never get kicked for being AFK. | Operators |
essentialsc.afk.bypass.auto |
Never get auto-marked AFK. | Operators |
essentialsc.afk.see.hidden |
See detailed AFK info in /afklist. |
Operators |