Open the complete Music Pack tutorial → · Version history

How do I get music?

1. Install the Music Interface mod for your Minecraft version and loader.
2. Get a Music Pack: use one provided by a creator, or make your own using the Music Pack guide.
3. Place the Music Pack in your instance's resourcepacks/ folder and enable it in Minecraft's Resource Packs menu.
4. Open Music Interface. Your tracks appear when the pack contains valid music_data.json and sound entries.
5. If the library is still empty, press F3+T or run /musicinterface_diagnostics and check the FAQ.

Vanilla music is separate: Minecraft's built-in soundtrack is not automatically imported into the Music Interface track list. Installing another music-playing mod does not add its library to Music Interface either.

At a glance

• Complete library with favorites, artists, albums, playlists, search and a queue.
• Radio and four personal Smart Mixes: For You, On Repeat, Rediscover and Current Context.
• Menu, ambient, day/night, weather, dimension, biome and optional battle music.
• Public Music Pack format; no Java development needed to add songs.

Using the music library

The player has a home library, search, grid/list display, Favorites, Albums, Artists, Playlists, History, Queue and Made for You.

• Play a track: choose it in the library. The player offers play/pause, previous, next and stop controls.
• Find a track: search or browse albums and authors. Use the home/favorites sorting controls where shown.
• Favorite a track: use the favorite control. Favorites are saved locally and can be played as a collection, in order or shuffled.
• Disable a track: use the track's available action. Disabled tracks are excluded from automatic selection. The library can optionally hide them.
• Repeat: the repeat control cycles between Off, Playlist and Track.
• Playlists: create, rename and delete playlists, manage their tracks and order, and play in order or shuffle.
• History: displays a recent-track list with a configurable maximum size. This UI history is separate from the long-term listening statistics.

When a song starts, Music Interface can display a Now Playing toast with the cover, artist and album. The toast's outer border accent is derived automatically from the track cover's dominant color, with a built-in fallback color if no usable cover is available. Position, animation and displayed metadata are configurable; there is no separate setting for manually choosing the border color.

Playlists and sharing

The playlist view offers Copy share code, Import from clipboard and Share in chat actions. A share code contains a playlist name and track IDs, not audio files. The recipient therefore needs packs containing those song IDs for those entries to play. Client/server-supported sharing requires the appropriate Music Interface networking to be present.

Use the on-screen playlist controls for creation, editing and track management. A code import creates a local playlist; it does not download missing OGG files.

Queue, Radio and Made for You

Manual queue

Open a song's actions, then select:

• Play Next: insert that song at the front of the pending manual queue.
• Add to Queue: append it at the end.
• Play Now: start it immediately instead of waiting for its queued turn.

The Queue screen lets you move songs up/down, drag to reorder, remove an entry, clear the queue, and Save as Playlist. The persistQueue setting controls whether the queue is saved to queue.json. It is enabled by default.

When the scheduler selects the next song, manual queue entries take precedence, followed by the active repeat/Radio/playlist flow and then normal autoplay as appropriate. Stop and manual playback actions can change the current playback source.

Track Radio

Open a song's actions and choose Start Radio. This keeps a starting song as the reference for choosing related tracks. Similarity considers:

• shared tags, genres and moods;
• artist, album and source Music Pack;
• approximate energy level;
• favorites and locally learned listening preferences.

Radio continues selecting tracks while active and candidates are available. Choose Stop Radio from the track action screen to return to the normal playback flow. Radio is not the same as context-triggered playback.

Made for You

Open Made for You in the player. It offers four automatically generated collections:

Mix	How tracks are selected
For You	Ranks tracks using favorites, listening history and shared metadata; starts with general choices if no habits exist
On Repeat	Tracks played most often
Rediscover	Previously played tracks whose last play was at least seven days ago
Current Context	Tracks eligible for the current in-game situation, ordered with listening history as a preference

Each mix has Play and Shuffle actions. Collections evolve as your library, favorites, context and local profile change. They are not server-synced recommendations.

Listening profile

The profile presents total listening time, plays, favorites, tracks, top songs and habits such as artists, albums, packs, biomes, dimensions, time and weather. The data is stored locally. The source code does not synchronize it to a server or send telemetry.

The profile also provides separate reset actions for statistics, recommendations, and recent history. Be deliberate: a reset cannot be assumed reversible without a backup.

Cobblemon and CobbleSafari

These integrations are optional, client-side compatibility paths. Music Interface should remain functional without either mod.

• Cobblemon: a compatible battle event toggles Music Interface's combat context. external mode suspends Music Interface's runtime for the battle; context mode allows the scheduler to use combat rules.
• CobbleSafari: a compatibility bridge detects when CobbleSafari claims music playback, so Music Interface can coordinate music ownership rather than blindly overlapping it.

Availability depends on the installed companion mod, the Minecraft version and working integrations. Do not assume battle integration is available on every source target just because Music Interface itself builds.