# 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 %}


---

# 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://wiki.modernmodpacks.site/wiki/hellish-mods/modern-custom-discs/adding-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.