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

* Reward Visuals & Sound: Players are automatically marked as AFK after a configurable period of inactivity (no movement, interactions, etc.). * Reward Visuals & Sound: 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). * Reward Visuals & Sound: Any configured activity (movement, interaction, etc.) will automatically remove the AFK status and restore the player's name. * Reward Visuals & Sound: Easily set the inactivity time required to trigger AFK status in the `config.yml`. * Reward Visuals & Sound: All messages sent to players and command responses are fully configurable, supporting standard Minecraft color codes (`&`). * Reward Visuals & Sound: Reward your AFK players by executing a configurable console command at regular intervals. Perfect for rewarding playtime! * Reward Visuals & Sound: 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...

- ... Leave a comment on SpigotMC page.

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!