Minecraft Music Player

[!IMPORTANT]

Install the required dependencies first

Minecraft Music Player will not load unless the correct builds of both APIs and External tools below are installed.

Required mod dependencies

• Architectury API 13.0.8 or newer: Download Architectury API
• UI Lib 1.0-1.21.1: Download UI Lib

External tools

• FFmpeg: required for music playback. Download FFmpeg and add it to your system PATH, or configure its executable path in the mod.
• yt-dlp: required only for online text search, supported public media pages, and public playlist extraction. Download yt-dlp

A client-side music player mod , it brings local music, direct URLs, online search, playlists, a compact HUD/Mini Player, gameplay audio ducking, and environmental music processing into Minecraft while keeping the interface close to the vanilla style.

The mod is designed to affect Music Player playback only. It does not replace, cancel, or reduce vanilla sound effects.

✨ Features

1. Playback Sources & Library

• Local Music Library: Place supported audio files in config/minecraftmusicplayer/music, then open the Local tab and select Refresh List. Subfolders are scanned up to four levels deep.
• Supported Local Formats: mp3, flac, wav, aac, ogg, opus, vorbis, webm, mkv, mp4, and m4a through the FFmpeg playback pipeline.
• Direct URL Playback: Paste a direct audio URL or a supported public media-page URL in the Player tab.
  • Play URL starts a temporary Player session and does not add the track to the Queue.
  • Queue URL explicitly adds the resolved track to the Queue.
  • Online Search: Search public media through yt-dlp, then play a result immediately or add it to the Queue / a playlist.
  • Queue & Playlists: Manage playback queues and persistent playlists in-game, including track reordering and playlist import/export workflows.
  • Reliable Metadata & Artwork: Session caches keep recent results responsive, refresh stale provider data in the background, and use seeded local template artwork when a track has no usable thumbnail.

2. Vanilla-Friendly In-Game Player

• Five Focused Tabs: Player, Search, Queue, Local, and Library.
• Compact Controls: Play, pause, stop, previous, next, repeat, shuffle, queue actions, filters, sorting, and scrollable lists are built for Minecraft's vanilla visual language.
• Stable Playback Ownership: The active > marker follows the source that truly owns playback—Queue, Local, Playlist Library, or a direct Player URL—and remains correct after changing tabs or reopening the screen.
• Pause-Menu Safe: Opening Music Player from the singleplayer Pause Menu keeps the world paused in the background. Opening it with the in-game keybind during normal play leaves the world running.

3. HUD, Mini Player & Controls

• Now Playing HUD: Shows the current track with configurable record/artwork presentation, placement, and entrance/exit animations.
• Mini Player: A compact non-pausing player screen with full transport controls and four corner positions.
• Artwork Options: Use Vanilla Records, Custom Records, or the active track thumbnail for the HUD artwork slot.
• Persistent Settings: Audio, HUD, Mini Player, playlist, and local-artwork settings are stored under config/minecraftmusicplayer.

4. Adaptive Gameplay Audio Ducking

• Gameplay-Aware Music: Music Player volume lowers smoothly for selected high-priority gameplay sounds, including explosions, bosses, combat, projectiles, blaze/ghast/fireball events, thunder, and other danger cues.
• Independent User Volume: The final playback level respects your Music Player volume and Minecraft Music volume. Ducking never overwrites either slider.
• Configurable Response: Adjust ducking enablement, minimum volume, attack, and release in Audio Settings.
• Vanilla Audio Stays Untouched: The mod observes gameplay sounds only; it never changes their volume, replaces them, or cancels them.

5. Environmental DSP

• Context-Aware Music Processing: Music Player can adapt to Open World, Cave, Underwater, Nether, and End environments.
  • Cave: A deeper room tail for enclosed spaces.
  • Underwater: A darker, submerged low-pass sound.
  • Nether: A denser, darker atmosphere.
  • End: A stable, spacious profile without volume pumping.
  • Clean Transitions: Environmental profile changes crossfade to avoid clicks, crackles, and abrupt DSP resets.
  • Safe Lifecycle Handling: Seeking, changing tracks, pausing, leaving a world, and closing Minecraft clear DSP state cleanly.
  • Optional: Toggle Environmental DSP independently in Audio Settings at any time.

⌨️ Default Keybinds

All bindings can be changed in Minecraft Options → Controls.

⚙️ Client Commands

These are client-side commands and do not require server installation.

• /musicplayer overlay on|off|toggle — Show or hide the Now Playing HUD.
• /musicplayer overlay anchor <top_left|top_middle|top_right|bottom_left|bottom_middle|bottom_right> — Move the HUD to a preset anchor.
• /musicplayer overlay move <x> <y> — Set a manual HUD offset.
• /musicplayer overlay reset — Reset the HUD position and settings.
• /musicplayer overlay animations on|off — Toggle HUD entrance/exit animations.
• /musicplayer overlay style <custom|vanilla|thumbnail> — Select the HUD record/artwork style.
• /musicplayer miniplayer position <top_left|top_right|bottom_left|bottom_right> — Move the Mini Player.
• /musicplayer miniplayer reset — Reset the Mini Player to Bottom Right.

🛠️ Requirements

• Required libraries:
  • Architectury API for NeoForge 13.0.8 or newer
  • UI Lib for NeoForge 1.0-1.21.1
  • External playback tool: FFmpeg must be installed and available on your system PATH, or configured explicitly.
  • Online search / public page resolution: yt-dlp is required for text search, supported public media pages, and public playlist extraction.

📥 Installation

1. Install the matching builds of Architectury API and UI Lib.
2. Install FFmpeg. Put it on your system PATH, or configure its executable path as described below.
3. Install yt-dlp if you want online search or public page / playlist resolution.
4. Drop the Minecraft Music Player JAR and the required library JARs into your Minecraft mods folder.
5. Launch Minecraft once. The mod creates its configuration folders automatically.

🎵 Quick Start

Local music

1. Press M in a world to open Music Player.
2. Open the Local tab.
3. Select Open Music Folder and copy music into the folder, or place files directly in:

.minecraft/config/minecraftmusicplayer/music

1. Select Refresh List.
2. Play a track, add it to Queue, or add it to a playlist.

Online music

1. Make sure yt-dlp is installed or configured.
2. Open Search to search public media, or open Player and paste a direct audio/public page URL.
3. Use Play URL for temporary playback or Queue URL to add it to the Queue.

Pro Tip: Keep FFmpeg and yt-dlp up to date, then use the Local tab for quick offline playback and the Queue / Library tabs for longer in-game sessions.

Another Pro Tip: If you like my mod please support my mod VIA paypal :