JustAFK v1.0.0 — Initial Release
JustAFK v1.0.0
The first public release of JustAFK, a lightweight and configurable AFK plugin for Minecraft 26.2 servers.
✨ Highlights
- Automatic AFK detection after a configurable period without positional movement
- Looking around does not reset the inactivity timer
- Positional movement immediately removes the AFK state
- Manual AFK toggling with
/afk - Operator control over other online players
- Configurable announcements for everyone, operators only, or nobody
- Optional AFK duration prefix in the TAB player list
- Immediate persistence of command-based configuration changes
- Bukkit and Folia-aware scheduling
- No NMS usage or external runtime dependencies
🧰 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 for administrative commands.
⚙️ Requirements
- Minecraft 26.2
- Java 25
✅ Compatibility
- Paper 26.2 — primary platform
- Purpur 26.2 — supported as a Paper fork
- Folia — scheduler support included
- Spigot and Bukkit — best-effort compatibility
- Sponge — not supported
📦 Installation
- Download
JustAFK-1.0.0.jarfrom the assets below. - Place the JAR inside the server's
pluginsdirectory. - Start or restart the server.
- Edit
plugins/JustAFK/config.ymlif needed. - Run
/justafk reloadafter manual configuration changes.
🧪 Build and tests
This release was built using:
- Java 25
- Gradle 9.1
- Paper API
26.2.build.84-stable - JUnit 5
Test results:
- 7 tests executed
- 0 failures
- 0 errors
- 0 skipped
🔐 Checksum
JustAFK-1.0.0.jar
SHA-256: F52A5D5653B29ECB2EEAD79F74A5391C6E04893AC5B4186EBF653C564B0BB922
⚠️ Notes
- Folia scheduler support is included, but additional live-server validation is recommended.
- Spigot and Bukkit support is provided on a best-effort basis.
- Changes to the TAB prefix format may only become visible when the displayed duration changes.
- The generated plugin JAR is provided as a release asset and is not stored in the source repository.
Thank you for trying JustAFK!