Set the background music NEW

Changes

Added

• AudioBackend abstraction layer; Melody / JavaFX are now swappable backends
• AudioFormats as the single source of truth for supported extensions
• Language support expanded to 8: en_us / zh_cn / zh_tw / ja_jp / ko_kr / fr_fr / de_de / ru_ru
• skills/ development documentation now tracked in version control

Fixed

• File handle leak in MusicFileScanner.scanCategory (Files.walk stream not closed)
• Scan results were unsorted, causing playlist order to drift with filesystem iteration
• EXT_REGEX was case-sensitive; uppercase extensions like .MP3 were not stripped
• MelodyPlayer toast overlapped with MusicHud on track change
• JavaFX hook moved from CLIENT_STOPPING to a JVM shutdown hook, preventing JavaFX from being shut down prematurely after leaving a world

Improved

• ConfigManager now uses a dirty flag; track changes no longer write to disk on every switch, flushed every 5 seconds by MusicTickHandler
• AudioPlayer.isIdle() check order adjusted so large files are not misjudged as idle during loading
• MusicPlayer.shuffle changed from a static field to an instance field
• Minecraft dependency widened to >=26.1 <26.2

Build Variants

• windows / linux / macos / universal / noffmpeg-universal
• Requires Minecraft 26.1.2 / Fabric Loader 0.19.3 / JDK 25
• Install only one JAR; multiple variants sharing the same mod ID will cause Fabric to report a duplicate mod