Aqua Thirst & Hunger

The most complete hunger and thirst system for Hytale. Balanced survival, custom foods, stamina buffs, poisoning, AFK detection, and seamless RPG leveling integration. 🍖💧

Public release distributed on CurseForge — Aqua Thirst & Hunger.
Project ID 1450021 · License AGPLv3 · Game version: Early Access

💧 Aqua-Thirst & Hunger 🍗

Bring hunger and thirst mechanics into your Hytale experience. There are very few mods offering these mechanics right now, but none as complete and polished as ours. It's perfectly balanced to work as a secondary mechanic you don't need to babysit: it adds challenge to the game while also bringing real benefits along with it.

🍖 Real Survival

It gives real meaning to food and drinks in Hytale, and that same food can save your life:

💚 When wounded, you regenerate health over time by sacrificing hunger and thirst
✨ Gain extra saturation when eating the right foods
💨 Max out your thirst and get a stamina buff to travel long distances
🤢 New poisoning mechanic if you eat raw food, pushing you to discover new recipes

All of this makes the survival immersion in Hytale vastly more engaging.

🛠️ QoL like no other mod

🔊 Custom audio cues that act as fun notifications so you never die of hunger or thirst
💤 AFK detection: if the player is idle, hunger and thirst consumption pauses
🌱 New players join with extended saturation, giving them more time to gather food
🎒 Custom crafting recipes to carry water anywhere you go

🎮 RPG Integration: the experience expands

When you combine the mod with MMO Skill Tree, RPG Leveling And Stats/Skills, or Endless Leveling, its full potential unlocks:

🏹 RPG Leveling And Stats/Skills → Earn XP boosts and let your level dynamically affect your food and water consumption, as well as your XP gains.
🗡️ Endless Leveling → The higher your level, the more stable your hunger and thirst stats become. Gain extra XP when you keep your stats healthy… and lose XP when you neglect them.
🧙‍♂️ MMO Skill Tree → We use this powerful API to create a survival skill tree with rewards. It's incredible how much deeper the mod becomes once you have room to grow!
- Requires restarting the server twice (the first to initialize systems, the second to load the tree).

⚙️ Main commands

Requires operator permissions (/op self).

/aquacheffconfig → main configuration menu
- Visual dashboard with presets (Easy / Normal / Hard)
- Fully customizable settings
- HUD in multiple positions
- Built-in custom food editor
- Life per hunger, thirst and hunger toggleable and customizable
/aquahunger set <0-100> → set hunger level
/aquathirst set <0-100> → set hydration level

🧬 Universal Compatibility

Designed to integrate with virtually any mod setup:

Support for food mods and RPG systems
Compatible with infinite water sources (AvidPixel's Infinite Water Supply)
Automatic integration based on item rarity
Scales with player progression through RPG mods (skills / leveling)

In the rare case of HUD conflicts, it's easily solved using AutoMultiHUD or disabling MultipleHUD depending on the case. This is a known Hytale issue, not caused by our mod, but we'll gladly help you fix it in the comments.

📖 Manifest

What started as a fork of Hunger Core ended up becoming one of the best survival mods for Hytale. Even though the foundation was solid, we rewrote the entire codebase to lay the groundwork for much bigger updates. Incredible plans are coming for this mod.

Eternal credit to @Aex12 for the starting point — and to all of you for keeping the project alive.

This is only the beginning.

💧 Aqua-Thirst & Hunger 🍗 (Español)

Añade a tu juego de Hytale la posibilidad de tener hambre y sed. Actualmente existen muy pocos mods que te ofrezcan estas mecánicas, pero ninguno tan completo y desarrollado como el nuestro. Está perfectamente balanceado para funcionar como una mecánica secundaria de la que no necesitas estar pendiente: añade dificultad al juego, pero también trae beneficios consigo.

🍖 Supervivencia real

Le da sentido a la comida y a las bebidas en Hytale, y esa misma comida puede salvarte la vida:

💚 Al ser herido, recuperas vida con el tiempo sacrificando hambre y sed
✨ Consigue saturación extra si tienes los alimentos adecuados
💨 Con la sed al máximo obtienes un buff de stamina para recorrer grandes distancias
🤢 Nueva mecánica de envenenamiento si comes alimentos crudos, forzándote a descubrir nuevas recetas

Todo esto hace muchísimo más interesante la inmersión survival en Hytale.

🛠️ QoL como ningún otro

🔊 Audios personalizados que funcionan como notificaciones entretenidas para que no mueras de hambre o sed
💤 Detección de AFK: si el jugador está inactivo, el consumo de hambre y sed se frena
🌱 Los jugadores nuevos entran con saturación extendida para tener más tiempo de conseguir alimentos
🎒 Crafteos personalizados para llevar agua a cualquier lugar

🎮 Integración RPG: la experiencia se expande

Cuando combinas el mod con MMO Skill Tree, RPG Leveling And Stats/Skills o Endless Leveling, se desbloquea todo su potencial:

🏹 RPG Leveling And Stats/Skills → Obtén mejoras de XP y haz que tu nivel afecte dinámicamente tu consumo de agua y comida, así como tu ganancia de XP.
🗡️ Endless Leveling → Cuanto más nivel consigas, más estables serán tus niveles de hambre y sed. Ganas XP adicional si mantienes tus stats en buen estado… y menos XP si los descuidas.
🧙‍♂️ MMO Skill Tree → Usamos esta robusta API para crear un árbol de habilidades y recompensas de supervivencia. ¡Es increíble lo interesante que se vuelve el mod cuando tienes posibilidades de mejora!
- Requiere reiniciar el servidor 2 veces (la primera para arrancar sistemas, la segunda para cargar el árbol).

⚙️ Comandos principales

Requiere permisos (/op self).

/aquacheffconfig → menú principal de configuración
- Dashboard visual con presets (Easy / Normal / Hard)
- Configuración personalizada para todos los ajustes
- HUD en diversas posiciones
- Editor de alimentos custom integrado
- Life per hunger, sed y hambre activables y customizables
/aquahunger set <0-100> → ajustar hambre
/aquathirst set <0-100> → ajustar hidratación

🧬 Compatibilidad Universal

Diseñado para integrarse con prácticamente cualquier configuración de mods:

Soporte para mods de comida y sistemas RPG
Compatible con fuentes de agua infinita (AvidPixel's Infinite Water Supply)
Integración automática basada en la rareza de los ítems
Escala con la progresión del jugador con mods RPG (skills / leveling)

En casos raros de conflictos con HUDs, se resuelve fácilmente con AutoMultiHUD o deshabilitando MultipleHUD dependiendo del caso. Este es un problema conocido de Hytale, no depende de nuestro mod, pero con gusto en los comentarios te ayudamos a resolverlo.

📖 Manifiesto

Lo que empezó como un fork de Hunger Core terminó siendo uno de los mejores mods de supervivencia para Hytale. Aunque la base era sólida, reescribimos el código por completo para cimentar updates mucho más grandes. Vienen planes increíbles para este mod.

Crédito eterno a @Aex12 por el punto de partida — y a ustedes por sostener el proyecto.

Esto es apenas el comienzo.

Building from source

Requires Java 25 and access to the Hytale Server JAR.

Drop the Hytale Server JAR into libs/. It is a compileOnly dependency and is intentionally not committed (proprietary).
Build:
```
./gradlew jar
```
The output JAR appears under build/libs/. Drop it into your server's mods/ directory.

Project layout

src/main/java/mx/jume/
  aquahud/                  HUD bridge + multi-HUD container
  aquahunger/
    AquaThirstHunger.java   Plugin entry point
    assets/                 FoodValue asset registration
    commands/               /aquahunger, /aquathirst, /aquacheff, ...
    compat/                 RPGLeveling, EndlessLeveling, MMOSkillTree bridges
    components/             HungerComponent, ThirstComponent (ECS)
    config/                 Config files + migration manager
    events/                 PlayerReady, PlayerDisconnect, GameMode watcher
    interactions/           FeedInteraction, StartFeedingInteraction
    systems/                StarveSystem, ThirstSystem, HungerLifeSystem
    ui/                     HUDs and configuration pages
src/main/resources/
  Common/UI/Custom/Hungry/  HUD .ui definitions
  Server/                   Items, interactions, entity effects, languages
  mmo/                      Custom skills, skill tree, XP maps
mods/Aqua-Thirst-hunger/
  ExternalFoodsDefaultConfig.json   bundled defaults (250+ external foods)

Configuration files

All configs live in mods/Aqua-Thirst-hunger/ and are generated on first run:

File	Purpose
`HungerConfig.json`	Initial level, max, depletion rates, starvation damage, life-per-hunger pulse, satiation thresholds.
`ThirstConfig.json`	Max thirst, depletion, dehydration damage, stamina boost threshold, satiation thresholds.
`FoodValuesConfig.json`	Per-tier hunger restoration / saturation, plus per-item overrides.
`ThirstFoodValuesConfig.json`	Per-tier thirst restoration, fruit multiplier, per-item overrides (Canteen, BasicBottle, etc.).
`ExternalFoodsDefaultConfig.json`	Bundled defaults for 250+ modded foods. Do not edit — overwritten on each launch.
`ExternalFoodsConfig.json`	Your personal overrides for external foods. Never touched by the mod.

Authors

The Aqua Thirst & Hunger Team — Jume, Andiemg.

Thanks to Hunger Core foundation by @Aex12.

License

GNU Affero General Public License v3 — see LICENSE.

Aqua Thirst & Hunger

Aqua Thirst & Hunger

💧 Aqua-Thirst & Hunger 🍗

🍖 Real Survival

🛠️ QoL like no other mod

🎮 RPG Integration: the experience expands

⚙️ Main commands

🧬 Universal Compatibility

📖 Manifest

💧 Aqua-Thirst & Hunger 🍗 (Español)

🍖 Supervivencia real

🛠️ QoL como ningún otro

🎮 Integración RPG: la experiencia se expande

⚙️ Comandos principales

🧬 Compatibilidad Universal

📖 Manifiesto

Building from source

Project layout

Configuration files

Authors

License

Links

📸Gallery

Creator

Information

On this page

Project Links