Overview
AFKControl is a modern AFK management plugin designed for Paper servers.
AFKControl uses smart detection logic to prevent false activity triggers caused by passive movement or minimal camera jitter.

Features

• Smart AFK detection (no fake movement)
• Camera-based activity system (yaw / pitch thresholds)
• Debounce system to prevent micro-movement spam
• Optional movement detection
• Multi-language support (EN, ES, PT-BR)
• PlaceholderAPI support
• MiniMessage-based messaging system
• Optimized for performance

Why AFKControl?
Most AFK plugins rely on movement detection.
Problems:

• Water or pistons mark players as active
• Small mouse movements reset AFK
• High-frequency events impact performance

AFKControl solves this by:

• Prioritizing camera movement over position
• Using thresholds to filter noise
• Applying debounce logic

Commands

Permissions

Permission	Description	Default
afkcontrol.toggle	Toggle AFK status manually	true
afkcontrol.status	Check own AFK status	true
afkcontrol.status.others	Check other players AFK status	op
afkcontrol.list	List AFK players	op
afkcontrol.reload	Reload configuration	op
afkcontrol.bypass	Ignore AFK detection	false
afkcontrol.admin	All admin permissions	op

Placeholders
[TD>Is player AFK[/TD]

Placeholder	Description
%afkcontrol_afk_players_count%	Number of AFK players
%afkcontrol_is_afk%
%afkcontrol_afk_time%	Readable AFK time
%afkcontrol_afk_stopwatch%	AFK time (MM:SS)
%afkcontrol_afk_seconds%	AFK time in seconds
%afkcontrol_afk_since%	AFK start timestamp

Configuration Highlights
Recommended: keep movement disabled to avoid false positives.

Performance
AFKControl is designed to be efficient:

• Minimal state updates
• Debounced event processing
• Activity cooldown system
• Thread-safe design

Requirements

• Paper / Spigot 1.21+
• PlaceholderAPI (optional)