<a href="https://discord.gg/rhayah27GC"><img src="https://img.shields.io/discord/704163135787106365?style=flat&label=Discord&labelColor=%234260f5&color=%2382aeff" /></a> <a href="https://paypal.me/TimSchroeter"><img src="https://img.shields.io/badge/Donate%20via%20PayPal-%233d91ff?style=flat" /></a> <a href="https://www.patreon.com/keksuccino"><img src="https://img.shields.io/badge/Support%20me%20on%20Patreon-%23ff9b3d?style=flat" /></a>
<br>
# IMPORTANT
This mod is a LIBRARY mod.<br>
It will do nothing on its own and its only purpose is to act as a dependency for other mods that use its features.
# About
Melody is an OpenAL-based client-side library mod for playing background music.<br>
It allows you to use OpenAL in Minecraft separated from Minecraft's sound engine and manager.
Melody allows you to (asynchronously) load audio files from all kinds of sources, including web sources.
It has built-in support for OGG and WAV audio files, but there's nothing stopping you from extending it to support more file types!
Since Melody was made for easily playing _music_ in menus or in-world, it can't play directional sounds (sounds with a fixed origin in a 3D environment). It can only play 2D audio, so basically music.
To get an idea of how to create ready-to-play audio sources, take a look at Melody's [`SimpleAudioFactory`](https://github.com/Keksuccino/Melody/blob/1.20.1/common/src/main/java/de/keksuccino/melody/resources/audio/SimpleAudioFactory.java) class!
Everything important is documented in the source, so make sure to take a look at [Melody's source on GitHub](https://github.com/Keksuccino/Melody)!
# Copyright & Licensing
Melody Copyright © 2023-2025 Keksuccino.<br>
Melody is licensed under MIT.
# Server Needed?
Looking to play Minecraft with friends but setting up a server is just too time-consuming?<br>
No worries! Simply rent a pre-configured server and start playing _in a snap_.
Just click the image below and use code **[keksuccino](https://bisecthosting.com/keksuccino)** to enjoy a **25% discount** on your first month! You can also click the code itself if your ad blocker hides the banner.
<br>
<a href="https://tinyurl.com/bisectkeks"><img src="https://www.bisecthosting.com/partners/custom-banners/f5dd9194-01d8-4ce3-9b6a-a85327d975b1.png" /></a>
