Nutrition - Revision history

Umbire the Phantom: adjust ring hunger bits

2026-01-10T14:11:59Z

adjust ring hunger bits

Tomsod: /* Nutrition burn */ failing to cast does burn nutrition too

2025-11-29T16:28:40Z

‎Nutrition burn: failing to cast does burn nutrition too

Umbire the Phantom: /* Hunger status */ slightly more detail...

2025-05-12T02:42:43Z

‎Hunger status: slightly more detail...

Umbire the Phantom: /* Nutrition gain */ cite nutrition calcs from talk page

2025-05-11T23:32:00Z

‎Nutrition gain: cite nutrition calcs from talk page

Umbire the Phantom: add to todo

2025-05-11T23:27:49Z

add to todo

Umbire the Phantom: /* Other nutrition sources */ detail

2025-05-11T23:15:24Z

‎Other nutrition sources: detail

Umbire the Phantom: /* Messages */ typo

2025-05-11T22:45:07Z

‎Messages: typo

Umbire the Phantom: /* Hunger status */ tweaks

2025-05-11T22:42:53Z

‎Hunger status: tweaks

Umbire the Phantom: caps et. al.

2025-05-11T22:17:55Z

caps et. al.

Umbire the Phantom: fix repeated citation

2025-05-11T22:16:07Z

fix repeated citation

@@ Line 12: / Line 12: @@
 * On every odd game [[turn]], the hero loses one point of nutrition if they have the [[Regeneration (property)|regeneration]] property from a non-[[artifact]] source, and loses one point of nutrition if their [[encumbrance]] level is stressed or worse.{{refsrc|src/eat.c|2808|nethack=3.6.7}}{{refsrc|src/eat.c|2811|nethack=3.6.7}}
 * On every even game turn, the hero loses one point of nutrition if they are generating [[conflict]] from a non-artifact source, and loses one point of nutrition if they have the [[voracious hunger]] property.{{refsrc|src/eat.c|2814|nethack=3.6.7}}{{refsrc|src/eat.c|2817|nethack=3.6.7}}
-* Every twenty game turns, the hero loses one point of nutrition for each worn [[amulet]], one point of nutrition for each worn [[ring]] ''excluding'' any rings that have a [[charge]] and are at +0, and one point of nutrition for carrying (rather than wearing) the [[Amulet of Yendor]].{{refsrc|src/eat.c|2821|nethack=3.6.7}}{{refsrc|src/eat.c|2826|nethack=3.6.7}}{{refsrc|src/eat.c|2830|nethack=3.6.7}}{{refsrc|src/eat.c|2834|nethack=3.6.7}} If a hero is wearing two applicable rings, this is calculated on different turns for their left or right hands.
+* Every twenty game turns, the hero loses one point of nutrition for each worn [[amulet]], one point of nutrition for each worn [[ring]] ''excluding'' any [[chargeable]] rings that have an [[enchantment]] of +0, and one point of nutrition for carrying (rather than wearing) the [[Amulet of Yendor]].{{refsrc|src/eat.c|2821|nethack=3.6.7}}{{refsrc|src/eat.c|2826|nethack=3.6.7}}{{refsrc|src/eat.c|2830|nethack=3.6.7}}{{refsrc|src/eat.c|2834|nethack=3.6.7}} If a hero is wearing two applicable rings, this is calculated on different turns for their left or right hands.
 All of these above sources stack with each other, so it is possible to burn nutrition at up to 320% of the normal rate. Remember that the nutrition is lost as the ''turn counter'' advances, not as the hero moves. The following actions also consume nutrition:
@@ Line 24: / Line 24: @@
 * [[Vomiting]] for any reason will generally decrease nutrition, with the exact amount of nutrition lost depending on the source.
-{{upcoming|NetHack 3.7.0|A +0 [[ring of protection]] now causes ring hunger if it is the hero's only source of extrinsic protection. If the hero is wearing two rings of protection and the one on their left hand is +0, ring hunger applies to it, even if the right hand's ring is charged.
+{{upcoming|NetHack 3.7.0|Per {{commit|7ea7058c0181291f681b477d3ad54714ffa72608}}, a worn [[meat ring]] or [[cheap plastic imitation of the Amulet of Yendor]] does not incur ring hunger while worn. A worn +0 [[ring of protection]] causes ring hunger if it is the hero's only source of extrinsic protection&mdash;also, if the hero is wearing two rings of protection and the one on their left hand is +0, ring hunger applies to that left-hand ring even if the right hand's ring is charged.}}
 ===Nutrition gain===

@@ Line 17: / Line 17: @@
 * Attacking a monster in combat uses the same amount of nutrition that would be consumed on a normal whole turn in addition to the normal nutrition rate{{refsrc|src/hack.c|1978|nethack=3.6.7|comment=<tt>overexertion()</tt> function}}{{refsrc|src/hack.c|1983|nethack=3.6.7|comment=calls <tt>gethungry()</tt>}}&mdash;this includes attempting to move into the same square as a monster even if they are not hostile, but does not count declining to attack a peaceful monster when prompted. 'Safe' movement using the {{kbd|m}} [[command]] does not initiate combat and so will not burn nutrition.
-* [[Spellcasting]] successfully will reduce nutrition by the spell's energy cost times 2 (or effectively 10 times the spell level under normal circumstances), meaning that the hero cannot cast spells if they are at 10 nutrition or less with the exception of the {{+ of|detect food}} spell, which always costs 0 nutrition.{{refsrc|src/spell.c|932|nethack=3.6.7}}{{refsrc|src/spell.c|966|nethack=3.6.7|name="spellhunger"}}
+* [[Spellcasting]] will reduce nutrition by the spell's energy cost times 2 (or effectively 10 times the spell level under normal circumstances), meaning that the hero cannot cast spells if they are at 10 nutrition or less with the exception of the {{+ of|detect food}} spell, which always costs 0 nutrition.{{refsrc|src/spell.c|932|nethack=3.6.7}}{{refsrc|src/spell.c|966|nethack=3.6.7|name="spellhunger"}}
 ** [[Wizard]]s have access to [[reduced-hunger casting]] based on their [[intelligence]]:{{refsrc|src/spell.c|983|nethack=3.6.7}} this cuts the nutrition drain from spellcasting by {{frac|2}} at 15 Int, cuts it by {{frac|3|4}} at 16 Int, and becomes fully hungerless casting at 17 or more Int.{{refsrc|src/spell.c|987|nethack=3.6.7}}{{refsrc|src/spell.c|998|nethack=3.6.7}}{{refsrc|src/spell.c|1001|nethack=3.6.7}}
 ** Spellcasting while carrying the [[Amulet of Yendor]] that causes additional energy drain to occur will drain up to twice the base amount of energy from the hero, which incurs additional nutrition drain as well.{{refsrc|src/spell.c|956|nethack=3.6.7|comment=nutrition drain is applied based on the amount of energy used, and energy drain from the Amulet occurs before this calculation}}<ref name="spellhunger"/>

@@ Line 70: / Line 70: @@
 * <span id="Satiated">While the hero is '''satiated''' (i.e. at 1000 nutrition or more), they abuse dexterity on every tenth game turn, and [[Monk]]s also abuse [[wisdom]] on every tenth game turn.{{refsrc|src/attrib.c|462|version=NetHack 3.6.7}} Lawful Knights that eat while satiated incur a -1 penalty to [[alignment record]].{{refsrc|src/eat.c|245|nethack=3.6.7|comment="gluttony is unchivalrous"}} If a hero is satiated and '''''fully''''' consumes food that would leave them in an oversatiated state, they will abuse constitution, choke and possibly suffer an [[instant death]] from overeating{{refsrc|src/eat.c|2765|nethack=3.6.7|name="overstuffed"}}{{refsrc|src/eat.c|2864|nethack=3.6.7}}&mdash;this choking only occurs if the hero was already satiated when beginning the meal, i.e. being interrupted will not make the meal unsafe unless they eat something else or the game is saved and restored.{{refsrc|src/eat.c|2606|nethack=3.6.7}}{{refsrc|src/eat.c|2612|nethack=3.6.7}}{{refsrc|src/eat.c|2719|nethack=3.6.7}} ([[Eating jewelry|Eating]] an [[amulet of strangulation]] causes choking regardless of nutrition status.)</span>
-** <span id="Oversatiated">A hero in an '''oversatiated''' state is treated as above, except that they will choke from consuming any further food, including zero-nutrition meals such as [[wraith]] corpses.<ref name="overstuffed"/></span>
+** <span id="Oversatiated">A hero in an '''oversatiated''' state (2000+ nutrition) is treated as above, except that they will always choke from starting another meal in that state, including zero-nutrition meals such as [[wraith]] corpses.<ref name="overstuffed"/></span>
 ** If a hero is at 1500 or higher nutrition and they eat a meal that takes multiple actions to finish, they will be given a warning when they are nearing the oversatiated state, and may be prompted if they want to continue eating their meal at risk of choking.{{refsrc|src/eat.c|2878|nethack=3.6.7}}{{refsrc|src/eat.c|2889|nethack=3.6.7}}
 ** If the hero would choke while they are [[unbreathing]]&ndash;e.g., from eating or putting on an [[amulet of magical breathing]], or from polymorphing into an unbreathing monster{{refsrc|src/eat.c|252|nethack=3.6.7}}&ndash;and they are also not currently subjected to [[strangulation]], they will instead vomit and lose 1000 points of nutrition.{{refsrc|src/eat.c|259|nethack=3.6.7}} This can also occur even if the hero is not unbreathing at the time, though only with a {{frac|20}} chance. Surviving choking via life saving will also cause the hero to vomit as well.<ref name="reset"/>

@@ Line 31: / Line 31: @@
 A hero can gain nutrition through several means, all of which are listed below:
-* [[Comestible]]s such as [[food ration]]s and [[monster]] [[corpse]]s are a primary source of nutrition, and eating one increases the hero's nutrition by a set amount, distributed across the amount of turns taken to finish the meal&mdash;[[rotten food]] only gives half of its usual nutrition, and may also cause adverse effects. See the article for details on what comestible items there are and how much nutrition they offer.
+* [[Comestible]]s such as [[food ration]]s and [[monster]] [[corpse]]s are a primary source of nutrition, and eating one increases the hero's nutrition by a set amount, distributed across the amount of turns taken to finish the meal&mdash;due to how this is calculated being interrupted during a meal actually slightly reduces the total nutrition gained from the meal.{{refsrc|src/eat.c|2706|nethack=3.6.7}} [[Rotten food]] only gives half of its usual nutrition, and may also cause adverse effects. See the article for details on what comestible items there are and how much nutrition they offer.
 ** [[Polymorph]]ing into a [[metallivore]] or [[gelatinous cube]] allows the hero to eat non-standard, non-comestible objects for nutrition&mdash;see those articles for details.
 * [[Quaffing]] a [[potion of fruit juice]] grants 10 nutrition if it is cursed, 20 if it is uncursed and 30 if it is blessed, and the amount is halved if the potion is [[diluted]].{{refsrc|src/potion.c|768|version=NetHack 3.6.7}}

@@ Line 2: / Line 2: @@
 While nutrition is generally maintained by [[eating]] [[comestible]]s regularly, this is not always the case: there are means of gaining nutrition without eating food, and the [[foodless]] [[conduct]] is dedicated to maintaining nutrition without eating at all.
-{{todo|Update to reflect info in food-343.txt that needs incorporating here and elsewhere, establish variant sections after ensuring the main body is filled out, and ensure the following isn't ''too'' redundant with the [[eating]] or [[comestible]] articles.<!--eating is the action, nutrition is the stat, and comestibles are the group of items-->}}
+{{todo|Update to reflect info in food-343.txt that needs incorporating here and elsewhere, fill out other sources of nutrition changes, establish variant sections after ensuring the main body is filled out, and ensure the following isn't ''too'' redundant with the [[eating]] or [[comestible]] articles.<!--eating is the action, nutrition is the stat, and comestibles are the group of items-->}}
 ==Description==
@@ Line 14: / Line 14: @@
 * Every twenty game turns, the hero loses one point of nutrition for each worn [[amulet]], one point of nutrition for each worn [[ring]] ''excluding'' any rings that have a [[charge]] and are at +0, and one point of nutrition for carrying (rather than wearing) the [[Amulet of Yendor]].{{refsrc|src/eat.c|2821|nethack=3.6.7}}{{refsrc|src/eat.c|2826|nethack=3.6.7}}{{refsrc|src/eat.c|2830|nethack=3.6.7}}{{refsrc|src/eat.c|2834|nethack=3.6.7}} If a hero is wearing two applicable rings, this is calculated on different turns for their left or right hands.
-All of these above sources stack with each other, so it is possible to burn nutrition at up to 320% of the normal rate. Note that the nutrition is lost as the turn counter advances, not as the hero moves. The following actions also consume nutrition:
+All of these above sources stack with each other, so it is possible to burn nutrition at up to 320% of the normal rate. Remember that the nutrition is lost as the ''turn counter'' advances, not as the hero moves. The following actions also consume nutrition:
 * Attacking a monster in combat uses the same amount of nutrition that would be consumed on a normal whole turn in addition to the normal nutrition rate{{refsrc|src/hack.c|1978|nethack=3.6.7|comment=<tt>overexertion()</tt> function}}{{refsrc|src/hack.c|1983|nethack=3.6.7|comment=calls <tt>gethungry()</tt>}}&mdash;this includes attempting to move into the same square as a monster even if they are not hostile, but does not count declining to attack a peaceful monster when prompted. 'Safe' movement using the {{kbd|m}} [[command]] does not initiate combat and so will not burn nutrition.

@@ Line 41: / Line 41: @@
 * Polymorphing and "feeling like a new <hero>" sets nutrition to a random value from 500 to 999.{{refsrc|src/polyself.c|346|version=NetHack 3.6.7}}
-* [[Life saving]] will set the hero's nutrition to 900 if they were at less than 500 nutrition when life saving occurred, or else if it triggered from a death caused by overeating.{{refsrc|src/end.c|867|version=NetHack 3.6.7|name="reset"}}
+* [[Life saving]] will set the hero's nutrition to 900 if they were at less than 500 nutrition when life saving occurred, or else if it triggered from a death caused by overeating (in which case they will vomit and lose 1000 nutrition).{{refsrc|src/end.c|867|version=NetHack 3.6.7|name="reset"}}
 ==Hunger status==

@@ Line 110: / Line 110: @@
 ==Messages==
-{{message|<Valkyrie|Wizard|Elf> needs food, badly!|You became weak from hunger as a Valkyrie, Wizard or elven hero&mdash;this is a reference to the ''[[wikipedia:Gauntlet (arcade game)|Gauntlet]]'' series of dungeon crawler arcade games, where food is usually a far more pressing issue since it is a healing item, and the games' narrator will boom this message when your character is dying.<ref name="gauntlet"/>}}
+{{message|<Valkyrie/Wizard/Elf> needs food, badly!|You became weak from hunger as a Valkyrie, Wizard or elven hero&mdash;this is a reference to the ''[[wikipedia:Gauntlet (arcade game)|Gauntlet]]'' series of dungeon crawler arcade games, where food is usually a far more pressing issue since it is a healing item, and the games' narrator will boom this message when your character is dying.<ref name="gauntlet"/>}}
 ==References==

@@ Line 76: / Line 76: @@
 * <span id="Hungry">A hero that becomes '''hungry''' will have a message printed to indicate this state, but does not abuse or exercise any attributes from this nutrition state.</span>
 * <span id="Weak">A hero that becomes '''weak''' from hunger will have a message printed to indicate this state (with a special message for [[Valkyrie]]s, [[Wizard]]s and [[Elf (starting race)|elven]] heroes).{{refsrc|src/eat.c|3054|version=NetHack 3.6.7|name="gauntlet"}}{{refsrc|src/eat.c|3061|version=NetHack 3.6.7}} A hero weak from hunger abuses [[strength]] on every tenth game turn, and Monks will also ''exercise'' wisdom on every tenth game turn.{{refsrc|src/attrib.c|470|version=NetHack 3.6.7}} While weak, the hero also has their current strength decreased by one point, which is restored upon raising their nutrition level from this state and ignores any [[sustain ability]] property in both cases.{{refsrc|src/eat.c|3018|nethack=3.6.7}}{{refsrc|src/eat.c|3024|nethack=3.6.7}}</span>
-* <span id="Fainting">A hero will begin '''fainting''' from hunger once they reach zero nutrition, which abuses constitution every tenth game turn and causes them to random fall unconscious after each movement or action.{{refsrc|src/attrib.c|475|version=NetHack 3.6.7}}<ref name="hunger"/>{{refsrc|src/eat.c|2977|nethack=3.6.7}}{{refsrc|src/eat.c|2983|nethack=3.6.7}} If a fainting hero reaches their minimum nutrition, they will die of starvation.<ref name="starved"/>{{refsrc|src/eat.c|3074|nethack=3.6.7}}</span>
+* <span id="Fainting">A hero will begin '''fainting''' from hunger once they reach zero nutrition, which abuses constitution every tenth game turn and causes them to random fall unconscious after each movement or action.{{refsrc|src/attrib.c|475|version=NetHack 3.6.7}}<ref name="hunger"/>{{refsrc|src/eat.c|2977|nethack=3.6.7}}{{refsrc|src/eat.c|2983|nethack=3.6.7}} If a fainting hero reaches their minimum nutrition, they will die instantly of '''starvation'''.<ref name="starved"/>{{refsrc|src/eat.c|3074|nethack=3.6.7}}</span>
 {{upcoming|NetHack 3.7.0|Per {{commit|50084750c426c465e976b23c9a7f871a8950fae3}}, the [[voracious hunger]] property also prevents the hero from choking on food when oversatiated by making them vomit, except that it will always leave them with 60 nutrition.}}

@@ Line 76: / Line 76: @@
 * <span id="hungry">A hero that becomes '''hungry''' will have a message printed to indicate this state, but does not abuse or exercise any attributes from this nutrition state.</span>
 * <span id="weak">A hero that becomes '''weak''' from hunger will have a message printed to indicate this state (with a special message for [[Valkyrie]]s, [[Wizard]]s and [[Elf (starting race)|elven]] heroes).{{refsrc|src/eat.c|3054|version=NetHack 3.6.7|name="gauntlet"}}{{refsrc|src/eat.c|3061|version=NetHack 3.6.7}} A hero weak from hunger abuses [[strength]] on every tenth game turn, and Monks will also ''exercise'' wisdom on every tenth game turn.{{refsrc|src/attrib.c|470|version=NetHack 3.6.7}} While weak, the hero also has their current strength decreased by one point, which is restored upon raising their nutrition level from this state and ignores any [[sustain ability]] property in both cases.{{refsrc|src/eat.c|3018|nethack=3.6.7}}{{refsrc|src/eat.c|3024|nethack=3.6.7}}</span>
-* <span id="fainting">A hero will begin '''fainting''' from hunger once they reach zero nutrition, which abuses constitution every tenth game turn and causes them to random fall unconscious after each movement or action.{{refsrc|src/attrib.c|475|version=NetHack 3.6.7}}{{refsrc|src/eat.c|2939|nethack=3.6.7}}{{refsrc|src/eat.c|2977|nethack=3.6.7}}{{refsrc|src/eat.c|2983|nethack=3.6.7}} If a fainting hero reaches their minimum nutrition, they will die of starvation.<ref name="starved"/>{{refsrc|src/eat.c|3074|nethack=3.6.7}}</span>
+* <span id="fainting">A hero will begin '''fainting''' from hunger once they reach zero nutrition, which abuses constitution every tenth game turn and causes them to random fall unconscious after each movement or action.{{refsrc|src/attrib.c|475|version=NetHack 3.6.7}}<ref name="hunger"/>{{refsrc|src/eat.c|2977|nethack=3.6.7}}{{refsrc|src/eat.c|2983|nethack=3.6.7}} If a fainting hero reaches their minimum nutrition, they will die of starvation.<ref name="starved"/>{{refsrc|src/eat.c|3074|nethack=3.6.7}}</span>
 {{upcoming|NetHack 3.7.0|Per {{commit|50084750c426c465e976b23c9a7f871a8950fae3}}, the [[voracious hunger]] property also prevents the hero from choking on food when oversatiated by making them vomit, except that it will always leave them with 60 nutrition.}}