Thirst Mechanics

A thirst system mod for Minecraft 26.1.2 – 26.3 (Fabric), part of the CraftZ experience. Register at craftz.net Register before launch (23/10) and you'll receive a unique Founding Survivor badge, visible on your profile.

What is Thirst Mechanics?

Thirst Mechanics brings thirst to Minecraft, shown above your hunger bar. Thirst goes down over time and faster when you sprint, and you manage it by drinking from different water sources: some are safe, some are risky. Drink dirty water and you might get sick. Let the bar run dry and you start losing health. Stay hydrated or face the consequences.

Water Sources

Tip: Right-click on any water source block with an empty bowl to fill it with water.

Tip: Milk, stews, soups and melon can be eaten even when your hunger bar is full, so you can always use them to top up thirst.

Purifying Water

Any water you collect yourself is risky until you cook it. Smelt it in a furnace (10 seconds) or on a campfire (30 seconds, no fuel needed):

• Water Bottle → Purified Water: a safe bottle, +8 thirst.
• Water Bucket → Purified Water Bucket: a canteen with 12 drinks of +8 each. When it's empty it turns back into a regular bucket.

Water bottles and Purified Water only stack to 4, so plan your trips around how much water you can carry.

Items Added

• Purified Water: A safe water bottle. Craft by smelting a water bottle in a furnace or over a campfire.
• Purified Water Bucket: A safe, reusable water bucket (12 drinks). Smelt a water bucket in a furnace or over a campfire.
• Bowl of Water: Fill an empty bowl by right-clicking on a water source.
• Activated Charcoal: The filter used by the Rain Collector and the Lifestraw. Craft with charcoal + redstone.
• Lifestraw: A portable filter for drinking safely straight from any water.
• Rain Collector: A block that automatically fills with rainwater and can filter it.

Lifestraw

A filter straw for drinking straight from lakes, rivers and puddles, with no bottles and no risk of getting sick.

How to use:

1. Craft it from 2 iron nuggets and 1 Activated Charcoal (nugget, charcoal, nugget in a column).
2. Look at water within 5 blocks and hold right-click to sip.
3. Each sip restores +8 thirst, with no chance of getting sick.

The filter wears out after 64 sips, and then the straw breaks.

🌧️ Rain Collector

The Rain Collector is a block that automatically fills with rainwater when placed under an open sky.

How to use:

1. Craft the Rain Collector and place it outside with nothing above it.
2. Wait for rain: the reservoir fills from 0% to 100% in about 4 minutes of rain.
3. Right-click with an empty glass bottle to collect water. Each bottle uses 10% of the tank, so a full tank fills 10 bottles.
   • Without a filter: regular water bottle (risk of contamination)
   • With a filter: purified water bottle (safe)
4. Insert Activated Charcoal into the filter slot (GUI) to purify the water. Right-click the collector without a bottle to open the GUI.
   • One piece of activated charcoal = one purified bottle
   • The charcoal is consumed after each use

⚠️ The collector only fills if the sky is visible above it and it is raining. It does not work underground or under a roof.

Requires a stone pickaxe or better to break.

Dehydration Effects

Thirst resets fully on death.

Thirst can't drop below ½ droplet, and dehydration can't take you below ½ heart. At that point, one zombie is all it takes.

Fully Configurable

Every value in this mod can be tuned in the config file located at:

./config/thirst-mechanics.json

Configurable values include:

• Thirst decrement interval
• Sprint and jump drain
• Thirst gain per source
• Poison chances
• Effect durations
• Rain Collector fill rate
• Lifestraw and Purified Water Bucket durability
• Stack sizes for water bottles and Purified Water
• Damage threshold and minimum health

Default values

20 thirst points = 10 droplets. 20 ticks = 1 second.

Drinks from other mods

Any food or drink from another mod can restore thirst: add its item ID to customDrinkGains. No code changes are needed.

"customDrinkGains": {
  "better_mcdonalds_mod:coca_cola": 6,
  "somemod:orange_juice": 5
}

Just edit and restart.

Admin command

/hydrate <player> fills a player's thirst bar (requires operator / Game Master permission).

CraftZ Network

This mod is developed as part of the CraftZ survival network. Experience Thirst Mechanics and other custom features live at:

craftz.net

Learn everything about the server on the CraftZ Wiki

Join the community on Discord

Built for Minecraft 26.X (Fabric)