SimpleHungerSystem

SimpleHungerSystem adds a lightweight survival layer to Hytale with hunger, thirst, food values, drink values, and a compact radial HUD.

The mod is built as a clean replacement-style survival system for servers that want food and water gameplay without relying on the old HUD routing setup. It also exposes a small compatibility API so other mods can read or change hunger and thirst values.

Features

• Hunger decreases over time.
• Thirst decreases over time.
• Food items restore hunger based on configurable values.
• Drink items restore thirst based on configurable values.
• Built-in support for raw and cooked food values.
• Direct configured drink handling for bottles and other drink items.
• Portable SimpleHunger water flask item.
• Compact vertical radial HUD for hunger and water.
• Hungry, starving, thirsty, dehydrated, nourished, and hydrated status effects.
• Optional pause while sleeping.
• Optional idle pause.
• Optional biome-based hunger and thirst modifiers.
• Simple compatibility API for other mods.

HUD

SimpleHungerSystem uses its own modern HUD entry:

simplehunger.survival.hud

The default HUD shows two small radial indicators:

• chicken leg icon for hunger
• water drop icon for thirst

The HUD is positioned near the lower-left area above the normal game UI. The exact UI layout is stored in:

Common/UI/Custom/HUD/SimpleHunger/SystemHud.ui

Configuration

The mod creates its config files on the server after first launch. Restart the server once after installing the mod, then edit the generated config files.

Main config files:

HungerConfig.json
Foods.json
Drinks.json
BiomeModifiers.json

What each file is for:

• HungerConfig.json controls max hunger, max thirst, decay rates, starvation damage, thirst damage, thresholds, sleeping pause, idle pause, and well-fed settings.
• Foods.json controls how much hunger each food item restores.
• Drinks.json controls how much thirst each drink item restores.
• BiomeModifiers.json controls optional biome multipliers for hunger and thirst decay.

Commands

/sh

Shows the SimpleHunger command help.

/shconfig

Opens the in-game configuration/value page.

/shversion

Shows the installed SimpleHungerSystem version and HUD mode.

Food And Drink Values

Food and drink values are configured by item ID.

Example behavior:

• cooked food restores more hunger
• raw food can restore smaller amounts
• berries can restore a small amount of hunger
• filled water flask restores thirst

Server owners can add or change values in Foods.json and Drinks.json without rebuilding the mod.

Compatibility

SimpleHungerSystem exposes:

com.simplehunger.api.SimpleHunger

Other mods can use this API through normal Java access or reflection to:

• read hunger
• set hunger
• add hunger
• read thirst
• set thirst
• add thirst
• register food values
• register drink values

This is intended for race/class/gameplay mods such as vampire or werewolf systems that need to replace or modify normal eating behavior.

Installation

Copy the jar into the Hytale user mods folder:

~/Library/Application Support/Hytale/UserData/Mods

Then restart the game/server.

Version Support

This release targets Hytale server versions:

>=0.6.0 <0.7.0

Tested against the installed Hytale 0.6.x runtime.