Hydration

Hydration describes the water restoration ability of an item or a fluid. For fluid, hydration data defines restoration value per 250mB.

Path in datapack

Hydration data is under the directory modid/data/hydration/ of a datapack.

Hydration data contains

Base values

• level (int)
• saturation (int)

Other match options

• nbt (string)
• match_mode (string, “all” or “any”)

Match type, just fill in one of them

• item (string)
• item_tag (string)
• fluid (string)
• fluid_tag (string)

Effects to be applied after using

• effects (array)

Examples

{
  "level": 2,
  "saturation": 0,
  "match_mode": "all",
  "fluid": "minecraft:water",
  "effects": [
    {
      "id": "watersource:thirsty",
      "amplifier": 0,
      "duration": 60.0,
      "probability": 0.8
    }
  ]
}

{
  "level": 2,
  "saturation": 0,
  "match_mode": "all",
  "item": "minecraft:potion",
  "nbt": "{Potion:\\"minecraft:water\\"}",
  "effects": [
    {
      "id": "watersource:thirsty",
      "amplifier": 0,
      "duration": 60.0,
      "probability": 0.8
    }
  ]
}

Dry Level

In Water Source 2, most of the food will consume water saturation. The value it consumes is called the dry level. Every food has a dry level by default following the formula below. dryLevel = floor(foodLevel / 2.0)

But if a food has hydration data of restoration, the dry level will be ignored.

• Config

Hydration data also describes the dry level of a food. It will cover the default dry level of a food.

{
  "dry_level": 1,
  "match_mode": "all",
  "item": "minecraft:cookie"
}

• item_tag effects nbt field also work in dry data