Dynamic Nutrition

Dynamic Nutrition adds five nutrients to the game: carbohydrates, protein, fat, vitamins and minerals. Hunger tells you how long it has been since you ate, and the nutrients tell you what you ate. Every food fills them by different amounts, based on real nutritional data, and each one drains at its own rate. Keep a nutrient high and it gives you an effect; let it run low and it gives you a penalty instead.

Nutrients

The values come from real per-100g composition rather than from a category label, so a carrot is worth far more vitamins than cooked beef, and cooked beef far more protein than a carrot. Vegetables are low in carbohydrates, protein and fat and high in vitamins and minerals, as they are in real food.

Each nutrient drains at its own speed. Carbohydrates go fastest, while fat, which the body stores, barely moves.

Variety

Eating the same food again is worth less. Of your last eight meals, every repeat of a food after the first lowers its value, down to a floor it never goes below. A rotation of eight or more foods loses nothing, three foods lose about a third, and a single food eaten every time stays at the floor. Variety changes nutrition only and never hunger, so hunger works the same as without the mod.

Effects

Above its green line, each nutrient gives an effect: Speed for carbohydrates, Strength for protein, Resistance for fat, Regeneration for vitamins and Haste for minerals. Below its red line it gives Slowness, Weakness, Hunger, Blindness or Mining Fatigue instead. All ten work at half the vanilla strength by default, and each one has its own setting from 0 to 100%.

They appear as two icons rather than ten. Every buff your diet earns is grouped under Well Nourished and every penalty under Malnourished, and both show at once when one nutrient is high and another is low. Hover either icon beside your inventory to see which effects it stands for, each in the colour of its nutrient. A potion or beacon that gives the same effect keeps its own icon, so no effect is shown twice. Milk does not clear them, because the cure for a deficiency is food.

The two lines are different for each nutrient and follow how the body stores it. Fat has months of reserve and a real deficiency is rare, so its red line is low. Protein has no store at all, and the vitamin deficiencies are the ones with names. Both lines are marked on every bar, and a mark turns white once you are past it.

Activity

Food burned draws on the nutrients your activity uses: carbs when running or swimming, protein when fighting, minerals when working with tools, vitamins when healing, fat in the cold and when swimming, and vitamins and minerals in the heat. The total stays the same, so this moves decay and adds none. Protein and fat also keep you full for longer than carbs.

With Tough As Nails, Cold Sweat, Legendary Survival Overhaul, Survive or Frostiful installed, your real body temperature decides whether you count as cold or hot, on the versions and loaders listed in the README. Elsewhere the biome decides.

AppleSkin's saturation preview shows what a meal will really give. Tested versions and loaders are in the README.

Ketosis

A full in-game day of low carbs with fat to spare turns your body to fat for fuel: carbs barely fall, fat falls faster, low carbs stop slowing you and meals last longer. Your fat percentage turns yellow while it lasts, and hovering it explains why. Eating real carbs ends it.

On screen

• Press N, or click the small button in your inventory, to open the nutrition screen. The key always works, so if the button overlaps another mod's button you can turn it off in the settings
• A strip beside the hunger bar shows all five nutrients. Each section is ten pixels wide, and one pixel is ten points. It sits above the other bars in that column, so a bar from another mod keeps its place and the strip moves up. Tested with Tough As Nails, Iron's Spells 'n Spellbooks, Thirst Was Taken, Legendary Survival Overhaul, Survive, AsteorBar, ParCool, Cold Sweat and Dehydration, on the loaders and versions listed in the README
• The food finder opens from the question mark on the nutrition screen, or by clicking a nutrient. Pick a nutrient to list the foods with the most of it, or use the star for the best foods for you right now. Foods that can harm you have their names in red
• Holding a food previews it: the strip fills in white up to where the meal would land, and the nutrition screen shows a pale extension on each bar
• Food tooltips show what a food is worth to you right now, including any reduction for repeats. With advanced tooltips on (F3 and H) they also show where the values came from

Food from other mods

Foods the mod has no data for get their values worked out automatically, in stages. Data written for the food comes first, including base values for common modded ingredients such as flour, butter, cheese and tofu, then item tags, then the recipe, so bread counts as a carbohydrate because wheat does, even through ingredients that cannot be eaten on their own. A dish takes the mix of its ingredients in proportion, so fried rice is mostly carbohydrates, and its size follows its hunger value. After that come the food and drink tags, including the ones mods add for their own foods. Then a food served another way, such as a stew in a cup or a serving from a feast, takes the values of the food it comes from. Last, the food's own name is read, so spider meat counts as meat.

In 18 test packs with over 400 food mods on 1.20.1 and 1.21.1 (30,668 foods), 97.6% of the foods got values this way; on NeoForge 26.2 (28 food mods) 99.5%, and on 26.1.2 (45 food mods) 98.5%. Writing values by hand for every mod's food is close to impossible: there are thousands of modded foods, they change from one version to the next, and many are fantasy foods with no real counterpart, so it would take hundreds of hours and still fall behind. Working the values out automatically is what covers the most foods as accurately as possible, and the algorithm will keep improving in future versions.

If a food gets no values, or values that look wrong, please report it on the issue tracker. I am actively looking for edge cases like these. /dynamicnutrition unassigned lists every food that has no values in your game.

For modpack authors

/dynamicnutrition export (operators only) writes the whole table of values to a CSV, with where each value came from, so you can check the balance of your own pack in a spreadsheet. A second file lists the ingredients each value was derived from.

Languages

English, Chinese (Simplified), Russian, Portuguese (Brazil), Spanish, German, French, Japanese and Korean. The translations are machine-assisted; corrections are welcome on the issue tracker.

Settings

Cloth Config gives the mod a settings screen in five tabs: the strip beside the hunger bar, the inventory button and tooltips, variety, hunger, and the nutrient effects, where each of the ten has its own strength, from 0 to turn it off to 100, and either icon can be hidden. Where Cloth Config is optional, the mod runs on its default settings without it.

Supported versions

Minecraft	Fabric	NeoForge	Forge
26.1 to 26.3	Yes	Yes	n/a
1.21.11	Yes	Yes	Yes
1.21 to 1.21.1	Yes	Yes	Yes
1.20 to 1.20.1	Yes	1.20.1	Yes

There is one file per loader, and it picks the right build for the version it is installed on. On NeoForge 1.20.1 the NeoForge file runs the Forge build, which NeoForge supports at that version. Every loader was tested in game on 1.20.1, 1.21.1 and 1.21.11, and Fabric and NeoForge also on 26.1.2, 26.2 and 26.3.

Dependencies

Mod	Fabric	NeoForge	Forge
Fabric API	Required	n/a	n/a
Cloth Config	Required on 1.21.x, optional otherwise	Required on 1.21.x, optional otherwise	Optional
Cloth Config API Forge	n/a	n/a	Optional, for the settings screen on 1.21.11
Mod Menu	Optional	n/a	n/a

On Forge 1.21.11, Cloth Config has no Forge build, so the settings screen comes from Cloth Config API Forge, a separate project. Because one Forge file covers versions that need different ones, both are listed as optional on the Forge file; install the one for your version.

Credits

Several of the interface textures are derived from Minecraft's own and remain Mojang's property.

An original mod, written from scratch. Not a fork or a port.