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

Permissions

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