JustAFK

JustAFK 1.1.0

JustAFK 1.1.0 introduces two major improvements: complete runtime control over the plugin and a new input-aware AFK detection system.

Player activity is no longer inferred from changes in position. JustAFK now detects actual movement input reported by the player, preventing external forces from incorrectly removing AFK.

JustAFK 1.1.0 requires Minecraft 1.21.3 or newer and Java 21 or newer.

Servers below Minecraft 1.21.3 should continue using JustAFK 1.0.1.

Version 1.0.1 remains compatible with older Minecraft versions but uses the previous position-based activity detection. Entity pushes, knockback, arrows, and other external movement may therefore reset the inactivity timer or remove AFK.

Global plugin control

A new enabled configuration option can completely enable or disable JustAFK:

• enabled: true — the plugin operates normally
• enabled: false — all AFK functionality is disabled

The option can also be changed at runtime:

• /justafk set enabled on
• /justafk set enabled off

When the plugin is disabled:

• Players are no longer tracked for AFK activity
• Automatic AFK detection stops
• /afk no longer changes AFK states
• Administrative AFK changes are disabled
• Existing plugin-managed AFK states are cleared
• Player-list prefixes are restored
• AFK announcements and duration updates stop

Configuration-related commands remain available:

• /justafk help
• /justafk status
• /justafk reload
• /justafk set ...

This allows administrators to inspect, configure, and enable the plugin again without restarting the server.

Independent automatic AFK control

Automatic AFK detection can now be controlled separately through:

• automatic-afk-enabled: true
• automatic-afk-enabled: false

The option can also be changed at runtime:

• /justafk set automatic-afk on
• /justafk set automatic-afk off

When automatic AFK detection is disabled:

• Inactivity does not place players into AFK automatically
• /afk remains available
• Administrators can still control another player's AFK state
• Movement input still removes a manually applied AFK state
• Announcements and player-list prefixes continue working for manual AFK states

This makes it possible to use JustAFK exclusively as a manual AFK plugin.

Input-aware activity detection

JustAFK now uses PlayerInputEvent and current-input polling instead of detecting activity through position changes.

The following inputs count as player activity:

• Forward
• Backward
• Left
• Right
• Jump
• Sneak
• Sprint

When movement input is detected:

• The inactivity timer is restarted
• An AFK player immediately becomes active
• The AFK player-list prefix is removed
• The configured active announcement is sent

Immediate input events detect short key presses, while periodic polling keeps the player active while a movement key remains held.

External movement no longer removes AFK

Position changes without movement input no longer restart the inactivity timer.

Players remain AFK when moved by:

• Entity collisions
• Pets or mobs pushing the player
• Slimes
• Zombie attacks
• Skeleton arrows
• Knockback
• Explosions
• Flowing water
• Bubble columns
• Pistons
• Shulkers
• Gravity or falling
• Passive vehicle movement
• Server or plugin teleports
• Death
• Respawn

The AFK state and displayed duration are preserved during these events unless the player sends movement input.

Looking around with the mouse also remains ignored.

Configuration compatibility

Configuration files created by JustAFK 1.0.0 and 1.0.1 remain compatible.

If the new options are missing, both default to true:

• enabled: true
• automatic-afk-enabled: true

Existing configuration files do not need to be deleted or regenerated.

Compatibility changes

JustAFK 1.1.0 supports:

Platform	Versions
Bukkit / CraftBukkit	1.21.3–26.2
Spigot	1.21.3–26.2
Paper	1.21.3–26.2
Purpur	1.21.3–26.2
Folia	1.21.3–26.2, where a server build is available

The plugin is built against Paper 26.2 and compatibility-compiled against Spigot 1.21.3.

Both compilations must produce identical class files before the build passes.

Support for older Minecraft versions

Servers below Minecraft 1.21.3 can continue using JustAFK 1.0.1.

Version 1.0.1 supports:

Platform	Versions
Paper	1.8.8–26.2
Purpur	1.14.1–26.2
Folia	1.19.4–26.2
Spigot / CraftBukkit	1.8.8–26.2, best-effort

JustAFK 1.0.1 uses Java 8-compatible bytecode but does not include:

• Input-aware movement detection
• Protection against AFK removal caused by external movement
• The global enabled option
• The independent automatic-afk-enabled option

Java requirements

JustAFK 1.1.0 uses Java 21 bytecode and requires Java 21 or newer.

The server may require a newer Java version depending on its Minecraft version. For example, Paper 26.2 requires Java 25.

Technical changes

• Replaced PlayerMoveEvent activity tracking with PlayerInputEvent
• Added current-input polling through Player#getCurrentInput()
• Removed position comparisons from the AFK monitor
• Removed the obsolete position snapshot implementation
• Added global and automatic-AFK configuration flags
• Added runtime commands and tab completion for both flags
• Set api-version to 1.21.3
• Changed the bytecode target from Java 8 to Java 21
• Added compatibility compilation against Spigot 1.21.3
• Maintained Paper 26.2 as the primary API target
• Updated the README, default configuration, build checks, and tests
• No runtime dependencies added

Validation

• 25 automated tests passed
• All seven movement inputs tested individually
• Short input taps tested
• Held movement input polling tested
• External position changes verified not to affect AFK timing
• Global plugin disable behaviour tested
• Automatic AFK disable behaviour tested
• Spigot 1.21.3 compatibility compilation passed
• Paper 26.2 primary compilation passed
• Paper and Spigot bytecode parity verified
• Java 21 bytecode verified
• Manually tested successfully on a 26.2 server