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 do not 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 place it in your mods/ folder
3. Download the SoundTweaks .jar and place 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:

• The keybind 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 does not replace or wrap the sound engine, so it should be compatible with other audio mods. It has been tested alongside:

• Sodium — no issues
• ModMenu — no issues (the mod doesn't register a ModMenu config screen; open with K instead)

If you encounter a compatibility issue, please 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 — you can delete them manually if you want to clean up:

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