
Smart AFK
Create a Paper 1.21.10 server-side plugin called SmartAFK+ that manages player inactivity with precision and advanced features, making AFK detection smarter...
00—paperServer1.21.10mod
SmartAFK+ Summary
- SmartAFK+ is a server-only Paper plugin for 1.21.10 that detects true AFK states from movement, camera changes, interactions (blocks/entities/inventory), combat, chat, commands, drops, and teleports. It dynamically ignores tiny nudges after long idling to prevent macro spam but keeps active players safe.
- AFK players get the configurable
tag.textprefix across chat, tab list, and nametags; their sleep state is ignored while AFK so night skipping isn’t blocked. Anti-spam cooldowns prevent repeated AFK/active broadcasts. - Automatic actions: mark AFK after
afk.timeout-seconds, optionally kick afterafk.kick.timeout-secondswith a custom message, and (if enabled) give periodic rewards (Vault economy, experience, or items) everyrewards.interval-seconds. - Zones: AFK detection is disabled inside configured cuboids under
zones.definitions(world + min/max coords). Use/afk setzone <name> <x1> <y1> <z1> <x2> <y2> <z2> [world]to add zones live; changes are persisted to the config. - Statistics: AFK time is tracked per player (all-time and today).
/afk stats [player]shows totals plus a configurable leaderboard (stats.leaderboard.*). - Player commands (permission
smartafk.afk.use):/afk toggle [on|off]to force AFK/manual return,/afk statusto see current state and idle time. - Admin commands (permission
smartafk.afk.admin):/afk reload,/afk setzone …,/afk stats <player>. Config reload re-applies detection, tags, rewards, zones, and leaderboard settings without restart. - Configuration (
config.yml): tune detection sensitivity (detection.*), AFK/kick timers, tag text, anti-spam cooldown, rewards, zones, sleep handling, and leaderboard size. An example zone is included as a template.