Automatically mutes the game while the Minecraft window is unfocused, then restores your exact volume the moment you come back. When you alt-tab away or go AFK, the mod stores your current master volume and sets it to 0%; when the window regains focus, your previous volume is restored — so the game never keeps blasting audio in the background, and you never have to touch the volume slider yourself.

📦 Install on the client. No server installation required — it works on any server (vanilla or modded) and in singleplayer.

🎮 Singleplayer note: Works perfectly in singleplayer — just drop it into your mods folder as usual.

ℹ️ Purely client-side: it only changes YOUR game's master volume. It never affects the server or other players, and it does not fight the volume slider while you are actively playing — it only acts when the window's focus actually changes.

Please report any bugs, errors, or feature suggestions on Discord: https://discord.gg/4XUPywnEyE

How it works:

Mute on focus loss: The instant the Minecraft window loses focus (alt-tab, switching apps, going AFK), master volume is set to 0%.
Restore on focus return: The instant the window regains focus, your previous volume is restored — down to the exact value you had.
Never loses your volume: The stored level survives world changes, menus, and even getting disconnected while muted (e.g. an AFK kick) — it is restored as soon as focus returns, never overwritten.
Optional action-bar message: A short "Game muted" / "Game volume restored" message can be shown when the state changes.
Toggle hotkey: Bind a key to enable or disable the mod on the fly, with the new state shown on the action bar.

Localization: fully translated into 10 languages — English, Russian, Simplified Chinese, Spanish, French, German, Japanese, Brazilian Portuguese, Korean, and Italian.

Configuration Config file: config/automuteonafk.json It is created with sensible defaults on first launch and loaded on startup.

You can also toggle the mod in-game without touching the file: open Options > Controls > Key Binds, find the Auto Mute On AFK category, and bind the Toggle Auto Mute On AFK key (unbound by default). Pressing it enables/disables the mod instantly and saves the new state.

Available options

enabled

When true (default), the mod is active and mutes/restores on focus changes.
When false, the mod does nothing (you can also flip this with the toggle hotkey).

showMessages

When true (default), a short action-bar message is shown when the game is muted or restored. Set to false for silent operation.

Examples

Default behavior (mute on unfocus, with messages):

{
"enabled": true,
"showMessages": true
}

Mute silently, without any on-screen messages:

{
"enabled": true,
"showMessages": false
}

Keep the mod installed but turned off (re-enable any time with the hotkey):

{
"enabled": false,
"showMessages": true
}

AutoMuteOnAfk