# Adding discs

## How to

When you first start the game after adding the mod, the `config/moderncustomdiscs` directory should be created.

To add a custom disc, all you need to do is add a `<id>.ogg` file to that directory. **WARNING: Your music file must be in .ogg format, you can use converters like** [**Convertio**](https://convertio.co/mp3-ogg/)**.**

If you want more customization, add a **\<id>.json** file formated like this:

```json
{
    "name": "<display name of your disc, defaults to the id>",
    "author": "<author of the song, defaults to none>",
    "colors": ["<color1 in hex, defaults to #ffffff", "<color2, defaults to color1>"],
    
    "creeper": <whether or not a creeper could drop this discs (normal disc behaviour), defaults to false>,
    "redstone": <comparator output of jukebox, defaults to 0(must be a number between 0 and 16)>
}
```

**All values are optional.**

You can also add a `<id>.png` file which will act as a texture for your disc, overriding the default. **The best resolution to use for your texture is 16x16 pixels.** `<id>.png.mcmeta` files for animation are also supported.

## File structure

```
<id>.ogg
<id>.json (optional)
<id>.png (optional)
<id>.png.mcmeta (optional)
```

Each id **must** have a .ogg file.

**WARNING: The ids must only contain a-zA-Z0-9\_ characters, otherwise your disc won't be added!**

## Examples

{% embed url="<https://github.com/Hellish-Mods/Modern-Custom-Discs/tree/main/example>" %}
GitHub example
{% endembed %}