Skip to content

FAQ

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

FAQ

Does this work on servers?

Yes. SoundTweaks is client-side only. The server does not need the mod installed and is not 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 aren't closing the game immediately after making a change. If the problem persists, 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 is 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 possibilities:

  • The sound you're looking for might be a block sound rather than a sound event. Check if it appears under the Block or Redstone category filter, or try searching for the block name.
  • In Detail View, there may be multiple sound files for the same event — silencing the event in Simple View silences all of them, but if you're in Detail View you may have only silenced one variant.
  • A preset might be overriding your base config. If a preset is active and it 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 sounds are excluded intentionally:

  • Sounds with no associated audio file
  • Continuous block ambient loops (these are already covered by the block volume layer)
  • A small number of sounds with no practical use

If a sound you expect to see is missing and it's not in the above categories, please 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 — press and release the held key(s) first, then tap the trigger
  • Make sure no other mod or the game itself is consuming that key before SoundTweaks checks it
  • Verify the shortcut in the Presets screen (it's shown 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 used by the mixins.

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 using Import Presets.... See Import and Export.

The mod loaded but nothing seems to happen when I drag sliders.

Check that Fabric API is installed. SoundTweaks depends on Fabric API to register its tick listener for saving config.

Clone this wiki locally