Import and Export

Import and Export

SoundTweaks stores all configuration as plain JSON files. You can share these files between instances or edit them manually.

---

Importing sound/block volumes

From the main screen, click Import Config... in the footer.

A native file dialog opens. Select one of:

• soundtweaks.json — imports sound volume overrides
• soundtweaks_blocks.json — imports block volume overrides

The filename determines which config is replaced. If the filename contains the word block, the block config is replaced; otherwise the sound config is replaced.

This replaces your current config entirely. Your existing volume settings for the selected config type will be overwritten.

After import, the list refreshes to reflect the imported values.

---

Importing presets

From the Presets screen, click Import Presets... in the footer.

A native file dialog opens. Select a soundtweaks_presets.json file.

The presets inside are added to your existing preset list. They are not merged — if an imported preset has the same name as an existing one, the imported one is renamed automatically (e.g. Trading Hall (2)). All imported presets are set to active immediately after import.

Supported import formats:

• A full soundtweaks_presets.json (the "presets" array is read)
• A JSON array of preset objects
• A single preset object (a JSON object with a "name" field)

---

Exporting / sharing

There is no dedicated export button. To share your config or presets, copy the files directly from .minecraft/config/:

File	What it contains
soundtweaks.json	Your sound volume overrides
soundtweaks_blocks.json	Your block volume overrides
soundtweaks_presets.json	All presets, their sounds/blocks, shortcuts, colors, active state, and favorites

You can share any of these files and the recipient can import them using the buttons described above.

---

Opening the config folder

From the Presets screen, click Open Config Folder in the footer. This opens .minecraft/config/ in your system's file manager.

---

Manual editing

All config files are formatted JSON and can be edited in any text editor while the game is closed.

soundtweaks.json / soundtweaks_blocks.json

Simple key-value maps. Keys are sound event IDs or block IDs. Values are floats between 0 and 1.

{
  "minecraft:entity.villager.ambient": 0.0,
  "minecraft:block.piston.extend": 0.3,
  "minecraft:entity.ender_dragon.growl": 0.5
}

A value of 1.0 means default volume. Entries with value 1.0 are not written to the file — only overrides are stored.

soundtweaks_presets.json

{
  "presets": [
    {
      "name": "Trading Hall",
      "colorIndex": 2,
      "shortcutKey": 89,
      "shortcutHeldKey": 73,
      "shortcutHeldKey2": 0,
      "sounds": {
        "minecraft:entity.villager.ambient": 0.0,
        "minecraft:entity.villager.trade": 0.0
      },
      "blocks": {
        "minecraft:bell": 0.2
      }
    }
  ],
  "activePresets": ["Trading Hall"],
  "favoritePresets": ["Trading Hall"]
}

Key fields per preset:

• name — display name
• colorIndex — index into the built-in colour palette (0–17), or 18 for custom
• customColor — ARGB integer, only present when colorIndex is 18
• shortcutKey — GLFW key code for the trigger key
• shortcutHeldKey / shortcutHeldKey2 — GLFW key codes for held keys (0 = unused)
• sounds — map of sound event ID → volume float
• blocks — map of block ID → volume float

activePresets and favoritePresets are lists of preset names.