AFKPlugin

A lightweight, configurable AFK plugin for Paper 1.21.x. Automatically detects inactive players and marks them as AFK.

Features

• Automatic Detection – Players are marked AFK after a configurable inactivity timeout
• Low Sensitivity – Small movements (stuttering, mouse clicks, short walks) won't cancel AFK. Only moving a significant distance or actively interacting counts as activity
• Manual Toggle – /afk to toggle AFK manually
• Tablist Display – AFK players get an [AFK] prefix in the player list
• Auto-Kick – Optional automatic kick after prolonged AFK time
• Broadcast – Optional chat notification when players go AFK / return
• Fully Configurable – Timeout, messages, kick, and detection are all adjustable
• Permissions – Bypass, ignore, and reload controlled via permissions
• Customizable Messages – All messages editable in messages.yml

Commands

Command	Description	Permission
/afk	Toggle AFK mode	afk.use
/afk reload	Reload configuration	afk.reload
/afk <player>	Check a player's AFK status	afk.others

Permissions

Permission	Default	Description
afk.use	true	Allows using /afk
afk.others	op	Allows checking others' AFK status
afk.bypass	false	Never automatically marked AFK
afk.kick.bypass	op	Never kicked for being AFK
afk.reload	op	Allows reloading the config

Installation

1. Make sure you're running Paper 1.21.x
2. Place AFKPlugin-1.0.0.jar into your plugins/ folder
3. Restart the server or run /reload
4. Optionally adjust config.yml and messages.yml

Configuration

config.yml

# Seconds of inactivity before a player is marked AFK
timeout: 600

# Kick after prolonged AFK
kick:
  enabled: false
  after: 1200

# Minimum movement distance (in blocks) required to count as activity
detection:
  min-movement-distance: 5.0