Skip to content

FAQ

Jump to bottom
Scr0ols edited this page Jun 5, 2026 · 3 revisions

FAQ

Does this work on servers?

Yes. SoundTweaks is client-side only — the server doesn't need the mod and isn't aware of it. Volume changes only affect what you hear locally.

Does it work in singleplayer?

Yes.

My changes aren't saving. What's wrong?

Config is saved automatically ~300ms after the last change. Make sure you're not closing the game immediately after adjusting something. If it keeps happening, check that .minecraft/config/ is writable and that no other process has the file open.

Do my settings carry over between worlds?

Yes. The base config (soundtweaks.json, soundtweaks_blocks.json) and presets are global — they apply across all worlds and servers. There's no per-world config.

Do preset active/inactive states carry over between sessions?

Yes. The active state of each preset is saved to soundtweaks_presets.json and restored when the game starts.

I set a sound to 0% but I can still hear it.

A few things to check:

  • The sound might be a block sound rather than a sound event. Look for it under the Block or Redstone category filter, or search for the block name.
  • In Detail View, a sound event can have multiple .ogg files — silencing the event in Simple View silences all of them, but in Detail View you may have only silenced one variant.
  • A preset might be overriding your base config. If an active preset defines a higher volume for that sound, the preset wins. Check the Presets screen.

A sound I want to control isn't in the list.

The list includes all sound events registered in the current game instance. Some are intentionally excluded: sounds with no audio file, continuous block ambient loops (covered by the block volume layer), and a handful with no practical use.

If something you'd expect to see is missing and doesn't fall into those categories, open an issue on GitHub with the sound ID.

I assigned a shortcut but it's not working.

  • The shortcut fires on the rising edge of the trigger key — hold the held key(s) first, then tap the trigger
  • Check that no other mod or the game itself is consuming that key before SoundTweaks sees it
  • Verify the shortcut in the Presets screen — it shows in brackets next to the preset name, e.g. [Ctrl+Alt+R]

Can I use this with Forge?

No. SoundTweaks is Fabric only.

Will you update it to a newer Minecraft version?

The mod targets 26.1.2. Updates depend on the Fabric toolchain and the stability of the internal APIs the mixins rely on.

Where are the config files?

In .minecraft/config/. See Config Files for details.

Can I share my preset file with someone else?

Yes — give them your soundtweaks_presets.json and they can import it from the Presets screen with Import Presets.... See Import and Export.

The mod loaded but nothing happens when I drag sliders.

Check that Fabric API is installed. SoundTweaks needs it to register the tick listener that handles config saving.

Clone this wiki locally