Droplets of Thirst has two layers of configuration:

• Datapacks hold everything that belongs to a registry id: item values, tags, biomes, dimensions, recipes, loot. They reload with /reload and the server sends clients what they need.
• TOML files in config/droplets_of_thirst/ hold global numbers and switches, plus a few per-item overrides. See Configuration.

All paths below are inside a datapack (data/<namespace>/...). The mod logs and skips bad entries. They never crash the game or disconnect players.

The formats on this page are those of Minecraft 26.3: datapacks declare "min_format": 121, "max_format": 121 in pack.mcmeta. Other versions read other formats, listed on their own page (see the home page).

A NeoForge data map on items. File: data/<namespace>/data_maps/item/drinks.json, in any namespace. NeoForge merges all packs in load order.

{
  "values": {
    "minecraft:apple": { "thirst": 2, "quenched": 3 },
    "#c:drinks/juice": { "thirst": 8, "quenched": 13 },
    "examplemod:spring_water": { "thirst": 6, "quenched": 8, "purity": 4 }
  },
  "remove": ["minecraft:carrot"]
}

• Keys are item ids or #tags. An entry from a later pack replaces the earlier one for that item. "replace": true at the top clears everything loaded before this file, and remove drops entries loaded before it (ids or tags).

• NeoForge logs an unknown item id as an error. For items of optional mods, put a condition on the entry:

  "examplemod:lemonade": {
    "neoforge:conditions": [{ "type": "neoforge:mod_loaded", "modid": "examplemod" }],
    "thirst": 6, "quenched": 4
  }

• Items that are eaten and items that are drunk use the same map. Droplets of Thirst tells them apart by the item itself: food hydrates when its food component feeds the player, a drink when it is finished.

• Negative values make an item salty: eating or drinking it removes thirst and quenched (never below 0, and quenched stays at or below thirst). Salty items never count towards overhydration. They roll purity effects only if they are water containers. Their tooltip shows red droplets, and the HUD flashes in red the droplets they would take away.

• The defaults are in data/droplets_of_thirst/data_maps/item/drinks.json: vanilla items and the terracotta water bowl. Water bottles and the terracotta water bowl give 4 and 5, the melon slice 4 and 4, rotten flesh, spider eyes, pufferfish and poisonous potatoes -3 and -3. To change a default, add your own entry (a later pack wins) or remove it.

• The map is synced to clients. Tooltips and the HUD use the server's values.

Blocks eaten in place, like cake, have their own data map on blocks: data/<namespace>/data_maps/block/hydrating_blocks.json, with the same thirst and quenched fields. The mod ignores purity here, because food never rolls purity effects. A bite counts when a right click on the block raised the player's food level, so it works for any block that feeds the player directly (other mods' pies too). Negative values work here too.

{
  "values": {
    "minecraft:cake": { "thirst": 1, "quenched": 1 },
    "#minecraft:candle_cakes": { "thirst": 1, "quenched": 1 }
  }
}

Each item takes its values from the first of these sources that has them, and the mod ignores the others for that item:

1. Blacklist: the item tag #droplets_of_thirst:no_thirst or overrides.blacklist in items.toml. The item restores no thirst at all.
2. TOML overrides: overrides.drinks and overrides.foods in items.toml.
3. Datapacks: the droplets_of_thirst:drinks data map.
4. Other mods' code: DropletsAPI.registerDrink, then value providers of mods whose values depend on the stack. See Mod developers.
5. Salty tag: items in #droplets_of_thirst:salty get salty.thirstPenalty and salty.quenchedPenalty from items.toml (-2 and -2). Explicit values from 1-4 win, so a tagged item with its own entry keeps it.
6. Keywords (items.toml, section keywords, off by default).
7. Estimated from recipes (items.toml, section inference, off by default), only for items that nothing above gives values. Estimates are never negative. Tooltips add "(est.)", and /droplets_of_thirst infer <item> shows how the number was made. See Configuration.

The server resolves this table on world load and on /reload, and sends it to every client.

Water picked up from the world (buckets, bottles, bowls, drinking by hand, dispensers, the Traveler's Backpack hose) gets a purity from 0 to 5:

1. Poured water: a source poured by a bucket keeps the purity it was poured with (see Poured water).
2. Salt water: if saltWaterPurity is 0-5 and the biome is in #droplets_of_thirst:salt_water, the water gets that fixed value and nothing else applies.
3. Base purity, the first that is set:
   1. base of the biome in the droplets_of_thirst:biome_water data map;
   2. the biome tags #droplets_of_thirst:water_purity/5 down to /0, checked in that order;
   3. base of the dimension type in the droplets_of_thirst:dimension_water data map;
   4. worldWaterBasePurity in purity.toml (1).
4. Plus the altitude delta, the still/running delta and the biome's delta. The result is kept between 0 and the biome's max (5 by default).

Global settings in purity.toml, section [world]:

A water cauldron stores no purity. Whatever went into it (rain, dripstone, a bucket of contaminated or pure water), the water taken out of it (buckets, bottles, bowls) is always murky (2). It is clean (4) while the cauldron stands on a block of #droplets_of_thirst:cauldron_heat_sources (blocks with a lit property count only when lit). For pure water, cook it. Jade shows the purity the water would have now.

The same rule applies to any registered purity container that another mod lets you fill from a cauldron, and to pumps and pipes of other mods that drain the cauldron through NeoForge's fluid capability.

• data/droplets_of_thirst/tags/worldgen/biome/water_purity/0.json to /5.json: plain biome tags. Droplets of Thirst ships none of them. The defaults come from the droplets_of_thirst:biome_water data map below, and biomes it does not list start at worldWaterBasePurity.
• data/droplets_of_thirst/tags/worldgen/biome/salt_water.json: ships with #minecraft:is_ocean. The mod does not use it when saltWaterPurity is -1.

{ "values": ["minecraft:cherry_grove", "#c:is_mountain"] }

Biome data map, data/<namespace>/data_maps/worldgen/biome/biome_water.json. The defaults use the standard c: biome tags, so biomes from other mods are covered too:

Oceans are fixed at 0 by saltWaterPurity.

When a biome is in several tags, the entry listed last wins and replaces the earlier one completely. The shipped file lists the jungle, taiga, cold and mountain biomes first, then deserts and badlands, and swamps last. So a swamp or desert that a mod also tags as mountain keeps the swamp or desert values. Entries you add for the same biome or tag replace the shipped ones (a later datapack wins). "replace": true at the top of your file drops all of them.

{
  "values": {
    "minecraft:plains": { "base": 2 },
    "#c:is_snowy": { "delta": 1 }
  }
}

Dimension type data map, data/<namespace>/data_maps/dimension_type/dimension_water.json. Its keys are dimension types (minecraft:overworld, minecraft:the_nether, a mod's type id), so dimensions that share a type share the value.

{ "values": { "minecraft:the_end": { "base": 5 } } }

Droplets of Thirst sets minecraft:the_end to thirst_multiplier 0.6, so the End counts as cold. A datapack entry for minecraft:the_end replaces it. Only the server reads the two world data maps.

droplets_of_thirst:dehydration is a harmful effect that makes thirst drop faster, like Hunger does for food: 0.005 exhaustion per tick per level, times effects.dehydrationMultiplier. Thirst never goes below zero. By default only [hotDirtyWater] gives it. Add it to a purity effect list for more, for example "droplets_of_thirst:dehydration,600,0,25" in effects.dirty for a 25% chance of 30 s of Dehydration I from dirty water.

droplets_of_thirst:quenchness restores (level) thirst and (level) quenched every effects.quenchnessIntervalTicks (40), like Regeneration does for health. The potions are in the minecraft:potion registry, so loot tables, set_potion and commands can use them: /give @p minecraft:potion[potion_contents={potion:"droplets_of_thirst:quenchness"}].

The mixes are 15 minecraft:brewing recipes in data/droplets_of_thirst/recipe/brewing/: each mix for the potion, splash and lingering containers, plus the gunpowder and dragon's breath container changes. Every one carries the load condition droplets_of_thirst:quenchness_potion, which follows gameplay.toml effects.quenchnessPotion. To use another ingredient, put a recipe with the same id in your datapack, or turn the switch off and add your own mixes without that condition. The first mix, droplets_of_thirst:brewing/potion_awkward_prismarine_crystals:

{
  "neoforge:conditions": [{ "type": "droplets_of_thirst:quenchness_potion" }],
  "type": "minecraft:brewing",
  "input": { "item": "minecraft:potion", "potion_contents": { "potions": "minecraft:awkward" } },
  "reagent": { "item": "minecraft:prismarine_crystals" },
  "output": { "id": "minecraft:potion", "components": { "minecraft:potion_contents": { "potion": "droplets_of_thirst:quenchness" } } }
}

droplets_of_thirst:hydrated slows thirst loss: it multiplies all thirst exhaustion by effects.hydratedMultiplier (0.5) once per level, so Hydrated II quarters it. It shows in /droplets_of_thirst debug exhaustion as hydrated. Sources: /effect give @p droplets_of_thirst:hydrated 60 0, the purity effect lists (for example "droplets_of_thirst:hydrated,600,0,100" in effects.pure) and the full-hydration bonus ([hydration] fullBonus, off by default). There is no potion for it.

droplets_of_thirst:overhydrated makes the player 10% slower per level (an attribute modifier on minecraft:movement_speed, like Slowness). Drinking far past full gives it ([overhydration], on by default), and /effect works too.

Vanilla effects that change thirst: Nausea drains it (depletion.nauseaDepletes) and Fire Resistance reduces it (fireResistancePercent). With effects.waterBreathingReducesThirst (off), Water Breathing or Conduit Power reduce it while fully underwater. Hunger does not change thirst: MIRROR_FOOD mode leaves out its extra food exhaustion.

Every player has the attribute droplets_of_thirst:thirst_drain (base 1.0, 0 to 10). It multiplies thirst loss, so anything that carries attribute modifiers changes thirst without code:

• items: the vanilla minecraft:attribute_modifiers component (/give, loot tables, other mods);
• enchantments (datapack): the minecraft:attributes effect component;
• effects, Curios, other mods: plain AttributeModifiers;
• commands: /attribute @s droplets_of_thirst:thirst_drain base set 0.5.

"minecraft:attribute_modifiers": [
  { "type": "droplets_of_thirst:thirst_drain", "id": "examplemod:cooling_helmet", "amount": -0.25, "operation": "add_multiplied_base", "slot": "head" }
]

Files: data/droplets_of_thirst/tags/item/<name>.json, tags/block/<name>.json, tags/mob_effect/<name>.json. Use {"id": "othermod:item", "required": false} for optional mods. The mod reads effects when the player's effects change and once a second.

Purification uses vanilla recipe types (minecraft:smelting, minecraft:campfire_cooking, minecraft:smoking) with NeoForge component ingredients. The ingredient matches water of one purity, and the result stores a higher one. JEI and other recipe viewers show them like any other recipe. JEI also gets a "Water Purification" page for the water cauldron, plain and over a heat source, which has no recipe. That page is hidden when purity.enabled is false. A "Hydration" page lists every item that changes thirst with the values the server resolved, so it shows your changes after /reload.

The recipes ship as optional built-in datapacks, listed in the datapack screen when creating a world and in /datapack list:

Each pack covers water bottles, water buckets and terracotta water bowls.

• Turn a method off or on per world with /datapack disable "mod/droplets_of_thirst:datapacks/purify_campfire" or /datapack enable .... The choice is saved with the world.
• Recipe ids follow <item>_from_<method>_to_<level>, for example droplets_of_thirst:water_bottle_from_smelting_to_murky. To change one, put a recipe with the same id in your own datapack above it.
• Water with no purity stored counts as acceptable (3), and the recipes that take level 3 match it.
• Every purification recipe carries the condition {"type": "droplets_of_thirst:purity_enabled"}, so none load when purity.enabled is false. Use it in your own purity recipes too.

One level of purification for a modded water container:

{
  "neoforge:conditions": [{ "type": "droplets_of_thirst:purity_enabled" }],
  "type": "minecraft:campfire_cooking",
  "ingredient": {
    "neoforge:ingredient_type": "neoforge:components",
    "items": "examplemod:canteen",
    "components": { "droplets_of_thirst:purity": 1 }
  },
  "result": { "id": "examplemod:canteen", "components": { "droplets_of_thirst:purity": 2 } },
  "cookingtime": 300
}

A water bottle is a potion, so its ingredient also names the potion: "items": "minecraft:potion", "components": {"minecraft:potion_contents": {"potion": "minecraft:water"}, "droplets_of_thirst:purity": 1}.

Water with no purity stored does not match a "droplets_of_thirst:purity": 3 ingredient. Match it with "strict": true and the other components only, and join both in a neoforge:compound ingredient, as the built-in recipes do:

"ingredient": {
  "neoforge:ingredient_type": "neoforge:compound",
  "children": [
    { "neoforge:ingredient_type": "neoforge:components", "items": "minecraft:water_bucket", "components": { "droplets_of_thirst:purity": 3 } },
    { "neoforge:ingredient_type": "neoforge:components", "items": "minecraft:water_bucket", "components": {}, "strict": true }
  ]
}

Droplets of Thirst adds water bottles, acceptable (3) or pure (5), to the chests of dungeons, mineshafts, shipwrecks (supply), Nether fortresses and bastions. Each chest is one loot table in data/droplets_of_thirst/loot_table/chests/ and one global loot modifier in data/droplets_of_thirst/loot_modifiers/. NeoForge loads every file in that folder, with no global_loot_modifiers.json list. Both carry the load condition droplets_of_thirst:loot_config, which follows gameplay.toml loot.enabled.

Loot tables and modifiers use the Minecraft 26.3 loot format: modifier in place of functions, a single condition in place of the conditions list, and type as the key of every function and condition. Several conditions go in {"type": "minecraft:all_of", "terms": [...]}.

{
  "neoforge:conditions": [{ "type": "droplets_of_thirst:loot_config" }],
  "type": "neoforge:add_table",
  "condition": { "type": "neoforge:loot_table_id", "loot_table_id": "minecraft:chests/simple_dungeon" },
  "table": "droplets_of_thirst:chests/simple_dungeon"
}

The purity of a bottle in a loot table goes on a set_components function with the loot condition droplets_of_thirst:purity_enabled, so the bottle comes without a purity when purity is off:

"modifier": [
  { "type": "minecraft:set_components", "components": { "droplets_of_thirst:purity": 3 }, "condition": { "type": "droplets_of_thirst:purity_enabled" } },
  { "type": "minecraft:set_count", "count": { "type": "minecraft:uniform", "min": 1, "max": 3 } },
  { "type": "minecraft:set_potion", "id": "minecraft:water" }
]

Loot in the old format loads without an error, but the game ignores its functions and conditions. A global loot modifier with the old conditions list adds its table to every loot table in the game. scripts/loot/convert.py in the repository converts loot tables and modifiers to the 26.3 format.

Two optional presets change the balance. The default is Droplets of Thirst's own. Each preset has two parts, and you apply them by hand, so nothing rewrites your config:

The TOML files only list the keys they change. Droplets of Thirst adds the rest with their defaults.

The terracotta water bowl's item model (assets/droplets_of_thirst/items/terracotta_water_bowl.json) tints its water layer with the item tint source droplets_of_thirst:water_purity (field default, an RGB colour used when the stack has no purity). A resource pack can put the same tint source on other water containers. Water bottles are tinted through vanilla's potion tint.