What is AlertAFK?

AlertAFK allows players to designate themselves as AFK, so that other
players talking to them in chat are notified that they are not

  • Players can designate a custom AFK message, which will be displayed to users mentioning them (and optionally broadcast to the server when they go AFK, if broadcastGlobally is enabled)
  • Players are automatically set back to available when they return to the game - there’s no need to remember to run a command
  • Players can designate custom "aliases" that will also trigger a notification that they are unavailable
  • Several command aliases are available, should there be any incompatibilities with existing plugins.

AlertAFK was built as light-weight as possible, but this is still my
first relatively comprehensive plugin (code-wise; the user interaction
is, of course, extremely simple :)), so it may be inefficient in some
aspects. Please feel free to suggest changes if you think something
could be better - in fact, I encourage you to. (What fun is open-source,
community-driven software if only one person is writing it?)

AlertAFK is entirely open-source, and is licensed under the GNU
General Public License version 3. Here’s what that means for you:

  • Feel free to do whatever you want with AlertAFK
  • Feel free to share AlertAFK with whoever you want
  • Don’t sell it.
  • Don’t license anything using AlertAFK with a more restricting license.

I believe in open software, and I believe in freedom of information.
Let’s use it responsibly and be an example to the world.


This is the usage for toggling AFK:

/<command> [optional AFK message]

That’s it. These are the commands:

  • /afk
  • /a
  • /away

This is the usage for setting aliases:

/alias <add/del/list/clear> [alias]


There are currently only two values that you need to worry about in AlertAFK’s configuration file.
There is broadcastGlobally, defaulting to false, which defines
whether or not to broadcast to the entire server when a user goes AFK or
becomes available again, and defaultAfkMessage, which is the default
AFK message to be provided, should the user not provide one. User-defined aliases are also stored in the configuration file, and can be modified from the configuration file, but are primarily modified from in-game. The
configuration file will be generated on first-run, you do not need to
create it manually.

Note: AlertAFK makes use of Hidendra’s Griefcraft Metrics. These
statistics are entirely anonymous, and do not affect performance in any
way. These statistics help me to get an idea of who’s using AlertAFK
and how, but I respect your right to privacy - should you wish to
disable these usage statistics, please opt-out in the
PluginMetrics/config.yml file, generated on first-run.

Latest version

1.1, CB 1.4.7-R1.0
Usage statistics

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of LHammonds LHammonds Sep 05, 2013 at 05:36 UTC - 0 likes

    Setting an AFK prefix would be handy. If anyone sends a msg, getting a response that they are AFK would also be great. I don't know if it is possible to modify the color of peoples names when listed after pressing TAB but that would be another great way to let people know who is AFK...such as a configurable color like dark gray.




    Minecraft Server:

  • Avatar of rmsy rmsy Jul 23, 2013 at 19:50 UTC - 0 likes

    @fungreenfox: Go

    I'm going to re-do this plugin soon, anyway.

  • Avatar of fungreenfox fungreenfox Jul 20, 2013 at 17:07 UTC - 0 likes

    the /a is already in use for adminchat.

  • Avatar of RFSMassacre RFSMassacre Jun 15, 2013 at 23:14 UTC - 0 likes

    This plugin works perfectly! All that's missing is the ability to add a prefix for a player's name when they are AFK. That way when people login after a player has put themselves as AFK they will know if they are away or not.




Date created
Dec 20, 2012
Last update
Dec 21, 2012
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent file


  • Avatar of rmsy
    • Manager
    • Author