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 –
/afkto 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
- Make sure you're running Paper 1.21.x
- Place
AFKPlugin-1.0.0.jarinto yourplugins/folder - Restart the server or run
/reload - Optionally adjust
config.ymlandmessages.yml
Config
config.yml
timeout: 600
kick:
enabled: false
after: 1200
detection:
min-movement-distance: 5.0
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as AFKPlugin-1.0.0.jar — drop this file into the mods folder
- Download size: 13 KB
- Download link checked 14 Sept 2026 — working
These come from our own check of the pack file, not from the source page.