View source for Hunger

{{about|the gameplay mechanic|the effect|Hunger (effect)}}
[[File:Hotbar with xp.png|thumb|350px|The hunger indicator is shown above the hotbar, to the other side of the health bar.]]

'''Hunger''' is a [[player]]-specific feature of [[Minecraft]] that regulates certain abilities ([[health]] regeneration and the ability to [[sprint]]), the value of which is managed by the player's activity.

== Description ==
The player's hunger value is shown on the [[heads-up display]] in the form of a hunger bar (or food bar), which is similar to the [[health]] bar (located above the [[hotbar]]), located opposite to it and represented by ten drumsticks ({{hunger|20|notag=1}}). One half of a drumstick ({{hunger|1|notag=1}}) represents one hunger point or half-unit of hunger, thus the full bar consists of twenty hunger points. It is replenished by eating [[food]], and decreased by a player's actions, such as [[sprinting]], [[digging]] or attacking.

Various levels of a player's hunger control health regeneration (or depletion) and the ability to sprint. When hunger is at 18 ({{Hungerbar|18|9px|total=20}}), the player's health regenerates. If it falls to 6 ({{Hungerbar|6|9px|total=20}}), the player loses the ability to sprint. If the hunger bar is at zero, the player's health depletes. The specific effects are described in the [[#Effects of hunger|Effects of hunger section]]. The hunger value does not drain on [[Peaceful]] difficulty, and regenerates if it is not at the maximum value.

An important aspect of hunger not shown on the hunger bar is called <u>food saturation</u>, which controls the decreasing of the hunger value. It depends on what the player has eaten last. There is also a food exhaustion value that controls the decreasing of the food saturation level. How exactly they control the overall hunger value is described in more depth in the [[#Mechanics|Mechanics section]].

{{See also|#Food poisoning}}

Certain foods have a chance of inflicting the [[Hunger (status effect)|Hunger]] effect on the player upon consumption, causing the player's food bar to deplete faster and turn a yellow-green color ({{hungerbar|2|9px|poisoned=1}}). These foods are [[Pufferfish (item)|pufferfish]], [[raw chicken]] (30% chance), and [[rotten flesh]] (80% chance). A [[husk]] can also give the player the Hunger effect upon being attacked by one.

== Mechanics ==

The hunger system utilizes four variables to control players' abilities, the values of which are stored in the [[player.dat format]]:
* <code>foodLevel</code>: The player's current hunger level, shown on the hunger bar. Its initial value on [[world]] creation or respawn is {{hunger|20}}.
* <code>foodSaturationLevel</code>: The player's current saturation level, which determines how fast <code>foodLevel</code> depletes and is controlled by the kinds of food the player has eaten. Its maximum value always equals <code>foodLevel</code>'s value and decreases with <code>foodLevel</code>. Its initial value on world creation or respawn is 5.
* <code>foodTickTimer</code>: This variable is used when <code>foodLevel</code> either exceeds 17 ({{Hungerbar|17|9px|total=20}}), or is at zero. It increases on every [[tick]], and whenever it reaches 80 (4 seconds), it resets to zero and {{hp|1}} is added or deducted, depending on whether the player is saturated or starving. If the player has a full {{hunger|20}}, {{frac|1|6}} of {{hp|1}} times the player's <code>foodSaturationLevel</code> is restored, up to a maximum of {{hp|1}}, when <code>foodTickTimer</code> reaches 10 ({{frac|1|2}} second), and <code>foodTickTimer</code> is reset to zero.
* <code>foodExhaustionLevel</code>: The player's current exhaustion level, which determines how fast the <code>foodSaturationLevel</code> depletes. Its value is increased by the player's actions (see [[#Exhaustion level increase|Exhaustion level increase]] for specific values). The initial value is zero. When it reaches a value of at least 4, the total value is decreased by 4 and one point is subtracted from <code>foodSaturationLevel</code>, or <code>foodLevel</code> if <code>foodSaturationLevel</code> is at zero.

The above variables can be queried in-game with the following command: {{cmd|data get entity <player's name> <variable>}}{{only|je}}.

As a visible sign that the saturation is used up, the hunger bar starts to shake or jitter periodically. When the saturation level is at zero, once the exhaustion value reaches 4, the total hunger value is decreased by {{hunger|1}}. Eating [[food]] replenishes both hunger and saturation levels (see [[#Food level and saturation level restoration|Food level and saturation level restoration]] for specific values), with the hunger level being replenished first, which also increases the maximum allowed saturation level. For example, if a [[golden carrot]] (giving {{hunger|6}} and 14.4 saturation points) is eaten by a player whose hunger bar is at {{hunger|9|total=20}} and saturation is below 1, its value increases to 15 ({{Hungerbar|15|9px|total=20}}), and the golden carrot's saturation potential is fully used. However, if the hunger level is {{hunger|8|total=20}}, its value increases to 14 ({{Hungerbar|14|9px|total=20}}) and only 14 saturation points are used.

=== Effects of hunger ===

Various hunger levels lead to various effects on the player:
* When the hunger bar is at 20 ({{Hungerbar|20|9px}}) and there is any saturation left, health regenerates {{hp|1}} every {{frac|1|2}} second.{{only|java}}
* When the hunger bar is at 18 ({{Hungerbar|18|9px|total=20}}) or more, health slowly regenerates {{hp|1}} every 4 seconds.
* When the hunger bar is at 17 ({{Hungerbar|17|9px|total=20}}) points or below, the player does not naturally regenerate health.
* If the hunger bar is at {{hunger|6|total=20}} points or below, then the player cannot sprint.
* When the hunger bar is at {{hunger|0|total=20}}, the player's health depletes at a rate of {{hp|1}} every 4 seconds (this makes [[Bed|sleeping]] impossible). On Easy [[difficulty]], the player's health stops dropping at {{hp|10|total=20}}, on Normal, it stops at {{hp|1|total=20}}, and on Hard, it keeps draining until either the player eats something or starves to death. [[Resistance]] and [[armor]] do not reduce starvation damage.<ref>{{tweet|jeb_|111047534318858240}}</ref>

Switching to Peaceful [[difficulty]] eliminates all penalties above, and rapidly restores the player's hunger bar and health.

=== Exhaustion level increase ===

''Any action not listed here does not increase exhaustion level. For example, normal walking doesn't increase exhaustion, and therefore does not decrease saturation or the food bar.''

{| class="sortable mw-collapsible wikitable" data-description="Exhaustion"
! class="unsortable" | Action
! Exhaustion<br>level increase
! Units
|-
| [[Swimming]]
| style="text-align: right;" | <center>0.01</center>
| per meter
|-
| [[Breaking]] a block
| style="text-align: right;" | <center>0.005</center>
| per block broken
|-
| [[Sprinting]]
| style="text-align: right;" | <center>0.1</center>
| per meter
|-
| [[Jumping]]
| style="text-align: right;" | <center>0.05</center>
| per jump
|-
| Attacking an [[entity]]
| style="text-align: right;" | <center>0.1</center>
| per attack landed
|-
| Taking [[damage]] that is normally [[Armor#Damage types|protected by armor]]
| style="text-align: right;" | <center>0.1</center>
| per distinct instance of damage being received
|-
| {{EffectLink|link=Hunger (status effect)|Hunger}}
| style="text-align: right;" | <center>0.005</center>
| per tick, per Hunger status effect level
|-
| Jumping while sprinting
| style="text-align: right;" | <center>0.2</center>
| per jump
|-
| Regenerating health by having {{hunger|18|notag=1}} or higher and<br>having [[gamerule]] <code>naturalRegeneration</code> set to <code>true</code>
| style="text-align: right;" | <center>6.0</center>
| per {{hp|1}} healed
|-
| {{EffectLink|link=Hunger (status effect)|Hunger}} from [[raw chicken]] or [[rotten flesh]], or taking damage from [[husk]]s.
| style="text-align: right;" | <center>3.0</center>
| full 0:30 duration of Hunger I, at 0.1 per second
|-
| {{EffectLink|link=Hunger (status effect)|Hunger}} from [[Pufferfish (item)|pufferfish]]
| style="text-align: right;" | <center>4.5</center>
| full 0:15 duration of Hunger III, at 0.3 per second
|}

=== Food level and saturation level restoration ===

{{main|Food}}
{{:Food/table}}

== Food poisoning ==
{{main|Hunger (status effect)}}

== Achievements ==

{{load achievements|Iron Belly}}

== Video ==

<div style="text-align:center">{{yt|yOAGhLP971s}}</div>

== History ==

[[File:Hungerscreen.png|thumb|The first image that shows the hunger bar.]]
{{History|java beta}}
{{History||July 19, 2011|link={{tweet|notch|93305042941132801}}|The hunger bar is first seen in an image Notch posted to Twitter that showcases his experimentation with world height.}}
{{History||1.8|snap=Pre-release|Hunger was introduced. Food no longer restores health directly, but the player can regenerate if the hunger meter is 90% or over.}}
{{History|java}}
{{History||1.6.1|snap=13w23a|Natural health regeneration now increases the food exhaustion level.}}
{{History||1.7.2|snap=13w36a|The exhaustion cost of sprint jumping is now 0.8 (up from 0.2), meaning that constant sprint jumping is no longer viable as a means of fast long-distance travel in most situations.}}
{{History||1.8|snap=14w29a|Hunger now regenerates when depleted if the [[difficulty]] is set to Peaceful.}}
{{History||1.9|snap=15w40a|Health regenerates faster when saturation is non-zero.|Health regeneration increases exhaustion more.}}
{{History|||snap=15w44a|Health regenerates speed bonus from non-zero saturation only applies when the hunger bar is at 20.}}
{{History|||snap=15w49a|Sneaking now increases exhaustion by 0.005/m, decreased from 0.01/m.}}
{{History||1.11|snap=16w32a|Exhaustion rates decreased across the board: Swimming decreased from 0.015/m to 0.01/m, breaking blocks decreased from 0.025/block to 0.005/block, jumping decreased from 0.2/jump to 0.05/jump, sprint jumping decreased from 0.8/jump to 0.2/jump, attacking and taking damage both decreased from 0.3/attack to 0.1/attack, Hunger status effect decreased from 0.5/s to 0.1/s.
|Sneaking and walking no longer affect exhaustion.
|Exhaustion rate from regeneration is increased from 4.0/half-heart to 6.0/half-heart.
|The hunger bar is now visible when riding a [[boat]] or a [[minecart]].}}
{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|Hunger was introduced. Food no longer restores health directly, but the player can regenerate if the hunger meter is 90% or over.}}
{{History|bedrock}}
{{History||1.18.30|snap=beta 1.18.20.25|The rate that hunger decreases has been changed to better match ''[[Java Edition]]'' and can now be changed with behavior packs ([[add-on]]s).<ref>https://bugs.mojang.com/browse/MCPE-56031</ref>}}
{{History|console}}
{{History||xbox=TU5|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|Added the food bar and hunger.}}
{{history||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Food now regenerates health.}}
{{History||xbox=TU54|xbone=CU44|ps=1.52|wiiu=Patch 24|switch=1.0.4|Exhaustion rates decreased across the board: Swimming decreased from 0.015/m to 0.01/m, breaking blocks decreased from 0.025/block to 0.005/block, jumping decreased from 0.2/jump to 0.05/jump, sprint jumping decreased from 0.8/jump to 0.2/jump, attacking and taking damage both decreased from 0.3/attack to 0.1/attack, Hunger status effect decreased from 0.5/s to 0.1/s.
|Sneaking and walking no longer affect exhaustion.
|Exhaustion rate from regeneration is increased from 0.4/half-heart to 0.6/half-heart.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{Reflist}}

{{Gameplay}}
[[Category:Rewritten gameplay]]

[[de:Hunger]]
[[es:Hambre]]
[[fr:Faim]]
[[hu:Éhség]]
[[it:Fame]]
[[ja:満腹度]]
[[ko:배고픔]]
[[nl:Honger]]
[[pl:Głód]]
[[pt:Fome]]
[[ru:Голод]]
[[tr:Açlık]]
[[uk:Голод]]
[[zh:饥饿]]
[[fi:Nälkä]]