# Custom Music Discs

Nexo streamlines the process of adding custom music discs to your server.\
You will need one valid OGG file, for your sound & a NexoItem referencing it.

### Registering your sound

To begin you will need to register your sound. This is essentially what [Sounds](/configuration/sounds.md)explains.\
All Sound-OGG files go into the **sounds-folder** in the ResourcePack.\
If unsure how ResourcePacks work & how to structure files, read through [ResourcePack](/configuration/resourcepack.md) & [FAQ](/general-usage/faq.md#how-do-i-reference-a-resourcepack-file-in-a-config)

In short, navigate to `plugins/Nexo/sounds.yml` and add a basic entry for your sound

```yaml
sounds:
  - id: namespace:my.sound    # This is a key which will be used in the NexoItem
    sound: namespace:my/sound  # This references your OGG file and where you put it
    stream: true              # Optional, defaults to false. Enable for long sounds
    jukebox_playable:
      comparator_output: 15   # Optional, defaults to 15, must be in 1..15
      range: X                # Optional, If omitted, the sound will have a variable range.
      duration: 2.5s
      description: Description
```

Now make sure you put the OGG file in the right spot. Above we have referenced `namespace:my/sound` -> `assets/namespace/sounds/my/sound.ogg` inside `plugins/Nexo/pack/`

### Making the Custom Music Disc NexoItem

Now that the sound is all done we just need to make a very basic NexoItem that references the ID of our sound above. There is a slight difference in how the Jukebox Playable-Component is written depending on your server-version. [Components](/configuration/items/components.md) will show you the one for your server.

For setting a custom texture/model on your NexoItem, you can define it under the Pack section.

```yaml
my_music_disc:
  itemname: My Music Disc
  material: PAPER
  Pack:
    texture: namespace:discs/my_music_disc
  Components:
    jukebox_playable:
      song_key: namespace:my.sound
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexomc.com/configuration/custom-music-discs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.