Skip to content

Preset Shortcuts

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

Preset Shortcuts

Each preset can have a keyboard shortcut assigned to it. Pressing the shortcut toggles that preset on/off without opening any UI.

Shortcut format

A shortcut consists of up to 3 keys:

  • 1 trigger key — the key whose press fires the shortcut
  • Up to 2 held keys — keys that must be held down when the trigger is pressed

Examples:

  • Y — press Y alone
  • I+Y — hold I, then press Y
  • Ctrl+Alt+R — hold I and J, then press Y

Any key on the keyboard can be used, including function keys, numpad keys, and modifier keys (Shift, Ctrl, Alt). There is no restriction on which keys can be held vs trigger.

Assigning a shortcut

  1. Open the Presets screen (Main screen → Presets button → Manage)
  2. Click the preset you want to configure
  3. Click the Shortcut tab in the detail panel
  4. Press the keys you want to assign:
    • Press and hold your held key(s) first
    • Then press the trigger key
    • The captured combination appears in green on screen
  5. Press Enter to confirm
  6. Press Backspace to clear the current shortcut
  7. Press Escape to cancel without saving

The assigned shortcut is shown next to the preset name in the list, e.g. [Ctrl+Alt+R].

How detection works

The shortcut is checked on every game tick (client-side only). Detection works as follows:

  • If the shortcut has held keys: all held keys must be physically held down via GLFW.glfwGetKey, and the trigger key must transition from released to pressed (rising edge)
  • If the shortcut has no held keys: only the trigger key's rising edge is checked

This means the shortcut fires once per press, not repeatedly while held.

Notes

  • Shortcuts are checked regardless of whether the SoundTweaks screen is open or not — they work any time the game has focus
  • If two presets have the same shortcut, both are toggled simultaneously
  • Shortcuts are saved per-preset in soundtweaks_presets.json
  • The shortcut does not conflict with Minecraft's built-in keybinds at the GLFW level, but be mindful of overlap if you assign commonly used keys

Clone this wiki locally