JustAFK 1.0.0

The first public release of JustAFK, a lightweight and configurable server-side AFK plugin for Minecraft 26.2.

Added

• Automatic AFK detection after a configurable inactivity period
• Default inactivity timeout of 300 seconds
• Position-only activity detection
• Camera rotation does not reset the inactivity timer
• Immediate AFK removal when a player changes position
• Manual AFK toggling with /afk
• Administrative control over other online players
• Explicit on, off, and toggle actions
• Configurable announcement audiences: all, ops, and none
• Optional AFK duration prefix in the TAB player list
• Whole-minute duration labels below one hour
• Whole-hour duration labels from one hour onwards
• Preservation of existing player-list names where possible
• Immediate configuration saving through administrative commands
• Runtime configuration reloads
• Command tab completion
• Legacy & colour-code support
• Folia-aware global and entity scheduling
• Bukkit permission support for permission managers such as LuckPerms

Commands

• /afk
• /afk <player> [on|off|toggle]
• /justafk help
• /justafk status
• /justafk reload
• /justafk set timeout <seconds>
• /justafk set announcements <all|ops|none>
• /justafk set playerlist <on|off>

The /jafk alias is also available.

Permissions

• justafk.use — toggle your own AFK state
• justafk.others — manage another online player's AFK state
• justafk.config — access administrative configuration commands
• justafk.admin — grant every JustAFK permission

Compatibility

• Paper 26.2 — primary platform
• Purpur 26.2 — supported as a Paper fork
• Folia 26.2 — Folia-aware scheduler integration included
• Spigot and Bukkit — best-effort compatibility, not yet declared as supported loaders
• Sponge and proxy platforms — not supported

Requirements

• Minecraft Java Edition 26.2
• Java 25
• Server-side installation only
• No required dependencies
• No client installation required

Build and tests

• Built with Gradle 9.1
• Compiled against Paper API 26.2.build.84-stable
• 7 tests executed successfully
• 0 failures
• 0 errors
• 0 skipped

Notes

• JustAFK marks players as AFK but does not kick, freeze, teleport, or punish them.
• AFK states are session-based and reset when a player disconnects.
• Paper is the primary and most extensively validated platform.
• Full server restarts are recommended instead of hot plugin reloaders.
• Changing only player-list.format while a player is already AFK may not become visible until the displayed duration changes.