Skip to content

Main Screen

Jump to bottom
Scr0ols edited this page Jun 5, 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.

Sound list

Each row shows a sound event or block with a volume slider.

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

Sounds set to 0% are shown in red so they're easy to spot.

The list has two types of entries:

  • 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. Category "Entity" → 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 Sounds grouped by event — one row per event (e.g. entity.creeper.hurt), regardless of how many .ogg files it contains
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. one of several hurt sounds for a mob) rather than the whole event.

The selected view persists between screen opens within a session.

Mute button

The speaker icon in the top-left mutes all currently visible sounds — everything that matches the active Category/Object/search filters.

  • Click once → all visible sounds go to 0% temporarily
  • Click again → restores them to their previous values

Nothing gets written to soundtweaks.json or soundtweaks_blocks.json. The mute layer is volatile — it doesn't persist across game restarts and doesn't affect your saved config at all.

Good for quickly silencing a group of sounds without touching your config.

Presets sidebar

The Presets button in the top bar toggles a sidebar on the right. It 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. 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