VanillaAFK Plugin

A simple and lightweight AFK plugin with custom overhead messages for Paper servers.

📦 Installation

1. Download the VanillaAFK.jar file
2. Place it in your server's plugins/ folder
3. Restart the server

🎮 Usage

Basic Commands:

• /afk - toggle AFK mode
• /afk [text] - enter AFK with custom text
• /afk reload - reload configuration

Examples:

• /afk - AFK with default text
• /afk Gone for lunch - AFK with custom text
• /afk &cBe back soon - AFK with colored text

⚙️ Configuration

All settings are located in plugins/VanillaAFK/config.yml:

Messages:

messages:
  afk-enabled: "&aYou entered AFK mode with text '&f<text>&a'"
  afk-disabled: "&aYou exited AFK mode"
  default-afk-text: "&7AFK"

🎨 Text Formatting

Supports standard Minecraft color codes:

Colors:

&0 - Black

&1 - Dark Blue

&2 - Dark Green

&3 - Dark Aqua

&4 - Dark Red

&5 - Purple

&6 - Gold

&7 - Gray

&8 - Dark Gray

&9 - Blue

&a - Green

&b - Aqua

&c - Red

&d - Pink

&e - Yellow

&f - White

Formatting:

&k - Obfuscated

&l - Bold

&m - Strikethrough

&n - Underlined

&o - Italic

&r - Reset

🔐 Permissions

vanillaafk.customtext - use custom AFK text

vanillaafk.reload - reload plugin configuration

📋 Features

Custom overhead messages with color formatting

Animated sandclock emoji (configurable)

Movement detection to exit AFK mode

Support for both Bukkit colors and HEX colors

Easy configuration reload

Lightweight and optimized

🐛 Support

If you encounter any issues or have suggestions, please create an issue on GitHub.