🎵 MusicPlay v1.1.0-SNAPSHOT - Playlists & Universal Audio Update

⚠️ Beta / Snapshot Warning:
This release (v1.1.0-SNAPSHOT) is a preview / snapshot version. Version 1.1 is currently under active development and may contain bugs or instability. Use it with caution and report any issues you encounter!

A major update for MusicPlay 1.1, taking server-side music to a whole new level! No more limitations to the OGG format only, no more generic track names like custom.track_1, and no more manual track switching. The plugin now features personal playlists, auto-play, universal audio conversion via FFmpeg, full localization support, and an improved built-in HTTP engine.

🎧 MusicPlay 1.1 Snapshot - turn your server into a full-fledged streaming audio player without a single client-side mod!

---

🚀 Key Features in Version 1.1

1. 🎼 Support for Any Audio Format via FFmpeg (MP3, WAV, FLAC, M4A...)

• In version 1.0, only raw .ogg files were supported.
• In version 1.1, automatic conversion has been added! If FFmpeg is installed on your server, you can insert direct links to MP3, WAV, FLAC, M4A, AAC, and other audio formats.
• The plugin converts tracks on the fly into OGG Vorbis Mono (192 kbps) - the standard required for proper playback in the Minecraft engine.
• Forced Mono Audio: Minecraft's sound engine only applies 3D spatial positioning to mono audio files. Stereo files played equally loud in both headphones regardless of distance. Now, 3D spatial sound from jukeboxes works perfectly!

2. 📋 Personal Playlists

• Every player now gets their own personal playlist with a capacity of up to 45 tracks!
• Easy management directly from the player GUI (/music play -> "📋 Playlist" button):
  • Right-Click a track in the global library to add it to your playlist.
  • Shift + Left-Click a track in the playlist menu to remove it.
  • "▶ Play Playlist" Button - starts playback of your saved collection.
• Playlists are saved to disk and persist across server restarts.

3. ⏭️ Smart Auto-Play & Track Looping

• No need to manually walk up to the jukebox to play the next song anymore!
• The plugin automatically reads the actual duration of the audio file and runs a lightweight timer.
• When a song finishes:
  • In library mode, the next track in order starts automatically.
  • In playlist mode, tracks play sequentially and loop seamlessly.

4. 🔤 Real Track Titles from Metadata (Vorbis Comments)

• Forget uninformative names like minecraft:custom.track_5.
• The built-in OGG Vorbis header parser extracts the original TITLE tag directly from the file metadata.
• Actual track names are now displayed across all menus, item descriptions, and chat messages.

5. 🌍 Full Localization File (lang.yml)

• All plugin messages and UI text have been moved to plugins/MusicPlay/lang.yml.
• Customize menu titles, item lore, tooltips, and chat messages in any language.
• Supports dynamic placeholders: {title}, {max}, {url}, {path}, {error}, {current}, {total}.

6. 🎛️ Individual Resource Pack Autodownload Management

• Players with slow internet connections or custom resource packs can control pack loading themselves:
  • /music skiprp - disable automatic resource pack downloading on join.
  • /music loadrp - re-enable automatic resource pack downloading.
  • /music linkrp - get a direct link for manual resource pack installation.

7. 🎨 Custom Music Disc Texture Support

• The plugin automatically generates a template texture at plugins/MusicPlay/textures/custom_disc.png.
• Server admins can replace this PNG file with their own 16x16 texture, run /music pack, and custom music discs will receive a unique visual style in-game!

8. 🛠️ Core Refactoring & Optimization

• Architecture completely rewritten using modular Kotlin services (PlaybackService, PlaylistService, ResourcePackService, LangService, TrackService).
• Advanced HTTP downloader with automatic redirect handling (301, 302, 307, 308), URL sanitization, and support for popular platforms (Dropbox, GitHub Releases, direct CDNs).
• Prevented thread leaks on server reloads.

---

🕹️ How to Use

For Players:

1. Insert a disc into a jukebox and press Shift + Right-Click (or type /music play).
2. In the main menu, click "Track Library":
   • Left-Click to play the song immediately on the jukebox.
   • Right-Click to add the song to your personal playlist.
3. Open "📋 Playlist":
   • Click "▶ Play Playlist" - your tracks will start playing in sequence and loop automatically.
   • To remove a track from your selection, press Shift + Left-Click.

For Server Administrators:

1. FFmpeg Setup (for MP3, WAV, FLAC, etc. conversion):
   • Ensure ffmpeg is installed on your server machine and accessible via console/PATH.
   • If FFmpeg is missing, uploading non-OGG formats will show an error prompt, but direct .ogg files will continue to work without external utilities.
2. Uploading a Track:
   • Type /music upload and send the direct link in chat.
   • The plugin will download the audio, convert it to mono OGG, read metadata, automatically rebuild musicpack.zip, and notify players.

---

🔧 Commands & Permissions

Command	Description	Permission
/music play (or /m play)	Open the GUI player	—
/music disk [sound]	Give yourself a custom music disc	musicplay.disk
/music upload	Upload a new track via direct link from chat	musicplay.upload
/music pack	Force rebuild the resource pack	musicplay.upload
/music tracks	List all available sound keys	—
/music linkrp	Get a direct link to the resource pack	—
/music skiprp	Disable automatic resource pack loading for yourself	—
/music loadrp	Enable automatic resource pack loading for yourself	—
/music help	Show command help	—

---

⚙️ Technical Requirements (v1.1)

• Server Engine: Paper 1.21+ / Purpur / Folia
• Java Version: JDK 21+
• Optional: System ffmpeg installation for automatic conversion of non-OGG audio formats.
• Port: One open TCP port for the resource pack HTTP server (default 25604)