> For the complete documentation index, see [llms.txt](https://luminex-studio.gitbook.io/untitled/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://luminex-studio.gitbook.io/untitled/plugins/lx-music.md).

# LX-Music

How to put custom music?

{% hint style="warning" %}
**You should follow** this first configuration **on** your **test server** on your PC to **avoid mistakes** and too many restarts.. players don't like when the server is offline. You can upload files to your real server after you finished here.
{% endhint %}

{% hint style="danger" %}
**Make sure** that all of your plugins and server software are up to date!
{% endhint %}

## Step 1 - Installing the plugin and libraries

* stop the server
* install [*ProtocolLib*](https://www.spigotmc.org/resources/protocollib.1997/)
* install [*ItemsAdder*](https://www.spigotmc.org/resources/%E2%9C%A8itemsadder%E2%AD%90emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/)
* start the server
* let LX-Music finish loading everything

First step is done.

{% hint style="warning" %}
Now you must complete **step 2** to configure the resourcepack. <mark style="color:red;">**DO NOT SKIP!**</mark>
{% endhint %}

## Step 2 - Put the music

You need to add the music you want to listen to, but for this, you need **ItemsAdder, Oraxen** or your **own texture pack.**

**In your resource pack, go to:  `resourcepack/ assets/ minecraft/`**

You will need to add a few things here. Open the **`sounds.json`** file or create one if it doesn't exist.

```
"music_name": {"sounds": [{"stream":true,"name": "music_name"}]}
```

{% hint style="danger" %}
**If you are adding more entries, make sure to add a , at the end of each one, except for the last one.**
{% endhint %}

```
"music_name": {"sounds": [{"stream":true,"name": "music_name"}]},
"music_name1": {"sounds": [{"stream":true,"name": "music_name1"}]}
```

Then, open the `sounds` folder: **`resourcepack/assets/minecraft/sounds`**

Place your music file in this folder, making sure it is in **`.ogg`** format.

{% hint style="success" %}
Now, the texture part is done. After that, reload your texture pack plugin and reload the texture.
{% endhint %}

## Step 3 - Config the region

Next, you will need two sets of coordinates: `x,y,z - x,y,z`.

open the LX Music config file and paste it.

<figure><img src="https://121668711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgh1fWmmuHCkwKBvclo1Q%2Fuploads%2F09euWDjcLWHLo0l0Yq1q%2Fimage.png?alt=media&amp;token=46574aaa-3dfa-4753-82e5-9ad9e4d65754" alt=""><figcaption></figcaption></figure>

After replace `music_name` with the name you used in `sounds.json`.

<figure><img src="https://121668711-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgh1fWmmuHCkwKBvclo1Q%2Fuploads%2FVvtvGmYMWzfTSuNZSXr7%2Fimage.png?alt=media&amp;token=f007350a-c639-4268-88b3-e9b358468151" alt=""><figcaption></figcaption></figure>

And finally restart your server. You can toggle the music on and off with /music on and /music off.         If it doesn't work, leave the region and re-enter to refresh the settings.

{% hint style="success" %}
And you're all set! If you encounter any issues, join our [Discord support server](https://discord.gg/JwupCcEvq5)!
{% endhint %}