📢 Updated: 2026-05-16 — Description updated to reflect v1.2.1. New HUD features, tooltip improvements, and more!

NutritionDisease adds a nutrition, disease, and trait system to Minecraft — all fully configurable via JSON datapacks.

🥩 Nutrition System

Five nutrients are tracked for each player:

Nutrient	High (≥80)	Low (≤20)
Protein	+20% attack damage	−20% attack damage
Carbs	+15% movement speed	−15% movement speed
Vitamins	Gradual healing	Gradual damage over time
Minerals	+4 armor	−2 armor
Lipids	+4 max health	−4 max health

Nutrients decay over time and are replenished by eating food. Every food item has unique nutritional values defined in JSON — you can add your own via datapacks.

🦠 Disease System

Prolonged nutritional imbalance triggers diseases. Each disease applies debuffs and random symptoms until cured.

Deficiency diseases (nutrient too low):

Scurvy — Vitamin deficiency → Weakness + vision blur + random damage. Cured by fruit.
Rickets — Mineral deficiency → Mining Fatigue + item drops + sneezing. Cured by milk.
Kwashiorkor — Protein deficiency → Weakness + Slowness + dizziness. Cured by cooked meat or sleep.

Excess diseases (nutrient too high):

Obesity — Lipid excess → Slowness + hunger drain. Recovers naturally over time.
Diabetes — Carb excess → Nausea + vomiting + dizziness. Recovers naturally over time.
Hypervitaminosis — Vitamin excess → Nausea + vomiting + random damage. Cured by sleep.

Recovery methods:

Eat the right food (cure items)
Sleep in a bed (for bed-recoverable diseases)
Restore your nutrient levels to a healthy range
Wait for natural recovery

After recovery, a temporary immunity effect is granted to prevent immediate relapse. Death resets all nutrition and diseases.

⭐ Trait System

Eating the same food repeatedly builds a streak. Hit the target count and unlock a permanent trait with powerful effects — but break the streak by eating something different, and you'll have to start over. All traits are lost on death.

There are 14 traits hidden in the game. Some reward dedication to a single food, others unlock from more… unconventional choices.

We're not going to tell you what they are. Eat obsessively. Experiment. Find them yourself. 🍖

Hint: Pay attention to the streak messages in chat — they'll tell you if you're on the right track.

🍽️ Mod Compatibility

Nutritional values are included for:

Vanilla Minecraft — full coverage
Farmer's Delight — 80+ items
Pam's HarvestCraft 2 — 80+ items
Croptopia — 90+ items

All values are defined in JSON — add support for any mod via datapack.

🖥️ HUD

A nutrition bar panel displays all five nutrient levels in real time, with color-coded warnings (orange = caution, red = danger). Active diseases and unlocked traits are shown alongside duration timers.

Food tooltips show the nutritional breakdown of each item, and will display "Cures: [Disease]" if you are currently infected and hovering over a cure item.

⚙️ Configuration & Commands

All thresholds, decay rates, and HUD position are adjustable via the config file.

Commands:

/disease list|add|remove — inspect and manage diseases
/trait list|unlock|reset — inspect and manage traits

📦 Datapack / Mod Support

Everything — diseases, traits, food nutrition values, effects — is defined in JSON. You can override any value or add new diseases and traits via a datapack without touching the mod itself.