Installation

Installation

Requirements

Dependency	Version
Minecraft (Java Edition)	26.1.2
Fabric Loader	≥ 0.19.2
Fabric API	0.150.0+26.1.2 or compatible
Java	25 or later

SoundTweaks is client-side only. You don't need to install it on a server to use it on that server.

---

Installing

1. Install Fabric Loader for Minecraft 26.1.2 if you haven't already
2. Download Fabric API for 26.1.2 and put it in your mods/ folder
3. Download the SoundTweaks .jar and put it in your mods/ folder
4. Launch the game

The mod is active as soon as the game starts. Press K (default keybind) to open the sound control screen.

---

Verifying the installation

If the mod loaded correctly:

• Pressing K opens the SoundTweaks screen in-game
• Three config files appear in .minecraft/config/ after the first launch:
  • soundtweaks.json
  • soundtweaks_blocks.json
  • soundtweaks_presets.json
• A reference file soundtweaks_sounds.txt is also generated listing all registered sound IDs

---

Compatibility

SoundTweaks intercepts sound volume at playback time via mixin. It doesn't replace or wrap the sound engine, so it should be compatible with other audio mods. Tested alongside:

• Sodium — no issues
• ModMenu — no issues (the mod doesn't register a ModMenu config screen; use K instead)
• Litematica — no issues
• Flashback — no issues
• Mouse Tweaks — no issues
• Tweakeroo — no issues
• Xaero's Minimap / World Map — no issues
• Borderless Fullscreen — no issues

If you hit a compatibility issue, open an issue on GitHub with the full crash report or log.

---

Uninstalling

Remove the .jar from your mods/ folder. The config files in .minecraft/config/ are left behind — delete them manually if you want a clean uninstall:

• soundtweaks.json
• soundtweaks_blocks.json
• soundtweaks_presets.json
• soundtweaks_sounds.txt