Import and Export

Import and Export

SoundTweaks stores all configuration as plain JSON files you can share or edit 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.

Warning: 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 are added to your existing list — not merged. If an imported preset has the same name as one you already have, it gets 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 (reads the "presets" array)
• A JSON array of preset objects
• A single preset object (a JSON object with a "name" field)

---

Exporting / sharing

There's 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

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