# 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](https://papermc.io) 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 ```yaml # 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