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