Config Files

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 with a ~300ms debounce — the file is written 300ms after the last slider change. No save button needed.

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].

Block volume control applies to blocks that produce sounds through the block-level playback path — 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. Regenerated each time the game starts. Useful as a reference if you want to write config or presets manually outside the UI.

---

Resetting to defaults

To reset all sound volumes, 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.