BetterHitSounds
A high performance, client-side combat audio enhancement utility for the Fabric ecosystem.
Overview
BetterHitSounds completely reworks Minecraft's combat audio engine feedback. It is created for competitive play, and has specific cues (signals) to indicate certain actions in gameplay, letting players tell the pacing of their actions through audio without affecting performance.
Key Features
- State Tracking — Implements unique audio ranges for base shots, combo extensions and important hits.
- Hot-Reloadable — Imports .ogg assets at runtime to tweak values on the fly without needing to restart the game or session.
- No lag — Written on the Fabric API to occupy as little time as possible in the main loop while resolving active entity interactions.
- Lightweight — Does not require any configuration API infrastructure to be present in the project at all.
Installation Guide
- Dependency Check: Confirm that your target run-time environment includes the appropriate iteration of the Fabric API
- Deployment: Install the BetterHitSounds mod into your local mods directory.
- Initialization: Launch your minecraft client and open the local configuration panel (through either modmenu or the keybind).
- Ingestion Configuration: Choose to either use native engine presets or route path directories to your local .ogg audio files.
Available for the Fabric Mod Loader.
All Versions
+ Add Version- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 26.2Minecraft 26.1Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 26.2Minecraft 26.1Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds v2.0.0 Changelog**
- New In v2.0.0**
- Added a full in-game config workflow for sound setup
- Added
OGGplayback mode - Added
Presetplayback mode - Added separate
Normal,Combo, andCritsound support - Added separate
PlayerandMobsound targeting - Added built-in preset sound styles
- Added
Minecraft Defaultpreset with vanilla-style hit, combo, and crit behavior - Added per-slot
.oggimporting - Added sound preview buttons
- Added reload support without restarting the game
- Added a
Guidepage for setup help - Added cleaner multi-page UI with
Options,Customization,Presets, andGuide
- Sound System Changes**
- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active
.oggfile - Importing a new
.oggreplaces the old file for that slot - Added safer decoding and playback handling for custom
.oggfiles - Improved fallback behavior when imported sound playback fails
- Preset Improvements**
- Presets now support separate
Hit,Combo, andCritplayback - Added better preview flow for preset sounds
- Preset mode now works as a true playback source instead of acting like a layered effect
- Customization Improvements**
- Simplified labels to make setup easier
- Reworked category flow into
Player/MobplusNormal/Combo/Crit - Removed confusing actions that made the UI harder to use
- Improved setup messaging and status feedback
- UI Changes**
- Reworked screen layout and spacing
- Added purple styling and cleaner panel design
- Split the config into separate pages for easier navigation
- Improved guide text and folder instructions
- Fixed multiple text overlap and placement issues
- Improved helper text placement around buttons and sliders
- Stability Fixes**
- Fixed native playback crash paths during repeated hit sound playback
- Reworked audio handling to avoid unsafe behavior from the older path
- Fixed multiple
.oggplayback failures and decoder issues during testing - Improved error handling so failed custom sounds warn safely instead of hard-crashing the game
- Version Compatibility Work**
Separate
v2.0.0 copies were prepared for:Minecraft 26.2Minecraft 26.1Minecraft 1.21.11Minecraft 1.21.8Minecraft 1.21.5Minecraft 1.21.4
Compatibility work included:
- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older
ClientWorldsound methods - Version-specific dependency and metadata alignment
- Notes**
- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.
- BetterHitSounds – v1.1.0**
- Stability Update + Automatic Version Checker**
This update fixes the crash reported in v1.0.0 and introduces a built-in automatic update notification system.
- Fixes**
• Fixed NoSuchFieldError crash on Minecraft 1.21.x
• Removed outdated compiled references
• Rebuilt in a clean environment for proper compatibility
• Improved overall stability
- New – Built-in Version Checker**
BetterHitSounds now includes a professional update system:
• Async background version checking
• Proper semantic version comparison
• Popup appears only on Title Screen
• Shows once per game launch
• “Update”, “Later”, and “No Thanks” options
• Remembers ignored versions
• Safe external Modrinth link opening
• Fully offline safe
This update makes BetterHitSounds more stable, polished, and future-ready.
Thank you for the continued support ❤️
- BetterHitSounds v1.0.0 🎉**
- Release Notes:**
- Added **combo hit sounds** for consecutive attacks
- Implemented **distance-based volume**
- Added **pitch randomization** for variety
- Full support for **custom sound packs**
- Bug fixes and performance improvements
- Download & Source:**
- GitHub: https://github.com/Hardik-Verma/BetterHitSounds
- Modrinth: https://modrinth.com/mod/betterhitsounds