BetterHitSounds

**BetterHitSounds v2.0.0 Changelog**

**New In v2.0.0**

- Added a full in-game config workflow for sound setup
- Added `OGG` playback mode
- Added `Preset` playback mode
- Added separate `Normal`, `Combo`, and `Crit` sound support
- Added separate `Player` and `Mob` sound targeting
- Added built-in preset sound styles
- Added `Minecraft Default` preset with vanilla-style hit, combo, and crit behavior
- Added per-slot `.ogg` importing
- Added sound preview buttons
- Added reload support without restarting the game
- Added a `Guide` page for setup help
- Added cleaner multi-page UI with `Options`, `Customization`, `Presets`, and `Guide`

**Sound System Changes**

- Reworked custom sound handling around dedicated slot folders
- Each slot now uses only one active `.ogg` file
- Importing a new `.ogg` replaces the old file for that slot
- Added safer decoding and playback handling for custom `.ogg` files
- Improved fallback behavior when imported sound playback fails

**Preset Improvements**

- Presets now support separate `Hit`, `Combo`, and `Crit` playback
- 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/Mob` plus `Normal/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 `.ogg` playback 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.11`
- `Minecraft 1.21.8`
- `Minecraft 1.21.5`
- `Minecraft 1.21.4`

Compatibility work included:

- Keybind API fixes for older versions
- UI render method fixes for older versions
- Mixin target cleanup for older `ClientWorld` sound methods
- Version-specific dependency and metadata alignment

**Notes**

- This release is focused on easier setup, safer playback, version compatibility, and cleaner sound customization.