# AntiAFK Plugin<\/p>\n
A complete Anti-AFK plugin for Minecraft Paper 1.21.10 that automatically detects and kicks inactive players.<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfaf **Automatic AFK Detection** – Detects players who are inactive for too long
\n– \u26a0\ufe0f **Warning System** – Warns players before they get kicked
\n– \ud83c\udfae **Manual AFK Toggle** – Players can mark themselves as AFK with `\/afk`
\n– \u2699\ufe0f **Fully Configurable** – Customize timeouts, messages and detection
\n– \ud83d\udee1\ufe0f **Permission System** – Staff can bypass AFK detection
\n– \ud83d\udce2 **Broadcast Messages** – Server is informed when players go AFK or return<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft**: 1.21.10
\n– **Server Software**: Paper (or forks like Purpur)
\n– **Java**: 21 or higher<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the latest `AntiAFK-1.0.0.jar` from releases
\n2. Place the JAR file in your server’s `plugins` folder
\n3. Restart your server
\n4. Customize the configuration in `plugins\/AntiAFK\/config.yml`
\n5. Use `\/afkreload` to reload the configuration<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The configuration is located in `plugins\/AntiAFK\/config.yml`:<\/p>\n
“`yaml
\n# Time in seconds before a player is considered AFK
\nafk-timeout: 300<\/p>\n
# Time in seconds before the warning is given
\nwarning-time: 270<\/p>\n
# Check interval in ticks (20 ticks = 1 second)
\ncheck-interval: 100<\/p>\n
# Messages (use & for color codes)
\nmessages:
\n kick: “&cYou have been kicked for inactivity!”
\n warning: “&eWarning: You will be kicked in {time} seconds for inactivity!”
\n afk-enabled: “&7You are now AFK”
\n afk-disabled: “&7You are no longer AFK”
\n player-afk: “&7{player} is now AFK”
\n player-back: “&7{player} is back”
\n reload: “&aConfiguration reloaded!”
\n no-permission: “&cYou don’t have permission to do this!”<\/p>\n
# Actions that reset AFK status
\ndetect-movement: true
\ndetect-chat: true
\ndetect-block-break: true
\ndetect-block-place: true
\ndetect-interact: true
\ndetect-damage: true
\n“`<\/p>\n
### Configuration Options<\/p>\n
| Option | Default | Description |
\n|——–|———|————-|
\n| `afk-timeout` | 300 | Seconds before player gets kicked |
\n| `warning-time` | 270 | Seconds before warning is given |
\n| `check-interval` | 100 | Ticks between each check (20 = 1 sec) |
\n| `detect-movement` | true | Detect movement as activity |
\n| `detect-chat` | true | Detect chat as activity |
\n| `detect-block-break` | true | Detect block breaking as activity |
\n| `detect-block-place` | true | Detect block placing as activity |
\n| `detect-interact` | true | Detect interactions as activity |
\n| `detect-damage` | true | Detect damage as activity |<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/afk` | Toggle your AFK status manually | `antiafk.command` |
\n| `\/afkreload` | Reload the plugin configuration | `antiafk.reload` |<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission | Default | Description |
\n|————|———|————-|
\n| `antiafk.command` | true | Use the `\/afk` command |
\n| `antiafk.bypass` | op | Bypass AFK detection (for staff) |
\n| `antiafk.reload` | op | Reload the configuration |<\/p>\n
### Permission Examples<\/p>\n
**LuckPerms:**
\n“`bash
\n# Give moderators bypass permission
\nlp group moderator permission set antiafk.bypass true<\/p>\n
# Give admins reload permission
\nlp group admin permission set antiafk.reload true
\n“`<\/p>\n
## \ud83d\udd0d How it Works<\/p>\n
1. **Activity Tracking**: The plugin tracks when players were last active
\n2. **Periodic Checks**: Every X ticks (configurable) it checks if players have been inactive too long
\n3. **Warning**: At `warning-time` seconds the player receives a warning
\n4. **Kick**: At `afk-timeout` seconds the player gets kicked
\n5. **Broadcast**: Other players are informed when someone goes AFK or returns<\/p>\n
### Detected Activities<\/p>\n
The plugin detects the following activities (if enabled in config):
\n– \u2705 Movement (position change, not just head rotation)
\n– \u2705 Chat messages
\n– \u2705 Breaking blocks
\n– \u2705 Placing blocks
\n– \u2705 Interactions (buttons, doors, etc.)
\n– \u2705 Taking damage
\n– \u2705 Executing commands<\/p>\n
## \ud83d\udcdd Examples<\/p>\n
### Example 1: Default Usage
\n“`
\nPlayer is inactive for 4 minutes
\n\u2192 At 4:30 minutes: “\u26a0\ufe0f Warning: You will be kicked in 30 seconds for inactivity!”
\n\u2192 At 5:00 minutes: Player gets kicked
\n“`<\/p>\n
### Example 2: Manual AFK
\n“`
\nPlayer: \/afk
\n\u2192 “You are now AFK”
\n\u2192 Server: “Player123 is now AFK”<\/p>\n
Player moves
\n\u2192 “You are no longer AFK”
\n\u2192 Server: “Player123 is back”
\n“`<\/p>\n
### Example 3: Staff Bypass
\n“`
\nStaff with antiafk.bypass permission
\n\u2192 Never gets kicked, regardless of inactivity
\n“`<\/p>\n
## \ud83d\udc1b Troubleshooting<\/p>\n
**Players are not getting kicked:**
\n– Check if `afk-timeout` is set correctly
\n– Verify players don’t have `antiafk.bypass` permission
\n– Verify the plugin is loaded correctly with `\/plugins`<\/p>\n
**Warnings don’t work:**
\n– Make sure `warning-time` is less than `afk-timeout`
\n– Check the console for errors<\/p>\n
**Config changes don’t work:**
\n– Use `\/afkreload` after editing the config
\n– Or restart the server<\/p>\n
## \ud83d\udcc4 License<\/p>\n
This project is open source and available for personal and commercial use.<\/p>\n
—<\/p>\n
**Made with \u2764\ufe0f for the Minecraft community**<\/p>\n","protected":false},"excerpt":{"rendered":"
A complete Anti-AFK plugin for Minecraft Paper 1.21.10 that automatically detects and kicks inactive players.<\/p>\n","protected":false},"featured_media":15781,"template":"","meta":{"_minecraft_slug":"anti-afk-system","_minecraft_project_id":"5vJsuy7O","_minecraft_author":"Samuele_NL","_minecraft_license":"MIT","_minecraft_downloads":88,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"anti-afk-system.zip","_minecraft_size_bytes":9513,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:57:16.328014Z","_minecraft_date_created":"2025-12-21T05:14:44.012240Z","_minecraft_date_modified":"2025-12-19T19:31:49.164634Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/anti-afk-system","_minecraft_icon_attachment_id":15781,"_minecraft_imported_at":"2026-05-31T18:37:26+00:00","_minecraft_import_hash":"46fbe870c62a92000f52a9c0e1b4ddb0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,123,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-15780","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n