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

Perms

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

Install

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

Config

config.yml

timeout: 600
kick:
  enabled: false
  after: 1200
detection:
  min-movement-distance: 5.0