Skip to content

Main Screen

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

Main Screen

Press K (default, rebindable in Minecraft's Controls settings) to open the SoundTweaks screen.

Layout overview

[ 🔇 ] [ Simple View ] [ Presets ◄ ]          SoundTweaks
[ Category ▼ ] [ Object ▼ ] [ × ] [ search...          ]
─────────────────────────────────────────────────────────
 sound list
 ...
─────────────────────────────────────────────────────────
 N sounds shown       [ Import Config... ] [ Done ]

When the Presets sidebar is open, the list area narrows and a panel appears on the right side.

Sound list

Each row in the list corresponds to a sound event or a block and shows:

  • The display name of the sound or block
  • A volume slider

Slider range: 0% (silent) to 100% (game default). Dragging to 0% effectively mutes that sound. Changes take effect immediately and are saved automatically when you close the screen (~300ms debounce).

Sounds with their volume set to 0% are shown in red to make them easy to spot.

The list contains two types of entries mixed together:

  • Sound entries — individual Minecraft sound events (e.g. entity.creeper.hurt)
  • Block entries — blocks that produce sounds but don't have dedicated sound events in the normal registry (e.g. pistons, observers, dispensers)

Filters

Category dropdown

Filters the list to a specific sound category. See Sound Categories for what each contains.

Object dropdown

Available after selecting a Category. Filters further to a specific entity, item, or block within that category (e.g. selecting Category "Entity" then Object "Creeper" shows only creeper sounds).

Search bar

Text search across all visible sound IDs and display names. Applies on top of whatever Category/Object filter is active.

Clear button (×)

Clears all three filters at once and resets the list to show everything.

Simple View vs Detail View

Toggle between them with the button in the top-left area.

Mode What's shown
Simple View One entry per sound event (e.g. entity.creeper.hurt)
Detail View Individual .ogg sound files within each event — the game may play any of these for a given event

Simple View is the default. Detail View is useful if you want to silence a specific variant of a sound (e.g. only one of the hurt sounds for a mob).

The selected view persists between screen opens within a session.

Mute button

The speaker icon in the top-left mutes all currently visible sounds — meaning all sounds that match the current Category/Object/search filters.

  • Click once → all visible sounds go to 0% (volatile, not written to config)
  • Click again → restores all visible sounds to their previous volumes

This uses a temporary mute layer. It does not modify soundtweaks.json or soundtweaks_blocks.json. The mute is cleared when you toggle it off. It does not persist across game restarts.

This is useful if you want to quickly silence a group of sounds without permanently changing your config.

Presets sidebar

The Presets button in the top bar toggles a sidebar on the right side of the screen. The sidebar shows your favorited presets and lets you toggle them on/off with a single click. See Presets for more detail.

Filter state persistence

The Category, Object, and search filters are remembered while the screen is open within a session. If you close and reopen the screen, the filters are restored to where you left them. Closing the game resets them.

Footer

  • Sound count — shows how many sounds are visible vs the total (e.g. 45 / 847 sounds)
  • Import Config... — import a soundtweaks.json or soundtweaks_blocks.json from another instance. See Import and Export
  • Done — closes the screen and saves

Clone this wiki locally