Simple Thirst

Simple Thirst

Plan your next journey around water as well as food. Simple Thirst adds a thirst system to Minecraft survival, with a water bar, dirty water, boiling, and a refillable four-serving waterskin. Collect water in the wild, make it safe to drink, and carry a supply for longer trips.

What the mod adds

• A water bar: ten drops above the hunger bar, including half-drop states. Air bubbles appear above the water bar when you are underwater.
• Thirst that responds to your activity: walking, sprinting, and exhausting actions use more water than standing still. Hot biomes increase water consumption.
• Dirty water and purification: bottles filled from natural water or water cauldrons contain dirty water. Boil it in a furnace or on a campfire.
• A refillable waterskin: carry four servings of clean or dirty water, top it up through crafting, and empty it without drinking.
• Other ways to hydrate: milk, drinkable potions, and melon slices restore water too. You can also drink directly from a nearby water source with empty hands.
• Configurable balance: adjust consumption, restoration, biome multipliers, the Thirst effect, and dehydration damage in a JSON config.

Getting started

1. Collect water with a glass bottle. Water collected from the world is dirty, including water collected by a dispenser.
2. Put the dirty-water bottle in a furnace, or use it on a lit campfire, to obtain a normal clean-water bottle.
3. Craft a waterskin and combine it with water bottles in the crafting grid.
4. Hold Use to drink when you need water. With the default controls, Use is the right mouse button.

Water and the Thirst effect

The full water bar contains 20 water points, shown as 10 drops. One drop equals two water points.

Dirty water restores water immediately, but the Thirst effect makes you lose it faster. By default, Thirst lasts 30 seconds, multiplies ordinary consumption by three, and adds a loss of 0.15 water points per second. Its fixed additional loss over 30 seconds is 4.5 points, plus the increased ordinary consumption. Drinking dirty water again refreshes the effect. Milk removes it.

To drink by hand, sneak and hold Use with an empty main hand, looking at an exposed water source within 2.5 blocks. There is a 1.5-second cooldown between sips. You cannot drink through solid obstructions. Hand drinking is disabled while a waterskin is in your offhand, so emptying that waterskin does not also drink from the water in front of you.

Boiling water

The result is a normal vanilla water bottle, suitable for brewing. Dirty water itself cannot be used as brewing water.

Crafting and using the waterskin

Craft an empty waterskin with three leather and one string:

[       ] [String ] [       ]
[Leather] [       ] [Leather]
[       ] [Leather] [       ]

Combine one waterskin and one to four clean- or dirty-water bottles anywhere in the crafting grid. Each bottle adds one serving and returns an empty glass bottle. The waterskin holds up to four servings; you can top it up, but a recipe that would overfill it will not work. Potions cannot fill it.

Adding dirty water contaminates the entire supply. Adding clean water to a dirty waterskin does not purify its contents. Once completely emptied, the waterskin can be filled with clean water again. Refilling preserves its custom name and other item data.

• Hold Use: drink one serving.
• Sneak + Use: pour out the entire supply without drinking. This works with clean or dirty contents, including when your water bar is full. The empty waterskin remains. Works in either hand.
• Check the tooltip and item bar: see the remaining supply and water type.

Consumption and dehydration

With the default settings and at 20 ticks per second, a full bar lasts approximately 60 minutes while idle, 40 minutes while walking, or 25 minutes while sprinting before additional exhaustion costs. Actions that generate exhaustion can shorten these times.

Water consumption is multiplied by 1.5 in deserts and 1.25 in savanna, jungle, and badlands biomes identified by the vanilla biome tags.

At 3 water points or below, sprinting is disabled. At zero, dehydration deals half a heart of damage every four seconds:

• Easy: dehydration damage stops at five hearts.
• Normal: dehydration damage stops at half a heart.
• Hard: dehydration can kill you.

Water consumption is disabled on Peaceful by default. Creative and Spectator players do not lose water. Your water level is saved when you leave and restored to full after death. Returning from the End without dying preserves it.

Installation and supported versions

Requires Fabric Loader and Fabric API. Install the mod on both the client and the server. For singleplayer, install it in your Fabric game profile.

Download the JAR for your exact Minecraft version and place it, together with a matching Fabric API JAR, in the mods folder.

Each listed Minecraft version has its own build. Select the matching file in the Versions tab. These releases support Fabric; Forge and NeoForge builds are not provided.

Configuration and languages

The mod creates config/simplethirst.json on first launch. Stop the game or server before editing it, then restart to apply changes. You can adjust water consumption, restoration values, hot-biome multipliers, Thirst duration and strength, the sprint threshold, hand-drinking reach and cooldown, damage intervals, and consumption on Peaceful. Server settings control gameplay. Waterskin capacity is fixed at four servings.

In-game translations are included for English, Russian, and Simplified Chinese. The mod follows the language selected in Minecraft.

For testing or administration, /thirst get shows your water level and /thirst set <0–20> changes it. These commands require operator permissions or cheats.

Current development status

The current builds have passed automated calculation and in-game tests, and client launches have been checked for all five listed versions.

Development disclosure: AI tools were used for implementation, version ports, testing, and documentation.

Simple Thirst

Планируй путешествия с запасом воды. Simple Thirst добавляет в выживание систему жажды: шкалу воды, грязную воду, кипячение и бурдюк на четыре порции. Набирай воду в природе, очищай её и бери с собой в дальние походы.

Что добавляет мод

• Шкалу воды: десять капель над полоской голода, включая половинки. Под водой пузырьки воздуха располагаются выше шкалы воды.
• Расход воды в зависимости от действий: ходьба, спринт и действия, вызывающие истощение, расходуют больше воды, чем стояние на месте. В жарких биомах расход увеличивается.
• Грязную воду и очистку: вода, набранная бутылкой из водоёма или котла, становится грязной. Её можно прокипятить в печи или на костре.
• Бурдюк: запас из четырёх порций чистой или грязной воды. Его можно доливать через крафт и опустошать без питья.
• Другие способы утолить жажду: молоко, питьевые зелья, ломтики арбуза и питьё рукой из ближайшего источника воды.
• Настраиваемый баланс: расход и восстановление воды, влияние биомов, эффект «Жажда» и урон от обезвоживания регулируются в JSON-конфиге.

С чего начать

1. Набери воду стеклянной бутылкой. Вода из мира будет грязной, в том числе при автоматическом наборе раздатчиком.
2. Положи бутылку грязной воды в печь или используй её на горящем костре, чтобы получить обычную бутылку чистой воды.
3. Скрафти бурдюк и соедини его с бутылками воды в сетке крафта.
4. Удерживай «Использовать», чтобы пить, когда запас воды снизится. По умолчанию это правая кнопка мыши.

Вода и эффект «Жажда»

Полная шкала — 20 единиц воды, или 10 капель. Одна капля равна двум единицам.

Грязная вода сразу восстанавливает запас, но эффект «Жажда» ускоряет его расход. По умолчанию эффект длится 30 секунд, умножает обычный расход на три и дополнительно отнимает 0,15 единицы воды в секунду. За 30 секунд это 4,5 единицы дополнительной потери плюс повышенный обычный расход. Повторное питьё грязной воды обновляет эффект. Молоко его снимает.

Чтобы пить рукой, присядь и удерживай «Использовать» с пустой основной рукой, глядя на открытый источник воды не дальше 2,5 блока. Между глотками есть задержка 1,5 секунды. Пить сквозь твёрдые препятствия нельзя. Если во второй руке находится бурдюк, питьё рукой отключается: опустошение бурдюка не вызовет одновременное питьё из водоёма.

Кипячение воды

Получается обычная ванильная бутылка воды, пригодная для зельеварения. Грязная вода для зельеварения не подходит.

Крафт и использование бурдюка

Для пустого бурдюка нужны три кожи и одна нить:

[      ] [ Нить ] [      ]
[ Кожа ] [      ] [ Кожа ]
[      ] [ Кожа ] [      ]

Положи один бурдюк и от одной до четырёх бутылок чистой или грязной воды в любом порядке в сетку крафта. Каждая бутылка добавляет одну порцию; пустые бутылки возвращаются. Вместимость — четыре порции. Можно доливать частично заполненный бурдюк, но рецепт с переполнением не сработает. Зелья для наполнения не подходят.

Грязная вода загрязняет весь запас. Добавление чистой воды в грязный бурдюк не очищает содержимое. После полного опустошения его можно снова наполнить чистой водой. Долив сохраняет переименование и другие данные предмета.

• Удерживать «Использовать»: выпить одну порцию.
• Присесть + «Использовать»: вылить весь запас без питья. Работает с чистой и грязной водой, даже при полной шкале воды. Пустой бурдюк остаётся. Работает в любой руке.
• Подсказка и полоска предмета: показывают оставшийся запас и тип воды.

Расход воды и обезвоживание

При стандартных настройках и 20 игровых тиках в секунду полной шкалы хватает примерно на 60 минут стояния, 40 минут ходьбы или 25 минут спринта до учёта дополнительного истощения. Действия, вызывающие истощение, могут сократить это время.

В пустыне расход умножается на 1,5, а в биомах саванны, джунглей и бесплодных земель из ванильных тегов — на 1,25.

При 3 единицах воды и ниже спринт отключается. При нуле обезвоживание наносит половину сердца урона каждые четыре секунды:

• Лёгкая сложность: урон от обезвоживания прекращается на пяти сердцах.
• Обычная: прекращается на половине сердца.
• Сложная: обезвоживание может убить.

На мирной сложности расход воды по умолчанию отключён. Творческий режим и наблюдатель не расходуют воду. При выходе из мира запас сохраняется, после смерти восстанавливается полностью. Возвращение из Края без смерти сохраняет запас.

Установка и поддерживаемые версии

Нужны Fabric Loader и Fabric API. Мод устанавливается и на клиент, и на сервер. Для одиночной игры установи его в свой профиль Minecraft с Fabric.

Скачай JAR для своей точной версии Minecraft и положи его вместе с подходящим Fabric API в папку mods.

Для каждой указанной версии Minecraft подготовлена отдельная сборка. Выбери подходящий файл во вкладке Versions. Эти релизы предназначены для Fabric; сборок для Forge и NeoForge нет.

Настройки и языки

При первом запуске создаётся файл config/simplethirst.json. Редактируй его при выключенной игре или сервере и перезапускай игру для применения изменений. Можно настроить расход и восстановление воды, множители жарких биомов, длительность и силу «Жажды», порог отключения спринта, дальность и задержку питья рукой, интервал урона и расход на мирной сложности. В сетевой игре механикой управляют настройки сервера. Вместимость бурдюка фиксирована: четыре порции.

В моде есть переводы на английский, русский и упрощённый китайский. Язык соответствует выбранному в Minecraft.

Для проверки и администрирования есть команды /thirst get — показать запас воды, и /thirst set <0–20> — установить его. Нужны права оператора или разрешённые читы.

Текущее состояние разработки

Текущие сборки прошли автоматические расчётные и игровые тесты; запуск клиента проверен на всех пяти указанных версиях.

Об использовании ИИ: инструменты ИИ широко использовались для реализации, переноса между версиями, тестирования и документации.