CraftHub
EclipseAFKPlugin

EclipseAFKPlugin

A simple AFK plugin with prefix and color.

20 downloads

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

No gallery available for this project.