VoidAFK
PluginMIT

VoidAFK

Void AFK - Simple & Configurable AFK Manager with Rewards

47
Downloads
1
Followers
10 months ago
Updated
📦
3
Versions

📖About VoidAFK

Void AFK - Simple & Configurable AFK Manager with Rewards

What is Void AFK?

  • Void AFK is a lightweight and easy-to-manage plugin for your Minecraft server that helps you automatically detect and handle AFK (Away From Keyboard) players. Keep track of who's actively playing and even reward those who spend time on your server!

Features

  • Automatic AFK Detection: Players are automatically marked as AFK after a configurable period of inactivity (no movement, interactions, etc.).
  • Visual AFK Tag: Players marked as AFK get a customizable prefix or tag added to their name, both in the chat display name and the player list (tab menu).
  • Activity Monitoring: Any configured activity (movement, interaction, etc.) will automatically remove the AFK status and restore the player's name.
  • Configurable Threshold: Easily set the inactivity time required to trigger AFK status in the config.yml.
  • Customizable Messages: All messages sent to players and command responses are fully configurable, supporting standard Minecraft color codes (&).
  • Optional Rewards System: Reward your AFK players by executing a configurable console command at regular intervals. Perfect for rewarding playtime!
  • Highly Configurable Rewards: Configure the reward interval (in minutes), the console command template (%player% placeholder supported), an optional player message, and add visual flair with customizable particle and sound effects!
  • Reward Visuals & Sound: Make rewards satisfying with configurable particles and sounds played around the player upon receiving a reward.

Placeholders (install PlaceholderAPI plugin to use it)

  • %voidafk_is_afk% (true/false)
  • %voidafk_afk_time% (formatted time)

Commands

  • /voidafk reload - Reloads the plugin's config.yml.
  • /voidafk reward <command_template> - Sets the console command template for rewards. Use %player% as a placeholder.
  • Alias: /vafk

Permissions

  • voidafk.reload - Allows using the /voidafk reload command. (Default: OPs)
  • voidafk.reward - Allows using the /voidafk reward command. (Default: OPs)

Installation

  1. Download the latest VoidAFK-VERSION.jar file from this page.
  2. Place the JAR file into the plugins folder of your Spigot/Paper server.
  3. Start or restart your server.
  4. (Optional) Edit the generated plugins/VoidAFK/config.yml to customize settings. Use /voidafk reload in-game or in console to apply changes.

Support & Reporting Issues

If you find any bugs, have feature requests, or need help, please...

Providing server version, plugin version, and any relevant console errors will help a lot!


Credits

Developed with passion by Void Labs.


Future Plans

  • Add an /afk command for players to manually toggle AFK status.
  • Implement preventing more specific actions while a player is AFK.
  • More options for the AFK tag (eg. changing displayname).
  • More functionalities

Stay tuned for updates!