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.timeout-seconds |
Integer | 300 |
Seconds of inactivity before a player is auto-marked AFK. -1 disables auto-AFK. |
afk.kick-timeout-seconds |
Integer | 0 |
Seconds after AFK before the player is kicked. 0 disables auto-kick. |
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 | false |
Prevent AFK players from picking up items. |
afk.freeze-player |
Boolean | false |
Freeze AFK players in place. |
afk.blocked-commands |
List | [] |
Commands that AFK players cannot use. |
afk.broadcast-enabled |
Boolean | true |
Broadcast a message when a player goes AFK or returns. |
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.afk |
Toggle AFK manually with /afk. |
Everyone |
essentialsc.afk.list |
Use /afklist to see all AFK players. |
Everyone |
essentialsc.afk.kick.bypass |
Never get kicked for being AFK. | Operators |
essentialsc.afk.auto.bypass |
Never get auto-marked AFK. | Operators |