Music Player Mod For Minecraft

Features

Playback sources and library

• Local Music Library: Put supported audio files in config/minecraftmusicplayer/music, open the Local tab, then 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 resolves the track and adds it to the Queue.
• Online Search: Search supported public media through yt-dlp, then play a result immediately or add it to the Queue or a playlist.
• Queue and Playlists: Manage the playback queue and persistent playlists in-game, including track reordering and playlist import/export workflows.
• Metadata and Artwork: Session caches keep recent results responsive, refresh stale provider data in the background, and use local template artwork when a track has no usable thumbnail.

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 follow Minecraft's vanilla visual language.
• Stable playback ownership: The active > marker follows the source that actually owns playback—Queue, Local, Playlist Library, or a direct Player URL—even after changing tabs or reopening the screen.
• Pause-menu safe: Opening Music Player from the singleplayer Pause Menu keeps the world paused. Opening it with the in-game keybind during normal play leaves the world running.

HUD, Mini Player, and controls

• Now Playing HUD: Displays 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.

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 both 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.

Environmental DSP

Music Player can adapt its playback processing 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: 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 keybinds can be changed in Options → Controls.

Client commands

These commands are client-side 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 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.