CustomMusic+

🎵 CustomMusic+

CustomMusic+ lets you bring your own soundtrack into Minecraft — but only .ogg audio files are currently supported. If you have music in .mp3 format, you’ll need to convert it to .ogg first. A quick and easy way to do this is by using Audacity (free), VLC Media Player, or an online converter like CloudConvert.

CustomMusic+ is a lightweight, client-side Fabric mod that lets you add, play, and manage your own music and playlists directly in Minecraft — without using resource packs or editing sound files.

Every Minecraft instance (per version or modpack) gets its own custommusic folder, allowing you to have a completely unique soundtrack for each setup.

📂 Folder Structure
Each version of Minecraft has its own independent folder:
.minecraft/
├── 1.21.6/
│ └── config/
│ └── custommusic/
│ ├── chill.ogg
│ ├── battle_theme.ogg
│ ├── night.ogg
│ └── playlists/
│ ├── chillvibes.txt
│ └── boss_battle.txt

Just drop your .ogg tracks or text-based playlists inside, and CustomMusic+ will load them automatically when the game starts.

---

⚙️ Core Features

✅ Play .ogg tracks directly from your filesystem
✅ Support for .txt playlists with sequential playback
✅ Instance-specific folders (perfect for multi-version setups)
✅ Auto folder creation on first launch
✅ Lightweight client-side mod — no server required
✅ Simple, unified command system under /CustomMusic
✅ Works with all Fabric versions that support OpenAL

---

💬 Commands

Command	Description
/CustomMusic play <name>	Plays a track or playlist immediately.
/CustomMusic stop	Stops current playback and clears the queue.
/CustomMusic pause	Pauses current track or playlist.
/CustomMusic resume	Resumes paused playback.
/CustomMusic list	Lists all available tracks and playlists.
/CustomMusic search <keyword>	Searches for songs/playlists containing the keyword.
/CustomMusic reload	Rescans folders for new music and playlists.
/CustomMusic help	Displays help and usage information.

---

🧠 How It Works (Technical Summary)

Component	Role
CustomMusicPlusClient	Client entrypoint — registers commands, handles ticks and playback queue.
PlaylistManager	Creates/scans custommusic and playlist folders for .ogg, .mp3, and .txt files.
OggDecoder	Uses LWJGL STB Vorbis to decode .ogg into raw PCM data.
AudioPlayer	Handles playback using LWJGL OpenAL (play, stop, pause, resume).

🔎 MP3 files are detected and listed but not playable yet — Minecraft natively supports only .ogg.

---

🎮 Example Usage

/CustomMusic play chillvibes Plays all tracks in playlists/chillvibes.txt sequentially

/CustomMusic search night Finds all tracks and playlists containing “night

🔮 Planned Features

Volume control per track Shuffle & loop modes “Now Playing” overlay Support for MP3 decoding via TinySound or FFmpeg GUI playlist browser

🧩 Compatibility

Requirement Info Loader Fabric Environment Client-side only Dependencies Fabric API Supported Formats .ogg (playable), .mp3 (listed only)

❤️ Credits

Developed and maintained by hindustani_gamer_fardin