About WhosAFK
From SpigotMCA plugin that lists the players who are AFK in the tab list
There are some plugins that broadcast when a player has gone AFK. That's fine, but if a player joins after the broadcast, how is that player going to know that the first player is AFK? This plugin solves that problem.
When a player goes AFK, the plugin will turn their player's name blue and will put the characters "(AFK)" at the end of their name in the tab list. Other players will know this player is going AFK because the server broadcasts that the player is AFK, and players who miss the broadcast simply have to hold down tab to view those who are AFK.
Players who are AFK will not take damage or lose hunger.
Commands
There are two commands.
- /afk : This is the main command which will broadcast that the player who executed the command is AFK. An operator can set another player's status to AFK by adding the other player's username as an argument to the command.
- /whosafkreload : Use this command to reload the config if you make a change to it. Requires the permission whosafk.reload .
There are three permissions.
- whosafk.afk : Allows the player to use the command /afk. By default all players have this.
- whosafk.autoafk : Allows the player to automatically go into AFK mode if he stands still for a while. By default all players have this.
- whosafk.reload : Allows player to use the command /whosafkreload. By default this is given to operators.
This is the default config:
enabled: true
timeout: 60
allow-movement-while-afk: true
movement-affects-afk: true
allow-collisions: false
- auto-afk.enabled : If set to true, the plugin will automatically put players into AFK mode if they do nothing for a configurable amount of time.
- auto-afk.timeout : This is the number of seconds during which players must do nothing in order to be automatically put in AFK mode.
- allow-movement-while-afk : If set to false, players will not be able to move until they type /afk.
- movement-affects-afk : If set to true, players will automatically leave AFK mode if they move or some exterior force moves the player. NOTE: This has no effect if allow-movement-while-afk is set to false .
- allow-collisions : If set to false, other mobs or players cannot push players in AFK mode, which will push them out of AFK mode.
This plugin uses the scoreboard's teams. When the plugin is enabled, the plugin will create the team called "afkers" if it doesn't exist already. It will set the team color to blue and set the team suffix to " (AFK)" if the team is created. When players type /afk, they will be put into the "afkers". Once they type /afk again, or somehow else leave AFK mode, they will be taken out of the "afkers" team, and will not be in a team afterward.
If allow-collisions is set to true in the config, the team's collisions rule is set to NEVER when the plugin is loaded or reloaded. Otherwise, the team's collisions rule is set to ALWAYS.
API Documentation
WhosAFK calls an event when a player goes into AFK mode (either by command, or automatic) and when a player leaves AFK. Here's an example:
public void playerGoesIntoAFKMode(AFKStatusOnEvent e){
// Set a custom message:
e.setMessage(ChatColor.YELLOW + "- " + e.getPlayer().getName() + " is now AFK");
// Disable the message
e.setMessage(null);
// Cancel the event
e.setCancelled(true);
}
@EventHandler
public void playerLeavesAFKMode(AFKStatusOffEvent e){
// Set a custom message:
e.setMessage(ChatColor.YELLOW + "- " + e.getPlayer().getName() + " is no longer AFK");
// Disable the message
e.setMessage(null);
// Cancel the event
e.setCancelled(true);
}
Source Code
The source code is on GItHub. Click here to view on GitHub.
To-do List
- Add Configuration file Done!
Highlights
From source dataGame versions
Supports 7 Minecraft versions, the newest being 1.16.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
WhosAFK on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- v1.3.0, released 2020-07-19
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.7 to 1.16 (7 versions) | 1.16 |
| Spigot | 1.7 to 1.16 (7 versions) | 1.16 |
From 5 recorded builds of WhosAFK.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| v1.3.0 | 2020-07-19 | 1.7 to 1.16 (7 versions) | Spigot, Paper |
| v1.2 | 2016-12-01 | n/a | Spigot, Paper |
| 1.1.1 | 2016-08-17 | n/a | Spigot, Paper |
| 1.1 | 2016-08-17 | n/a | Spigot, Paper |
| 1.0 | 2016-03-07 | n/a | Spigot, Paper |
Run WhosAFK on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists WhosAFK as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.16 and 6 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-01Open ↗
- ✓AuthorDrOverbuild, as published on SpigotMC
- ✓LicenseNot published by the sourceFree










