Dehydration Mod Wiki

Dehydration adds a critical layer of survival to Minecraft by introducing a Hydration Bar (Thirst) that functions similarly to the Hunger bar. Players must maintain their hydration levels to avoid debilitating debuffs and eventual death. The mod is designed for the Fabric loader and emphasizes a balanced progression from early-game makeshift containers to advanced purification systems.

Key Features

• Hydration Bar: A new UI element located above the hunger bar consisting of 10 water droplets (20 points).
• Dynamic Depletion: Thirst levels drop based on physical activity (sprinting, jumping, mining) and environmental factors.
• Purification System: Multiple ways to turn 'Dirty' water into 'Purified' water using cauldrons, campfires, and specialized pumps.
• Progression: Craftable flasks made from Bamboo, Leather, and Copper to store water for long journeys.
• Compatibility: Native support for EnvironmentZ (temperature affects thirst) and Motschen's Puddles (drinking from rainwater puddles).

The core mechanic of the mod is the management of the Thirst bar. Like hunger, thirst has an internal 'exhaustion' value that increases with player actions.

Thirst Depletion Factors

Environmental Effects

• Hot Biomes: In Deserts, Badlands, and the Nether, the hydration bar depletes significantly faster. Wearing heavy armor in these biomes can further accelerate dehydration.
• Drinking from the World: Players can drink directly from any water source (River, Ocean, etc.) by Shift + Right-Clicking with an empty hand. However, this 'Dirty Water' has a high chance of applying the Thirst status effect, which causes the bar to drain even faster.

Drinking unpurified water is dangerous. To stay healthy, players must use one of the following methods to obtain Purified Water.

1. Smelting

Water Bottles can be placed in a Furnace or Smoker to create Purified Water Bottles. This is the most basic form of purification available early-game.

2. Campfire Cauldron

By placing a Campfire Cauldron over a lit campfire, players can purify large quantities of water.

• Fill the cauldron with a Water Bucket or Bottles.
• Wait approximately 10 seconds (indicated by a bubbling sound).
• Collect the Purified Water using a Flask or Glass Bottle.

3. Rain Collection

The Rain Collector block automatically gathers fresh rainwater during storms. This water is considered purified and can be extracted directly into containers.

4. Bamboo Pump

The Bamboo Pump is an advanced block that can extract purified water from a water source located directly below it (up to 50 blocks deep). It requires a cooldown of 1 minute between uses.

The mod introduces several items for storing and consuming liquids. Flasks are superior to Glass Bottles as they can hold multiple 'charges' of water.

Flasks

Consumables

• Purified Water Bottle: Restores 4 Hydration points (2 droplets). Safe to drink.
• Water Bottle (Dirty): Restores 2 Hydration points but has a 60% chance to apply the Thirst effect.
• Juices: Crafted by combining a Purified Water Bottle with fruits (Apple, Sweet Berries, Glow Berries, Melon). Juices restore both Hydration and a small amount of Hunger.
• Milk Bottle: Obtained by using a Glass Bottle on a Cow. Restores hydration and clears status effects.

Purification Blocks

Copper Cauldron

Crafted with 7 Copper Ingots in a 'U' shape. It acts as a more versatile version of the vanilla cauldron, capable of holding purified water and collecting rainwater at a slow rate.

Campfire Cauldron

Crafted with 1 Copper Cauldron, 3 Sticks, and 1 Chain. Must be placed on a Campfire to function. It is the primary mid-game method for bulk water purification.

Rain Collector

Crafted with 8 Planks and 1 Bucket. When placed under an open sky during rain or snow, it fills with purified water. It can hold up to 10 bottles worth of water internally.

Bamboo Pump

Crafted with 1 Bamboo, 1 Lever, 1 Smooth Stone Slab, and 1 Bucket.

• Usage: Place it above a water source. Right-click to pump water into an attached container (Flask/Bucket).
• Retrieval: Use Shift + Right-Click to retrieve the filled container from the pump.

Managing thirst is vital to avoid the following effects:

Negative Effects

• Thirst: Applied when drinking dirty water or being attacked by certain mobs (if configured). It causes the hydration bar to deplete 2x faster.
• Dehydration (Low Thirst): When the bar reaches 0, the player receives Slowness, Weakness, and Mining Fatigue.
• Damage: If the bar remains at zero, the player will begin taking periodic damage (0.5 hearts every few seconds) until they drink or die.

Positive Effects

• Hydration: Some high-quality drinks provide a 'Hydration' buff that temporarily freezes the thirst bar, preventing depletion for a short duration.

Dehydration is highly customizable via the cloth-config API and standard Minecraft datapacks.

Datapack Integration

You can add hydration values to any modded item by creating a JSON file at data/dehydration/hydration_items/.

Example JSON:

{
 "1": {
 "replace": false,
 "items": [
 "minecraft:apple",
 "minecraft:melon_slice"
 ]
 }
}

(Note: The key "1" represents 0.5 droplets or 1 hydration point.)

Config Options

• Hydration Factor: Global multiplier for how fast thirst drains.
• Biome Multipliers: Adjust how much faster thirst drains in specific biomes.
• Damage Interval: How often the player takes damage when fully dehydrated.
• Bonus Chest: Enable this in world settings to start with a Leather Flask and Purified Water.