142 lines
3.2 KiB
Markdown
142 lines
3.2 KiB
Markdown
# 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:
|
|
|
|
|
|
### 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:
|
|
|
|
|
|
## 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:
|
|
|
|
|
|
## 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:
|
|
|
|
|
|
## 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:
|
|
|