Smart Recipes

!(https://raw.githubusercontent.com/Kir-Antipov/smart-recipes/HEAD/media/logo.png)

# Smart Recipes

[!(https://img.shields.io/github/actions/workflow/status/Kir-Antipov/smart-recipes/build-artifacts.yml?style=flat&logo=github&cacheSeconds=3600)](https://github.com/Kir-Antipov/smart-recipes/actions/workflows/build-artifacts.yml) [!(https://img.shields.io/github/v/release/Kir-Antipov/smart-recipes?sort=date&style=flat&label=version&cacheSeconds=3600)](https://github.com/Kir-Antipov/smart-recipes/releases/latest) [!(https://img.shields.io/badge/dynamic/json?color=00AF5C&label=Modrinth&query=title&url=https://api.modrinth.com/v2/project/smart-recipes&style=flat&cacheSeconds=3600&logo=modrinth)](https://modrinth.com/mod/smart-recipes) [!(https://img.shields.io/badge/dynamic/json?color=F16436&label=CurseForge&query=title&url=https://api.cfwidget.com/522139&cacheSeconds=3600&logo=curseforge)](https://www.curseforge.com/minecraft/mc-mods/smart-recipes) [!(https://img.shields.io/github/license/Kir-Antipov/smart-recipes?style=flat&cacheSeconds=36000)](https://github.com/Kir-Antipov/smart-recipes/blob/HEAD/LICENSE.md)

Do you find the standard Minecraft recipe format boring? Or maybe you wish to make the game more event-based, like Terraria? If so, `Smart Recipes` is what you need! Craft your own unique experience with our new conditional recipe format!

If you prefer a practical example over explanations, feel free to skip directly to the (#example) section. However, don't forget to revisit the (#conditions) and (#reload-conditions) sections later.

### Conditions Format

The `Smart Recipes` mod extends the (https://minecraft.wiki/Recipe). It's crucial to understand how the vanilla format works; otherwise, the following descriptions may not make sense.

This mod introduces a new `smart_recipes:conditions` property to the recipe format. It's somewhat similar to the conditions in loot tables. Let's take a closer look it:

```jsonc "smart_recipes:conditions": [] ```

This property determines conditions for the recipe to be loaded. If multiple conditions are specified, all must pass.

```jsonc "smart_recipes:conditions": [ { "condition": "conditionName0", "args": [ // Arguments to be passed to some condition named `conditionName0`. 4, "2" ] }, { "condition": "conditionName1", "args": [ // Arguments to be passed to some condition named `conditionName1`. "foo" ] } ] ```

This example is identical to how conditions in loot tables are usually written. However, I find them too verbose. Let's explore how we can improve our conditions.

```jsonc // Let's turn this condition declaration: { "condition": "conditionName1", "args": [ "foo" ] }

// Into this one: "conditionName1": ["foo"] ```

Much better, don't you think?

```jsonc "smart_recipes:conditions": [ { "conditionName0": }, { "conditionName1": ["foo"] } ] ```

This is even better than before, but there is still some room for imporvement. Let's consolidate our conditions into a single object:

```jsonc "smart_recipes:conditions": [ { "conditionName0": , "conditionName1": ["foo"] } ] ```

Finally, if an array contains only one object, the `Smart Recipes` mod allows you to omit its declaration. Here's the final result:

```jsonc "smart_recipes:conditions": { "conditionName0": , "conditionName1": "foo" } ```

I should note that `Smart Recipes` can parse every single one of the examples above, so you can choose the style you prefer.

### Reload Conditions Format

Reload conditions allow recipe conditions to be re-evaluated on different occasions. It can be useful if your recipe relies on weather, time and/or other volatile entities.

This process is surprisingly straightforward. All you need to do is provide the names of the reload conditions that your recipe depends on:

```jsonc "smart_recipes:reload_conditions": [ "weather_changed", "time_changed" ] ```

## Conditions

### `false`

Doesn't require arguments, always returns `false`.

```jsonc "smart_recipes:conditions": [ "false" ] ```

Doesn't require arguments, always returns `true`.

```jsonc "smart_recipes:conditions": [ "true" ] ```

### `or` and `any`

Return `true` if any of the specified conditions returns `true`.

```jsonc "smart_recipes:conditions": { "or": [ { "false": {} }, false, "true" ] } ```

### `and` and `all`

Return `true` if all the specified conditions return `true`.

```jsonc "smart_recipes:conditions": { "and": { "true": {}, "false": null } } ```

### `not` and `none`

Return `true` if none of the specified conditions return `true`.

```jsonc "smart_recipes:conditions": { "not": { "false": null } } ```

### `is_hardcore`

Doesn't require arguments, returns `true` if