Thirst Mechanics

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

Source	Thirst Restored	Risk
Water Bottle	+4	50% chance of Nausea + Poison + Darkness
Bowl of Water	+3	40% chance of Nausea + Poison
Milk Bucket	+8	None
Mushroom Stew	+2	None
Rabbit Stew	+2	None
Beetroot Soup	+2	None
Melon Slice	+1	None
Purified Water	+8	None
Purified Water Bucket	+8 per drink (12 drinks)	None
Lifestraw	+8 per sip (64 sips)	None

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 Level	Effect
½ droplet (thirst floor)	Lose ½ heart every 30 seconds
Your health reaches ½ heart	Damage stops. Dehydration alone never kills you

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.

Option	Default	Meaning
maxThirst	20	Size of the bar
decrementIntervalTicks	600	Lose 1 point every 30 s
sprintDrainIntervalTicks / sprintDrainAmount	100 / 1	Extra drain while sprinting
jumpDrainAmount	0	Drain per jump (off by default)
minimalThirst / minimalHealth	1 / 1.0	Thirst floor, and the health dehydration stops at
unfilteredGain / waterBottlePoisonChance	4 / 0.5	Water Bottle
bowlGain / bowlPoisonChance	3 / 0.4	Bowl of Water
filteredGain	8	Purified Water & Lifestraw sip
filteredWaterBucketGain / purifiedWaterBucketDurability	8 / 12	Purified Water Bucket
milkBucketGain	8	Milk Bucket
mushroomStewGain / rabbitStewGain / beetrootSoupGain	2	Stews & soup
melonSliceGain	1	Melon Slice
nauseaDuration / darknessDuration / poisonDuration	300 / 300 / 100	Sickness effects (ticks)
rainFillIntervalTicks / rainFillAmount	100 / 2	Rain Collector fills 2% every 5 s
lifestrawDurability / lifestrawUseCost	64 / 1	Lifestraw sips
purifiedStack / waterBottleStack	4 / 4	Stack sizes

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)