# ResourcePackOpts Config.

### Location (ResourcePacks).
> `/assets/respackopts/conf.json`

### Location (DataPacks).
> `/data/respackopts/conf.json`

## What needs to be here.
```json
{
    "id": "<PackID>",
    "version": 5,
    "capabilities": ["FileFilter", "DirFilter"],
    "conf": {
        // Your config options here
    }
}
```

### Capabilities:

> **FileFilter:** (Default Enabled) <br> If stated will enable file filtering functionality.

> **DirFilter:** (Default Disabled) <br> If stated will enable folder filtering functionality.

> **DirFilterAdditive:** (Default Disabled) <br> If stated this will enable a compatibility fix for some mods that also modify resources.

## Adding a Toggle/Boolean

To add a boolean entry, add code like this: `"EntryName": <Default Option (true/false)>` 

### Example:
```json
{
    "id": "ExamplePack",
    "version": 5,
    "capabilities": ["FileFilter", "DirFilter"],
    "conf": {
        "SomeTexture": true,
        "SomeOtherTexture": false
    }
}
```
### Result:
![configExampleBolean](./img/ExamplePackBoolean.png "ConfigExampleBolean")

### See [Togglefiles](./ToggleFiles.md) to see the logic behind this

## Adding a Free Number Box
A number box follows the same principle as a boolean: `"entryName": DefaultNumber`
*please note any value can be put in here with no limit*

### Example:
```json
{
    "id": "ExamplePack",
    "version": 5,
    "capabilities": ["FileFilter", "DirFilter"],
    "conf": {
        "SomeOption": 10
    }
}
```
### Result:
![configExampleNumber](./img/ExamplePackNumber.png "ConfigExampleNumber")

## Adding a slider
A slider is slightly more complicated as a minimum and a maximum need to be defined. Sliders also only support whole numbers.

### Example:
```json
{
    "id": "ExamplePack",
    "version": 5,
    "capabilities": ["FileFilter", "DirFilter"],
    "conf": {
        "SomeOption": {
            "min": 0,
            "default": 5,
            "max": 10
        }
    }
}
```
### Result:
![configExampleSlider](./img/ExamplePackSlider.png)

## Select From a list
To allow users to select one entry from a list, you can use a json array with string entries. *Numbers/etc are not supported*

### Example:
```json
{
    "id": "ExamplePack",
    "version": 5,
    "capabilities": ["FileFilter", "DirFilter"],
    "conf": {
        "SomeOption": [
            "option_one",
            "option_two",
            "option_three"
        ]
    }
}
```
### Result:
![configExampleEnum](./img/ExamplePackEnum.png)

## Make a category

### Example:
```json
{
    "id": "ExamplePack",
    "version": 5,
    "capabilities": ["FileFilter", "DirFilter"],
    "conf": {
        "SomeCategory": {
            "SomeBoleanOption": true,
            "SomeNumberOption": 5,
            "SomeSelectionOption": [
                "option_one",
                "option_two",
                "option_three"
           ],
            "SomeSliderOption": {
                "min": 0,
                "default": 5,
                "max": 10
            }
        },
        "SomeotherCategory": {
            "SomeOtherBoleanOption": true,
            "SomeOtherNumberOption": 5
        }
    }
}
```
### Result:
![configExampleCategory](./img/ExamplePackCategory.png)