Well Seasoned

Well Seasoned replaces Minecraft's hunger loop with direct healing and data-driven food effects. It is inspired by ingredient-based cooking systems like in Breath of the Wild and the Matcha Flavoured Datapack.

The mod supplies the food system. Modpacks and datapacks supply the food profiles.

What changes

• The hunger HUD is hidden.
• Hunger, exhaustion, starvation, and hunger-based regeneration are disabled.
• Players can always sprint and eat.
• Unconfigured food restores health instead of hunger.
• Datapacks can set the healing, status effects, and preparation tier of any existing food item.
• Food tooltips show the final heart value and configured status effects.
• The same data works with vanilla items and items from other mods.

An unconfigured food restores half of its vanilla nutrition value as health, with a minimum of one health point. Two health points equal one heart.

Supported targets

Fabric also requires Fabric API. Install the mod on both the client and server.

Datapack setup

Place cooking catalogs in this directory:

<datapack>/
└── data/
    └── <namespace>/
        └── well_seasoned/
            └── cooking/
                └── <catalog>.json

Each catalog is one JSON object. It can contain an intrinsics array, a foods array, or both. Definitions can refer to definitions in other catalog files.

This complete example defines one intrinsic and assigns it to one food:

{
  "intrinsics": [
    {
      "id": "example:fortifying",
      "effects": [
        {
          "id": "minecraft:resistance",
          "duration": 240,
          "amplifier": 0,
          "maximum_duration": 4800,
          "maximum_amplifier": 1,
          "ambient": false,
          "show_particles": true
        }
      ]
    }
  ],
  "foods": [
    {
      "item": "example:pumpkin_jam",
      "tier": "preserved",
      "healing": 3,
      "mode": "append",
      "intrinsics": [
        "example:fortifying"
      ]
    }
  ]
}

A food entry can select all food items in an item tag. Use tag instead of item:

{
  "foods": [
    {
      "tag": "example:fruit",
      "tier": "simple",
      "healing": 2,
      "intrinsics": [
        "example:refreshing"
      ]
    }
  ]
}

The tag uses the normal datapack item-tag format. For the example above, define the tag at data/example/tags/item/fruit.json. Do not add a # before the tag ID. Missing and empty tags are allowed. Non-food items in a tag are ignored.

An explicit item entry overrides a matching tag entry. If two configured tags contain the same food and there is no explicit item entry, reload fails.

Run /reload after you change a catalog. Well Seasoned validates all catalogs as one set. If any catalog is invalid, the reload fails and the last valid set stays active. Intrinsic IDs, explicit food item IDs, and food tag IDs must be unique across the full set.

Preparation tiers

The tier changes the base healing and effect duration. A special meal also adds one effect level. The configured maximum values still apply.

For example, a preserved food with healing: 3 restores 4.05 health points.

Catalog reference

Intrinsic fields

Effect fields

There are 20 ticks in one second. The tier multiplier is applied before the duration and amplifier caps.

If a player already has the same effect at the same level, eating the food adds half of the new duration, with a minimum addition of 20 ticks. The result cannot exceed maximum_duration. A weaker food effect does not replace a stronger active effect.

When several food sources supply the same effect, the strongest amplifier wins. Effects with the same amplifier add their durations. The result cannot exceed the largest maximum_duration from those sources. Built-in item effect probabilities are preserved.

Food fields

Planned features

The roadmap is split into two systems. These features are planned and are not part of the current release unless another section says that they are already supported.

Food-effect compatibility

• Add configurable global defaults for effect combination behavior.
• Expose item tags and data formats for compatibility with other mods.
• Provide example data for fire-resistant food.

Dish effect inheritance

• Detect the ingredients or recipe components of a dish, including food from Farmer's Delight and its add-ons.
• Let dishes inherit and combine ingredient effects when they do not have a specific food entry.
• Let pack makers override, disable, or replace inherited effects for a specific dish.
• Add configurable rules for duplicate effects and for duration and amplifier scaling.
• Add separate duration and strength multipliers for combined dishes. Values above 1.0 will be allowed. For example, a multiplier of 0.75 gives each inherited effect 75% efficiency.
• Support data-driven booster ingredients that make prepared meals stronger or longer-lasting than simple foods. For example, potato soup could give more fire resistance than a baked potato.
• Expose ingredient tags and data formats for compatibility with other mods.
• Validate ingredient data and provide example data for combined meals.