# AFK Actions<\/p>\n
A powerful and feature-rich AFK detection plugin for Paper\/Purpur servers that automatically manages idle players with customizable commands and multi-language support.<\/p>\n
—<\/p>\n
## \ud83c\udf1f Features<\/p>\n
– **\ud83c\udfaf Automatic AFK Detection** – Tracks player movement and chat activity
\n– **\u2699\ufe0f Dual Command System** – Execute commands when players go AFK and when they return
\n– **\ud83c\udf0d Multi-Language Support** – Built-in English and Turkish translations (fully customizable)
\n– **\ud83d\udee1\ufe0f Smart Exemptions** – OP and permission-based AFK immunity
\n– **\ud83d\udce2 Broadcast System** – Server-wide notifications for AFK status changes
\n– **\ud83d\udd27 Debug Mode** – Detailed logging for troubleshooting
\n– **\ud83d\udcca Management Commands** – View, list, and reset player AFK status
\n– **\u26a1 High Performance** – Lightweight with minimal server impact
\n– **\ud83c\udfa8 Fully Customizable** – Every message and setting is configurable<\/p>\n
—<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft:** 1.21+
\n– **Server:** Paper, Purpur, or any Paper-based server
\n– **Java:** 21+<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
All commands are under the main `\/afkactions` command (alias: `\/afk`)<\/p>\n
| Command | Permission | Description | —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n ### Admin Permissions<\/p>\n | Permission | Default | Description | ### Exemption Permission<\/p>\n | Permission | Default | Description | —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n ### Main Config (`config.yml`)<\/p>\n “`yaml # Language (en = English, tr = Turkish) # Debug mode – Shows detailed logs in console (default: false) # AFK detection time – Player will be marked as AFK after this time of inactivity (seconds) # Command execution time – Commands will run after player has been AFK for this long (seconds) # Exemption settings # Broadcast settings # Commands to run when player becomes AFK # Commands to run from console (do not include \/) # Commands to run when player returns from AFK # Commands to run from console (do not include \/) —<\/p>\n ## \ud83c\udf0d Language Files<\/p>\n The plugin creates customizable language files in `plugins\/AFKActions\/`:<\/p>\n ### English (`messages_en.yml`) All messages including broadcasts, commands, and errors are fully translatable!<\/p>\n **Change language:** Then run: `\/afkactions reload`<\/p>\n —<\/p>\n ## \ud83d\udcd6 How It Works<\/p>\n ### AFK Detection Flow<\/p>\n 1. **Player goes idle** \u2192 No movement or chat for configured time —<\/p>\n ## \ud83d\udca1 Use Cases & Examples<\/p>\n ### Example 1: Kick AFK Players<\/p>\n “`yaml player-commands: [] ### Example 2: Move to Lobby<\/p>\n “`yaml console-commands: ### Example 3: Spectator Mode + Return System<\/p>\n “`yaml # When returning ### Example 4: Economy\/Reward System<\/p>\n “`yaml —<\/p>\n ## \ud83d\udee1\ufe0f Exemptions<\/p>\n ### OP Exemption (Config-based)<\/p>\n “`yaml ### Permission-based Exemption<\/p>\n Grant `afkactions.bypass` permission to exempt specific players:<\/p>\n **LuckPerms Examples:** # Exempt VIP group # Exempt staff members —<\/p>\n ## \ud83d\udd0d Debug Mode<\/p>\n Enable debug mode for detailed logging:<\/p>\n “`yaml **Console Output:** Perfect for troubleshooting command execution!<\/p>\n —<\/p>\n ## \ud83c\udfaf Placeholders<\/p>\n Currently supported placeholder:<\/p>\n – `{player}` – The player’s name<\/p>\n Works in all command lists (player\/console, AFK\/return)<\/p>\n —<\/p>\n ## \ud83d\udcca Status Command Details<\/p>\n `\/afkactions status – \u2705 Player name Perfect for moderators to check player activity!<\/p>\n —<\/p>\n ## \ud83c\udfa8 Customization Tips<\/p>\n ### Custom Messages<\/p>\n Edit language files in `plugins\/AFKActions\/`: All colors use `&` codes: `&a` = green, `&c` = red, `&e` = yellow, etc.<\/p>\n ### Multiple Commands<\/p>\n You can add multiple commands per action:<\/p>\n “`yaml ### BungeeCord\/Velocity Support<\/p>\n For network servers, use console commands:<\/p>\n **BungeeCord:** **Velocity:** —<\/p>\n ## \ud83d\ude80 Performance<\/p>\n – \u2705 Lightweight – Checks run every second with minimal CPU usage —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. Download the latest version —<\/p>\n ## \ud83d\udcdd License<\/p>\n This plugin is free to use and modify.<\/p>\n —<\/p>\n ## \u2b50 Credits<\/p>\n **Developer:** DevPanda (Efe D\u00f6nmez) —<\/p>\n *Made with \u2764\ufe0f for the Minecraft community*<\/p>\n","protected":false},"excerpt":{"rendered":" AFK Actions is a comprehensive Minecraft Paper plugin that automatically detects and manages AFK (Away From Keyboard) players by executing customizable commands after specified inactivity periods.<\/p>\n","protected":false},"featured_media":8846,"template":"","meta":{"_minecraft_slug":"afk-actions","_minecraft_project_id":"lWg9LWEx","_minecraft_author":"DevPanda","_minecraft_license":"MIT","_minecraft_downloads":107,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"afk-actions.zip","_minecraft_size_bytes":3400867,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:33:40.300865Z","_minecraft_date_created":"2025-10-22T03:46:48.350376Z","_minecraft_date_modified":"2025-11-15T10:46:26.993881Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/afk-actions","_minecraft_icon_attachment_id":8846,"_minecraft_imported_at":"2026-05-31T15:22:34+00:00","_minecraft_import_hash":"8659dc1e4a14892c893ec480c8e93acb","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128],"mod_loader":[132,133],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-8845","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","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
\n|———|———–|————-|
\n| `\/afkactions` | – | Show help menu |
\n| `\/afkactions help` | – | Show available commands |
\n| `\/afkactions reload` | `afkactions.reload` | Reload configuration and language files |
\n| `\/afkactions status
\n| `\/afkactions list` | `afkactions.list` | List all currently AFK players |
\n| `\/afkactions reset
\n|———–|———|————-|
\n| `afkactions.*` | op | Grants all AFK Actions permissions |
\n| `afkactions.reload` | op | Reload plugin configuration |
\n| `afkactions.status` | op | View player AFK status |
\n| `afkactions.list` | op | List all AFK players |
\n| `afkactions.reset` | op | Reset player AFK status |<\/p>\n
\n|———–|———|————-|
\n| `afkactions.bypass` | false | **Exempts player from AFK system** – Never marked as AFK |<\/p>\n
\n# AFK Actions Plugin Configuration
\n# All times are in seconds<\/p>\n
\nlanguage: “en”<\/p>\n
\ndebug: false<\/p>\n
\nafk-detection-time: 180<\/p>\n
\ncommand-execution-time: 600<\/p>\n
\nexemptions:
\n # Should OPs be exempt from the AFK system?
\n ignore-ops: true
\n # Players with afkactions.bypass permission are automatically exempt<\/p>\n
\nbroadcast:
\n # Should AFK status be broadcast to the server?
\n afk-enabled: true
\n # Should return from AFK be broadcast to the server?
\n return-enabled: true<\/p>\n
\n# Commands to run as the player (do not include \/)
\n# Available placeholder: {player}
\nplayer-commands:
\n – “server lobby”<\/p>\n
\n# Available placeholder: {player}
\nconsole-commands:
\n – “kick {player} You have been AFK for too long!”<\/p>\n
\n# Commands to run as the player (do not include \/)
\n# Available placeholder: {player}
\nreturn-player-commands:
\n – “spawn”<\/p>\n
\n# Available placeholder: {player}
\nreturn-console-commands:
\n – “tell {player} Welcome back!”
\n – “effect give {player} minecraft:speed 10 1”
\n“`<\/p>\n
\n### Turkish (`messages_tr.yml`)<\/p>\n
\n“`yaml
\nlanguage: “en” # or “tr”
\n“`<\/p>\n
\n2. **AFK Status** \u2192 Player is marked as AFK (3 minutes default)
\n3. **Broadcast** \u2192 Server notified: `{player} is now AFK!` (if enabled)
\n4. **Wait Period** \u2192 Additional waiting time before commands execute
\n5. **Command Execution** \u2192 After total time (10 minutes default), commands run
\n6. **Player Returns** \u2192 On movement\/chat, AFK status clears
\n7. **Return Broadcast** \u2192 Server notified: `{player} is no longer AFK!` (if enabled)
\n8. **Return Commands** \u2192 Optional commands execute immediately upon return<\/p>\n
\nafk-detection-time: 300 # 5 minutes
\ncommand-execution-time: 600 # 10 minutes total<\/p>\n
\nconsole-commands:
\n – “kick {player} You were AFK for too long!”
\n“`<\/p>\n
\nplayer-commands:
\n – “server lobby”<\/p>\n
\n – “tell {player} Moving you to lobby due to inactivity”
\n“`<\/p>\n
\n# When AFK
\nconsole-commands:
\n – “gamemode spectator {player}”
\n – “tell {player} You are now in spectator mode (AFK)”<\/p>\n
\nreturn-console-commands:
\n – “gamemode survival {player}”
\n – “effect give {player} minecraft:regeneration 30 2”
\n – “tell {player} Welcome back! Restored to survival mode”
\n“`<\/p>\n
\n# When returning from AFK
\nreturn-console-commands:
\n – “eco give {player} 100”
\n – “title {player} title {“text”:”Welcome Back!”,”color”:”gold”}”
\n – “title {player} subtitle {“text”:”Here’s $100!”,”color”:”yellow”}”
\n“`<\/p>\n
\nexemptions:
\n ignore-ops: true # OPs never go AFK
\n“`<\/p>\n
\n“`bash
\n# Exempt a single player
\n\/lp user PlayerName permission set afkactions.bypass true<\/p>\n
\n\/lp group vip permission set afkactions.bypass true<\/p>\n
\n\/lp group admin permission set afkactions.bypass true
\n\/lp group moderator permission set afkactions.bypass true
\n“`<\/p>\n
\ndebug: true
\n“`<\/p>\n
\n“`
\n[AFKActions] [DEBUG] Executing 1 AFK player command(s) for PlayerName
\n[AFKActions] [DEBUG] AFK player command: server lobby
\n[AFKActions] [DEBUG] Executing 1 return console command(s) for PlayerName
\n[AFKActions] [DEBUG] Return console command: tell PlayerName Welcome back!
\n“`<\/p>\n
\n– \ud83d\udd34 AFK status (AFK \/ Active)
\n– \u23f0 Time since last activity
\n– \u2699\ufe0f Commands executed status
\n– \u23f3 Time remaining until commands execute (if AFK)<\/p>\n
\n– `messages_en.yml` – English messages
\n– `messages_tr.yml` – Turkish messages<\/p>\n
\nconsole-commands:
\n – “tell {player} You are AFK!”
\n – “title {player} title {“text”:”AFK”,”color”:”red”}”
\n – “gamemode spectator {player}”
\n – “tp {player} 0 100 0”
\n“`<\/p>\n
\n“`yaml
\nconsole-commands:
\n – “send {player} lobby”
\n“`<\/p>\n
\n“`yaml
\nconsole-commands:
\n – “server {player} lobby”
\n“`<\/p>\n
\n– \u2705 Concurrent HashMaps – Thread-safe player tracking
\n– \u2705 Efficient scheduling – Uses Bukkit’s task system
\n– \u2705 No database required – All data in memory
\n– \u2705 Automatic cleanup – Player data removed on disconnect<\/p>\n
\n2. Place JAR in your server’s `plugins` folder
\n3. Restart or reload your server
\n4. Configure `plugins\/AFKActions\/config.yml`
\n5. Optional: Customize language files
\n6. Run `\/afkactions reload` to apply changes<\/p>\n
\n**API:** Paper 1.21+
\n**Language:** Kotlin<\/p>\n