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