ВЕРСИИ (29)

## [3.0.12] ### Fixed - **Crash Fix**: Fixed game crash when clicking Playlists button for users updating from older versions - **Stability**: Added protections against crashes when track data is invalid ### Improved - **Better Compatibility**: Playlists created in older versions now work properly after updating

## [3.0.11] ### Fixed - **Lag Spike**: Fixed stutter when pressing previous track button - **Loading Screen**: Fixed "Loading tracks" message showing after restarting the game - **Performance**: Made track loading and playlist lookups faster ### Improved - **Faster Playback**: Previous track now loads instantly when possible - **Better Resource Usage**: Optimized file I/O and reduced memory usage

# [3.0.10] ### Fixed - **Crashes**: Fixed several rare crashes that could happen during gameplay - **Playlists**: Improved playlist reliability, especially when using multiple playlists - **Downloads**: Fixed some issues with asset downloads ### Improved - **Performance**: General performance improvements and bug fixes - **Stability**: Made the mod more stable overall

# Soundtrack Player v3.0.9 ## Bug Fixes - Fixed button not showing on title screen in some cases - Fixed crash when clicking Next/Previous track - Fixed memory issues during playback - Fixed various crashes and freezes - Fixed issues with corrupted save files ## Improvements - Added warning that Full Reset requires game restart - Download screen now allows ESC to close anytime - Better error handling throughout

# Soundtrack Player 3.0.8 - Changelog ## Bug Fixes - Fixed custom tracks replacing all other tracks when added - Fixed playlist GUI not refreshing after adding/removing tracks - Fixed clicking a playlist glitching instead of refreshing - Fixed scroll position not resetting when switching playlists - Fixed track position not resetting when selecting a different song - Fixed resume playing wrong song when switching playlists - Fixed custom tracks folder not being created after full reset ## Features - Added "Full Reset" button - deletes all config, playlists, and songs, then re-downloads

# Soundtrack Player 3.0.7 - Changelog ## Bug Fixes - Fixed custom tracks replacing all other tracks when added - Fixed playlist GUI not refreshing after adding/removing tracks - Fixed clicking a playlist glitching instead of refreshing - Fixed scroll position not resetting when switching playlists - Fixed custom tracks folder not being created after full reset ## Features - Added "Full Reset" button - deletes all config, playlists, and songs, then re-downloads - Improved ModMenu config layout with better spacing - ## Improvements - Better track loading reliability - Cleaner config GUI layout

# Soundtrack Player 3.0.6 ## Bug Fixes - Fixed custom tracks replacing all other tracks when added - Fixed playlist GUI not refreshing after adding/removing tracks - Clicking a playlist now refreshes instead of glitching - Scroll position now resets when switching between playlists ## Improvements - Better track loading reliability - Improved playlist management

# Changelog ## [3.0.5] ### Changed - Updated to Minecraft 1.21.4 ### Fixed - Fixed rendering compatibility for 1.21.4 (backgrounds, text, and UI panels now display correctly) - Fixed mouse click handling for 1.21.4 API changes - Fixed keybinding registration for 1.21.4

## [3.0.4] - 2025-12-21 (Minecraft 1.21.11) ### Fixed - **Add Songs Button Now Works**: Fixed file picker not opening on all systems - **Native File Picker**: Now uses system native file dialogs (works on Windows, Linux, macOS)

## [3.0.3] ### Fixed - **Add Songs Button Now Works**: Fixed file picker not opening on all systems - **Native File Picker**: Now uses system native file dialogs (works on Windows, Linux, macOS)

## [3.0.2] ### Fixed - **Accurate Song Durations**: All songs now show their real length instead of "3:00" - **Better Rescan**: Improved custom tracks rescanning with detailed feedback

## [3.0.1] ### Fixed - **Accurate Song Durations**: All songs now show their real length instead of "3:00" - **Better Rescan**: Improved custom tracks rescanning with detailed feedback ### Added - **1.21.10 Support**

## [3.0.0] ### Added - **Custom Songs Support**: Upload your own music files (MP3, WAV, OGG, FLAC) - **"+ Add Songs" Button**: One-click file picker to easily add custom songs - **Multi-Format Support**: Play MP3, WAV, OGG, and FLAC audio files - **Metadata Extraction**: Automatically reads song title, artist, and album from audio files - **Custom Track Badge**: Purple "C" badge shows which songs are custom - **Album Display**: Shows album info for custom tracks in playlist - **Rescan Custom Button**: Manually refresh custom songs list

## Version 2.5.6 (Minecraft 1.21.11) **Updated to:** 1.21.11

## Version 2.5.5 (Minecraft 1.21.10) **Fixed:** - Music volume no longer changes based on which direction you're facing

# Soundtrack Player v2.5.4 ## New Feature ### 🎵 Resume Playback - Tracks now remember where you left off - Pause at 2:30, close the game, reopen → resumes at 2:30 - Works automatically - no configuration needed - Position clears when you skip or select a different track

**Code Fixing**

# 2.5.2 - Optimization Update ## ⚡ Performance Improvements - **44% smaller file size** - Reduced from 211KB to 117KB - **Faster audio loading** - Songs load and play faster than before - **Better playback performance** - Smoother music playback with less lag - **Reduced memory usage** - More efficient audio handling ## 🛠️ Stability Improvements - **Fixed potential crashes** - Resolved threading issues that could cause problems - **Better error handling** - Improved stability during song loading and playback - **Proper cleanup** - Resources now clean up correctly when closing Minecraft ## 📦 What Changed - Upgraded audio decoder for better performance - Optimized internal systems for faster operation - Cleaned up code for better stability

# 2.5.1 - Stability Fix ## 🛡️ Stability Improvements - **Fixed audio crashes** - The mod now works reliably without random crashes - **Improved audio playback** - Rewrote audio decoder for stable music playback - **Better memory handling** - Fixed memory leaks that could cause issues over time ## 📦 Download Improvements - **Better download warnings** - Clear warning that Minecraft may crash during first-time download - **Restart recommendation** - Prompts you to restart after downloading for best stability - **Download progress everywhere** - See download status on title screen, player, and HUD - **Crash recovery** - If download crashes, just restart - your songs will be ready!

# 2.5.0 - Performance & Stability Update ## 🎯 Major Improvements This release **fixes all known issues from 2.4.0 beta** and makes the mod fully stable! ### ⚡ Performance Fixes - **✅ FIXED: Lag spikes eliminated** - Track loading now happens asynchronously on background threads - **✅ FIXED: No more FPS drops** - All file I/O moved off the main render thread - **✅ Smooth track switching** - Instant transitions with smart preloading - **✅ Faster Minecraft startup** - Manifest loading deferred until first use ### 🛡️ Stability Fixes - **✅ FIXED: All crashes resolved** - Comprehensive bounds checking prevents index errors - **✅ Bulletproof validation** - Every track access is now validated - **✅ Graceful error handling** - Missing tracks handled without crashes - **✅ Thread-safe operations** - Proper synchronization prevents race conditions ### 🎵 Technical Improvements - **Async audio loading** - Files load in background without blocking gameplay - **Smart debouncing** - Prevents issues from rapid skip button clicking - **Track preloading** - Next track loads ahead of time for instant playback - **Lazy initialization** - Resources created only when needed ## 🎉 Result The mod is now **production-ready** with no known bugs! Enjoy smooth, lag-free music playback.

# Version 2.4.0 - Playlists & Auto-Download ## ⚠️ BETA RELEASE - Known Issues **This is an early beta version with known bugs!** You may experience: - Occasional lag spikes when switching tracks - Possible crashes Use at your own risk and report bugs in the Discord! --- ## 🎉 Major Update - New Core Features ### 📋 NEW: Custom Playlist System - **Create custom playlists** - Build your own track collections - **Add/remove tracks** - Easy playlist management - **Rename & delete playlists** - Full control over your collections - **Switch playlists** - Play from any playlist instantly - **"All Songs" default playlist** - Complete library always available ### 📦 NEW: Automatic Asset Download System - **First-launch auto-download** - Soundtrack downloads automatically (~250MB) - **Downloads from GitHub** - Assets hosted at [wd40loverr/soundtrack-player-assets](https://github.com/wd40loverr/soundtrack-player-assets) - **Progress screen** - Visual progress with download status - **Retry on error** - Handle failed downloads gracefully - **One-time download** - Assets persist across mod updates - **70+ high-quality tracks** - Complete Minecraft soundtrack collection ### 🖥️ ENHANCED: Player Interface - **Playlist management UI** - Create and manage playlists from the player - **Visual playlist indicators** - See which tracks are in playlists - **Enhanced track list** - Better organization and display - **Quick playlist switching** - Change active playlist easily ## 🐛 Bug Fixes - Fixed pause/resume stability issues - Improved track switching performance - Better error handling for missing assets --- **⚠️ Beta Version Notice:** This release is functional but not polished. Expect bugs, lag, and glitches.

# 1.4.3 - Multi-Version Compatibility Release (1.21.6 - 1.21.8) Enjoy the soundtrack on your Minecraft version! 🎵

# 1.4.2 - 1.21.5 Version Compatibility Release Enjoy the soundtrack on your Minecraft version! 🎵

# 1.4.1 - Multi-Version Compatibility Release Enjoy the soundtrack on your Minecraft version! 🎵

# 1.4.0 - Settings & HUD Update ## ✨ New Features ### ⚙️ Settings Screen - **Full configuration GUI** accessible from ModMenu - **UI Settings:** - Mini Player position (4 corners) - Mini Player opacity slider (0-100%) - Toggle progress bar visibility - Toggle composer display - **Behavior Settings:** - Auto-resume on launch option - Control action bar messages - Adjustable message duration (1-10s) - **Additional Features:** - Now Playing HUD toggle and position - Crossfade toggle (coming soon) ### 📺 Now Playing HUD - **In-game overlay** showing current track - Displays track name, composer, and progress bar - Configurable position (4 corners) - Only shows during gameplay (auto-hides in menus) - Toggle on/off in settings ## 🎨 UI Improvements - Mini Player is now fully customizable - Choose corner position - Adjust transparency - Control what information displays ## 📋 How to Access Settings 1. Install ModMenu (if not already installed) 2. Open Mods menu 3. Find "Soundtrack Player" 4. Click "Configure" button 5. Adjust settings and click "Save & Close" - ModMenu (recommended for settings access) Enjoy the soundtrack! 🎵

# 1.3.0 - Essential QOL Update ## ✨ New Features - **⚙️ Settings Persistence** - Your preferences now save between sessions - Volume, shuffle, and loop settings remembered - Last played track saved - Config file: `.minecraft/config/soundtrack-player.json` - **⌨️ Global Hotkeys** - Control playback without opening the GUI - Play/Pause, Next/Previous track - Volume Up/Down (5% increments) - Toggle Shuffle, Cycle Loop modes - All customizable in Controls menu - Action bar messages show feedback ## 🐛 Bug Fixes - **Fixed ALL song durations** - Corrected 70+ track lengths - Progress bars now complete accurately - Auto-advance triggers at the correct time - No more tracks ending early or late Enjoy the soundtrack! 🎵

# 1.2.0 - Mini Player & ModMenu Update ## ✨ New Features - **📺 Mini Now Playing Widget** - Compact player appears on the pause menu (ESC) - Shows current track and playback status - Quick access controls: Previous, Play/Pause, Next, Open Player - Real-time progress bar - Bottom-left corner, non-intrusive design - **🔧 ModMenu Integration** - Access the player directly from ModMenu's mod list - Click "Configure" next to Soundtrack Player to open the GUI - Optional integration (mod works without ModMenu) Enjoy the soundtrack! 🎵

# 1.1.0 - Shuffle & Loop Update ## ✨ New Features - **🔀 Shuffle mode** - Randomize track playback order - **🔁 Loop modes** - Three loop options: - Off - Stop after last track - Loop All - Restart playlist from beginning - Loop One - Repeat current track indefinitely Enjoy the soundtrack! 🎵

# Initial Release First public release of Soundtrack Player! ## Features - **70+ music tracks** - All background music from C418, Lena Raine, Kumi Tanioka, Aaron Cherof, Amos Roddy, and Samuel Åberg - **True pause/resume** - Pause music and resume from the exact same position - **Volume control** - Adjustable volume slider (0-100%) - **Track navigation** - Previous/Next buttons with proper track history - **Progress tracking** - Real-time progress bar with time display - **Auto-advance** - Automatically plays the next track when current finishes - **Clean GUI** - Spacious, modern interface with clear status indicators - **Keybinding** - Press **M** to open the soundtrack player Enjoy the soundtrack! 🎵