🎵 My Music Box - Custom Music Disc Mod

📖 Overview

My Music Box is a Minecraft mod that allows you to add custom music into the game as music discs. This mod can automatically download music from YouTube, Spotify, SoundCloud, Facebook, and 1000+ other platforms directly to your server using a single simple command!

⚠️ IMPORTANT COPYRIGHT NOTICE

Intended Use

This mod is developed FOR PERSONAL AND ENTERTAINMENT PURPOSES ONLY. It provides tools to download and use music within your personal Minecraft environment.

User Responsibility

THE USER IS FULLY RESPONSIBLE for how this mod is used. Specifically:

1. Downloading music
   You must ensure that you have the legal right to download and use the music you obtain. This mod is only a tool and does not control or verify the content you download.

2. Sharing

   • ❌ DO NOT share servers containing copyrighted music publicly
   • ❌ DO NOT upload or distribute downloaded music files on the internet
   • ❌ DO NOT broadcast, stream, or rebroadcast copyrighted music
   • ✅ ONLY USE on private servers with personal friends

3. Copyright violations

   • Any copyright violation arising from the use of this mod is ENTIRELY THE USER’S RESPONSIBILITY
   • The mod author TAKES NO RESPONSIBILITY for any legal issues related to copyright
   • Public distribution or sharing of copyrighted music is illegal, and you must bear all consequences yourself

Recommendations for Legal Use

• Use royalty-free or Creative Commons music
• Use music you have purchased or own the rights to
• Use only in private environments
• Respect the rights of artists and creators

By using this mod, you acknowledge that you understand and agree to the terms above.

🚀 Installation

Step 1: Install the mod

1. Download the mod .jar file
2. Place it into the mods/ folder of your server/client
3. Start Minecraft

Step 2: Install yt-dlp (required for download features)

Windows

winget install yt-dlp

Linux (Ubuntu/Debian)

sudo apt update
sudo apt install yt-dlp

Linux (CentOS/RHEL/Fedora)

sudo dnf install yt-dlp

macOS

brew install yt-dlp

Verify installation

yt-dlp --version

⚙️ Configuration

Config file: config/mymusicbox-common.toml

Explanation:

1. creeperDropChance

   • Chance for Creepers to drop a custom music disc upon death
   • 0.05 = 5% = 1 out of 20 Creepers
   • Randomly selects 1 disc from all loaded discs

2. chestLootChance

   • Chance for music discs to appear in dungeon/mineshaft/etc chests
   • 0.1 = 10% = 1 out of 10 chests
   • Randomly selects 1 disc from all loaded discs

3. musicScanInterval

   • Time interval between scans of the mymusic folder
   • Scanning is only for detecting new files, it does NOT load them into the game
   • New files are only loaded after restarting the server
   • Set to 0 to completely disable (saves resources)

🎯 Features

✅ Available

• ✨ Automatic music downloads from 1000+ platforms (YouTube, Spotify, SoundCloud, etc.)
• 🎵 Supports .ogg and .mp3 (auto-converts MP3 → OGG)
• 🎲 Custom loot tables (Creeper drops, dungeon chests)
• ⚙️ Easy drop rate configuration
• 🔄 Automatic scanning of the mymusic folder
• 📡 Client ↔ Server network synchronization
• 🎮 Full Minecraft integration (jukebox, playsound, creative tab)
• 🛡️ Strict validation (file header checks, size limits)
• 🧹 Automatic cleanup of temporary files
• 💬 Detailed command feedback

🔮 Future Possibilities

• Web UI for music management
• Playlist system
• Music voting system
• Custom disc textures/models
• In-game music visualizer
• Discord bot integration

📄 License & Credits

License

This mod is open-source (source code available). You may:

• ✅ Use it for personal purposes
• ✅ Modify it for private servers
• ✅ Learn from the code

You may NOT:

• ❌ Sell the mod or its code
• ❌ Reupload the mod to other websites without proper credit
• ❌ Claim the mod as your own

Credits

• yt-dlp: https://github.com/yt-dlp/yt-dlp
• Minecraft: Mojang Studios

📞 Support

If you encounter issues:

1. Read the troubleshooting section above
2. Check the server logs (logs/latest.log)
3. Look for lines containing [mymusicbox] or CustomMusicManager
4. Contact me at: https://guns.lol/TheRealShiroz

🎵 Enjoy your favorite music in Minecraft!