- Loaders
- Fabric
- Downloads on Modrinth
- 664
- Followers on Modrinth
- 1
- versions
- 2
- Updated
- July 15, 2026Jul 15
- Published
- in 2026
At a glance
Install in the game only; not needed on the server
safe-afk
safe-afk is a client-only Fabric mod for Minecraft Java Edition 26.2.
It provides nearby-player warnings, optional automatic disconnection when a non-whitelisted player comes too close, and prevents the pause menu from opening automatically when the game window loses focus. All features can be configured through ModMenu.
Versions
- Mod version:
3.1.1+26.2 - Minecraft Java Edition:
26.2 - Java runtime:
25+ - Fabric Loader:
0.19.3 - Fabric API: not required
- ModMenu: optional,
18.xon 26.1.2 and20.xon 26.2 - Author:
ozozorz - Homepage: https://github.com/ozozorz/safe-afk
- Issues: https://github.com/ozozorz/safe-afk/issues
Build
$env:GRADLE_USER_HOME = "$PWD\.gradle"
.\gradlew.bat buildThe mod jar will be created under build/libs/.
The maintained release jars are:
safe-afk-3.1.0+26.1.2.jarfor Minecraft Java 26.1.2safe-afk-3.1.1+26.2.jarfor Minecraft Java 26.2
The ModMenu configuration screen supports English (en_us) and Simplified Chinese (zh_cn).
To build both maintained release jars from a clean workspace:
.\scripts\build-releases.batThis project compiles against Mojang's named 26.2 client jar directly because 26.2 does not publish Mojang method mappings or Yarn mappings.
Config
On first launch the mod writes config/safe-afk.json.
{
"proximity": {
"enabled": true,
"range": 128.0,
"whitelist": [],
"warningCooldownTicks": 100,
"actionBar": true,
"chat": false,
"sound": true,
"maxDisplayedPlayers": 3
},
"autoDisconnect": {
"enabled": false,
"range": 32.0,
"whitelist": []
},
"noEscMenu": {
"enabled": true
}
}The two player whitelists are independent. Both accept player names, dashed UUIDs, or UUIDs without dashes.
FAQ
How to install Safe AFK?
Install Fabric for your Minecraft version, download Safe AFK for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does Safe AFK support?
Safe AFK has builds for Minecraft 26.1.2–26.2.
Is Safe AFK needed on the server?
Client only — no need to install it on the server