JustAFK
JustAFK brings a simple, multilingual, and powerful AFK (away from keyboard) plugin to Bukkit servers.
Installation
To install JustAFK, simply drop the jar file into your server's plugin directory and reload! A configuration file will be automatically created which you can edit to fine-tune your own installation.
Localization
As of JustAFK v1.2, you can completely customize the messages associated with JustAFK by editing the generated localization.yml file after loading the plugin. You can use it to simply change the way the messages look, or to translate to another language. This should work with most languages, but you may run into some issues with certain character types. If you have any problems with the plugin after doing a translation please let me know in the comments below.
If you'd like to contribute your translation for JustAFK, please let me know and I'll work with you to get it included as a download alongside the plugin. Thanks!
Currently Included Languages:
- English
- Traditional Chinese
- Italian
- German
- Danish
- Dutch
Features
- Optional, automatic kicking of AFK players
- Outwits methods used to circumvent automatic AFK
- Configurable AFK time limit
- Configurable kick message
- Players are automatically hidden from others when going AFK
- Automatic detection of players returning from AFK (e.g. when moving or chatting)
- Set a status when going AFK
- Fully customizable messages via the generated
localization.ymlfile
Commands
| Basic Commands | Description |
|---|---|
| /afk | Sets yourself to away, making your player invisible and broadcasting a message to the server. |
| /afk [reason] | Sets yourself to away as above, but also includes a reason. |
| /whosafk | Shows you a list of who is currently set to away on the server. |
| /justafk | Gives you a bit of information about JustAFK. |
| Administrative Commands | |
| /setafk <player> | Sets the specified player to away. |
Permissions
| Node | Description |
|---|---|
| justafk.basic | The basic permission node which allows for full use of the plugin. |
| justafk.immune | Makes the player immune to auto-afk and auto-kicking. |
| justafk.admin | Gives the player access to the admin commands (seen above) included in the plugin. |
Configuration
| Setting Node | Default | |
|---|---|---|
| tagmessages | true | All AFK messages will be tagged with "[JustAFK]". |
| hideawayplayers | true | If true, players going AFK will be hidden on the server. |
| broadcastawaymsg | true | Sets whether or not away messages will be broadcasted to the entire server. |
| autokick | true | Players will be kicked automatically if inactive. |
| movementcheckfreq | 15 | The frequency to check for player inactivity. |
| kicktime | 300 | The time that a player can be AFK before being kicked. |
| kickreason | Reason | The reason to give when kicking an AFK player. |
| kickwhileinvehicle | true | Kick players that aren't looking around but are moving in a vehicle. |
All time is in seconds.
Miscellaneous
To get support for JustAFK or to suggest new features, just leave a comment on this page and I'll see what I can do about it!
Comments
-
_ForgeUser10460770 Owner
-
View User Profile
-
Send Message
Posted Aug 13, 2013@MGbeenieboy
Are you running the latest version? (1.2.5)
-
View User Profile
-
Send Message
Posted Aug 13, 2013please set it optional that players become invisibility, it's buggy :/
-
View User Profile
-
Send Message
Posted Aug 8, 2013@underscoreAlex
If its not difficult/too much of a hassle to implement, please :-)
-
View User Profile
-
Send Message
Posted Aug 7, 2013@ThisUsernameIsMine
Formatting code as in colors? I'm afraid this isn't possible in the plugin's current state. I have limited it to ensure that the messages always look consistent. I could look into changing it to allow color codes, however. Just depends on if it's something that everyone truly wants or not.
@Boyka31
I'm afraid I don't quite understand what you're saying/asking. If you would be willing to provide a Hungarian translation I will gladly add it to the downloads.
-
View User Profile
-
Send Message
Posted Aug 7, 2013Let him be Hungarian in a language! I am Hungarian!
-
View User Profile
-
Send Message
Posted Aug 7, 2013Is it possible to use formatting code for the JustAFK prefix and the messages?
Thnx 4 the plugin! :-)
-
View User Profile
-
Send Message
Posted Aug 6, 2013@marubal21
I have replied to your PM about this. Sorry I hadn't noticed the comment before!
-
View User Profile
-
Send Message
Posted Aug 6, 2013@a1anna
I'm very glad that you enjoy the plugin! Thanks for the kind words!
-
View User Profile
-
Send Message
Posted Aug 3, 2013Hi! This is exactly what I was looking for; Essentials has /afk but no automatic kick or automatic afk and I don't know if it has any sort of good un-afk'ing from moving or chatting. I also need a bit of a timer, so a player can be afk only for 10 minutes or something, and this has that. I also really like that you show the configuration for people who might not understand. Your work is much appreciated! Thanks!
-
View User Profile
-
Send Message
Posted Aug 2, 2013Hi, i love this plugin, but its kinda annoying that every time the server starts up this plugin replaces/over-rides my PluginMetrics settings.
I currently use 'JustAFK v1.2.3' on my 1.5.2 server, and i choose to opt-out of reporting plugin metrics, but for some reason this plugin overrides my current setting with its own and opts me into report plugin metrics data.
Could you possibly fix this?
-
View User Profile
-
Send Message
Posted Aug 1, 2013@ridddle
Right, but the
kickwhileinvehicleis supposed to force the kick, or at least should. I coded JustAFK long ago, so I won't lie and say I remember my thought process when creating it.-
View User Profile
-
Send Message
Posted Aug 1, 2013I believe that is mostly due to the fact that yaw changes when you take a corner in Minecart and pitch can change when you go up or down a slope.
And yes, I do have
kickwhileinvehicle: true.-
View User Profile
-
Send Message
Posted Jul 29, 2013@ridddle
I'll look into all of that for you. The minecart issue must be due to a bug, assuming you have
kickwhileinvehicleset to true. As for the GUI issue.. I'm not sure how that would stop a kick, other than a bug in Bukkit. I'll look into it for you!-
View User Profile
-
Send Message
Posted Jul 29, 2013Hey there! Is there a way to force minecart kicks on players? I have AFK time setup to 1h and there is no way someone can legitimately travel 1h in a cart.
Also, I believe there is a small loophole that prevents a player who has a chest GUI opened from being booted.
-
View User Profile
-
Send Message
Posted Jul 25, 2013@sbl03
I sure do! The cursor is one of the main factors in determining the player's status. If their pitch and yaw remain the same even if they're walking around they are still seen as away. This helps defeat many AFK machines. In theory, the player's pitch and yaw should only change with user input. In practice this doesn't hold up 100%, but it is still fairly accurate. There are other compensations for that inaccuracy though.
-
View User Profile
-
Send Message
Posted Jul 25, 2013@underscoreAlex
Thank you for the quick response! That makes a lot of sense. I have a suggestion - do you check where the player's cursor is pointed at? That might be worth including with the player's location.
-
View User Profile
-
Send Message
Posted Jul 24, 2013@sbl03
I'm glad you like it! To answer your question:
movementcheckfreqis, how it sounds, how often the plugins checks for inactivity. The first time it runs the check it saves the location of the player for reference. When it runs again it checks their current location against the last. If they are the same, the plugin assumes the player is inactive and therefore will mark them as such. From there, they will be kicked after the number of seconds you have configured forkicktime.In short, the
movementcheckfreqis how long a player must be "afk" before being actually set as away.As an example: If you set your
movementcheckfreqto 120 seconds, the player will have to remain stationary (in the plugin's eyes) for 120 seconds before being marked as away.I hope this made sense for you! I've taken note of that bug. It's a really easy fix but isn't crucial. I'll include it in the next update. If you need anything else just let me know.
-
View User Profile
-
Send Message
Posted Jul 24, 2013Hi, thanks for this fantastic plugin. It really serves my purpose well. One question - could you elaborate more on what movementcheckfreq does? I would like to configure when the game notifies the player that they are afk before actually kicking them, but I'm not sure if changing this setting will make it less effective. Example, if I have that setting set to 5 minutes, and the kicktime to 20 minutes, and somebody is afk'ing next to a grinder. Does that mean that the plugin records the player's 'state' every 5 minutes, and when there is a period of 20 minutes where the 'state' recorded is continuously the same, that player is kicked?
Hopefully that makes sense, thanks!
Also, I have a small bug report:
java.lang.ClassCastException: org.bukkit.craftbukkit.v1_5_R3.command.ColouredConsoleSender cannot be cast to org.bukkit.entity.Player
when I run '/whosafk' in console.
-
View User Profile
-
Send Message
Posted Jul 21, 2013@TheLecturer
This has been addressed with the latest release, version 1.2.4. It's pending approval now. Thanks for making me aware!
-
View User Profile
-
Send Message
Posted Jun 19, 2013I have the following set in my config :
hideawayplayers: false
Yet they still vanish on AFK...
Let me know if you want any version info etc..