Hunger with HUD bar [hbhunger]

• Version: 0.7.1-Wooster

Using the mod

This mod adds a mechanic for hunger. This mod depends on the HUD bars mod [hudbars], version 1.4.1 or any later version starting with “1.”.

About hunger

This mod adds a hunger mechanic to the game. Players get a new attribute called “satiation”:

• A new player starts with 20 satiation points out of 30
• Actions like digging, placing and walking cause exhaustion, which lower the satiation
• Every 800 seconds you lose 1 satiation point without doing anything
• At 1 or 0 satiation you will suffer damage and die in case you don't eat something
• If your satiation is 16 or higher, you will slowly regenerate health points
• Eating food will increase your satiation (Duh!)

Important: Eating food will not directly increase your health anymore, as long as the food item is supported by this mod (see below).

Careful! Some foods may be poisoned. If you eat a poisoned item, you may still get a satiation boost, but for a brief period you lose health points because of food poisoning. However, food poisoning can never kill you.

Customisability

You can change two parameters in the Settings section of minetest.

• "Stomach size" is you maximum satiation (which is to say, how much food you can eat). The default value is 30.
• "Depletion rate" governs how quickly you wear down your satiation. The default value is 1.0.

If you find the food mechanism too easy, raising depletion rate to 5 or 10 might make things sufficiently tougher. You may wish to increase stomach size by a factor smaller than your depletion rate in order to mitigate somewhat the effect of wearing down your energy level more quickly.

Statbar mode

If you use the statbar mode of the HUD Bars mod, these things are important to know: As with all mods using HUD Bars, the bread statbar symbols represent the rough percentage out of 30 satiation points, in steps of 5%, so the symbols give you an estimate of your satiation. This is different from the hunger mod by BlockMen.

You gain health at 5.5 symbols or more, as 5.5 symbols correspond to 16 satiation points. You may lose health at exactly 0.5 symbols, as 0.5 symbols correspond to 1-2 satiation points.

Supported food

All mods which add food through standard measures (minetest.item_eat) are already supported automatically. Poisoned food needs special support.

Known supported food mods

• Apple from Minetest Game [default]
• Red and brown mushroom from Minetest Game [flowers]
• Bread from Minetest Game [farming]
• [animalmaterials] (Mob Framework (mobf modpack))
• Bushes [bushes]
• [bushes_classic]
• Creatures [creatures]
• [dwarves] (beer and such)
• Docfarming [docfarming]
• Ethereal / Ethereal NG [ethereal]
• Farming Redo [farming] by TenPlus1
• Farming plus [farming_plus]
• Ferns [ferns]
• Fishing [fishing]
• [fruit]
• Glooptest [glooptest]
• JKMod ([jkanimals], [jkfarming], [jkwine])
• [kpgmobs]
• [mobfcooking]
• [mooretrees]
• [mtfoods]
• [mushroom]
• [mush45]
• Seaplants [sea]
• Simple mobs [mobs]
• Pizza [pizza]
• Not So Simple Mobs [nssm]

Supported mods without optional dependency (mods provide their own support)

• Food ([food], [food_basic])
• Sweet Foods [food_sweet]

Examples

• Eating an apple (from Minetest Game) increases your satiation by 2;
• eating a bread (from Minetest Game) increases your satiation by 4.

Licensing

This mod is free software.

Source code

• License: LGPL v2.1
• Author: by Wuzzy (2015-2016)
• Forked from the “Better HUD (and hunger)” mod by BlockMen (2013-2015), most code comes from this mod.

Textures

• hbhunger_icon.png—PilzAdam (MIT License), modified by BlockMen
• hbhunger_bgicon.png—PilzAdam (MIT License), modified by BlockMen
• hbhunger_bar.png—Wuzzy (MIT License)
• hbhunger_icon_health_poison.png—celeron55 (CC BY-SA 3.0), modified by BlockMen, modified again by Wuzzy
• Everything else: MIT License, by BlockMen and Wuzzy