Source-checkedAdmin & protection

WhosAFK

by DrOverbuild · for Minecraft

A plugin that lists the players who are AFK in the tab list

57KDownloads
6 yr agoLast updated
Spigot · PaperLoaders
1.16Latest game version

About WhosAFK

From SpigotMC

A 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 .
Permissions
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.
Configuration
This is the default config:
Code (Text):
auto-afk:
  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.
Other Info
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:

Code (Text):
    @EventHandler
    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 data

Game 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

LoaderGame versionsNewest
Paper1.7 to 1.16 (7 versions)1.16
Spigot1.7 to 1.16 (7 versions)1.16

From 5 recorded builds of WhosAFK.

Recent builds

BuildReleasedGame versionsLoaders
v1.3.02020-07-191.7 to 1.16 (7 versions)Spigot, Paper
v1.22016-12-01n/aSpigot, Paper
1.1.12016-08-17n/aSpigot, Paper
1.12016-08-17n/aSpigot, Paper
1.02016-03-07n/aSpigot, 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 catalog
Listed on SpigotMC as “Admin”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

SpigotMC 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

WhosAFK, answered

Generated from the mod’s own source data.

Do my players need to install WhosAFK?

SpigotMC lists WhosAFK as required on the server. Check its SpigotMC page to see whether players need it too.

Which loaders does it support?

Spigot and Paper.

Is it free?

Yes. WhosAFK is free to download from SpigotMC.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run WhosAFK on a Minecraft server.

Deploy in about a minute from $4.99 a month, then add WhosAFK in one click.