Respackopts/docs/filerpo/ToggleFilesWithFallback.md

54 lines
1.4 KiB
Markdown
Raw Normal View History

2021-09-15 15:17:32 +02:00
# Switch between two files
2022-12-08 19:00:41 +01:00
Imagine a simple `IF` statement controlling whether the texture/file should be loaded into the pack.
That is exactly what this page is about.
You will need the `Pack ID` and `Entry Name` from your `respackopts.json5` that you created earlier
2022-08-30 13:31:08 +02:00
if you have not, see [Main Config](../setup/MainConfig.md) on how to do so.
2021-08-30 14:38:03 +02:00
<br>
2021-08-30 15:03:33 +02:00
You will need to navigate to the file you would like to toggle inside your resource, and create a `.rpo` file for it in the same directory (folder).
2021-08-30 14:38:03 +02:00
<br>
### Examples:
`texture.png` would be `texture.png.rpo`<br>
`SomeRecipe.json` would be `SomeRecipe.json.rpo`
<br>
### Layout:
```json
{
condition: "<entry name>",
fallback: "location/of/the/file"
2021-08-30 14:38:03 +02:00
}
```
### Example:
```json
{
condition: "someTexture",
fallback: "assets/minecraft/textures/example/alternate.png"
2021-08-30 14:38:03 +02:00
}
```
2022-12-08 19:00:41 +01:00
Please be aware that Minecraft restricts file and path names.
You MUST follow these! If you don't (for example by using uppercase letters or symbols), your pack WILL NOT WORK!
## Another way to do this:
Respackopts supports specifying multiple possible fallbacks when configuring single files.
You can use this functionality as follows:
```json
{
condition: "<entry name>",
fallbacks: [
"location/of/the/file",
"assets/minecraft/textures/example/alternate.png"
]
}
```
```json
{
condition: "someTexture"
}
```
2021-09-15 15:17:32 +02:00
See [Toggle Files ](./ToggleFiles.md) to see how to just disable files.