Thirsty

# **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 ``` <details> <summary>Installation & Update</summary> - Download the datapack `.zip`. - Place it inside: ``` <your_world>/datapacks/ ``` - Enter the world or run: ``` /reload ``` - Verify installation: ``` /datapack list ``` </details> <details> <summary>Operator Commands</summary> 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. </details> --- ## 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 <details> <summary>Thirst System Details</summary> 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.* </details> --- ## 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. <details> <summary>Recent Updates</summary> - **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.) </details>

## 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.