> For the complete documentation index, see [llms.txt](https://xerickerspigot.gitbook.io/mysteryboxes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xerickerspigot.gitbook.io/mysteryboxes/guides/jukebox-songs.md).

# Jukebox Songs

## TL;DR

1. Create data for songs in the `/config/songs/` folder.
2. Copy and paste your `.ogg` files into the `/songpack/songs` folder.
3. Type `/mb generatepack` in-game to generate a Song Pack.
4. Upload the .zip file  from `/songpack/output` to [mc-packs.net](https://mc-packs.net/).
5. Paste the URL in either `song-pack.yml` or `server.properties`.

## What is a Song Data

"Song Data" refers to a data file inside the /config/songs/ folder. Each data file contains crucial information about a specific song, such as its name, cost, and icon.

## What is a Song Pack

"Song Pack" refers to a resource pack that contains all the song files. Song Packs are sent to players upon clicking any Mystery Vault on the server. When a player declines the download, they won't be able to preview or listen to the songs.

## How to create a Song Data

* Go to the `/config/songs` folder.
* Copy and paste one of the already existing box files.
* Rename the file to your desired name (which serves as its ID).
* Modify the settings according to your preferences.

{% hint style="info" %}
To verify that the song data was created, you can type `/mb listsongs`
{% endhint %}

## How to create a Song Pack

1. Copy the .ogg files to the `/songpack/songs` folder.
   * You can type `/mb verifypack` in-game to verify if your .ogg files have matching data files.
2. Generate a Song Pack using the `/mb gensongpack` command.
3. Navigate to the `/songpack/output` folder.
4. Upload the zip file to mc-packs.net.
5. Copy the download link.
6. Paste the URL in either `song-pack.yml` or `server.properties`.
7. Reload or restart the server to apply the changes.

{% hint style="info" %}
You can use a tool such as [Audacity](https://www.audacityteam.org/) to convert `.mp3` files to `.ogg` format.
{% endhint %}

{% hint style="warning" %}
All songs in a Song Pack must have matching data files.

For example, if you want to create a Song Pack of 3 songs:

* `christmas.ogg`
* `halloween.ogg`
* `summer.ogg`

Then you'd need to create 3 data files of the same name in `/config/songs`:

* `christmas.yml`
* `halloween.yml`
* `summer.yml`

You can type `/mb verifypack` to verify your ogg and data files before generation.
{% endhint %}