Description

### Summary Music and Melody is an easy-to-use, incredibly powerful & customisable music overhaul - **Albums**. Browse vanilla and modded albums, and disable any tracks you don't want to hear - **Playlists**. Queue, Shuffle, Loop and play any music, any time, right from your own personal playlist, with access to the entire vanilla and modded library of Albums and music discs - **Events**. Control how your music plays. Make entire custom music systems that replace vanilla, listen to structure-specific music, revert music to the old days - really, anything you can think of! And you can do it all right in-game, even if you're not a developer! Even built-in Events can be enabled or disabled as you wish - **soundtrack expansion**. This includes a large, custom Album, featuring a plethora of new songs tailored for each location they're added to, created by community composers (included with their permission, of course) - **fix vanilla music shortcomings**. Recent updates have destroyed the weighting and balance of music, both new and old, and this is only getting worse in new updates. Music and Melody not only reweights every music pool, but adds additional fixes for vanilla bugs (such as creative music not playing when it should), and additional quality of life features (including Jukeboxes no longer overlapping with background music) - **extensible resource-driven developer features**. Resource Pack, Mod and Modpack developers alike can make entire custom music projects with detailed music playback conditions and high configurability, all through Music and Melody's resource-driven features as documented on the [wiki](https://github.com/Rebel459/music-and-melody/wiki) _**Check out the [Gallery](https://modrinth.com/mod/music-and-melody/gallery)** for images, and **check out the [Wiki](https://github.com/Rebel459/music-and-melody/wiki)** for comprehensive documentation on Albums, Playlists & Events!_ ### Albums Music and Melody introduces Albums, and lets you view and edit all available Albums in a new menu accessed from the sounds or mod config screen. Here, you can view all unique albums, whether they're from vanilla (every vanilla album is included, alongside a couple new ones!), Music and Melody or a supported resource pack / mod. You are able to enable and disable entire albums, or even individual tracks at your leisure. Whilst browsing an album, you can play any song directly, or add it to your Playlist queue. Further, if you're a player, you can easily drag any .ogg file you want into config/music_and_melody/album to have it appear in-game. Albums are entirely resource-driven, so check out [Album documentation](https://github.com/Rebel459/music-and-melody/wiki/Albums) on the wiki! ### Playlists Playlists and Albums go hand-in-hand. You can queue any song into the game, control your playlist and even save and share them with friends! The Playlist screen allows you to Shuffle, Loop and directly play all queued music. Saved playlists can be loaded from and found in the albums screen. To bring up your current playlist, simply press the bound keybind (default: H) or access it from the sound settings or config screen. Playlists can even be dynamically loaded through your own events! Playlists are entirely resource-driven, so whether you're a player or developer you should check out the [Playlist documentation](https://github.com/Rebel459/music-and-melody/wiki/Playlists). ### Events Events are a unique, built-in-editable way of controlling dynamic music playback. The event system is so comprehensive that it makes both vanilla and modded ways of playing custom music in-world (eg for biomes, structures, etc) entirely redundant. You can check for various conditions like the time of day, weather, dimension, etc. Events can be edited in-game from the Events menu, accessed from the Playlist or config screen. A guide on doing so can be found with the [Event documentation](https://github.com/Rebel459/music-and-melody/wiki/Events). Built-in event presets, made entirely within the client-side event system, which can be enabled or disabled in-game, include: - Stronghold music - Ancient City music - Wither music - Snowy music - Dark Forest music - Savanna music - Classic C418-only preset (defaults to disabled) ### Config Location: - all config files (and folders) are located in config/music_and_melody - client config is config/music_and_melody/client.json5 - data config (stores internal data, should not be touched by users) is config/music_and_melody/data.json5 - server config (optional features when installed on the server) is config/music_and_melody/server.json5 - config album songs should be placed in config/music_and_melody/album - config playlists should be stored, and are generated (if saved in-game) in config/music_and_melody/playlists - config events should be stored, and are generated (if saved in-game) in config/music_and_melody/events Client Config Features: - **Music Rebalance**. The reweighting of every vanilla music pool with an emphasis on restoring variety and reducing repetition added by poor decision-making in recent updates _(see [this explanation](https://t.co/bzWjYixTzr) and [MC-308155](https://report.bugs.mojang.com/servicedesk/customer/portal/2/MC-308155) for context)_. This does include re-adding C418 music to biomes Mojang removed certain tracks from, making common tracks slightly rarer, and rarer tracks more common, and a ton more smaller changes - **Jukebox Fading**. When you're listening to a music disc, background music temporarily fades away - **Fade Speed**. The speed at which music fades in and out between using Jukeboxes or switching Events - **Creative Fix**. A fix for [MC-299683](https://bugs.mojang.com/browse/MC/issues/MC-299683), restoring the ability for Creative music to play in all Overworld biomes. You can also tag a biome in #music_and_melody:has_creative_music if you want a non-Overworld biome to have this fix - **Under Water Fix**. Based on the Creative Fix, this fixes [MC-306710](https://report.bugs.mojang.com/servicedesk/customer/portal/2/MC-306710) and enforces the under-water-exclusive music being able to play in all rivers and oceans. You can also tag a biome in #music_and_melody:has_under_water_music if you want a non-river or non-ocean biome to have this fix - **Event Weight Fix**. This fixes a flaw (not necessarily a bug) in vanilla code that makes sounds.json files ignore the weight specified for "type": "event". The fix is only applied to entries that specify an explicit weight, ensuring safe compatability with vanilla & modded sound pools, whilst allowing Music and Melody to utilise this fix in its own pools. This also allows the further fixing of Creative music frequency, seeing as Creative music references the music.game sound event - **Button Placement**. Whether the Albums and Playlist buttons should be at the top of sound settings, bottom, or config-menu-only - **Config Album**. Whether the built-in config album generated from unbound music discs and your custom added music (config/music_and_melody/album) should function - **Allow Events**. Whether the Event system should function - **Vanilla Music**. Whether vanilla music playback should occur Features that require Music and Melody to also be installed on the server: - **Count Disc Uses**. Whether putting a disc in a Jukebox should count as using the disc. Used for determining whether a music disc is unlocked for survival-mode playback - **Sync Structures**. Whether structure information should be tracked and sent to the client. Used for Events with structure-specific conditions - **Sound Events**. Used to register custom sound events under the music_and_melody namespace **Once again, for further documentation, you should [check out the Wiki](https://github.com/Rebel459/music-and-melody/wiki)!** _If you have any feedback, issues or contributions, you're welcome to open an issue or pull request on the [GitHub page](https://github.com/Rebel459/music-and-melody)_ _**Music and Melody has full integration with [Simple Music Control](https://modrinth.com/mod/simple-music-control)**, which offers additional features such as fancier music popups and customisable music frequency, down to the second! Further, Simple Music Control provides now-playing popups and no-loading-interruptions playback for 1.21.1_ _If you're a composer, or you just think you've found some fitting music you'd like to see added, open an issue or reach out to me on Discord as @rebel459_ _If you'd like some new music discs, also check out [Legacies and Legends](https://modrinth.com/mod/legacies-and-legends)!_ **Music Credits** Firel - https://www.youtube.com/@FirelMusic/featured Soul_ - https://www.youtube.com/@soulwynmc BouncyTorch - https://aurigrave.org/ qwaston - https://www.youtube.com/@qwaston Firch - https://www.youtube.com/@Firchex bhuv_ - https://www.youtube.com/watch?v=BhV2mtaM8wQ Technotech - https://www.youtube.com/watch?v=9uVA7RKZ2XM Talon Trueblood - https://www.youtube.com/@TalonTrueblood ARKTNDR - https://www.youtube.com/@ARKTNDR Naps the Block Music - https://www.youtube.com/@napstheblockmusic5807 solunary - https://www.youtube.com/@solunary Oh Eight - https://www.youtube.com/@oheight Freja Nelson - https://www.youtube.com/@frejanelson/featured Louie Zong - https://louiezong.bandcamp.com Judio Kallio - https://jukiokallio.com F7c82 - https://www.youtube.com/@F7c82 Jorclai - https://www.youtube.com/@Jorclai Antimo & Welles - https://www.youtube.com/antimowelles Shauny Jang - https://www.shaunyjangaudio.com Johan Johnson - https://minecraft.wiki/w/Johan_Johnson