{"id":67537,"date":"2026-06-03T23:39:26","date_gmt":"2026-06-03T20:39:26","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/"},"modified":"2026-06-03T23:39:26","modified_gmt":"2026-06-03T20:39:26","slug":"ezafk","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/","title":{"rendered":"EzAfk"},"content":{"rendered":"

## **Keep AFK management simple.**<\/p>\n

EzAfk is a modern, lightweight AFK management plugin for Paper and Spigot servers.
\nIt automates AFK detection, rewards or charges players based on idle state, gives staff
\na real-time overview panel, and integrates with the tools you already run, all without
\nsacrificing performance.<\/p>\n

> **v3.0.0** \u00b7 Minecraft 26.1+ \u00b7 Java 25 \u00b7 Paper \/ Spigot \/ Bukkit \/ Purpur<\/p>\n

—<\/p>\n

## Feature Highlights<\/p>\n

| Feature | Summary |
\n|———|———|
\n| **AFK Detection** | Idle timeout with configurable broadcasts, titles, animations, display-name changes, and a blindness-blur overlay |
\n| **Anti-Bypass** | Block infinite water flow, vehicle riding, and bubble column tricks from resetting idle timers |
\n| **AFK Kick** | Kick idle players after a configurable period, optionally only when the server is full |
\n| **Kick Warnings** | Multi-stage countdown messages (chat and\/or title) at custom intervals before the kick fires |
\n| **Staff GUI** | `\/afk gui` panel showing all AFK players with one-click kick, message, teleport, and custom command buttons |
\n| **AFK Zones** | Cuboid regions where players earn rewards (economy, commands, or items) for being AFK |
\n| **Economy Costs** | Charge a one-time entry fee and\/or a recurring fee while AFK via any Vault economy plugin |
\n| **AFK Leaderboard** | Per-player cumulative AFK time, `\/afk top` leaderboard, persisted across restarts |
\n| **PlaceholderAPI** | 16 placeholders for status, session time, totals, counts, prefix\/suffix, and playtime |
\n| **Multi-language** | EN, ES, NL, RU, ZH, DE, fully overridable per server |
\n| **Storage backends** | YAML (default), SQLite, or MySQL |
\n| **Simple Voice Chat** | Play a custom MP3 sound when a player goes AFK |<\/p>\n

—<\/p>\n

## Installation<\/p>\n

1. Download `EzAfk-x.x.x.jar` from the files tab above.
\n2. Drop it into your server’s `plugins\/` folder.
\n3. Restart the server. EzAfk generates all config files automatically.
\n4. Edit `plugins\/EzAfk\/config.yml` to configure your desired features.
\n5. Run `\/afk reload` in-game to apply changes without a restart.<\/p>\n

—<\/p>\n

## Commands<\/p>\n

| Command | Description | Permission |
\n|———|————-|————|
\n| `\/afk` | Toggle your own AFK status | (none) |
\n| `\/afk reload` | Reload all configuration files | `ezafk.reload` |
\n| `\/afk gui` | Open the AFK staff overview panel | `ezafk.gui` |
\n| `\/afk toggle ` | Force a player’s AFK state | `ezafk.toggle` |
\n| `\/afk bypass ` | Toggle AFK bypass for a player | `ezafk.bypass.manage` |
\n| `\/afk info ` | View a player’s AFK session details | `ezafk.info` |
\n| `\/afk time [player]` | View total AFK time | `ezafk.time` |
\n| `\/afk time reset ` | Reset a player’s AFK time | `ezafk.time.reset` |
\n| `\/afk top` | Show the AFK time leaderboard | `ezafk.top` |
\n| `\/afk zone pos1` \/ `pos2` | Select zone corners | `ezafk.zone.manage` |
\n| `\/afk zone add ` | Create an AFK zone | `ezafk.zone.manage` |
\n| `\/afk zone remove ` | Remove an AFK zone | `ezafk.zone.manage` |
\n| `\/afk zone list` | List all zones | `ezafk.zone.list` |<\/p>\n

Aliases: `\/ezafk`, `\/ea`, `\/afktime`, `\/afktop`<\/p>\n

—<\/p>\n

## Permissions<\/p>\n

| Node | Default | Description |
\n|——|———|————-|
\n| `ezafk.reload` | OP | Reload configuration |
\n| `ezafk.bypass` | OP | Never be marked AFK automatically |
\n| `ezafk.bypass.manage` | OP | Toggle bypass for other players |
\n| `ezafk.toggle` | OP | Toggle other players’ AFK state |
\n| `ezafk.info` | OP | View AFK details for other players |
\n| `ezafk.kick.bypass` | OP | Never be kicked by EzAfk |
\n| `ezafk.gui` | OP | Open the staff GUI |
\n| `ezafk.gui.view-active` | OP | View non-AFK players in the GUI |
\n| `ezafk.gui.actions` | OP | Use action buttons in the GUI |
\n| `ezafk.time` | **all** | View own AFK time |
\n| `ezafk.time.others` | OP | View another player’s AFK time |
\n| `ezafk.time.reset` | OP | Reset a player’s AFK time |
\n| `ezafk.top` | OP | View the leaderboard |
\n| `ezafk.economy.bypass` | OP | Skip economy AFK charges |
\n| `ezafk.zone.list` | OP | List AFK zones |
\n| `ezafk.zone.manage` | OP | Create and remove zones |<\/p>\n

—<\/p>\n

## PlaceholderAPI Placeholders<\/p>\n

Requires PlaceholderAPI. The expansion registers automatically. No extra setup needed.<\/p>\n

| Placeholder | Returns |
\n|————-|———|
\n| `%ezafk_status%` | `AFK` or `ACTIVE` |
\n| `%ezafk_status_colored%` | `&cAFK` or `&aACTIVE` |
\n| `%ezafk_since%` | Seconds since AFK session started (empty if not AFK) |
\n| `%ezafk_last_active%` | Seconds since last player activity |
\n| `%ezafk_total_seconds%` | Total lifetime AFK seconds |
\n| `%ezafk_total%` | Total AFK time `HH:MM:SS` |
\n| `%ezafk_total_formatted%` | Verbose, e.g. `2 hours 15 minutes` |
\n| `%ezafk_prefix%` | Configured AFK display-name prefix |
\n| `%ezafk_suffix%` | Configured AFK display-name suffix |
\n| `%ezafk_playtime_active_seconds%` | Active (non-AFK) playtime in seconds |
\n| `%ezafk_playtime_active%` | Active playtime `HH:MM:SS` |
\n| `%ezafk_playtime_active_formatted%` | Active playtime verbose |
\n| `%ezafk_afk_count%` \/ `%ezafk_afk_players%` | Number of AFK players |
\n| `%ezafk_active_count%` \/ `%ezafk_active_players%` | Number of non-AFK players |<\/p>\n

—<\/p>\n

## Configuration Overview<\/p>\n

EzAfk’s settings are spread across focused files for clarity:<\/p>\n

“`text
\nconfig.yml AFK detection, kick, anti-bypass, economy, integrations
\ngui.yml Staff GUI layout and action buttons
\nzones.yml AFK zone definitions with coordinates and rewards
\nmysql.yml Database connection (only when storage.type: mysql)
\nmessages\/ Language files: en.yml, es.yml, nl.yml, ru.yml, zh.yml, de.yml
\n“`<\/p>\n

### Core settings (`config.yml`)<\/p>\n

“`yaml
\nafk:
\n timeout: 300 # seconds of inactivity \u2192 AFK
\n broadcast:
\n enabled: true # announce AFK in chat
\n title:
\n enabled: true # show title to the AFK player
\n anti:
\n infinite-waterflow: false
\n infinite-vehicle: false
\n bubble-column: false<\/p>\n

kick:
\n enabled: false # kick AFK players
\n enabledWhenFull: false # only kick when server is at capacity
\n timeout: 600 # seconds AFK before kick
\n warnings:
\n enabled: true
\n intervals: [60, 30, 10]
\n mode: both # chat | title | both<\/p>\n

economy:
\n enabled: false
\n cost:
\n enter:
\n enabled: true
\n amount: 25.0<\/p>\n

storage:
\n type: yaml # yaml | sqlite | mysql
\n flush-interval-seconds: 30
\n“`<\/p>\n

—<\/p>\n

## Integrations<\/p>\n

| Integration | Notes |
\n|————-|——-|
\n| **Vault \/ Economy** | Required for economy costs and zone economy rewards |
\n| **PlaceholderAPI** | Auto-detected; provides 16 AFK placeholders |
\n| **WorldGuard** | Adds `afk-bypass` region flag; use `\/rg flag afk-bypass allow` |
\n| **TAB** | Delegate tab-list AFK prefix formatting to the TAB plugin |
\n| **Simple Voice Chat** | Play MP3 sounds on AFK state changes |
\n| **bStats** | Anonymous usage statistics (opt-out in `config.yml`) |
\n| **Spigot update checker** | Console reminder when a new version is available |<\/p>\n

—<\/p>\n

## Links<\/p>\n

– Documentation: full configuration guide, feature pages, and API reference
\n– Discord: support, bug reports, and feature requests
\n– GitHub: source code and issue tracker
\n– Developer API: `PlayerAfkStatusChangeEvent` and `AfkReason` enum<\/p>\n

![Try the other Minecraft plugins in the EzPlugins series](https:\/\/modrinth.com\/collection\/Q98Ov6dA)<\/p>\n","protected":false},"excerpt":{"rendered":"

Modern, lightweight AFK management plugin that keeps your staff informed while gently nudging idle players back into the action<\/p>\n","protected":false},"featured_media":67538,"template":"","meta":{"_minecraft_slug":"ezafk","_minecraft_project_id":"lFROrcEl","_minecraft_author":"Shadow48402","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":627,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ezafk.zip","_minecraft_size_bytes":15917729,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T10:06:37.258234Z","_minecraft_date_created":"2026-01-13T21:07:40.349589Z","_minecraft_date_modified":"2026-04-26T09:45:25.484116Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ezafk","_minecraft_icon_attachment_id":67538,"_minecraft_imported_at":"2026-06-03T20:39:27+00:00","_minecraft_import_hash":"050e7a4cd2dd1e674d683f34c0829d89","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,844,89,126,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-67537","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nEzAfk - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"EzAfk - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Modern, lightweight AFK management plugin that keeps your staff informed while gently nudging idle players back into the action\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/\",\"name\":\"EzAfk - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ezafk-icon-0cd97abdee8fc325effea4dcf21ea56a9195c9ea.jpeg\",\"datePublished\":\"2026-06-03T20:39:26+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ezafk-icon-0cd97abdee8fc325effea4dcf21ea56a9195c9ea.jpeg\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/ezafk-icon-0cd97abdee8fc325effea4dcf21ea56a9195c9ea.jpeg\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/ezafk\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"EzAfk\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"EzAfk - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/","og_locale":"en_US","og_type":"article","og_title":"EzAfk - Minecraft","og_description":"Modern, lightweight AFK management plugin that keeps your staff informed while gently nudging idle players back into the action","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/","name":"EzAfk - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ezafk-icon-0cd97abdee8fc325effea4dcf21ea56a9195c9ea.jpeg","datePublished":"2026-06-03T20:39:26+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ezafk-icon-0cd97abdee8fc325effea4dcf21ea56a9195c9ea.jpeg","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/ezafk-icon-0cd97abdee8fc325effea4dcf21ea56a9195c9ea.jpeg","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/ezafk\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"EzAfk"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/67537","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/67538"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=67537"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=67537"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=67537"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=67537"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}