AFK Control icon

AFK Control -----

Lightweight AFK detector with warnings and kicks.




This maintenance release ensures full compatibility with Minecraft 1.21.10 (Paper & Spigot).
All existing features remain stable and backwards compatible with earlier versions (1.8.x → 1.21.10).


Changes & Fixes

Fixed: Version check + rendering correctness.
  • Minor internal adjustments for Paper API 1.21.10 field/method consistency.
  • Ensured all Adventure/MiniMessage components render correctly under 1.21.10.
  • Corrected version comparison so notifications are only shown when the loaded plugin is older than the Spigot release.
  • No console/OP spam when the remote version is equal to or older than the local plugin version.
  • Handles semantic versions and pre-release tags (alpha, beta, rc, SNAPSHOT) correctly.

New
  • Support for Minecraft 1.21.10
  • Updated build target and dependency to paper-api:1.21.10-R0.1-SNAPSHOT.
  • Verified AFK detection, Control Panel, PlaceholderAPI, and MiniMessage rendering remain fully functional.
  • Improved build metadata for clearer version tracking during startup (onEnable / onDisable now include plugin version).

Improvements
  • Cross-version reliability: confirmed safe operation from Spigot 1.8.8 through Paper 1.21.10.


Tested On
  • PaperMC 1.21.x
    Latest Paper build line where features and GUI interactions were verified.
  • Spigot 1.20.6
    Baseline Spigot compatibility check completed.

Supported Versions
  • Spigot/Paper 1.8.x → 1.21.x
    Cross-version color/formatting and GUI holders keep features stable on legacy + modern.

Install/Upgrade

Drop the new jar in /plugins and restart.
Full restart preferred over /reload to avoid stale listeners or tasks.


Compatibility

Release Type: Maintenance + Feature Enhancement
Tested On: PaperMC 1.21.x / Spigot 1.20.6
Supported Versions: 1.8.x → 1.21.x
----------, Oct 8, 2025

Changes & Fixes

• Fixed: MiniMessage and prefix rendering issues.
  • MiniMessage formatting now properly renders in chat.
  • Prefix display restored.
  • Players were instantly kicked upon rejoining after an AFK timeout due to outdated activity timestamps. Activity now refreshes automatically on rejoin to prevent repeat kicks.

• Added: Quality-of-life features for admins and operators.
  • Version update notifier: Sends a friendly join notification (with a clickable link) when a newer version is available on SpigotMC. Controlled by updates.enabled and permission afkcontrol.admin (customizable via updates.notifyPermission).
  • Admin Kick Command/afkcontrol kick <player> <reason>: Confirmation-based flow with a clickable [CONFIRM KICK] button, informative hover text, colorized console logs, and tab completion for player names and common reasons. Permission: afkcontrol.kick (included under afkcontrol.admin).
  • AFK Control Panel Toggle: The Status item is now toggleable (left/right click) to enable/disable AFK checks, with feedback to the player and console.

• Improved: Stability, clarity, and cross-version behavior.
  • Cleaner YAML handling and safer configuration fallbacks.
  • Cross-version stability: modernized MiniMessage/legacy color rendering works seamlessly from 1.8 → 1.21.
  • Panel layout polish: clearer timing icons and richer hover details.
  • AFKManager refactor: clearer, version-safe structure for tracking player activity and AFK pool regions; cleaner API for toggles, selections, and boundaries; beginner-friendly docs throughout.

Configuration Changes
(No breaking changes — existing setups remain valid.)​

messages.yml
Code (YAML):

updateAvailable
: "<yellow>A new version is available:</yellow> <gold><bold><latest></bold></gold> <gray>(you have <white><current></white>)</gray>"
updateLinkLabel
: "Click to open the Spigot page"
 
config.yml
Code (YAML):

updates
:
enabled
: true
spigotResourceId
: 129311
checkHours
: 12
notifyPermission
: afkcontrol.admin
downloadUrlOverride
: ""
 
(No changes required for users upgrading from earlier builds.)​

Compatibility

Release Type: Maintenance + Feature Enhancement
Tested On: PaperMC 1.21.x / Spigot 1.20.6
Supported Versions: 1.8.x → 1.21.x
----------, Oct 7, 2025

This update focuses on improving player experience after AFK kicks and tightening backend performance. Players will now be able to safely rejoin after being kicked for inactivity without being instantly removed again.


Changes & Fixes

• Fixed: Players were instantly kicked upon rejoining after an AFK timeout due to outdated activity timestamps.
  • Activity is now automatically refreshed when a player rejoins, preventing repeated AFK detections.
• Added: New PlayerJoinEvent and PlayerQuitEvent listeners ensure player states are properly reset and cleaned up between sessions.

• Improved: The AFK tracking system now clears old data on player quit and reinitializes when they return, reducing false detections and improving accuracy.

• Enhanced Stability: Internal memory cleanup and more efficient task handling for smoother performance, especially on larger servers.

• Version-Aware Logging: The plugin now displays its version number in console messages on startup and shutdown, making it easier to confirm which build is running.

• Tested On: PaperMC 1.21.x and Spigot 1.20.6 for compatibility and stability.​
----------, Oct 7, 2025

Resource Information
Author:
----------
Total Downloads: 10
First Release: Oct 6, 2025
Last Update: Oct 8, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings