Thirsty

Thirsty is a vanilla-friendly datapack that introduces a hydration system into Minecraft, adding an extra layer of immersion and resource management to survival gameplay.

It is designed to integrate smoothly with vanilla mechanics, with a strong focus on performance, clarity, and multiplayer stability.

• Suitable for survival worlds
• Server-ready
• No mods required

---

⚠️ Required Resource Pack
This datapack requires the Thirsty Resource Pack to display the HUD element correctly. Make sure the resource pack is installed and enabled, or the thirst bar will not appear.

---

Technical and Server Information

The settings menu and uninstall system were designed to be server-friendly and safe.

Open the settings menu:

/trigger ThirstSettings

Installation & Update

• Download the datapack .zip.
• Place it inside:

<your_world>/datapacks/

• Enter the world or run:

/reload

• Verify installation:

/datapack list

Operator Commands Server operators can control access to the uninstall option:

/function uninstall_lock
/function uninstall_unlock

These commands lock or unlock the uninstall option globally for all players.

---

Thirst Mechanics

Thirsty adds a hydration system that works alongside vanilla hunger mechanics.

• Players have internal thirst and hydration values.
• Thirst only decreases through player actions — AFK players won’t suddenly die of thirst.
• In Peaceful Mode, thirst and hydration are automatically replenished.
• Includes a custom advancement tree to track progression.

Ways to restore thirst

• Drinking water bottles or potions
• Eating water-rich foods
• Sipping directly from natural water sources

Thirst System Details

Thirst works similarly to hunger and saturation:

• th_thirst → visible bar (0–20, starts at 20)
• th_hydration → hidden buffer (0–20, starts at 5)

Hydration is always consumed before visible thirst.

Category / Items	Thirst (visible)	Hydration (hidden)
Drinks (Water Bottle, Potions)	8	6
Sipping from source (Every 80 ticks)	2	1
Stews	6	5
Milk	6	4
Hearty Fruits (Melon Slice)	4	2
Fruits	3	1
Special (Honey Bottle, Golden Apple)	2	0
Negative (Cause thrist, Dried Kelp)	0	0

Note: thirst decreases through sprinting, swimming, jumping, and combat. The Thirst status effect accelerates this drain.

---

Sipping System

• Sneak + look at a water block to drink directly from it.
• Requires 80 ticks (~4s) to complete.
• Restores +2 Thirst and +1 Hydration.
• Intentionally slow to balance risk vs convenience.
• Disabled by default — can be enabled in the settings menu.
• Each player has an independent sipping configuration.

---

Thirst Status Effect

• Applied by eating dried kelp or being attacked by a drowned.
• Lasts 30 seconds and accelerates thirst drain.
• Visual feedback: greenish HUD bar and particles.
• Instantly cured by drinking Milk.

---

Multiplayer and Language Support

• Built with multiplayer compatibility in mind (still experimental).
• Available languages: English, Brazilian Portuguese, Spanish (Mexico), French, German.
• Resource pack system allows easy addition of new translations.

---

Final Notes

Known limitation: Custom HUD may temporarily disappear when interacting with beds during daytime or when consuming potions, due to engine behavior in recent Minecraft versions.

If you enjoy this datapack:

• 👍 Follow the project
• 💬 Share feedback and ideas
• ⬆️ Recommend it to friends or servers

Every bit of feedback helps improve the project.

Recent Updates

• v1.4.2 — Stability update
• v1.4.1 — Bugfix and HUD Refresh
• v1.4 — HUD update, performance optimizations, multiple bug fixes, initial Modrinth release

(See the update logs for the full changelog.)