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