AntiAFK Plugin

A complete Anti-AFK plugin for Minecraft Paper 1.21.10 that automatically detects and kicks inactive players.

✨ Features

• 🎯 Automatic AFK Detection - Detects players who are inactive for too long
• ⚠️ Warning System - Warns players before they get kicked
• 🎮 Manual AFK Toggle - Players can mark themselves as AFK with /afk
• ⚙️ Fully Configurable - Customize timeouts, messages and detection
• 🛡️ Permission System - Staff can bypass AFK detection
• 📢 Broadcast Messages - Server is informed when players go AFK or return

📋 Requirements

• Minecraft: 1.21.10
• Server Software: Paper (or forks like Purpur)
• Java: 21 or higher

📥 Installation

1. Download the latest AntiAFK-1.0.0.jar from releases
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Customize the configuration in plugins/AntiAFK/config.yml
5. Use /afkreload to reload the configuration

⚙️ Configuration

The configuration is located in plugins/AntiAFK/config.yml:

# Time in seconds before a player is considered AFK
afk-timeout: 300

# Time in seconds before the warning is given
warning-time: 270

# Check interval in ticks (20 ticks = 1 second)
check-interval: 100

# Messages (use & for color codes)
messages:
  kick: "&cYou have been kicked for inactivity!"
  warning: "&eWarning: You will be kicked in {time} seconds for inactivity!"
  afk-enabled: "&7You are now AFK"
  afk-disabled: "&7You are no longer AFK"
  player-afk: "&7{player} is now AFK"
  player-back: "&7{player} is back"
  reload: "&aConfiguration reloaded!"
  no-permission: "&cYou don't have permission to do this!"

# Actions that reset AFK status
detect-movement: true
detect-chat: true
detect-block-break: true
detect-block-place: true
detect-interact: true
detect-damage: true

Configuration Options

| Option | Default | Description |
|--------|---------|-------------|
| afk-timeout | 300 | Seconds before player gets kicked |
| warning-time | 270 | Seconds before warning is given |
| check-interval | 100 | Ticks between each check (20 = 1 sec) |
| detect-movement | true | Detect movement as activity |
| detect-chat | true | Detect chat as activity |
| detect-block-break | true | Detect block breaking as activity |
| detect-block-place | true | Detect block placing as activity |
| detect-interact | true | Detect interactions as activity |
| detect-damage | true | Detect damage as activity |

🎮 Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /afk | Toggle your AFK status manually | antiafk.command |
| /afkreload | Reload the plugin configuration | antiafk.reload |

🔐 Permissions

| Permission | Default | Description |
|------------|---------|-------------|
| antiafk.command | true | Use the /afk command |
| antiafk.bypass | op | Bypass AFK detection (for staff) |
| antiafk.reload | op | Reload the configuration |

Permission Examples

LuckPerms:

# Give moderators bypass permission
lp group moderator permission set antiafk.bypass true

# Give admins reload permission
lp group admin permission set antiafk.reload true

🔍 How it Works

1. Activity Tracking: The plugin tracks when players were last active
2. Periodic Checks: Every X ticks (configurable) it checks if players have been inactive too long
3. Warning: At warning-time seconds the player receives a warning
4. Kick: At afk-timeout seconds the player gets kicked
5. Broadcast: Other players are informed when someone goes AFK or returns

Detected Activities

The plugin detects the following activities (if enabled in config):

• ✅ Movement (position change, not just head rotation)
• ✅ Chat messages
• ✅ Breaking blocks
• ✅ Placing blocks
• ✅ Interactions (buttons, doors, etc.)
• ✅ Taking damage
• ✅ Executing commands

📝 Examples

Example 1: Default Usage

Player is inactive for 4 minutes
→ At 4:30 minutes: "⚠️ Warning: You will be kicked in 30 seconds for inactivity!"
→ At 5:00 minutes: Player gets kicked

Example 2: Manual AFK

Player: /afk
→ "You are now AFK"
→ Server: "Player123 is now AFK"

Player moves
→ "You are no longer AFK"
→ Server: "Player123 is back"

Example 3: Staff Bypass

Staff with antiafk.bypass permission
→ Never gets kicked, regardless of inactivity

🐛 Troubleshooting

Players are not getting kicked:

• Check if afk-timeout is set correctly
• Verify players don't have antiafk.bypass permission
• Verify the plugin is loaded correctly with /plugins

Warnings don't work:

• Make sure warning-time is less than afk-timeout
• Check the console for errors

Config changes don't work:

• Use /afkreload after editing the config
• Or restart the server

📄 License

This project is open source and available for personal and commercial use.

---

Made with ❤️ for the Minecraft community