
AFK Guard
Automatic disconnect from game if damaged while AFK.
About this Mod
AFK Guard Mod
A client-side Fabric mod that protects you while you're AFK by automatically disconnecting if you take damage. AFK in peace.
Features
- AFK Protection: Automatically disconnects the client if you take damage while the guard is active.
- Auto-AFK: Automatically enables the guard after a configurable period of inactivity (default: 30 seconds).
- Configurable: Customize the delay, status messages, and damage sources.
- Ignore Player Damage: Option to ignore damage from other players (useful for preventing combat logging, can be disabled).
Usage
Keybinds
- Toggle AFK Guard: Manually enable/disable the guard. (Check your keybinds menu to set).
- Toggle Auto-AFK: Enable/disable the automatic AFK timer.
Commands
All commands start with /afkguard:
/afkguard config- View the current configuration./afkguard delay <seconds>- Set the inactivity time before Auto-AFK triggers./afkguard messages <true|false>- Toggle status messages on enable/disable./afkguard ignoreplayerdamage <true|false>- Choose whether damage from other players should trigger a disconnect.
Configuration
The config file is located at .minecraft/config/afkguard.json. You can edit it manually or use the in-game commands. Cloth config is also supported. I recommend using mod menu with cloth config api to configure the mod in-game.
Available Versions
How to Install AFK Guard on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.1).
Install Mod
Open the mod browser in the dashboard and search for "AFK Guard". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.1, 26.1, 1.21.11
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
AFK Guard server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.1). You can switch loaders with one click in the panel.
Is AFK Guard compatible with fabric?
AFK Guard officially supports fabric for Minecraft 26.1.1, 26.1, 1.21.11. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with AFK Guard – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if AFK Guard consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install AFK Guard with just one click on your server.
Details
- License
- Creative Commons Attribution Non Commercial 4.0 International
- Server-side
- Unsupported