EzAfk

Build Release Downloads License

EzAfk is a powerful and flexible AFK management plugin for Spigot, Bukkit, Paper, and Purpur servers. It provides advanced AFK detection, player management, and deep integration with popular plugins and server systems.


Features

  • Automatic AFK detection: idle timeout with configurable thresholds
  • AFK kick warnings: multi-stage countdown messages before kicking inactive players
  • GUI overview: in-game panel to view and manage AFK players
  • AFK zones: region-based AFK rules and rewards
  • Multi-language support: EN, ES, NL, RU, ZH, DE out of the box
  • Storage backends: YAML, SQLite, and MySQL supported
  • Anti-bypass detection: catches water flow, vehicle, and bubble column tricks
  • Developer API: cancellable PlayerAfkStatusChangeEvent and AfkReason enum
  • Integrations: Economy/Vault, PlaceholderAPI, Tab, WorldGuard, Simple Voice Chat

Quick start

1. Download and install:

Download the latest EzAfk .jar from Modrinth and place it in your server’s plugins/ folder. Restart the server.

2. Configure:

Edit the files generated in plugins/EzAfk/:

config.yml    main settings (AFK timeout, kick, zones)
gui.yml       GUI layout and item settings
mysql.yml     database connection (only needed for MySQL)
messages/     per-language message files

3. Set permissions:

Grant ezafk.* to administrators, or assign individual nodes. See the Permissions page for the full list.


Documentation

Page What it covers
Getting Started Install, first config, verify it works
Commands All /afk commands, arguments, and permission nodes
Configuration Every config option explained
Features AFK detection, anti-bypass, kick, GUI, zones, economy, leaderboard (each with config)
Permissions Permission nodes and defaults
Messages Customising plugin messages and language files
Storage YAML, SQLite, and MySQL storage backends
Integrations Economy, PlaceholderAPI, Tab, WorldGuard, and more
FAQ & Troubleshooting Common questions and solutions
Developer API Events and enums for plugin developers