Smart AFK banner
Smart AFK icon

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.text prefix 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 after afk.kick.timeout-seconds with a custom message, and (if enabled) give periodic rewards (Vault economy, experience, or items) every rewards.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 status to 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.