First Install

Documents AntiAFKPlus 6.4.0 · mirrored from the product wiki, updated 2026-02-08

Guide on how to set up AntiAFKPlus for the first time.

Installation

Download AntiAFKPlus.jar from the resource page
Place the .jar file into your server's plugins/ folder
Restart (or start) your server
The plugin will generate default configuration files in plugins/AntiAFKPlus/

Always use a full server restart rather than /reload for first-time setup. Live reloads can cause issues with listeners and scheduled tasks.

Default Files Generated

After the first startup, the following files will be created:

plugins/AntiAFKPlus/
├── config.yml        # Main configuration
├── messages.yml      # All player-facing messages
└── data/
    └── antiafkplus.db  # SQLite database (if using SQLite storage)

Default Behavior

Out of the box, AntiAFKPlus is configured with a 5-minute kick cycle:

Time (seconds)	Stage	Action
120 (2 min)	Stage 1	Actionbar warning: "You seem to be AFK"
240 (4 min)	Stage 2	Title warning + notification sound
270 (4.5 min)	Stage 3	Boss bar countdown: "You will be kicked in..."
300 (5 min)	Stage 4	Kick with message

You can fully customize these stages in config.yml. See Warning Stages & Actions.

Optional Setup

PlaceholderAPI

If you want to use AFK-related placeholders in scoreboards, tab plugins, or holograms:

Install PlaceholderAPI
No additional setup needed — AntiAFKPlus registers its placeholders automatically

LuckPerms Groups

To set different AFK timeouts for different player groups:

Install LuckPerms
Configure the groups: section in config.yml
See Per-Group Settings for details

Vault Economy

To charge a fee when a player is kicked for AFK:

Install Vault and an economy plugin (e.g., EssentialsX)
Enable economy.fee-on-kick in config.yml
See Economy for details

WorldGuard Zones

To create regions where AFK rules differ:

Install WorldGuard
Enable zones in config.yml and define your regions
See Zones for details

Verify It's Working

Run /antiafk debug to enable debug mode. You'll see detection events logged in the console, such as:

[AntiAFK] [Debug] Steve: Activity: head-rotation
[AntiAFK] [Debug] Steve: Activity: block-break

This confirms that the plugin is tracking player activity correctly. Run the command again to disable debug mode.

Next Steps

Commands & Permissions — Learn all available commands
Configuration — Fine-tune settings for your server
Features — Explore all detection methods and features

Ready to run it? Get AntiAFKPlus — Configurable AFK detection with actions, permissions, and PlaceholderAPI.