# 📦 Mixer v2.3.0 Changelog > I know that Mixer is kinda an addon for SVC, and now I gave an option to create addon for addon, like sub-addon, it's kinda funny. Anyways I create one addon for burning the discs by players with payments via Vault or in-game items, with optional moderation via game/discord, etc. I'm not sure, if I should release it or not, if someone needs it give me a notice via [issue](https://github.com/Andromedov/Mixer/issues) or smth. `¯\_(ツ)_/¯` ## ✨ New Features - **Addon API:** Added addon lifecycle management, custom audio source resolvers, player/DSP controls, disc services, and playback policies for private or moderated discs (more in the [wiki](https://github.com/Andromedov/Mixer/wiki/Addon-API)). - **Physical Jukebox Discs:** Added configurable disc insertion directly into jukeboxes via mixer.disc-inserted (false for old mechanic). - **Local Audio & Burn Requirements:** Added local audio saving with `/mixer burn --save` and configurable material, Custom Model Data, and Item Model requirements. ## ⚡ Improvements & Optimization - **Paper Compatibility:** Updated support range to Paper 1.21.4 - 26.2 with configurable Java and Paper API versions. - **Audio Reliability:** Updated Lavaplayer to 2.2.7 and added progressive SoundCloud playback with improved source resolution. - **API Distribution:** Added generated Javadocs and sources JARs for addon development. API packages and Maven coordinates now use me.andromedov. **More details** in the [wiki](https://github.com/Andromedov/Mixer/wiki)<br> **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v2.2.3...v2.3.0

# 📦 Mixer v2.2.3 Changelog ## 🐞 Bug Fixes * **SoundCloud Fix:** Fixed SoundCloud connection issues (music from there was previously just throwing an error) by updating the audio (`lavaplayer`) library. ## ⚡ Improvements & Optimization * **Dependency Updates:** Updated the rest of the core libraries to their newer versions for better stability. * **YouTube Playback Reliability:** Removed deprecated `TvHtml5Embedded` and `TvHtml5EmbeddedWithThumbnail` clients. **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v2.2.2...v2.2.3

# 📦 Mixer v2.2.2 Changelog ## ✨ New Features * **bStats Metrics:** Added support for anonymous statistics collection via bStats. This can be toggled via the `metrics: true` parameter in the `config.yml` file. ## ⚡ Improvements & Optimization * **Cobalt API Integration:** Significantly improved Cobalt URL handling. Updated requests to use API v7 with an automatic fallback to v6, ensuring more stable media loading. * **Async Handling:** Refactored asynchronous processes, improved thread management and overall server & music stability (will be most noticeable when there are 3+ players on the server playing music). * **Code & Dependencies Cleanup:** Optimized dependencies (switched the `:api` dependency to `implementation`) and removed redundant `StandardCharsets` conversions in the TTS URL generator. ## 🐞 Bug Fixes * **Cobalt Error Messages:** Fixed and simplified Cobalt API error messages in-game. If an HTTP 403 error occurs, the plugin now directly warns the user about potential hosting blocks by Cloudflare. * **Data Access Safety:** Fixed potential NullPointerExceptions in `RedstoneListener` and `PlayerInteractListener` when interacting with discs. Added proper safety checks for `ItemMeta` and `PersistentDataContainer` keys. * **Playback Stability:** Improved track completion handling and queue loading. Fixed the state management of the `playbackStarted` variable, preventing playback hangs when processing playlists. **Note**: I tried to add an easier YouTube support, but it didn't work out the way I'd planned, so I kinda scrapped all of the progress and might start over from scratch (or maybe I will just ignore that feature entirely) **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v2.2.1...v2.2.2

# 📦 Mixer v2.2.1 Changelog ## ✨ New Features * **Portable Speaker Persistence:** DSP settings (Gain, Filters, Flanger) are now saved to the local H2 database linked to the speaker's unique ID. Your custom audio effects will now persist across sessions and server restarts. ## ⚡ Improvements & Optimization * **Database Integration:** Extended the database schema to handle per-item storage for portable speaker effects. * **GUI Accessibility:** The "Audio Effects" button in the Portable Speaker menu can now be accessed to configure settings even if music is not currently playing. ## 🐞 Bug Fixes * **GUI Closing Issue:** Fixed a critical bug where the DSP settings menu would close unexpectedly when clicking items or interacting with other inventories. * **Session Handling:** Resolved an issue where editing sessions were incorrectly removed in the `onClose` handler, ensuring smoother interaction with the settings menu. **More details** in a [wiki](https://github.com/Andromedov/Mixer/wiki)<br> **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v2.2.0...v2.2.1

# 📦 Mixer v2.2.0 Changelog ## ✨ New Features * **H2 Database Support:** Migrated active mixer management from YAML to local H2 database for improved performance, concurrency, and reliability. * **PlaceholderAPI Support:** Added `MixerPapiExpansion` integration. You can now use `%mixer_...%` placeholders. * **DSP GUI:** Implemented a new inventory-based GUI for managing Digital Signal Processing (DSP) settings. * **Update Notifier:** Added automatic update checks via Modrinth with console alerts and in-game notifications. * **Configurable Debugging:** Introduced `system.debugLevel` in `config.yml` for detailed log control. * **Localization:** Added merging logic for language files to comfortable updating. ## ⚡ Improvements & Optimization * **Stream Optimization:** Replaced piped streams with circular buffers in `LavaplayerAudioStream` for better audio reliability. * **Concurrency Handling:** Refactored core systems to use `ConcurrentHashMap` and `ScheduledExecutorService` for thread-safe operations. * **Async Loading:** Audio queues and cleanup operations are now processed asynchronously to prevent main thread blocking. * **Opus4j Cleanup:** Improved logic for cleaning up temporary Opus files. ## 🐞 Bug Fixes * **TTS Encoding:** Fixed `URLEncoder` usage to correctly handle special characters in Text-to-Speech. * **Update Checker:** Fixed version comparison logic and download URL parsing. **More details** in a [wiki](https://github.com/Andromedov/Mixer/wiki)<br> **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v2.1.2...v2.2.0

## 📦 Mixer v2.1.2 Changelog ### ✨ Improvements * **Interaction Handling:** * Restricted interactions to the **Main Hand** only. This improves consistency and prevents potential off-hand conflicts. * Refined Portable Speaker handling with improved inventory type checks. * **System Stability:** * Added automatic cleanup of `opus4j` temporary files during plugin enable to keep the environment clean. ### 🐛 Bug Fixes * Fixed an `ArrayIndexOutOfBoundsException`. * Updated the Action Bar message key for "stopping playback" to ensure the correct text is displayed. ### 🔧 Internal Changes * **Reverted** `opus4j` library relocation (fixes "music is not playing" issue). * Improved CI workflows: added concurrency control and DEV suffix for artifacts.

## 📦 Mixer v2.1.1 Changelog ### 🐛 Bug Fixes * Addressed issues with Portable Speaker playback logic. * Interaction events in the inventory now correctly stop playback. * Extended handling to support entity interactions. * Improved item null safety and inventory checks. ### 🔧 Internal Changes & Refactoring * Updated dependency relocation for `opus4j` to prevent conflicts. * Adjusted Bukkit authors list.

## 📦 Mixer v2.1.0 Changelog ### 🎵 New Feature: Portable Speakers Take your music on the go! The Portable Speaker allows you to play custom discs directly from your inventory, with the sound following your character. * **New Item:** `Portable Speaker` (obtainable via `/mixer speaker`). * **Easy Control:** Right-click the speaker to open a user-friendly GUI. * Insert a custom disc. * Use **Play (Green)** to start playback. * Use **Stop (Red)** to stop playback. * **Smart Interaction:** * Music automatically stops if you drop the active speaker item. * Music stops if you disconnect or die. * Visual note particles appear above your head while music is playing. * **Configuration:** * Enable/disable the feature in `config.yml`. * Customize the speaker item material (default: `NOTE_BLOCK`). * Full localization support in `en.yml` and `uk.yml`. ### 🛠️ Technical Improvements * **Audio Engine Refactor:** The core audio logic has been split into an abstract layer, making the codebase cleaner and easier to maintain. * **Config Auto-Update:** The `config.yml` file now automatically updates with new settings while preserving your existing configuration and comments. * **Bug Fixes:** * Fixed an issue where `LocationalAudioChannel` was incorrectly used for portable players (now uses `EntityAudioChannel`). * Fixed an issue where the GUI would throw errors if the item in hand was swapped while the menu was open. * Added proper validation for item NBT data to prevent errors with invalid discs. ### 📜 Commands * `/mixer speaker` - Gives the player a Portable Speaker item. --- If you have any suggestions or found a bug, please create an issue on GitHub: https://github.com/Andromedov/Mixer/issues

# 📦 Mixer v2.0.1 Changelog This update focuses on server stability, fixing critical playback issues with mixed content (TTS + Music), and improving automation mechanics. ### ✨ New Features * **Shulker Box Support:** Added support for Shulker Boxes as a container option for jukebox automation, alongside Barrels. * **New TTS API:** Replaced the Text-to-Speech API with a more stable solution (Google Translate), resolving voice availability issues. * **Improved Tooltips:** Changed the logic for hiding item information on discs (now only hides `ADDITIONAL_TOOLTIP` instead of the entire tooltip). * **Retry Logic:** Added an automatic retry system (3 attempts) for loading tracks in case of connection errors. ### 🛠 Bug Fixes * **Mixed Content Fix:** Fixed a critical bug where the player would stop when switching between different audio formats (e.g., Opus Music -> PCM TTS). * **Song Queue:** Implemented a proper song queue to resolve the "force next song" bug where tracks were skipped or ignored. * **DSP Gain:** Volume changes (Gain) are now applied immediately without delay. * **Console Cleanup:** Added suppression for `403 Forbidden` and `410 Gone` errors (common with old/expired links) to prevent console spam. ### ⚡ Performance & Stability * **Full Async Rewrite:** * Track loading, configuration saving, and DSP initialization have been moved to asynchronous threads. * This eliminates main thread freezes and prevents player kicks due to `keepalive timeout` errors. * **Redstone Cooldown:** Added a 1-second cooldown for jukebox redstone inputs to prevent event spam and audio stream overload. * **Timer Optimization:** Replaced legacy Java `Timer` with native Bukkit/Paper schedulers for better server compatibility. ### 🔧 Technical / Internal * Removed unnecessary register functions. * Bumped plugin version and reworked GitHub workflows. * Fixed `ConcurrentModificationException` that could occur when disabling the plugin. **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v2.0.0...v2.0.1

## What's changed in plugin itself - remove metrics - moved from CommandAPI - multiple configuration files - add reload option - fix messages not showing correctly - fix lang files not changing on `/mixer reload` - fix volume setting not changing on `/mixer reload` - move `mixers` from config.yml to data.yml - add lang-version option - support of Minecraft 1.20.6 up to 1.21.10 Plugin is working on these versions (lmk if other supported versions is not working): - Paper 1.20.6 - Paper 1.21.4 - Paper 1.21.10 **Full Changelog**: https://github.com/Andromedov/Mixer/compare/v1.1.4...v2.0.0