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.x on 26.1.2 and 20.x on 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 build

The mod jar will be created under build/libs/.

The maintained release jars are:

• safe-afk-3.1.0+26.1.2.jar for Minecraft Java 26.1.2
• safe-afk-3.1.1+26.2.jar for 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.bat

This 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.