Skip to content

Config Files

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

Config Files

All SoundTweaks config files are stored in .minecraft/config/.

File overview

File Created Contents
soundtweaks.json On first change to any sound slider Per-sound volume overrides
soundtweaks_blocks.json On first change to any block slider Per-block volume overrides
soundtweaks_presets.json On first preset change All presets, active/favorite state
soundtweaks_sounds.txt On every game launch Auto-generated list of all registered sound IDs

Auto-save behavior

Changes are saved automatically. There is a ~300ms debounce: the file is written 300ms after the last slider change. You do not need to press any save button.

If the game crashes before the debounce fires, the last change may not be saved.

soundtweaks.json

Stores per-sound volume overrides. Only sounds that differ from the default (1.0) are written.

{
  "minecraft:entity.villager.ambient": 0.0,
  "minecraft:block.note_block.harp": 0.5,
  "minecraft:ui.button.click": 0.1
}
  • Keys are Minecraft sound event IDs in the format namespace:path
  • Values are floats in the range [0.0, 1.0]
    • 0.0 = silent
    • 1.0 = default volume (entries at 1.0 are not written to the file)

soundtweaks_blocks.json

Same structure as soundtweaks.json but for blocks. Keys are block IDs.

{
  "minecraft:piston": 0.0,
  "minecraft:observer": 0.3,
  "minecraft:dispenser": 0.5
}

Values are in [0.0, 1.0].

Note: Block volume control applies to blocks that produce sounds through the block-level playback path. This covers most farm-relevant blocks (pistons, observers, dispensers, droppers, comparators, etc.) and some decorative ones (bells, note blocks, etc.). See Sound Categories for the full block list.

soundtweaks_presets.json

Stores all presets and their state. See Import and Export for the full format.

soundtweaks_sounds.txt

A plain-text list of all sound event IDs registered in the current game instance, one per line. This file is regenerated each time the game starts. It's provided as a reference if you want to manually write config or presets outside the UI.

Volume resolution order

When a sound plays, the effective volume is determined as follows:

  1. Volatile mute layer — set by the mute button in the UI; not persisted to disk; cleared on restart
  2. Active presets — if multiple active presets define the sound, the one with the biggest deviation from 1.0 wins
  3. Base config — soundtweaks.json or soundtweaks_blocks.json
  4. Default — 1.0 (no change)

Resetting to defaults

To reset all sound volumes to default, delete soundtweaks.json (or soundtweaks_blocks.json for blocks). The mod will create a new empty file on the next save.

To reset presets, delete soundtweaks_presets.json.

Clone this wiki locally