📦 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 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).
• 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
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
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
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